Type Method

rotateByX:y:z:duration:

Creates an action that rotates the node in each of the three principal axes by angles relative to its current orientation.

Declaration

+ (SCNAction *)rotateByX:(CGFloat)xAngle y:(CGFloat)yAngle z:(CGFloat)zAngle duration:(NSTimeInterval)duration;

Parameters

xAngle

The amount to rotate the node counterclockwise around the x-axis of its local coordinate space, in radians.

yAngle

The amount to rotate the node counterclockwise around the y-axis of its local coordinate space, in radians.

zAngle

The amount to rotate the node counterclockwise around the z-axis of its local coordinate space, in radians.

duration

The duration, in seconds, of the animation.

Return Value

A new action object.

Discussion

When the action executes, the node’s rotation property animates to the new angle.

This action is reversible; the reverse is created as if the following code had been executed:

[SCNAction rotateByX: -xAngle y: -yAngle z: -zAngle duration: duration];

See Also

Creating Actions That Rotate a Node

+ rotateToX:y:z:duration:

Creates an action that rotates the node to absolute angles in each of the three principal axes.

+ rotateToX:y:z:duration:shortestUnitArc:

Creates an action that rotates the node to absolute angles in each of the three principal axes.

+ rotateByAngle:aroundAxis:duration:

Creates an action that rotates the node by an angle around a specified axis.

+ rotateToAxisAngle:duration:

Creates an action that rotates the node to an absolute angle around a specified axis.