Go to: Return value. Related commands. Flags. Examples.

Synopsis

polyEditUV [-relative boolean] [-uValue double] [-vValue double] [-rotation boolean] [-scale boolean] [-pivotU double] [-pivotV double] [-scaleU double] [-scaleV double] [-angle double] [-uvSetName string]

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.

Return value

boolean Success or Failure.

Keywords

poly, editUV, tweakUV, uvEditing

Related commands

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

Flags

angle, pivotU, pivotV, relative, rotation, scale, scaleU, scaleV, uValue, uvSetName, vValue

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

Examples


// To query the u and v values of selected uvs:
polyEditUV -query ;
// To tweak the u and v values of selected uvs:
polyEditUV -relative true -uValue 0.05925926 -vValue 0.05555556 ;
// To set absolute values for u and v values of selected uvs:
polyEditUV -relative false -uValue 0.556 -vValue 0.56 ;
// To rotate selected uv points about a pivot:
polyEditUV -pivotU 0.5 -pivotV 0.5 -angle -15;
// To scale selected uv points about a pivot:
polyEditUV -pivotU 0.5 -pivotV 0.5 -scaleU -0.06 -scaleV -0.06;