polyMoveFacetUV command

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

Synopsis

polyMoveFacetUV [flags]

Modifies the map by moving all UV values associated with the selected face(s). The UV coordinates of the model are manipulated without changing the vertices of the 3D object.

Return value

string The node name.

Related commands

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

Flags

axisLen, axisLenX, axisLenY, constructionHistory, name, pivot, pivotU, pivotV, random, rotationAngle, scale, scaleU, scaleV, translate, translateU, translateV

Long name (short name) [argument types] Properties

-axisLen (-l) float float

Axis Length vector, used to draw the manip handles.
C: Default is 1.0, 1.0
Q: When queried, this flag returns a float[2].

-axisLenX (-lx) float

Axis Length in X, used to draw the manip handles.
C: Default is 1.0
Q: When queried, this flag returns a float.

-axisLenY (-lx) float

Axis Length in Y, used to draw the manip handles.
C: Default is 1.0
Q: When queried, this flag returns a float.

-rotationAngle (-ra) angle

Angle of rotation.
C: Default is 0.0.
Q: When queried, this flag returns a float.

-pivot (-pvt) float float

This flag specifies the pivot for scaling and rotation.
C: Default is 0.0 0.0.
Q: When queried, this flag returns a float[2].

-pivotU (-pvu) float

This flag specifies U for the pivot for scaling and rotation.
C: Default is 0.0.
Q: When queried, this flag returns a float.

-pivotV (-pvv) float

This flag specifies V for the pivot for scaling and rotation.
C: Default is 0.0.
Q: When queried, this flag returns a float.

-random (-ran) float

This flag specifies the random value for all parameters.
C: Default is 0.0. The range is [-10.0, 10.0].
Q: When queried, this flag returns a float.

-scale (-s) float float

This flag specifies the scaling vector.
C: Default is 1.0 1.0.
Q: When queried, this flag returns a float.

-scaleU (-su) float

This flag specifies U for the scaling vector.
C: Default is 1.0.
Q: When queried, this flag returns a float.

-scaleV (-sv) float

This flag specifies V for the scaling vector.
C: Default is 1.0.
Q: When queried, this flag returns a float.

-translate (-t) float float

This flag specifies the translation vector.
C: Default is 0.0 0.0.
Q: When queried, this flag returns a float[2].

-translateU (-tu) float

This flag specifies the U translation vector.
C: Default is 0.0.
Q: When queried, this flag returns a float.

-translateV (-tv) float

This flag specifies the V translation vector.
C: Default is 0.0.
Q: When queried, this flag returns a float.

Common flags

-name (-n) string

Name the resulting object.

-constructionHistory (-ch) boolean

Turn the construction history on or off (where applicable).
Q: When queried, this flag returns an int.

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


	//Create a plane and select it.
	polyPlane -n plg -sx 5 -sy 5 -w 10 -h 10;
	select plg;

	//Display map borders.
	polyOptions -ao -dmb true;

	//Cut the map.
	polyMapCut plg.e[44] plg.e[46] plg.e[48] plg.e[50] plg.e[52];
	//now we can move the row without affecting the other faces' mapping

	//Opening the UV Texture Editor window will give you a better picture
	//of what is happening here.

	//Translate each UV of the mapping which is associated with
	//the selected faces as the vector (0.0, 0.5).
	select -r plgShape.f[20:24];
	polyMoveFacetUV -t 0.0 0.5;