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:
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();
new Wipe(gameObject, [wipeWidth], [direction], [axis], [reveal])
name | type | arguments | Default | description |
---|---|---|---|---|
gameObject | Phaser.GameObjects.GameObject |
A reference to the Game Object that has this fx. |
||
wipeWidth | number | <optional> | 0.1 |
The width of the wipe effect. This value is normalized in the range 0 to 1. |
direction | number | <optional> | 0 |
The direction of the wipe effect. Either 0 or 1. Set in conjunction with the axis property. |
axis | number | <optional> | 0 |
The axis of the wipe effect. Either 0 or 1. Set in conjunction with the direction property. |
reveal | boolean | <optional> | false |
Is this a reveal (true) or a fade (false) effect? |
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.
The axis of the wipe effect. Either 0 or 1. Set in conjunction with the direction property.
The direction of the wipe effect. Either 0 or 1. Set in conjunction with the axis property.
A reference to the Game Object that owns this effect.
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)
Is this a reveal (true) or a fade (false) effect?
The FX_CONST type of this effect.
The width of the wipe effect. This value is normalized in the range 0 to 1.
Destroys this FX Controller.
Sets the active state of this FX Controller.
A disabled FX Controller will not be updated.
name | type | description |
---|---|---|
value | boolean |
|
This FX Controller instance.