Go to: Synopsis. Return value. Flags. Python examples.
showManipCtx(
string
, [currentNodeName=boolean], [exists=boolean], [history=boolean], [image1=string], [image2=string], [image3=string], [incSnap=[uint, boolean]], [incSnapRelative=[uint, boolean]], [incSnapUI=boolean], [incSnapValue=[uint, float]], [lockSelection=boolean], [name=string], [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.
| string | The name of the newly created context. |
In query mode, return type is based on queried flag.
currentNodeName, exists, history, image1, image2, image3, incSnap, incSnapRelative, incSnapUI, incSnapValue, lockSelection, name, toggleIncSnap, toolFinish, toolStart
| Long name (short name) |
Argument types |
Properties |
|
currentNodeName(cnn)
|
boolean
|
|
|
Returns the name of the first node that the context is attached to.
|
|
exists(ex)
|
boolean
|
|
|
Returns true or false depending upon whether the
specified object exists. Other flags are ignored.
|
|
history(ch)
|
boolean
|
|
|
If this is a tool command, turn the construction history on
for the tool in question.
|
|
image1(i1)
|
string
|
|
|
First of three possible icons representing the tool
associated with the context.
|
|
image2(i2)
|
string
|
|
|
Second of three possible icons representing the tool
associated with the context.
|
|
image3(i3)
|
string
|
|
|
Third of three possible icons representing the tool
associated with the context.
|
|
incSnap(incSnap)
|
[uint, boolean]
|
|
|
If true, the manipulator owned by the context will use incremental snapping for specified mode.
|
|
incSnapRelative(isr)
|
[uint, boolean]
|
|
|
If true, the manipulator owned by the context will use relative incremental snapping for specified mode.
|
|
incSnapUI(isu)
|
boolean
|
|
|
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]
|
|
|
Supply the step value which the manipulator owned by the context will use for specified mode.
|
|
lockSelection(ls)
|
boolean
|
|
|
If true, this context will never change the current selection.
By default this is set to false.
|
|
name(n)
|
string
|
|
|
If this is a tool command, name the tool appropriately.
|
|
toggleIncSnap(tis)
|
boolean
|
|
|
Toggles (enables/disables) snapping for all modes.
|
|
toolFinish(tf)
|
script
|
|
|
Supply the script that will be run when the user exits
the script.
|
|
toolStart(ts)
|
script
|
|
|
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.
|
import maya.cmds as cmds
# Creates a new show manip context.
cmds.showManipCtx()