Phaser API Documentation

  Version: 
Filter

Phaser . FX . Wipe

Phaser . FX . Wipe

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 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?

Since: 3.60.0
Source: src/fx/Wipe.js (Line 11)

Extends


Members

active: boolean
Focus
Focus

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.

Type:
boolean
Inherited from: Phaser.FX.Controller#active
Since: 3.60.0
Source: src/fx/Controller.js (Line 47)
Focus
Focus
axis: number
Focus
Focus

Description:

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

Type:
number
Since: 3.60.0
Source: src/fx/Wipe.js (Line 98)
Focus
Focus
direction: number
Focus
Focus

Description:

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

Type:
number
Since: 3.60.0
Source: src/fx/Wipe.js (Line 89)
Focus
Focus

Description:

A reference to the Game Object that owns this effect.

Type:
Inherited from: Phaser.FX.Controller#gameObject
Since: 3.60.0
Source: src/fx/Controller.js (Line 38)
Focus
Focus
progress: number
Focus
Focus

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)

Type:
number
Since: 3.60.0
Source: src/fx/Wipe.js (Line 69)
Focus
Focus
reveal: boolean
Focus
Focus

Description:

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

Type:
boolean
Since: 3.60.0
Source: src/fx/Wipe.js (Line 107)
Focus
Focus
type: number
Focus
Focus

Description:

The FX_CONST type of this effect.

Type:
number
Inherited from: Phaser.FX.Controller#type
Since: 3.60.0
Source: src/fx/Controller.js (Line 29)
Focus
Focus
wipeWidth: number
Focus
Focus

Description:

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

Type:
number
Since: 3.60.0
Source: src/fx/Wipe.js (Line 80)
Focus
Focus

Methods

destroy()
Focus
Focus

Description:

Destroys this FX Controller.

Inherited from: Phaser.FX.Controller#destroy
Since: 3.60.0
Source: src/fx/Controller.js (Line 81)
Focus
Focus
setActive(value)
Focus
Focus

Description:

Sets the active state of this FX Controller.

A disabled FX Controller will not be updated.

Parameters:

name type description
value boolean

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

Returns:
Description:

This FX Controller instance.

Inherited from: Phaser.FX.Controller#setActive
Since: 3.60.0
Source: src/fx/Controller.js (Line 62)
Focus
Focus