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

Synopsis

showManipCtx [-addAttr string] [-currentNodeName] [-exists] [-history boolean] [-image1 string] [-image2 string] [-image3 string] [-incSnap uint boolean] [-incSnapRelative uint boolean] [-incSnapUI] [-incSnapValue uint float] [-iveVisible boolean] [-lockSelection boolean] [-moveActiveAttrDown] [-moveActiveAttrToTop] [-moveActiveAttrUp] [-name string] [-removeAttr string] [-resetActiveAttr] [-selectedAttributes] [-setAttrActive string] [-setNextAttrActive] [-setPreviousAttrActive] [-toggleIncSnap] [-toolFinish script] [-toolStart script] string

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) query
Returns the name of the first node that the context is attached to.
-exists(-ex) 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(-is) 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) 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) edit
Move the In View Editor active attribute down one in the list.
-moveActiveAttrToTop(-mtt) edit
Move the In View Editor active attribute to the top of the list.
-moveActiveAttrUp(-mu) 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) edit
Reset the In View Editor active attribute to its default value.
-selectedAttributes(-sa) 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) edit
Set the next attribute in the In View Editor attribute list active.
-setPreviousAttrActive(-spa) edit
Set the previous attribute in the In View Editor attribute list active.
-toggleIncSnap(-tis) 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 be used more than once in a command.

MEL examples

// Creates a new show manip context.
showManipCtx;