The Vignette FX Controller.
This FX controller manages the vignette effect for a Game Object.
The vignette effect is a visual technique where the edges of the screen, or a Game Object, gradually darken or blur, creating a frame-like appearance. This effect is used to draw the player's focus towards the central action or subject, enhance immersion, and provide a cinematic or artistic quality to the game's visuals.
A Vignette effect is added to a Game Object via the FX component:
const sprite = this.add.sprite();
sprite.preFX.addVignette();
sprite.postFX.addVignette();
Constructor
new Vignette(gameObject, [x], [y], [radius], [strength])
Parameters
name | type | optional | default | description |
---|---|---|---|---|
gameObject | No | A reference to the Game Object that has this fx. | ||
x | number | Yes | 0.5 | The horizontal offset of the vignette effect. This value is normalized to the range 0 to 1. |
y | number | Yes | 0.5 | The vertical offset of the vignette effect. This value is normalized to the range 0 to 1. |
radius | number | Yes | 0.5 | The radius of the vignette effect. This value is normalized to the range 0 to 1. |
strength | number | Yes | 0.5 | The strength of the vignette effect. |
Scope: static
Extends
Source: src/fx/Vignette.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
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
radius
radius: number
Description:
The radius of the vignette effect. This value is normalized to the range 0 to 1.
Source: src/fx/Vignette.js#L75
Since: 3.60.0
strength
strength: number
Description:
The strength of the vignette effect.
Source: src/fx/Vignette.js#L84
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
x
x: number
Description:
The horizontal offset of the vignette effect. This value is normalized to the range 0 to 1.
Source: src/fx/Vignette.js#L57
Since: 3.60.0
y
y: number
Description:
The vertical offset of the vignette effect. This value is normalized to the range 0 to 1.
Source: src/fx/Vignette.js#L66
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.Vignette - This FX Controller instance.
Inherits: Phaser.FX.Controller#setActive
Source: src/fx/Controller.js#L62
Since: 3.60.0