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

Synopsis

showManipCtx [-currentNodeName] [-incSnap uint boolean] [-incSnapRelative uint boolean] [-incSnapUI] [-incSnapValue uint float] [-lockSelection boolean] [-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, 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(-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.
-incSnapValue(-isv) uint float createqueryeditmultiuse
Supply the step value which the manipulator owned by the context will use for specified mode.
-toggleIncSnap(-tis) createedit
Toggles (enables/disables) snapping for all modes.
-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
-lockSelection(-ls) boolean createqueryedit
If true, this context will never change the current selection. By default this is set to false.
-currentNodeName(-cnn) 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 be used more than once in a command.

MEL examples

// Creates a new show manip context.
showManipCtx;