Go to: Synopsis. Return value. Related. Flags. MEL examples.

Synopsis

rotate [-absolute] [-centerPivot] [-euler] [-objectCenterPivot] [-objectSpace] [-pivot double double double] [-reflection] [-reflectionAboutBBox] [-reflectionAboutOrigin] [-reflectionAboutX] [-reflectionAboutY] [-reflectionAboutZ] [-reflectionTolerance float] [-relative] [-rotateX] [-rotateXY] [-rotateXYZ] [-rotateXZ] [-rotateY] [-rotateYZ] [-rotateZ] [-worldSpace] x y z [object 1] [object 2] ...

rotate is undoable, queryable, and editable.

The rotate command is used to change the rotation of geometric objects. The rotation values are specified as Euler angles (rx, ry, rz). The values are interpreted based on the current working unit for Angular measurements. Most often this is degrees.

The default behaviour, when no objects or flags are passed, is to do a absolute rotate on each currently selected object in the world space.

Return value

None

In query mode, return type is based on queried flag.

Related

move, scale, xform

Flags

absolute, centerPivot, euler, objectCenterPivot, objectSpace, pivot, reflection, reflectionAboutBBox, reflectionAboutOrigin, reflectionAboutX, reflectionAboutY, reflectionAboutZ, reflectionTolerance, relative, rotateX, rotateXY, rotateXYZ, rotateXZ, rotateY, rotateYZ, rotateZ, worldSpace
Long name (short name) argument types Properties
-absolute(-a) create
Perform an absolute operation.
-relative(-r) create
Perform a operation relative to the object's current position
-reflection(-rfl) create
To move the corresponding symmetric components also.
-reflectionAboutOrigin(-rao) create
Sets the position of the reflection axis at the origin
-reflectionAboutBBox(-rab) create
Sets the position of the reflection axis at the geometry bounding box
-reflectionAboutX(-rax) create
Specifies the X=0 as reflection plane
-reflectionAboutY(-ray) create
Specifies the Y=0 as reflection plane
-reflectionAboutZ(-raz) create
Specifies the Z=0 as reflection plane
-reflectionTolerance(-rft) float create
Specifies the tolerance to findout the corresponding reflected components
-centerPivot(-cp) create
Let the pivot be the center of the bounding box of all objects
-objectCenterPivot(-ocp) create
Let the pivot be the center of the bounding box of each object
-pivot(-p) double double double create
Define the pivot point for the transformation
-objectSpace(-os) create
Perform rotation about object-space axis.
-worldSpace(-ws) create
Perform rotation about global world-space axis.
-euler(-eu) create
Modifer for -relative flag that specifies rotation values should be added to current XYZ rotation values.
-rotateX(-x) create
Rotate in X direction
-rotateY(-y) create
Rotate in Y direction
-rotateZ(-z) create
Rotate in Z direction
-rotateXY(-xy) create
Rotate in X and Y direction
-rotateXZ(-xz) create
Rotate in X and Z direction
-rotateYZ(-yz) create
Rotate in Y and Z direction
-rotateXYZ(-xyz) create
Rotate in all directions (default)

Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can be used more than once in a command

MEL examples

// create a circle and grouped cone to rotate;
circle -n circle1;
cone -ax 0 1 0 -n cone1;
group -n group1 cone1;

// rotate the active objects 45 degrees about the world space X axis
// centered at each object's rotate pivot point.
select cone1;
rotate -r 45deg 0 0;

// Set the rotation values for group1 to (90, 0, 0). This is
// equivalent to 'setAttr group1.rx 90; setAttr group1.ry 0;
// setAttr group1.rz 0;'.
rotate 90deg 0 0 group1;

// rotate the circle 180 degrees about its local space Y axis
// centered at the rotate pivot point 1 0 0.
rotate -pivot 1 0 0 0 180deg 0 circle1;