rotate

R2026b

Rotate actor

Since R2026b

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

actr — Actor

m-by-1 vector of Actor objects

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

rot — Actor rotation

m-by-1 vector | m-by-3 matrix | m-by-1 vector of quaternion objects

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