Go to: Synopsis. Return value. Flags. MEL examples.

Synopsis

manipRotateContext [-activeHandle int] [-alignAlong float float float] [-bakePivotOri boolean] [-centerTrackball boolean] [-constrainAlongNormal boolean] [-currentActiveHandle int] [-editPivotMode boolean] [-editPivotPosition] [-exists] [-image1 string] [-image2 string] [-image3 string] [-lastMode int] [-manipVisible boolean] [-mode int] [-modifyTranslation boolean] [-orientAxes float float float] [-orientObject string] [-orientTowards float float float] [-pinPivot boolean] [-pivotOriHandle boolean] [-position] [-postCommand script] [-postDragCommand script string] [-preCommand script] [-preDragCommand script string] [-preserveChildPosition boolean] [-preserveUV boolean] [-reflection boolean] [-reflectionAbout int] [-reflectionAxis int] [-reflectionTolerance float] [-rotate float float float] [-snap boolean] [-snapPivotOri boolean] [-snapPivotPos boolean] [-snapRelative boolean] [-snapValue float] [-tweakMode boolean] [-useCenterPivot boolean] [-useManipPivot boolean] [-useObjectPivot boolean] [-xformConstraint string] [object]

manipRotateContext is undoable, queryable, and editable.

This command can be used to create, edit, or query a rotate manip context.

Return value

string(name of the new context)

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

Flags

activeHandle, alignAlong, bakePivotOri, centerTrackball, constrainAlongNormal, currentActiveHandle, editPivotMode, editPivotPosition, exists, image1, image2, image3, lastMode, manipVisible, mode, modifyTranslation, orientAxes, orientObject, orientTowards, pinPivot, pivotOriHandle, position, postCommand, postDragCommand, preCommand, preDragCommand, preserveChildPosition, preserveUV, reflection, reflectionAbout, reflectionAxis, reflectionTolerance, rotate, snap, snapPivotOri, snapPivotPos, snapRelative, snapValue, tweakMode, useCenterPivot, useManipPivot, useObjectPivot, xformConstraint
Long name (short name) Argument types Properties
-activeHandle(-ah) int queryedit
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 - View rotation handle (outer ring) is active (default)
-alignAlong(-aa) float float float createedit
Aligns active handle along vector.
-bakePivotOri(-bpo) boolean queryedit
Bake pivot orientation. Automatically bake pivot orientation changes into the transform hierarchy / geometry.
-centerTrackball(-ctb) boolean createqueryedit
Specify if the center is to be handled like a trackball
-constrainAlongNormal(-xn) boolean queryedit
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 queryedit
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 - View rotation handle (outer ring) is active
  • 4 - Arc Ball is active
-editPivotMode(-epm) boolean query
Returns true manipulator is in edit pivot mode
-editPivotPosition(-epp) query
Returns the current position of the edit pivot manipulator.
-exists(-ex) create
Returns true or false depending upon whether the specified object exists. Other flags are ignored.
-image1(-i1) string createqueryedit
First of three possible icons representing the tool associated with the context.
-image2(-i2) string createqueryedit
Second of three possible icons representing the tool associated with the context.
-image3(-i3) string createqueryedit
Third of three possible icons representing the tool associated with the context.
-lastMode(-lm) int query
Returns the previous rotation mode.
-manipVisible(-vis) boolean query
Returns true if the rotate manipulator is visible.
-mode(-m) int queryedit
Rotate mode:
  • 0 - Object Space (default)
  • 1 - World Space
  • 2 - Gimbal Mode
  • 3 - Custom Axis Orientation
  • 10 - Component Space
-modifyTranslation(-mt) boolean queryedit
When false, and an object is rotated about a point other than its rotate pivot, its rotateTranslate attribute is modified to put the object at the correct position. When true, its translate attribute is used instead. Default is false.
-orientAxes(-oa) float float float queryedit
Orients manipulator rotating around axes by specified angles
-orientObject(-oo) string createedit
Orients manipulator to the passed in object/component
-orientTowards(-ot) float float float createedit
Orients active handle towards world point
-pinPivot(-pin) boolean queryedit
Pin component pivot. When the component pivot is set and pinned selection changes will not reset the pivot position and orientation.
-pivotOriHandle(-poh) boolean queryedit
When true, the pivot manipulator will show the orientation handle during editing. Default is true.
-position(-p) query
Returns the current position of the manipulator.
-postCommand(-psc) script createedit
Specifies a command to be executed when the tool is exited.
-postDragCommand(-pod) script string createedit
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 createedit
Specifies a command to be executed when the tool is entered.
-preDragCommand(-prd) script string createedit
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 queryedit
When false, the children objects move when their parent is rotated. When true, the worldspace position of the children will be maintained as the parent is moved. Default is false.
-preserveUV(-puv) boolean queryedit
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.
-rotate(-ro) float float float queryedit
Returns the rotation of the manipulator for its current orientation/mode.
-snap(-s) boolean createqueryedit
Specify that the manipulation is to use absolute snap
-snapPivotOri(-spo) boolean queryedit
Snap pivot orientation. Modify pivot orientation when snapping the pivot to a component.
-snapPivotPos(-spp) boolean queryedit
Snap pivot position. Modify pivot position when snapping the pivot to a component.
-snapRelative(-sr) boolean createqueryedit
Specify that the manipulation is to use relative snap
-snapValue(-sv) float createqueryedit
Specify the snapping value
-tweakMode(-twk) boolean queryedit
When true, the manipulator is hidden and highlighted components can be selected and rotated in one step using a click-drag interaction.
-useCenterPivot(-ucp) boolean queryedit
When true, use the center of the selection's bounding box as the center of the rotation (for all objects).
-useManipPivot(-ump) boolean queryedit
When true, use the manipulator's center as the center of the rotation (for all objects).
-useObjectPivot(-uop) boolean queryedit
When true, use each object's pivot as the center of its rotation.
-xformConstraint(-xc) string queryedit
  • none - no transform constraint
  • edge - edge transform constraint
  • surface - surface transform constraint

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 be used more than once in a command.

MEL examples

// To create a new rotate context:
manipRotateContext;

// To query the mode of an existing context:
manipRotateContext -q -mode manipRotateContext1;

// To edit an existing context to come up with the X axis
// handle active by default:
manipRotateContext -e -ah 0 manipRotateContext1;