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

Synopsis

showManipCtx( string , [currentNodeName=boolean], [incSnap=[uint, boolean]], [incSnapRelative=[uint, boolean]], [incSnapUI=boolean], [incSnapValue=[uint, float]], [lockSelection=boolean], [toggleIncSnap=boolean], [toolFinish=script], [toolStart=script])

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

showManipCtx is undoable, queryable, and editable.

This command can be used to create a show manip context. The show manip context will display manips for all selected objects that have valid manips defined for them.

Return value

string The name of the newly created context.

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

Flags

currentNodeName, incSnap, incSnapRelative, incSnapUI, incSnapValue, lockSelection, toggleIncSnap, toolFinish, toolStart
Long name (short name) Argument types Properties
toolStart(ts) script createqueryedit
Supply the script that will be run when the user first enters the script
toolFinish(tf) script createqueryedit
Supply the script that will be run when the user exits the script.
incSnap(incSnap) [uint, boolean] createqueryeditmultiuse
If true, the manipulator owned by the context will use incremental snapping for specified mode.
incSnapRelative(isr) [uint, boolean] createqueryeditmultiuse
If true, the manipulator owned by the context will use relative incremental snapping for specified mode.
incSnapValue(isv) [uint, float] createqueryeditmultiuse
Supply the step value which the manipulator owned by the context will use for specified mode.
toggleIncSnap(tis) boolean createedit
Toggles (enables/disables) snapping for all modes.
incSnapUI(isu) boolean query
Returns an array of elements indicating what kind of incremental snap UI is required by the manipulator owned by the context. If no UI is required, the result array will contain a single element of with the value 0. The other values and their meanings are:
  • 1 - UI for linear incremental translate
  • 2 - UI for incremental rotate
  • 3 - UI for inclremental scale
lockSelection(ls) boolean createqueryedit
If true, this context will never change the current selection. By default this is set to false.
currentNodeName(cnn) boolean query
Returns the name of the first node that the context is attached to.
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

# Creates a new show manip context.
cmds.showManipCtx()