pymel.core.modeling.manipOptions¶

manipOptions(*args, **kwargs)¶

Changes the global manipulator parameters In query mode, return type is based on queried flag.

Flags:

Long Name / Short Name		Argument Types	Properties
enableSmartDuplicate / esd		bool
	Enables Shift-Duplicate option on t/r/s manips.
enableSmartExtrude / ese		bool
	Enables Shift-Extrude option on t/r/s manips.
forceRefresh / fr		bool
	Force a refresh if there is any deferred evaluation.
handleSize / hs		float
	Sets the maximum handles size in pixels, for small handles
hideManipOnCtrl / hmc		bool
	Hide transform manip when the Ctrl key is pressed.
hideManipOnShift / hms		bool
	Hide transform manip when the Shift key is pressed.
hideManipOnShiftCtrl / hsc		bool
	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		bool
	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		bool
	Set whether manip handles should be highlighted when moving mouse.
refreshMode / rm		int
	Set the global refresh mode.
relative / r		bool
	All values are interpreted as multiplication factors instead of final values.
rememberActiveHandle / rah		bool
	Set whether manip handles should be remembered after selection change.
rememberActiveHandleAfterToolSwitch / rhs		bool
	Set whether manip handles should be remembered after manipulator change.
scale / s		float
	Global scaling factor of all manipulators
showExtrudeSliders / ses		bool
	Specify if the extrude sliders are to be shown on the manip
showPivotRotateHandle / spr		bool
	Toggles the visibility of the pivot rotation handle.
showPlaneHandles / sph		bool
	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 have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.manipOptions

Example:

import pymel.core as pm

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

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