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

Synopsis

manipScaleContext [-activeHandle int] [-alignAlong float float float] [-currentActiveHandle int] [-editPivotMode boolean] [-editPivotPosition] [-mode int] [-orientAxes float float float] [-orientTowards float float float] [-pinPivot boolean] [-position] [-postCommand script] [-postDragCommand script string] [-preCommand script] [-preDragCommand script string] [-preserveChildPosition boolean] [-preserveUV boolean] [-preventNegativeScale boolean] [-reflection boolean] [-reflectionAbout int] [-reflectionAxis int] [-reflectionTolerance float] [object]

manipScaleContext is undoable, queryable, and editable.

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

Return value

string(name of the new context)

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

Flags

activeHandle, alignAlong, currentActiveHandle, editPivotMode, editPivotPosition, mode, orientAxes, orientTowards, pinPivot, position, postCommand, postDragCommand, preCommand, preDragCommand, preserveChildPosition, preserveUV, preventNegativeScale, reflection, reflectionAbout, reflectionAxis, reflectionTolerance
Long name (short name) Argument types Properties
-mode(-m) int queryedit
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 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 - Center handle (all axes) is active (default)
-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 - Center handle (all axes) is active
-position(-p) query
Returns the current position of the manipulator.
-editPivotPosition(-epp) query
Returns the current position of the edit pivot manipulator.
-orientAxes(-oa) float float float queryedit
Orients manipulator rotating around axes by specified angles
-orientTowards(-ot) float float float createedit
Orients active handle towards world point
-alignAlong(-aa) float float float createedit
Aligns active handle along vector.
-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 createedit
Specifies a command to be executed when the tool is entered.
-postCommand(-psc) script createedit
Specifies a command to be executed when the tool is exited.
-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.
-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.
-editPivotMode(-epm) boolean query
Returns true manipulator is in edit pivot mode
-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.
-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.
-preventNegativeScale(-pns) boolean query
When this is true, negative scale is not allowed.

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 scale context:
manipScaleContext;

// To query the active handle of an existing scale context:
manipScaleContext -q -ah manipScaleContext1;

// To edit an exiting scale context so that it comes up with the X axis
// handle active by default:
manipScaleContext -e -ah 0 manipScaleContext1;