Go to: Synopsis. Return value. Related. Flags. Python examples.
move(
float float float [objects]
, [absolute=boolean], [componentOffset=boolean], [componentSpace=boolean], [constrainAlongNormal=boolean], [deletePriorHistory=boolean], [localSpace=boolean], [moveX=boolean], [moveXY=boolean], [moveXYZ=boolean], [moveXZ=boolean], [moveY=boolean], [moveYZ=boolean], [moveZ=boolean], [objectSpace=boolean], [orientJoint=string], [parameter=boolean], [preserveChildPosition=boolean], [preserveGeometryPosition=boolean], [preserveUV=boolean], [reflection=boolean], [reflectionAboutBBox=boolean], [reflectionAboutOrigin=boolean], [reflectionAboutX=boolean], [reflectionAboutY=boolean], [reflectionAboutZ=boolean], [reflectionTolerance=float], [relative=boolean], [rotatePivotRelative=boolean], [scalePivotRelative=boolean], [secondaryAxisOrient=string], [symNegative=boolean], [worldSpace=boolean], [worldSpaceDistance=boolean], [xformConstraint=string])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
move is undoable, NOT queryable, and NOT editable.
The move command is used to change the positions of geometric
objects.
The default behaviour, when no objects or flags are passed, is
to do a absolute move on each currently selected object in the
world space. The value of the coordinates are interpreted as
being defined in the current linear unit unless the unit is
explicitly mentioned.
When using -objectSpace there are two ways to use this command.
If numbers are typed without units then the internal values of
the object are set to these values. If, on the other hand a
unit is specified then the internal value is set to the equivalent
internal value that represents that world-space distance.
The -localSpace flag moves the object in its parent space. In this
space the x,y,z values correspond directly to the tx, ty, tz
channels on the object.
The -rotatePivotRelative/-scalePivotRelative flags can be used
with the -absolute flag to translate an object so that its
pivot point ends up at the given absolute position. These
flags will be ignored if components are specified.
The -worldSpaceDistance flag is a modifier flag that may be used
in conjunction with the -objectSpace/-localSpace flags. When this
flag is specified the command treats the x,y,z values as world
space units so the object will move the specified world space
distance but it will move along the axis specified by the
-objectSpace/-localSpace flag. The default behaviour, without
this flag, is to treat the x,y,z values as units in object
space or local space. In other words, the worldspace distance
moved will depend on the transformations applied to the object
unless this flag is specified.
None
rotate, scale, xform, xformConstraint
absolute, componentOffset, componentSpace, constrainAlongNormal, deletePriorHistory, localSpace, moveX, moveXY, moveXYZ, moveXZ, moveY, moveYZ, moveZ, objectSpace, orientJoint, parameter, preserveChildPosition, preserveGeometryPosition, preserveUV, reflection, reflectionAboutBBox, reflectionAboutOrigin, reflectionAboutX, reflectionAboutY, reflectionAboutZ, reflectionTolerance, relative, rotatePivotRelative, scalePivotRelative, secondaryAxisOrient, symNegative, worldSpace, worldSpaceDistance, xformConstraint
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
cmds.polySphere()
cmds.move( 1, 1, 1 )
cmds.move( 5, y=True )
cmds.move( '1in', '1in', '1in', relative=True, objectSpace=True, worldSpaceDistance=True )
cmds.move( 0, 0, 0, 'pSphere1', absolute=True )