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

Synopsis

move( x y z [object 1] [object 2] ... , [absolute=boolean], [localSpace=boolean], [moveX=boolean], [moveXY=boolean], [moveXYZ=boolean], [moveXZ=boolean], [moveY=boolean], [moveYZ=boolean], [moveZ=boolean], [objectSpace=boolean], [parameter=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, queryable, and 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.

Return value

None

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

Related

rotate, scale, xform

Flags

absolute, localSpace, moveX, moveXY, moveXYZ, moveXZ, moveY, moveYZ, moveZ, objectSpace, parameter, reflection, reflectionAboutBBox, reflectionAboutOrigin, reflectionAboutX, reflectionAboutY, reflectionAboutZ, reflectionTolerance, relative, rotatePivotRelative, scalePivotRelative, worldSpace, worldSpaceDistance
Long name (short name) argument types Properties
absolute(a) boolean create
Perform an absolute operation.
relative(r) boolean create
Perform a operation relative to the object's current position
reflection(rfl) boolean create
To move the corresponding symmetric components also.
reflectionAboutOrigin(rao) boolean create
Sets the position of the reflection axis at the origin
reflectionAboutBBox(rab) boolean create
Sets the position of the reflection axis at the geometry bounding box
reflectionAboutX(rax) boolean create
Specifies the X=0 as reflection plane
reflectionAboutY(ray) boolean create
Specifies the Y=0 as reflection plane
reflectionAboutZ(raz) boolean create
Specifies the Z=0 as reflection plane
reflectionTolerance(rft) float create
Specifies the tolerance to findout the corresponding reflected components
worldSpace(ws) boolean create
Move in world space
objectSpace(os) boolean create
Move in object space
localSpace(ls) boolean create
Move in local space
parameter(p) boolean create
Move in parametric space
worldSpaceDistance(wd) boolean create
Move is specified in world space units
moveX(x) boolean create
Move in X direction
moveY(y) boolean create
Move in Y direction
moveZ(z) boolean create
Move in Z direction
moveXY(xy) boolean create
Move in XY direction
moveXZ(xz) boolean create
Move in XZ direction
moveYZ(yz) boolean create
Move in YZ direction
moveXYZ(xyz) boolean create
Move in all directions (default)
rotatePivotRelative(rpr) boolean create
Move relative to the object's rotate pivot point.
scalePivotRelative(spr) boolean create
Move relative to the object's scale pivot point.

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.

Python examples

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 )