manipOptions

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

Synopsis

manipOptions([forceRefresh=boolean], [handleSize=float], [linePick=float], [lineSize=float], [pointSize=float], [preselectHighlight=boolean], [refreshMode=int], [relative=boolean], [scale=float])

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
relative(r)	boolean
All values are interpreted as multiplication factors instead of final values.
scale(s)	float
Global scaling factor of all manipulators
handleSize(hs)	float
Sets the maximum handles size in pixels, for small handles
lineSize(ls)	float
Set the width of long handles (drawn as lines)
linePick(lp)	float
Set the width of picking zone for long handles
pointSize(ps)	float
Set the size of points (used to display previous states)
refreshMode(rm)	int
Set the global refresh mode.
forceRefresh(fr)	boolean
Force a refresh if there is any deferred evaluation.
preselectHighlight(psh)	boolean
Set whether manip handles should be highlighted when moving mouse.

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 )