Go to: Synopsis. Flags. Return value. Keywords. Related. 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.

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;

In query mode, this flag needs a value.
-uValue(-u) double createquery
Specifies the value, in the u direction - absolute if relative flag is false..

In query mode, this flag needs a value.
-vValue(-v) double createquery
Specifies the value, in the v direction - absolute if relative flag is false..

In query mode, this flag needs a value.
-rotation(-rot) boolean createquery
Specifies whether this command is editing the values with rotation values

In query mode, this flag needs a value.
-scale(-s) boolean createquery
Specifies whether this command is editing the values with scale values

In query mode, this flag needs a value.
-pivotU(-pu) double createquery
Specifies the pivot value, in the u direction, about which the scale or rotate is to be performed.

In query mode, this flag needs a value.
-pivotV(-pv) double createquery
Specifies the pivot value, in the v direction, about which the scale or rotate is to be performed.

In query mode, this flag needs a value.
-scaleU(-su) double createquery
Specifies the scale value in the u direction.

In query mode, this flag needs a value.
-scaleV(-sv) double createquery
Specifies the scale value in the v direction.

In query mode, this flag needs a value.
-angle(-a) double createquery
Specifies the angle value (in degrees) that the uv values are to be rotated by.

In query mode, this flag needs a value.
-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.

In query mode, this flag needs a value.
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

Return value


boolean Success or Failure.

Keywords

poly, editUV, tweakUV, uvEditing

Related

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

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;