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

Synopsis

texScaleContext [-editPivotMode boolean] [-exists] [-image1 string] [-image2 string] [-image3 string] [-position] [-preventNegativeScale boolean] [-snap boolean] [-snapRelative boolean] [-snapValue float] [-tweakMode boolean]

texScaleContext is undoable, queryable, and editable.

This command can be used to create, edit, or query a scale context for the UV Editor. Note that the above flag controls the global behaviour of all texture editor scale contexts. Changing one context independently is not allowed. Changing a context's behaviour using the above flag, will change all existing texture editor scale contexts.

Return value

string: name of the context created

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

Flags

editPivotMode, exists, image1, image2, image3, position, preventNegativeScale, snap, snapRelative, snapValue, tweakMode
Long name (short name) Argument types Properties
-editPivotMode(-epm) boolean query
Returns true when manipulator is in edit pivot mode.
-exists(-ex) create
Returns true or false depending upon whether the specified object exists. Other flags are ignored.
-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.
-position(-p) query
Returns the current position of the manipulator.
-preventNegativeScale(-pns) boolean queryedit
Prevent negative scale for components.
-snap(-s) boolean queryedit
Sets or queries whether snapping is to be used.
-snapRelative(-sr) boolean queryedit
Sets or queries whether snapping is relative.
-snapValue(-sv) float queryedit
Sets or queries the size of the snapping increment.
-tweakMode(-twk) boolean queryedit
When true, the manipulator is hidden and highlighted components can be selected and scaled in one step using a click-drag interaction.

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

// To create a new scale context:
texScaleContext;

// To query the position of the manipulator
texScaleContext -q -position texScaleContext;