rotate

R2026b

Rotate actor

Since R2026b

collapse all in page

    Syntax

    rotate(actr,rot)

    Description

    Add-On Required: This feature requires the 3D Scenarios add-on.

    rotate(actr,rot) rotates the centroid of the specified actor. Specify the rotation with respect to the initial body frame of the actor.

    To rotate an actor, the Behavior property of the actor must be empty and the SimulationStatus property of the associated Scenario object must be "notstarted".

    Input Arguments

    collapse all

    Actor, specified as an m-by-1 vector of Actor objects, where m is the number of actors.

    Actor rotation, specified as one of these options.

    • An m-by-1 vector of type double. Each value specifies a yaw angle in degrees.

    • An m-by-3 matrix of type double. Each row of the matrix is of the form [yaw pitch roll], where yaw specifies a yaw angle, pitch specifies a pitch angle in the range (–90, 90), and roll specifies a roll angle in the range (–180, 180). Specify the angles in degrees.

    • m-by-1 vector of quaternion objects. This option requires a product that includes the quaternion object.

    If m is 1, then the rotation applies to all the actors. Otherwise, m must match the number of actors.

    Version History

    Introduced in R2026b

    See Also

    Functions

    Objects

    Topics