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

Synopsis

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

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.

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

Keywords

poly, editUV, tweakUV, uvEditing

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) double createquery
Specifies the value, in the u direction - absolute if relative flag is false..
-vValue(-v) double 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) double createquery
Specifies the pivot value, in the u direction, about which the scale or rotate is to be performed.
-pivotV(-pv) double createquery
Specifies the pivot value, in the v direction, about which the scale or rotate is to be performed.
-scaleU(-su) double createquery
Specifies the scale value in the u direction.
-scaleV(-sv) double createquery
Specifies the scale value in the v direction.
-angle(-a) double 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 be used more than once in a command

MEL 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;