Go to:
Return value. Related commands. Flags. Examples.
Synopsis
polyUVSet
[-uvSet string]
[-currentUVSet toggle]
[-currentLastUVSet toggle]
[-allUVSets toggle]
[-allUVSetsIndices toggle]
[-rename toggle]
[-newUVSet string]
[-delete toggle]
[-copy toggle]
[-create toggle]
[-projections toggle]
polyUVSet is
undoable, queryable, and editable
.
Command to do the following to uv sets:
- delete an existing uv set.
- rename an existing uv set.
- create a new empty uv set.
- copy the values from one uv set to a another
pre-existing uv set.
- set the current uv set to a pre-existing uv set.
- query the current uv set.
- set the current uv set to the last uv set added to an object.
- query the names of all uv sets.
Return value
boolean
Success or Failure.
Keywords
poly, uvSet, currentUVSet, renameUVSet, deleteUVSet, copyUVSet, createUVSetRelated commands
polyProjection, polyForceUV, untangleUV, polyEditUV, polyPlanarProjection, polyCylindricalProjection, polyClipboard, polySphericalProjection, polyMoveFacetUV, polyMoveUV, polyMapCut, polyMapDel, polyMapSewFlags
allUVSets, allUVSetsIndices, copy, create, currentLastUVSet, currentUVSet, delete, newUVSet, projections, rename, uvSet
| Long name (short name) | [argument types] | Properties |
|---|
-uvSet
(-uvs)
| string |    |
|
Specifies the name of the uv set that this command needs to work on.
This flag has to be specified for this command to do anything meaningful
other than query the current uv set.
|
|
-currentUVSet
(-cuv)
| | |
|
This flag when used will set the current uv set that the object needs to
work on, to be the uv set corresponding to the name specified with the
uvSet flag. This does require that a uvSet with the specified name exist.
When queried, this returns the current uv set.
|
|
-currentLastUVSet
(-luv)
| | |
|
This flag when used will set the current uv set that the object needs to
work on, to be the last uv set added to the object.
If no uv set exists for the object, then no uv set name will be returned.
|
|
-allUVSets
(-auv)
| | |
|
This flag when used in in a query will return a list of all
of the uv set names
|
|
-allUVSetsIndices
(-uvn)
| | |
|
This flag when queried will return a list of the logical plug
indices of all the uv sets in the sparse uv set array.
|
|
-rename
(-rn)
| | |
|
This flag when used will result in the renaming of the uv set corresponding
to the name specified with the uvSet flag to the name specified using the
newUVSet flag.
|
|
-newUVSet
(-nuv)
| string | |
|
Specifies the name that the uv set corresponding to the name specified with
the uvSet flag, needs to be renamed to.
|
|
-delete
(-d)
| | |
|
This flag when used will result in the deletion of the uv set corresponding
to the name specified with the uvSet flag.
|
|
-copy
(-cp)
| | |
|
This flag when used will result in the copying of the uv set corresponding
to name specified with the uvSet flag to the uvset corresponding
to the name specified with the newUVSet flag
|
|
-create
(-cr)
| | |
|
This flag when used will result in the creation of an empty uv set
corresponding to the name specified with the uvSet flag. If
a uvSet with that name already exists, then no new uv set will
be created.
|
|
-projections
(-pr)
| | |
|
This flag when used in a query will return a list of polygon
uv projection node names. The order of the list is from
most-recently-applied to least-recently-applied.
|
|
|
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 set the current uv set to be "map2".
polyUVSet -currentUVSet -uvSet "map2";
// To set the current uv set to the last uv set added to an object.
polyUVSet -currentLastUVSet;
// To query the current uv set.
polyUVSet -q -currentUVSet;
// To rename a currently existing uv set from "map3" to "map4".
polyUVSet -rename -uvSet "map3" -newUVSet "map4";
// Rename the current uv set (if any) to "map4".
polyUVSet -rename -newUVSet "map4";
// To delete a currently existing uv set "map3".
polyUVSet -delete -uvSet "map3";
// To delete the current uv set (if any)
polyUVSet -delete;
// Copy values of uvset "map1" to "map2"
polyUVSet -copy -uvSet "map1" -nuv "map2";
// Copy values of the current uvset to "map2"
polyUVSet -copy -nuv "map2";
// Make a copy of "map1" to a new uvset. The
// name of which is automatically generated and returned.
polyUVSet -copy -uvSet "map1";
// Create a new empty uv set
polyUVSet -create -uvSet "newMap";
// Create a new empty uv set with a generate new name
// The newly generated name is returned.
polyUVSet -create;
// To query all of the uv sets
polyUVSet -q -allUVSets;
// To query the logical indices of the uv sets in the
// node's uv set array
string $node = "node";
int $indices[] = `polyUVSet -q -allUVSetsIndices $node`;
for( $i in $indices )
{
string $name = `getAttr ($node+".uvSet["+$i+"].uvSetName")`;
print( "Found uv set called " + $name + "\n" );
}