Go to: Synopsis. Return value. Flags. Python examples.
texSmudgeUVContext(
contextName
, [dragSlider=string], [effectType=string], [exists=boolean], [functionType=string], [history=boolean], [image1=string], [image2=string], [image3=string], [name=string], [pressure=float], [radius=float], [smudgeIsMiddle=boolean])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
texSmudgeUVContext is undoable, queryable, and editable.
This command creates a context for smudge UV tool. This
context only works in the texture UV editor.
| string | Name of the effect type created. |
In query mode, return type is based on queried flag.
dragSlider, effectType, exists, functionType, history, image1, image2, image3, name, pressure, radius, smudgeIsMiddle
| Long name (short name) |
Argument types |
Properties |
|
dragSlider(ds)
|
string
|
 
|
|
radius | none
Enables the drag slider mode. This is to support brush
resizing while holding the 'b' or 'B' button.
|
|
effectType(et)
|
string
|
|
|
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)
|
boolean
|
|
|
Returns true or false depending upon whether the
specified object exists. Other flags are ignored.
|
|
functionType(ft)
|
string
|
|
|
exponential | linear | constant.
Specifies how UVs fall off from the center of influence.
|
|
history(ch)
|
boolean
|
|
|
If this is a tool command, turn the construction history on
for the tool in question.
|
|
image1(i1)
|
string
|
|
|
First of three possible icons representing the tool
associated with the context.
|
|
image2(i2)
|
string
|
|
|
Second of three possible icons representing the tool
associated with the context.
|
|
image3(i3)
|
string
|
|
|
Third of three possible icons representing the tool
associated with the context.
|
|
name(n)
|
string
|
|
|
If this is a tool command, name the tool appropriately.
|
|
pressure(prs)
|
float
|
|
|
Pressure value when effect type is set to smudge.
|
|
radius(r)
|
float
|
|
|
Radius of the smudge tool. All UVs within this radius are
affected by the tool
|
|
smudgeIsMiddle(sim)
|
boolean
|
|
|
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 have multiple arguments, passed either as a tuple or a list.
|
import maya.cmds as cmds
# Create a poly plane
cmds.polyPlane(w=10, h=10, sx=10, sy=10, n='pPlane1')
# Select all UVs
cmds.select('pPlane1.map[0:120]', r=True)
# 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
cmds.texSmudgeUVContext('texSmudgeUVContext1', effectType='smudge', r=0.1, prs=0.2)
cmds.setToolTo('texSmudgeUVContext1')