manipScaleContext

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

Synopsis

manipScaleContext [-activeHandle float] [-editPivotMode] [-editPivotPosition] [-position] [-postDragCommand script string] [-preDragCommand script string] [-preserveChildPosition boolean] [-reflection boolean] [-reflectionAbout int] [-reflectionAxis int] [-reflectionTolerance float] [object]

manipScaleContext is undoable, queryable, and editable.

Return value

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

Flags

Long name (short name)	Argument types	Properties
-activeHandle(-ah)	float
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)
-position(-p)
Returns the current position of the manipulator
-editPivotPosition(-epp)
Returns the current position of the edit pivot manipulator.
-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.
-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.
-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.
-editPivotMode(-epm)
Returns true manipulator is in edit pivot mode
-preserveChildPosition(-pcp)	boolean
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.

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;