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 |
-mode(-m) |
int |
![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
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
|
|
-activeHandle(-ah) |
int |
![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
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)
|
|
-position(-p) |
|
![query query](../gfx/query.gif) |
|
Returns the current position of the manipulator |
|
-editPivotPosition(-epp) |
|
![query query](../gfx/query.gif) |
|
Returns the current position of the edit pivot
manipulator. |
|
-orientAxes(-oa) |
float float float |
![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
Orients manipulator rotating around axes by specified
angles |
|
-orientTowards(-ot) |
float float float |
![create create](../gfx/create.gif) ![edit edit](../gfx/edit.gif) |
|
Orients active handle towards world point |
|
-alignAlong(-aa) |
float float float |
![create create](../gfx/create.gif) ![edit edit](../gfx/edit.gif) |
|
Aligns active handle along vector. |
|
-interactiveUpdate(-iu) |
boolean |
![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
Value can be : true or false. This flag value is valid only if
the mode is 3 i.e. move vertex normal. |
|
-activeHandleNormal(-ahn) |
int |
![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
- 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. |
|
-snap(-s) |
boolean |
![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
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. |
|
-preserveChildPosition(-pcp) |
boolean |
![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
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 |
![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
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. |
|
-orientJointEnabled(-oje) |
boolean |
![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
Specifies if joints should be reoriented when moved. |
|
-orientJoint(-oj) |
string |
![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
Specifies the type of orientation for joint orientation. Valid
options are: none, xyz, xzy, yxz, yzx, zxy, zyx. |
|
-secondaryAxisOrient(-sao) |
string |
![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
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. |
|
-snapValue(-sv) |
float |
![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
Applicable only when the snap is enabled. The manipulator of
all move contexts would move in steps of 'snapValue' |
|
-snapRelative(-sr) |
boolean |
![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
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. |
|
-snapComponentsRelative(
-scr) |
boolean |
![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
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. |
|
-snapLivePoint(-slp) |
boolean |
![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
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. |
|
-snapLiveFaceCenter(-slf) |
boolean |
![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
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. |
|
-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. |
|
-preCommand(-prc) |
script |
![create create](../gfx/create.gif) |
|
Specifies a command to be executed when the tool is
entered. |
|
-postCommand(-psc) |
script |
![create create](../gfx/create.gif) |
|
Specifies a command to be executed when the tool is
exited. |
|
-preDragCommand(-prd) |
script string |
![create create](../gfx/create.gif) ![edit edit](../gfx/edit.gif) |
|
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. |
|
-postDragCommand(-pod) |
script string |
![create create](../gfx/create.gif) ![edit edit](../gfx/edit.gif) |
|
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. |
|
-editPivotMode(-epm) |
boolean |
![query query](../gfx/query.gif) |
|
Returns true manipulator is in edit pivot mode |
|