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

Synopsis

texScaleContext([editPivotMode=boolean], [exists=boolean], [image1=string], [image2=string], [image3=string], [position=boolean], [preventNegativeScale=boolean], [snap=boolean], [snapRelative=boolean], [snapValue=float], [tweakMode=boolean])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

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) boolean 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) boolean 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 have multiple arguments, passed either as a tuple or a list.

Python examples

import maya.cmds as cmds

# To create a new scale context:
cmds.texScaleContext()

# To query the position of the manipulator
cmds.texScaleContext( 'texScaleContext', q=True, position=True )