move

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

Synopsis

move( float float float [objects] , [absolute=boolean], [autoOrientSecondaryAxis=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 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

Related

Flags

Long name (short name)	Argument types	Properties
absolute(a)	boolean
Perform an absolute operation.
autoOrientSecondaryAxis(aos)	boolean
This flag is used in conjunction with the -sao/secondaryAxisOrient flag. If this flag is enabled the secondary axis will be oriented using the plane defined by neighboring joints and pointing in the same direction as the secondary axis. If no such plane exists the joint will be oriented using the secondary axis alone.
componentOffset(co)	boolean
Move components individually in local space
componentSpace(cs)	boolean
Move in local component space
constrainAlongNormal(xn)	boolean
When true, transform constraints are applied along the vertex normal first and only use the closest point when no intersection is found along the normal.
deletePriorHistory(dph)	boolean
If true then delete the history prior to the current operation.
localSpace(ls)	boolean
Move in local space
moveX(x)	boolean
Move in X direction
moveXY(xy)	boolean
Move in XY direction
moveXYZ(xyz)	boolean
Move in all directions (default)
moveXZ(xz)	boolean
Move in XZ direction
moveY(y)	boolean
Move in Y direction
moveYZ(yz)	boolean
Move in YZ direction
moveZ(z)	boolean
Move in Z direction
objectSpace(os)	boolean
Move in object space
orientJoint(oj)	string
Default is xyz.
parameter(p)	boolean
Move in parametric space
preserveChildPosition(pcp)	boolean
When true, transforming an object will apply an opposite transform to its child transform to keep them at the same world-space position. Default is false.
preserveGeometryPosition(pgp)	boolean
When true, transforming an object will apply an opposite transform to its geometry points to keep them at the same world-space position. Default is false.
preserveUV(puv)	boolean
When true, UV values on translated components are projected along the translation in 3d space. For small edits, this will freeze the world space texture mapping on the object. When false, the UV values will not change for a selected vertices. Default is false.
reflection(rfl)	boolean
To move the corresponding symmetric components also.
reflectionAboutBBox(rab)	boolean
Sets the position of the reflection axis at the geometry bounding box
reflectionAboutOrigin(rao)	boolean
Sets the position of the reflection axis at the origin
reflectionAboutX(rax)	boolean
Specifies the X=0 as reflection plane
reflectionAboutY(ray)	boolean
Specifies the Y=0 as reflection plane
reflectionAboutZ(raz)	boolean
Specifies the Z=0 as reflection plane
reflectionTolerance(rft)	float
Specifies the tolerance to findout the corresponding reflected components
relative(r)	boolean
Perform a operation relative to the object's current position
rotatePivotRelative(rpr)	boolean
Move relative to the object's rotate pivot point.
scalePivotRelative(spr)	boolean
Move relative to the object's scale pivot point.
secondaryAxisOrient(sao)	string
Default is xyz.
symNegative(smn)	boolean
When set the component transformation is flipped so it is relative to the negative side of the symmetry plane. The default (no flag) is to transform components relative to the positive side of the symmetry plane.
worldSpace(ws)	boolean
Move in world space
worldSpaceDistance(wd)	boolean
Move is specified in world space units
xformConstraint(xc)	string
Apply a transform constraint to moving components. none - no constraint surface - constrain components to the surface edge - constrain components to surface edges live - constraint components to the live surface

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 )