Go to: Synopsis. Return value. Keywords. Related. Flags. Python examples.
polyEditUV([angle=float], [pivotU=float], [pivotV=float], [relative=boolean], [rotation=boolean], [scale=boolean], [scaleU=float], [scaleV=float], [uValue=float], [uvSetName=string], [vValue=float])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
polyEditUV is undoable, queryable, and NOT editable.
Command edits uvs on polygonal objects. When used with the query flag, it
returns the uv values associated with the specified components.
boolean | Success or Failure. |
In query mode, return type is based on queried flag.
poly, editUV, tweakUV, uvEditing
polyClipboard, polyCylindricalProjection, polyForceUV, polyMapCut, polyMapDel, polyMapSew, polyMoveFacetUV, polyMoveUV, polyPlanarProjection, polyProjection, polySphericalProjection, polyUVSet, untangleUV
angle, pivotU, pivotV, relative, rotation, scale, scaleU, scaleV, uValue, uvSetName, vValue
Long name (short name) |
Argument types |
Properties |
relative(r)
|
boolean
|
|
|
Specifies whether this command is editing the values relative to the currently
existing values. Default is true;
|
|
uValue(u)
|
float
|
|
|
Specifies the value, in the u direction - absolute if relative flag is false..
|
|
vValue(v)
|
float
|
|
|
Specifies the value, in the v direction - absolute if relative flag is false..
|
|
rotation(rot)
|
boolean
|
|
|
Specifies whether this command is editing the values with rotation values
|
|
scale(s)
|
boolean
|
|
|
Specifies whether this command is editing the values with scale values
|
|
pivotU(pu)
|
float
|
|
|
Specifies the pivot value, in the u direction, about which the scale or
rotate is to be performed.
|
|
pivotV(pv)
|
float
|
|
|
Specifies the pivot value, in the v direction, about which the scale or
rotate is to be performed.
|
|
scaleU(su)
|
float
|
|
|
Specifies the scale value in the u direction.
|
|
scaleV(sv)
|
float
|
|
|
Specifies the scale value in the v direction.
|
|
angle(a)
|
float
|
|
|
Specifies the angle value (in degrees) that the uv values are to be rotated
by.
|
|
uvSetName(uvs)
|
string
|
|
|
Specifies the name of the uv set to edit uvs on. If not specified
will use the current uv set if it exists.
|
|
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
# To query the u and v values of selected uvs:
cmds.polyEditUV( query=True )
# To tweak the u and v values of selected uvs:
cmds.polyEditUV( relative=True, uValue=0.05925926, vValue=0.05555556 )
# To set absolute values for u and v values of selected uvs:
cmds.polyEditUV( relative=False, uValue=0.556, vValue=0.56 )
# To rotate selected uv points about a pivot:
cmds.polyEditUV( pivotU=0.5, pivotV=0.5, angle=-15 )
# To scale selected uv points about a pivot:
cmds.polyEditUV( pivotU=0.5, pivotV=0.5, scaleU=-0.06, scaleV=-0.06 )