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

Synopsis

texSmudgeUVContext [-dragSlider string] [-effectType string] [-exists] [-functionType string] [-history boolean] [-image1 string] [-image2 string] [-image3 string] [-name string] [-pressure float] [-radius float] [-smudgeIsMiddle boolean] contextName

texSmudgeUVContext is undoable, queryable, and editable.

This command creates a context for smudge UV tool. This context only works in the texture UV editor.

Return value

stringName of the effect type created.

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

Flags

dragSlider, effectType, exists, functionType, history, image1, image2, image3, name, pressure, radius, smudgeIsMiddle
Long name (short name) Argument types Properties
-dragSlider(-ds) string queryedit
radius | none Enables the drag slider mode. This is to support brush resizing while holding the 'b' or 'B' button.
-effectType(-et) string queryedit
fixed | smudge Specifies the effect of the tool. In fixed mode, the UVs move as if they are attached by a rubber band. In smudge mode the UVs are moved as the cursor is dragged over the UVs.
-exists(-ex) create
Returns true or false depending upon whether the specified object exists. Other flags are ignored.
-functionType(-ft) string queryedit
exponential | linear | constant. Specifies how UVs fall off from the center of influence.
-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.
-name(-n) string create
If this is a tool command, name the tool appropriately.
-pressure(-prs) float queryedit
Pressure value when effect type is set to smudge.
-radius(-r) float queryedit
Radius of the smudge tool. All UVs within this radius are affected by the tool
-smudgeIsMiddle(-sim) boolean queryedit
By default, the left mouse button initiates the smudge. However, this conflicts with selection. When smudgeIsMiddle is on, smudge mode is activated by the middle mouse button instead of the left mouse button.

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

// Create a poly plane
polyPlane -w 10 -h 10 -sx 10 -sy 10 -n pPlane1;

// Select all UVs
select -r pPlane1.map[0:120];

// Create a new smudge UV tool context, set the effect type to smudge mode, set the radius to 0.1 and pressure to 0.2, then switch to it
// In order to use this tool to smudge the UVs of pPlane1, you must open the texture UV editor
texSmudgeUVContext -effectType smudge -r 0.1 -prs 0.2 texSmudgeUVContext1;
setToolTo texSmudgeUVContext1;