manipOptions

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

Synopsis

manipOptions [-enableSmartDuplicate boolean] [-enableSmartExtrude boolean] [-forceRefresh] [-handleSize float] [-hideManipOnCtrl boolean] [-hideManipOnShift boolean] [-hideManipOnShiftCtrl boolean] [-linePick float] [-lineSize float] [-middleMouseRepositioning boolean] [-pivotRotateHandleOffset int] [-planeHandleOffset int] [-pointSize float] [-preselectHighlight boolean] [-refreshMode int] [-relative] [-rememberActiveHandle boolean] [-rememberActiveHandleAfterToolSwitch boolean] [-scale float] [-showExtrudeSliders boolean] [-showPivotRotateHandle boolean] [-showPlaneHandles boolean] [-smartDuplicateType 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
-enableSmartDuplicate(-esd)	boolean
Enables Shift-Duplicate option on t/r/s manips.
-enableSmartExtrude(-ese)	boolean
Enables Shift-Extrude option on t/r/s manips.
-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)
-middleMouseRepositioning(-mm)	boolean
Specify if the middle mouse should reposition
-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
-showExtrudeSliders(-ses)	boolean
Specify if the extrude sliders are to be shown on the manip
-showPivotRotateHandle(-spr)	boolean
Toggles the visibility of the pivot rotation handle.
-showPlaneHandles(-sph)	boolean
Toggles the visibility of the planar drag handles.
-smartDuplicateType(-sdt)	int
Change Shift-Duplicate or Shift-Extrude between Copy and Instance on t/r/s manips.

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;