phaser - v3.90.0
    Preparing search index...

    The Wipe FX Controller.

    This FX controller manages the wipe effect for a Game Object.

    The wipe or reveal effect is a visual technique that gradually uncovers or conceals elements in the game, such as images, text, or scene transitions. This effect is often used to create a sense of progression, reveal hidden content, or provide a smooth and visually appealing transition between game states.

    You can set both the direction and the axis of the wipe effect. The following combinations are possible:

    • left to right: direction 0, axis 0
    • right to left: direction 1, axis 0
    • top to bottom: direction 1, axis 1
    • bottom to top: direction 1, axis 0

    It is up to you to set the progress value yourself, i.e. via a Tween, in order to transition the effect.

    A Wipe effect is added to a Game Object via the FX component:

    const sprite = this.add.sprite();

    sprite.preFX.addWipe();
    sprite.postFX.addWipe();
    sprite.preFX.addReveal();
    sprite.postFX.addReveal();

    Hierarchy (View Summary)

    Index

    Constructors

    • Parameters

      • gameObject: GameObject

        A reference to the Game Object that has this fx.

      • OptionalwipeWidth: number

        The width of the wipe effect. This value is normalized in the range 0 to 1. Default 0.1.

      • Optionaldirection: number

        The direction of the wipe effect. Either 0 or 1. Set in conjunction with the axis property. Default 0.

      • Optionalaxis: number

        The axis of the wipe effect. Either 0 or 1. Set in conjunction with the direction property. Default 0.

      • Optionalreveal: boolean

        Is this a reveal (true) or a fade (false) effect? Default false.

      Returns Wipe

    Properties

    active: boolean

    Toggle this boolean to enable or disable this effect, without removing and adding it from the Game Object.

    Only works for Pre FX.

    Post FX are always active.

    axis: number

    The axis of the wipe effect. Either 0 or 1. Set in conjunction with the direction property.

    direction: number

    The direction of the wipe effect. Either 0 or 1. Set in conjunction with the axis property.

    gameObject: GameObject

    A reference to the Game Object that owns this effect.

    progress: number

    The progress of the Wipe effect. This value is normalized to the range 0 to 1.

    Adjust this value to make the wipe transition (i.e. via a Tween)

    reveal: boolean

    Is this a reveal (true) or a fade (false) effect?

    type: number

    The FX_CONST type of this effect.

    wipeWidth: number

    The width of the wipe effect. This value is normalized in the range 0 to 1.

    Methods

    • Destroys this FX Controller.

      Returns void

    • Sets the active state of this FX Controller.

      A disabled FX Controller will not be updated.

      Parameters

      • value: boolean

        true to enable this FX Controller, or false to disable it.

      Returns this