pymel.core.modeling.nurbsUVSet — PyMEL 1.0.7 documentation

pymel.core.modeling.nurbsUVSet

nurbsUVSet(*args, **kwargs)

Allows user to toggle between implicit and explicit UVs on a NURBS object. Also provides a facility to create, delete, rename and set the current explicit UVSet. An implicit UVSet is non-editable. It uses the parametric make-up of the NURBS object to determine the location of UVs (isoparm intersections). NURBS objects also support explicit UVSets which are similar to the UVs of a polygonal object. UVs are created at the knots (isoparm intersections) of the object and are fully editable. In order to access UV editing capabilities on a NURBS object an explicit UVSet must be created and set as the current UVSet.

Flags:

Long Name / Short Name Argument Types Properties
create / c bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

Creates an explicit UV set on the specified surface. If the surface already has an explicit UV set this flag will do nothing. Use the -ue/useExplicit flag to set/unset the explicit UV set as the current UV set.

useExplicit / ue bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

Toggles the usage of explicit/implicit UVs. When true, explicit UVs will be used, otherwise the object will use implicit UVs. Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.nurbsUVSet

Example:

import pymel.core as pm

result = pm.sphere()
shape = result[0]
pm.select(shape, r=True)
# Create and activate a UV set
pm.nurbsUVSet(create=True)
# Result: u'defaultExplicitUVSet' #
pm.nurbsUVSet(useExplicit=True)
# Result: True #
pm.select(shape+".cv[3:5][2:4]", r=True)
# Rotate the UVs by 45 degrees
pm.nurbsEditUV(angle=45)