Go to: Synopsis. Return value. Related. Flags. Python examples.
rotate(
x y z [object 1] [object 2] ...
, [absolute=boolean], [centerPivot=boolean], [euler=boolean], [objectCenterPivot=boolean], [objectSpace=boolean], [pivot=[double, double, double]], [reflection=boolean], [reflectionAboutBBox=boolean], [reflectionAboutOrigin=boolean], [reflectionAboutX=boolean], [reflectionAboutY=boolean], [reflectionAboutZ=boolean], [reflectionTolerance=float], [relative=boolean], [rotateX=boolean], [rotateXY=boolean], [rotateXYZ=boolean], [rotateXZ=boolean], [rotateY=boolean], [rotateYZ=boolean], [rotateZ=boolean], [worldSpace=boolean])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
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.
None
In query mode, return type is based on queried flag.
move, scale, xform
absolute, centerPivot, euler, objectCenterPivot, objectSpace, pivot, reflection, reflectionAboutBBox, reflectionAboutOrigin, reflectionAboutX, reflectionAboutY, reflectionAboutZ, reflectionTolerance, relative, rotateX, rotateXY, rotateXYZ, rotateXZ, rotateY, rotateYZ, rotateZ, worldSpace
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 have multiple arguments, passed either as a tuple or a list.
|
import maya.cmds as cmds
# create a circle and grouped cone to rotate;
cmds.circle( n='circle1' )
cmds.cone( ax=(0, 1, 0), n='cone1' )
cmds.group( 'cone1', n='group1' )
# rotate the active objects 45 degrees about the world space X axis
# centered at each object's rotate pivot point.
cmds.select( 'cone1' )
cmds.rotate( '45deg', 0, 0, r=True )
# Set the rotation values for group1 to (90, 0, 0). This is
# equivalent to:
# cmds.setAttr('group1.rx',90)
# cmds.setAttr('group1.ry',0)
# cmds.setAttr('group1.rz',0)
cmds.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.
cmds.rotate( 0, '180deg', 0, 'circle1', pivot=(1, 0, 0) )