Instance Method

# rotationAtTime:

Returns the orientation of the transform relative to its parent coordinate space, as of the specified time sample.

## Parameters

`time`

The time sample for which to request information.

## Return Value

The orientation, as a vector of Euler angles in radians, of the transform.

## Discussion

The three components of the rotation vector describe counterclockwise rotation around the corresponding axes. In a coordinate system where the negative z-axis direction is considered “forward”, these components are pitch (rotation about the x-axis), yaw (rotation about the y-axis), and roll (rotation about the z-axis).

Together with the translation, scale, and shear factors, rotation defines the local coordinate space for any object affected by the transform, relative to a parent coordinate space. To work with the complete transform, use the `localTransformAtTime:` and `setLocalTransform:forTime:` methods.

Requesting a sample outside the time range clamps results to the `minimumTime` or `maximumTime` sample. Some asset formats support continuous sampling, with interpolation for times between the samples stored in the asset; others are discrete. For an asset with discrete time information, requesting a sample time in between the samples stored in the asset returns data for the immediately preceding time.

### Using Factors of an Animated Transform

`- translationAtTime:`

Returns the x-, y-, and z-axis offsets of the transform relative to its parent coordinate space, as of the specified time sample.

`- setTranslation:forTime:`

Sets the x-, y-, and z-axis offsets of the transform for the specified time sample.

`- rotationMatrixAtTime:`

Returns the orientation of the transform as a rotation matrix, as of the specified time sample.

`- setRotation:forTime:`

Sets the orientation of the transform for the specified time sample.

`- scaleAtTime:`

Returns the x-, y-, and z-axis scale factors of the transform relative to its parent coordinate space, as of the specified time sample.

`- setScale:forTime:`

Sets the x-, y-, and z-axis scale factors of the transform for the specified time sample.

`- shearAtTime:`

Returns the x-, y-, and z-axis shear factors of the transform relative to its parent coordinate space, as of the specified time sample.

`- setShear:forTime:`

Sets the x-, y-, and z-axis shear factors of the transform for the specified time sample.