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

Synopsis

showManipCtx [-currentNodeName] [-exists] [-history boolean] [-image1 string] [-image2 string] [-image3 string] [-incSnap uint boolean] [-incSnapRelative uint boolean] [-incSnapUI] [-incSnapValue uint float] [-lockSelection boolean] [-name string] [-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

currentNodeName, exists, history, image1, image2, image3, incSnap, incSnapRelative, incSnapUI, incSnapValue, lockSelection, name, toggleIncSnap, toolFinish, toolStart
Long name (short name) Argument types Properties
-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.
-lockSelection(-ls) boolean createqueryedit
If true, this context will never change the current selection. By default this is set to false.
-name(-n) string create
If this is a tool command, name the tool appropriately.
-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;