manipOptions

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

Synopsis

manipOptions([enableSmartDuplicate=boolean], [enableSmartExtrude=boolean], [forceRefresh=boolean], [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=boolean], [rememberActiveHandle=boolean], [rememberActiveHandleAfterToolSwitch=boolean], [scale=float], [showExtrudeSliders=boolean], [showPivotRotateHandle=boolean], [showPlaneHandles=boolean], [smartDuplicateType=int])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

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)	boolean
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)	boolean
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 have multiple arguments, passed either as a tuple or a list.

Python examples

import maya.cmds as cmds

# Scales all handles by a 1.5 factor
cmds.manipOptions( r=True, hs=1.5, ls=1.5 )

# All manips are scaled by 2
cmds.manipOptions( s=2 )