RotateTo
A Camera Rotate effect.
This effect will rotate the Camera so that the its viewport finishes at the given angle in radians,
over the duration and with the ease specified.
Camera rotation always takes place based on the Camera viewport. By default, rotation happens
in the center of the viewport. You can adjust this with the originX and originY properties.
Rotation influences the rendering of all Game Objects visible by this Camera. However, it does not
rotate the Camera viewport itself, which always remains an axis-aligned rectangle.
Only the camera is rotates. None of the objects it is displaying are impacted, i.e. their positions do
not change.
The effect will dispatch several events on the Camera itself and you can also specify an onUpdate callback,
which is invoked each frame for the duration of the effect if required.
Constructor
new RotateTo(camera)
Parameters
| name | type | optional | description |
|---|---|---|---|
| camera | Phaser.Cameras.Scene2D.Camera | No | The camera this effect is acting upon. |
Scope: static
Source: src/cameras/2d/effects/RotateTo.js#L13
Since: 3.23.0
Public Members
camera
camera: Phaser.Cameras.Scene2D.Camera
Description:
The Camera this effect belongs to.
Source: src/cameras/2d/effects/RotateTo.js#L45
Since: 3.23.0
clockwise
clockwise: boolean
Description:
The direction of the rotation. Clockwise is positive.
Source: src/cameras/2d/effects/RotateTo.js#L153
Since: 3.23.0
current
current: number
Description:
The current camera angle during the rotation, in radians.
Source: src/cameras/2d/effects/RotateTo.js#L86
Since: 3.23.0
destination
destination: number
Description:
The destination angle to rotate the camera to, in radians.
Source: src/cameras/2d/effects/RotateTo.js#L95
Since: 3.23.0
duration
duration: number
Description:
The duration of the effect, in milliseconds.
Source: src/cameras/2d/effects/RotateTo.js#L66
Since: 3.23.0
ease
ease: function
Description:
The ease function to use during the rotation.
Source: src/cameras/2d/effects/RotateTo.js#L104
Since: 3.23.0
isRunning
isRunning: boolean
Description:
Is this effect actively running?
Source: src/cameras/2d/effects/RotateTo.js#L55
Since: 3.23.0
progress
progress: number
Description:
If this effect is running this holds the current progress, a value between 0 (start) and 1 (end).
Source: src/cameras/2d/effects/RotateTo.js#L113
Since: 3.23.0
shortestPath
shortestPath: boolean
Description:
The shortest direction to the target rotation.
Source: src/cameras/2d/effects/RotateTo.js#L162
Since: 3.23.0
source
source: number
Description:
The starting angle to rotate the camera from, in radians.
Source: src/cameras/2d/effects/RotateTo.js#L77
Since: 3.23.0
Public Methods
destroy
<instance> destroy()
Description:
Destroys this effect, releasing it from the Camera.
Source: src/cameras/2d/effects/RotateTo.js#L336
Since: 3.23.0
effectComplete
<instance> effectComplete()
Description:
Called internally when the effect completes.
Source: src/cameras/2d/effects/RotateTo.js#L305
Since: 3.23.0
reset
<instance> reset()
Description:
Resets this camera effect.
If it was previously running, it stops instantly without calling its onComplete callback or emitting an event.
Source: src/cameras/2d/effects/RotateTo.js#L321
Since: 3.23.0
start
<instance> start(angle, [shortestPath], [duration], [ease], [force], [callback], [context])
Description:
Rotate the Camera to the given angle over the duration and with the ease specified.
Parameters:
| name | type | optional | default | description |
|---|---|---|---|---|
| angle | number | No | The destination angle in radians to rotate the Camera view to. | |
| shortestPath | boolean | Yes | false | If true, take the shortest distance to the destination. This adjusts the destination angle to be within one half turn of the start angle. |
| duration | number | Yes | 1000 | The duration of the effect in milliseconds. |
| ease | string | function | Yes | "'Linear'" | The ease to use. Can be any of the Phaser Easing constants or a custom function. |
| force | boolean | Yes | false | Force the rotation effect to start immediately, even if already running. |
| callback | Phaser.Types.Cameras.Scene2D.CameraRotateCallback | Yes | This callback will be invoked every frame for the duration of the effect. It is sent three arguments: A reference to the camera, a progress amount between 0 and 1 indicating how complete the effect is, and the current camera rotation. | |
| context | any | Yes | The context in which the callback is invoked. Defaults to the Scene to which the Camera belongs. |
Returns: Phaser.Cameras.Scene2D.Camera - The Camera on which the effect was started.
Fires: Phaser.Cameras.Scene2D.Events#event:ROTATE_START, Phaser.Cameras.Scene2D.Events#event:ROTATE_COMPLETE
Source: src/cameras/2d/effects/RotateTo.js#L172
Since: 3.23.0
update
<instance> update(time, delta)
Description:
The main update loop for this effect. Called automatically by the Camera.
Parameters:
| name | type | optional | description |
|---|---|---|---|
| time | number | No | The current timestamp as generated by the Request Animation Frame or SetTimeout. |
| delta | number | No | The delta time, in ms, elapsed since the last frame. |
Source: src/cameras/2d/effects/RotateTo.js#L252
Since: 3.23.0