manipOptions

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

Synopsis

manipOptions [-forceRefresh] [-handleSize float] [-hideManipOnCtrl boolean] [-hideManipOnShift boolean] [-hideManipOnShiftCtrl boolean] [-linePick float] [-lineSize float] [-pivotRotateHandleOffset int] [-planeHandleOffset int] [-pointSize float] [-preselectHighlight boolean] [-refreshMode int] [-relative] [-rememberActiveHandle boolean] [-rememberActiveHandleAfterToolSwitch boolean] [-scale float] [-showPivotRotateHandle int] [-showPlaneHandles int]

manipOptions is undoable, queryable, and NOT editable.

Return value

None

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

Flags

Long name (short name)	Argument types	Properties
-forceRefresh(-fr)
Force a refresh if there is any deferred evaluation.
-handleSize(-hs)	float
Sets the maximum handles size in pixels, for small handles
-hideManipOnCtrl(-hmc)	boolean
Hide transform manip when the Ctrl key is pressed.
-hideManipOnShift(-hms)	boolean
Hide transform manip when the Shift key is pressed.
-hideManipOnShiftCtrl(-hsc)	boolean
Hide transform manip when the Shift and Ctrl keys are both pressed.
-linePick(-lp)	float
Set the width of picking zone for long handles
-lineSize(-ls)	float
Set the width of long handles (drawn as lines)
-pivotRotateHandleOffset(-pro)	int
Set the offset of the pivot rotation handle.
-planeHandleOffset(-pho)	int
Set the offset of the planar drag handles.
-pointSize(-ps)	float
Set the size of points (used to display previous states)
-preselectHighlight(-psh)	boolean
Set whether manip handles should be highlighted when moving mouse.
-refreshMode(-rm)	int
Set the global refresh mode.
-relative(-r)
All values are interpreted as multiplication factors instead of final values.
-rememberActiveHandle(-rah)	boolean
Set whether manip handles should be remembered after selection change.
-rememberActiveHandleAfterToolSwitch(-rhs)	boolean
Set whether manip handles should be remembered after manipulator change.
-scale(-s)	float
Global scaling factor of all manipulators
-showPivotRotateHandle(-spr)	int
Toggles the visibility of the pivot rotation handle.
-showPlaneHandles(-sph)	int
Toggles the visibility of the planar drag handles.

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

// Scales all handles by a 1.5 factor
manipOptions -r -hs 1.5 -ls 1.5;

// All manips are scaled by 2
manipOptions -s 2;