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();
Constructor
new Wipe(gameObject, [wipeWidth], [direction], [axis], [reveal])
Parameters
name | type | optional | default | description |
---|---|---|---|---|
gameObject | No | A reference to the Game Object that has this fx. | ||
wipeWidth | number | Yes | 0.1 | The width of the wipe effect. This value is normalized in the range 0 to 1. |
direction | number | Yes | 0 | The direction of the wipe effect. Either 0 or 1. Set in conjunction with the axis property. |
axis | number | Yes | 0 | The axis of the wipe effect. Either 0 or 1. Set in conjunction with the direction property. |
reveal | boolean | Yes | false | Is this a reveal (true) or a fade (false) effect? |
Scope: static
Extends
Source: src/fx/Wipe.js#L11
Since: 3.60.0
Public Members
active
active: boolean
Description:
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.
Inherits: Phaser.FX.Controller#active
Source: src/fx/Controller.js#L47
Since: 3.60.0
axis
axis: number
Description:
The axis of the wipe effect. Either 0 or 1. Set in conjunction with the direction property.
Source: src/fx/Wipe.js#L98
Since: 3.60.0
direction
direction: number
Description:
The direction of the wipe effect. Either 0 or 1. Set in conjunction with the axis property.
Source: src/fx/Wipe.js#L89
Since: 3.60.0
gameObject
gameObject: Phaser.GameObjects.GameObject
Description:
A reference to the Game Object that owns this effect.
Inherits: Phaser.FX.Controller#gameObject
Source: src/fx/Controller.js#L38
Since: 3.60.0
progress
progress: number
Description:
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)
Source: src/fx/Wipe.js#L69
Since: 3.60.0
reveal
reveal: boolean
Description:
Is this a reveal (true) or a fade (false) effect?
Source: src/fx/Wipe.js#L107
Since: 3.60.0
type
type: number
Description:
The FX_CONST type of this effect.
Inherits: Phaser.FX.Controller#type
Source: src/fx/Controller.js#L29
Since: 3.60.0
wipeWidth
wipeWidth: number
Description:
The width of the wipe effect. This value is normalized in the range 0 to 1.
Source: src/fx/Wipe.js#L80
Since: 3.60.0
Public Methods
destroy
<instance> destroy()
Description:
Destroys this FX Controller.
Inherits: Phaser.FX.Controller#destroy
Source: src/fx/Controller.js#L81
Since: 3.60.0
setActive
<instance> setActive(value)
Description:
Sets the active state of this FX Controller.
A disabled FX Controller will not be updated.
Parameters:
name | type | optional | description |
---|---|---|---|
value | boolean | No |
|
Returns: Phaser.FX.Wipe - This FX Controller instance.
Inherits: Phaser.FX.Controller#setActive
Source: src/fx/Controller.js#L62
Since: 3.60.0