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

Synopsis

polyEditUVShell([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.

polyEditUVShell is undoable, queryable, and NOT editable.

Command edits uv shells on polygonal objects. When used with the query flag, it returns the transformation values associated with the specified components.

Return value

booleanSuccess or Failure.

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

Keywords

poly, editUV, tweakUV, uvEditing, uvShells

Related

polyClipboard, polyCylindricalProjection, polyForceUV, polyMapCut, polyMapDel, polyMapSew, polyMoveFacetUV, polyMoveUV, polyPlanarProjection, polyProjection, polySphericalProjection, polyUVSet, untangleUV

Flags

angle, pivotU, pivotV, relative, rotation, scale, scaleU, scaleV, uValue, uvSetName, vValue
Long name (short name) Argument types Properties
relative(r) boolean createquery
Specifies whether this command is editing the values relative to the currently existing values. Default is true;
uValue(u) float createquery
Specifies the value, in the u direction - absolute if relative flag is false..
vValue(v) float createquery
Specifies the value, in the v direction - absolute if relative flag is false..
rotation(rot) boolean createquery
Specifies whether this command is editing the values with rotation values
scale(s) boolean createquery
Specifies whether this command is editing the values with scale values
pivotU(pu) float createquery
Specifies the pivot value, in the u direction, about which the scale or rotate is to be performed.
pivotV(pv) float createquery
Specifies the pivot value, in the v direction, about which the scale or rotate is to be performed.
scaleU(su) float createquery
Specifies the scale value in the u direction.
scaleV(sv) float createquery
Specifies the scale value in the v direction.
angle(a) float createquery
Specifies the angle value (in degrees) that the uv values are to be rotated by.
uvSetName(uvs) string createquery
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.

Python examples

import maya.cmds as cmds

# To query the u and v values of selected uvs:
cmds.polyEditUVShell( query=True )
# To tweak the u and v values of selected uvs:
cmds.polyEditUVShell( relative=True, uValue=0.05925926, vValue=0.05555556 )
# To rotate selected uv points about a pivot:
cmds.polyEditUVShell( pivotU=0.5, pivotV=0.5, angle=-15 )