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


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.

Changes the global manipulator parameters

Return value


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


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