Go to: Synopsis. Return value. Related.
Flags. Python
examples.
move( float float float [objects] ,
[absolute=boolean], [localSpace=boolean], [moveX=boolean], [moveXY=boolean], [moveXYZ=boolean], [moveXZ=boolean], [moveY=boolean], [moveYZ=boolean], [moveZ=boolean], [objectSpace=boolean], [parameter=boolean], [preserveUV=boolean], [reflection=boolean], [reflectionAboutBBox=boolean],
[reflectionAboutOrigin=boolean],
[reflectionAboutX=boolean],
[reflectionAboutY=boolean],
[reflectionAboutZ=boolean],
[reflectionTolerance=float],
[relative=boolean], [rotatePivotRelative=boolean],
[scalePivotRelative=boolean],
[worldSpace=boolean],
[worldSpaceDistance=boolean])
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
absolute, localSpace, moveX,
moveXY, moveXYZ, moveXZ,
moveY, moveYZ,
moveZ, objectSpace, parameter, preserveUV, reflection, reflectionAboutBBox, reflectionAboutOrigin, reflectionAboutX, reflectionAboutY, reflectionAboutZ, reflectionTolerance, relative, rotatePivotRelative, scalePivotRelative, worldSpace, worldSpaceDistance
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 )