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

Synopsis

showManipCtx( string , [addAttr=string], [currentNodeName=boolean], [exists=boolean], [history=boolean], [image1=string], [image2=string], [image3=string], [incSnap=[uint, boolean]], [incSnapRelative=[uint, boolean]], [incSnapUI=boolean], [incSnapValue=[uint, float]], [iveVisible=boolean], [lockSelection=boolean], [moveActiveAttrDown=boolean], [moveActiveAttrToTop=boolean], [moveActiveAttrUp=boolean], [name=string], [removeAttr=string], [resetActiveAttr=boolean], [selectedAttributes=boolean], [setAttrActive=string], [setNextAttrActive=boolean], [setPreviousAttrActive=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

stringThe name of the newly created context.

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

Flags

addAttr, currentNodeName, exists, history, image1, image2, image3, incSnap, incSnapRelative, incSnapUI, incSnapValue, iveVisible, lockSelection, moveActiveAttrDown, moveActiveAttrToTop, moveActiveAttrUp, name, removeAttr, resetActiveAttr, selectedAttributes, setAttrActive, setNextAttrActive, setPreviousAttrActive, toggleIncSnap, toolFinish, toolStart
Long name (short name) Argument types Properties
addAttr(aa) string edit
Add a specific attribute to the In View Editor attribute list.
currentNodeName(cnn) boolean query
Returns the name of the first node that the context is attached to.
exists(ex) boolean create
Returns true or false depending upon whether the specified object exists. Other flags are ignored.
history(ch) boolean create
If this is a tool command, turn the construction history on for the tool in question.
image1(i1) string createqueryedit
First of three possible icons representing the tool associated with the context.
image2(i2) string createqueryedit
Second of three possible icons representing the tool associated with the context.
image3(i3) string createqueryedit
Third of three possible icons representing the tool associated with the context.
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.
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
incSnapValue(isv) [uint, float] createqueryeditmultiuse
Supply the step value which the manipulator owned by the context will use for specified mode.
iveVisible(iv) boolean queryedit
Set the In View Editor visible or not.
lockSelection(ls) boolean createqueryedit
If true, this context will never change the current selection. By default this is set to false.
moveActiveAttrDown(md) boolean edit
Move the In View Editor active attribute down one in the list.
moveActiveAttrToTop(mtt) boolean edit
Move the In View Editor active attribute to the top of the list.
moveActiveAttrUp(mu) boolean edit
Move the In View Editor active attribute up one in the list.
name(n) string create
If this is a tool command, name the tool appropriately.
removeAttr(ra) string edit
Remove a specific attribute from the In View Editor attribute list.
resetActiveAttr(raa) boolean edit
Reset the In View Editor active attribute to its default value.
selectedAttributes(sa) boolean query
Returns a list of the names of the attributes that are currently visible in the In View Editor.
setAttrActive(saa) string edit
Set a specific attribute from the In View Editor attribute list active.
setNextAttrActive(sna) boolean edit
Set the next attribute in the In View Editor attribute list active.
setPreviousAttrActive(spa) boolean edit
Set the previous attribute in the In View Editor attribute list active.
toggleIncSnap(tis) boolean createedit
Toggles (enables/disables) snapping for all modes.
toolFinish(tf) script createqueryedit
Supply the script that will be run when the user exits the script.
toolStart(ts) script createqueryedit
Supply the script that will be run when the user first enters the script

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()