manipMoveContext is undoable, queryable, and editable.
This command can be used to create, edit, or query a move
manip context.
Note that the flags -s, -sv, -sr, -scr, -slp, -slf control
the global behaviour of all move manip context. Changing one
context independently is not allowed. Changing a context's
behaviour using the above flags, will change all existing move
manip context.
In query mode, return type is based on queried flag.
Long name (short name) |
Argument types |
Properties |
|
-activeHandle(-ah)
|
int
|

|
|
Sets the default active handle for the manip. That is, the handle
which should be initially active when the tool is activated.
Values can be:
- 0 - X axis handle is active
- 1 - Y axis handle is active
- 2 - Z axis handle is active
- 3 - Center handle (all 3 axes) is active (default)
|
|
-activeHandleNormal(-ahn)
|
int
|

|
|
- 0 - U axis handle is active
- 1 - V axis handle is active
- 2 - N axis handle is active ( default )
- 3 - Center handle (all 3 axes) is active
applicable only when the manip mode is 3.
|
|
-alignAlong(-aa)
|
float float float
|

|
|
Aligns active handle along vector.
|
|
-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.
|
|
-currentActiveHandle(-cah)
|
int
|

|
|
Sets the active handle for the manip.
Values can be:
- 0 - X axis handle is active
- 1 - Y axis handle is active
- 2 - Z axis handle is active
- 3 - Center handle (all 3 axes) is active
- 4 - XY plane handle is active
- 5 - YZ plane handle is active
- 6 - XZ plane handle is active
|
|
-editPivotMode(-epm)
|
boolean
|
|
|
Returns true manipulator is in edit pivot mode
|
|
-editPivotPosition(-epp)
|
|
|
|
Returns the current position of the edit pivot manipulator.
|
|
-exists(-ex)
|
|
|
|
Returns true or false depending upon whether the
specified object exists. Other flags are ignored.
|
|
-image1(-i1)
|
string
|
 
|
|
First of three possible icons representing the tool
associated with the context.
|
|
-image2(-i2)
|
string
|
 
|
|
Second of three possible icons representing the tool
associated with the context.
|
|
-image3(-i3)
|
string
|
 
|
|
Third of three possible icons representing the tool
associated with the context.
|
|
-interactiveUpdate(-iu)
|
boolean
|

|
|
Value can be : true or false.
This flag value is valid only if the mode is 3 i.e. move vertex normal.
|
|
-lastMode(-lm)
|
int
|
|
|
Returns the previous translation mode.
|
|
-manipVisible(-vis)
|
boolean
|
|
|
Returns true if the main translate manipulator is visible.
|
|
-mode(-m)
|
int
|

|
|
Translate mode:
- 0 - Object Space
- 1 - Local Space
- 2 - World Space (default)
- 3 - Move Along Vertex Normal
- 4 - Move Along Rotation Axis
- 5 - Move Along Live Object Axis
- 6 - Custom Axis Orientation
- 9 - Component Space
|
|
-orientAxes(-oa)
|
float float float
|

|
|
Orients manipulator rotating around axes by specified angles
|
|
-orientJoint(-oj)
|
string
|

|
|
Specifies the type of orientation for joint orientation. Valid options are:
none, xyz, xzy, yxz, yzx, zxy, zyx.
|
|
-orientJointEnabled(-oje)
|
boolean
|

|
|
Specifies if joints should be reoriented when moved.
|
|
-orientObject(-oo)
|
string
|

|
|
Orients manipulator to the passed in object/component
|
|
-orientTowards(-ot)
|
float float float
|

|
|
Orients active handle towards world point
|
|
-pinPivot(-pin)
|
boolean
|

|
|
Pin component pivot. When the component pivot is set and pinned selection
changes will not reset the pivot position and orientation.
|
|
-pivotOriHandle(-poh)
|
boolean
|

|
|
When true, the pivot manipulator will show the orientation handle during editing.
Default is true.
|
|
-position(-p)
|
|
|
|
Returns the current position of the manipulator
|
|
-postCommand(-psc)
|
script
|

|
|
Specifies a command to be executed when the tool is exited.
|
|
-postDragCommand(-pod)
|
script string
|

|
|
Specifies a command and a node type. The command will be executed at
the end of a drag when a node of the specified type is in the selection.
|
|
-preCommand(-prc)
|
script
|

|
|
Specifies a command to be executed when the tool is entered.
|
|
-preDragCommand(-prd)
|
script string
|

|
|
Specifies a command and a node type. The command will be executed at
the start of a drag when a node of the specified type is in the selection.
|
|
-preserveChildPosition(-pcp)
|
boolean
|

|
|
When false, the children objects move when their parent is moved.
When true, the worldspace position of the children will be maintained as
the parent is moved. Default is false.
|
|
-preserveUV(-puv)
|
boolean
|

|
|
When false, the uvs are not changes to match the vertex edit.
When true, the uvs are edited to project to new values to stop texture
swimming as vertices are moved.
|
|
-reflection(-rfl)
|
boolean
|
|
|
This flag is obsolete. Reflection is now managed as part of selection itself
using the symmetricModeling command.
|
|
-reflectionAbout(-rab)
|
int
|
|
|
This flag is obsolete. Reflection is now managed as part of selection itself
using the symmetricModeling command.
|
|
-reflectionAxis(-rfa)
|
int
|
|
|
This flag is obsolete. Reflection is now managed as part of selection itself
using the symmetricModeling command.
|
|
-reflectionTolerance(-rft)
|
float
|
|
|
This flag is obsolete. Reflection is now managed as part of selection itself
using the symmetricModeling command.
|
|
-secondaryAxisOrient(-sao)
|
string
|

|
|
Specifies the global axis (in world coordinates) that should be used
to should be used to align the second axis of the orientJointType triple.
Valid options are xup, yup, zup, xdown, ydown, zdown, none.
|
|
-snap(-s)
|
boolean
|

|
|
Value can be : true or false.
Enable/Disable the discrete move.
If set to true, the move manipulator of all the
move contexts would snap at discrete points
along the active handle during mouse drag. The
interval between the points can be controlled
using the 'snapValue' flag.
|
|
-snapComponentsRelative(-scr)
|
boolean
|

|
|
Value can be : true or false.
If true, while snapping a group of CVs/Vertices, the
relative spacing between them will be preserved.
If false, all the CVs/Vertices will be snapped to the
target point
(is used during grid snap(hotkey 'x'), and
point snap(hotkey 'v'))
Depress the 'x' key before click-dragging the manip handle
and check to see the behaviour of moving a bunch of CVs,
with this flag ON and OFF.
|
|
-snapLiveFaceCenter(-slf)
|
boolean
|

|
|
Value can be : true or false.
If true, while moving on the live polygon object, the
move manipulator will snap to the face centers of the object.
|
|
-snapLivePoint(-slp)
|
boolean
|

|
|
Value can be : true or false.
If true, while moving on the live polygon object, the
move manipulator will snap to the vertices of the object.
|
|
-snapPivotOri(-spo)
|
boolean
|

|
|
Snap pivot orientation. Modify pivot orientation when snapping the pivot to a component.
|
|
-snapPivotPos(-spp)
|
boolean
|

|
|
Snap pivot position. Modify pivot position when snapping the pivot to a component.
|
|
-snapRelative(-sr)
|
boolean
|

|
|
Value can be : true or false.
Applicable only when the snap is enabled.
If true, the snapValue is treated relative to the
original position before moving.
If false, the snapValue is treated relative to the
world origin.
NOTE: If in local/object Space Mode,
the snapRelative should be ON.
Absolute discrete move is not supported
in local/object mode.
|
|
-snapValue(-sv)
|
float
|

|
|
Applicable only when the snap is enabled.
The manipulator of all move contexts would move in
steps of 'snapValue'
|
|
-translate(-tr)
|
float float float
|

|
|
Returns the translation of the manipulator for its current orientation/mode.
|
|
-tweakMode(-twk)
|
boolean
|

|
|
When true, the manipulator is hidden and highlighted components can be selected
and moved in one step using a click-drag interaction.
|
|
-xformConstraint(-xc)
|
string
|

|
|
- none - no transform constraint
- edge - edge transform constraint
- surface - surface transform constraint
|
|