Filter
BaseTweenData is the class that the TweenData and TweenFrameData classes extend from. You should not typically instantiate this class directly, but instead use it to form your own tween data classes from, should you require it.
Prior to Phaser 3.60 the TweenData was just an object, but was refactored to a class, to make it responsible for its own state and updating.
Constructor:
new BaseTweenData(tween, targetIndex, key, getEnd, getStart, getActive, ease, delay, duration, yoyo, hold, repeat, repeatDelay, flipX, flipY, interpolation, interpolationData)
Parameters:
| name | type | description |
|---|---|---|
| tween | Phaser.Tweens.Tween |
The tween this TweenData instance belongs to. |
| targetIndex | number |
The target index within the Tween targets array. |
| key | string |
The property of the target to tween. |
| getEnd | Phaser.Types.Tweens.GetEndCallback |
What the property will be at the END of the Tween. |
| getStart | Phaser.Types.Tweens.GetStartCallback |
What the property will be at the START of the Tween. |
| getActive | Phaser.Types.Tweens.GetActiveCallback |
If not null, is invoked immediately as soon as the TweenData is running, and is set on the target property. |
| ease | function |
The ease function this tween uses. |
| delay | function |
Function that returns the time in milliseconds before tween will start. |
| duration | number |
The duration of the tween in milliseconds. |
| yoyo | boolean |
Determines whether the tween should return back to its start value after hold has expired. |
| hold | number |
Function that returns the time in milliseconds the tween will pause before repeating or returning to its starting value if yoyo is set to true. |
| repeat | number |
Function that returns the number of times to repeat the tween. The tween will always run once regardless, so a repeat value of '1' will play the tween twice. |
| repeatDelay | number |
Function that returns the time in milliseconds before the repeat will start. |
| flipX | boolean |
Should toggleFlipX be called when yoyo or repeat happens? |
| flipY | boolean |
Should toggleFlipY be called when yoyo or repeat happens? |
| interpolation | function |
The interpolation function to be used for arrays of data. Defaults to 'null'. |
| interpolationData | Array.<number> |
The array of interpolation data to be set. Defaults to 'null'. |
Members
Description:
The time, in milliseconds, before this tween will start playing.
This value is generated by the getDelay function.
Type:
Description:
The duration of the tween in milliseconds, excluding any time required for yoyo or repeats.
Type:
Description:
The amount of time, in milliseconds, that has elapsed since this TweenData was made active.
Type:
Description:
If true this Tween will call toggleFlipX on the Tween target
whenever it yoyo's or repeats. It will only be called if the target
has a function matching this name, like most Phaser GameObjects do.
Type:
Description:
If true this Tween will call toggleFlipY on the Tween target
whenever it yoyo's or repeats. It will only be called if the target
has a function matching this name, like most Phaser GameObjects do.
Type:
Description:
This function returns the value to be used for TweenData.delay.
Type:
Description:
The time, in milliseconds, before this tween will start a yoyo to repeat.
Type:
Description:
Is this Tween Data currently waiting for a countdown to elapse, or not?
Type:
Description:
A value between 0 and 1 holding the progress of this TweenData.
Type:
Description:
The number of times this tween will repeat.
The tween will always run once regardless of this value, so a repeat value of '1' will play the tween twice: I.e. the original play-through and then it repeats that once (1).
If this value is set to -1 this tween will repeat forever.
Type:
Description:
How many repeats are left to run?
Type:
Description:
The time, in milliseconds, before the repeat will start.
Type:
Description:
The index of the target within the Tween targets array.
Type:
Description:
The total calculated duration, in milliseconds, of this TweenData. Factoring in the duration, repeats, delays and yoyos.
Type:
Description:
A reference to the Tween that this TweenData instance belongs to.
Type:
Description:
Will the Tween ease back to its starting values, after reaching the end
and any hold value that may be set?
Type:
Methods
Description:
Immediately destroys this TweenData, nulling of all its references.
Description:
Returns a reference to the target object belonging to this TweenData.
Returns:
Description:
The target object. Can be any JavaScript object, but is typically a Game Object.
Type:
- object
Description:
Returns true if this TweenData has a current state of COMPLETE, otherwise false.
Returns:
Description:
true if this TweenData has a current state of COMPLETE, otherwise false.
Type:
- boolean
Description:
Returns true if this TweenData has a current state of CREATED, otherwise false.
Returns:
Description:
true if this TweenData has a current state of CREATED, otherwise false.
Type:
- boolean
Description:
Returns true if this TweenData has a current state of DELAY, otherwise false.
Returns:
Description:
true if this TweenData has a current state of DELAY, otherwise false.
Type:
- boolean
Description:
Returns true if this TweenData has a current state of HOLD_DELAY, otherwise false.
Returns:
Description:
true if this TweenData has a current state of HOLD_DELAY, otherwise false.
Type:
- boolean
Description:
Returns true if this TweenData has a current state of PENDING_RENDER, otherwise false.
Returns:
Description:
true if this TweenData has a current state of PENDING_RENDER, otherwise false.
Type:
- boolean
Description:
Returns true if this TweenData has a current state of PLAYING_BACKWARD, otherwise false.
Returns:
Description:
true if this TweenData has a current state of PLAYING_BACKWARD, otherwise false.
Type:
- boolean
Description:
Returns true if this TweenData has a current state of PLAYING_FORWARD, otherwise false.
Returns:
Description:
true if this TweenData has a current state of PLAYING_FORWARD, otherwise false.
Type:
- boolean
Description:
Returns true if this TweenData has a current state of REPEAT_DELAY, otherwise false.
Returns:
Description:
true if this TweenData has a current state of REPEAT_DELAY, otherwise false.
Type:
- boolean
Description:
Internal method that handles repeating or yoyo'ing this TweenData.
Called automatically by setStateFromStart and setStateFromEnd.
Parameters:
| name | type | description |
|---|---|---|
| diff | number |
Any extra time that needs to be accounted for in the elapsed and progress values. |
| setStart | boolean |
Set the TweenData start values? |
| isYoyo | boolean |
Is this call a Yoyo check? |
Description:
Internal method that resets this Tween Data entirely, including the progress and elapsed values.
Called automatically by the parent Tween. Should not be called directly.
Description:
Sets this TweenData state to COMPLETE.
Description:
Sets this TweenData state to CREATED.
Description:
Sets this TweenData state to DELAY.
Description:
Sets this TweenData state to HOLD_DELAY.
Description:
Sets this TweenData state to PENDING_RENDER.
Description:
Sets this TweenData state to PLAYING_BACKWARD.
Description:
Sets this TweenData state to PLAYING_FORWARD.
Description:
Sets this TweenData state to REPEAT_DELAY.
Description:
Internal method used as part of the playback process that checks if this TweenData should yoyo, repeat, or has completed.
Parameters:
| name | type | description |
|---|---|---|
| diff | number |
Any extra time that needs to be accounted for in the elapsed and progress values. |
Description:
Internal method used as part of the playback process that checks if this TweenData should repeat or has completed.
Parameters:
| name | type | description |
|---|---|---|
| diff | number |
Any extra time that needs to be accounted for in the elapsed and progress values. |
Description:
Sets this TweenData's target object property to be the given value.
Parameters:
| name | type | arguments | description |
|---|---|---|---|
| value | number | <optional> |
The value to set on the target. If not given, sets it to the last |