pymel.core.modeling.untangleUV

untangleUV(*args, **kwargs)

This command will aid in the creation of non-overlapping regions (i.e. polygons) in texture space by untangling texture UVs. This is done in two stages:1) Use this command to map the UV border determined by the current selection or passed component into a shape that is more suitable for subsequent relaxation.2) Relax all the internal texture UVs by performing a length minimization algorithm on all edges in texture space.

Flags:
Long name (short name) Argument Types Properties
mapBorder (mb) unicode ../../../_images/create.gif
 

Map the border containing the selected UV into a variety of shapes that may be more amenable to UV relaxation operations. There are various types of mapping available. All the resulting mappings are fit inside the unit square.Valid values for the STRING are:circular- a circular mapping with picked UV closest to (0,0)square- map to unit square with picked UV at (0,0)shape- a mapping which attempts to reflect the actual shape of the object where the picked UV is placed on the line from (0,0) -(0.5,0.5)shape_circular- shape mapping which will interpolate to a circular mapping just enough to prevent self- intersections of the mapped border shape_square- shape mapping which will interpolate to a square mapping just enough to prevent self-intersections of the mapped border

maxRelaxIterations (mri) int ../../../_images/create.gif
 
The relaxation process is an iterative algorithm. Using this flag will put an upper limit on the number of iterations that will be performed.
pinBorder (pb) bool ../../../_images/create.gif
 
If this is true, then the relevant texture borders are pinned in place during any relaxation
pinSelected (ps) bool ../../../_images/create.gif
 
If this is true, then then any selected UVs are pinned in place during any relaxation
pinUnselected (pu) bool ../../../_images/create.gif
 

If this is true, then all unselected UVs in each mesh are pinned in place during any relaxation Flag can have multiple arguments, passed either as a tuple or a list.

relax (r) unicode ../../../_images/create.gif
 

Relax all UVs in the shell of the selected UV’s. The relaxation is done by simulating a spring system where each UV edge is treated as a spring. There are a number of different methods characterized by the way the UV edges are weighted in the spring system. These weightings are determined by STRING. Valid values for STRING are:uniform- every edge is weighted the same. This is the fastest method.inverse_length- every edge weight is inversely proportional to it’s world space length.inverse_sqrt_length- every edge weight is inversely proportional the the square root of it’s world space length.harmonic- this weighting can yield near optimal results in matching the UV’s with the geometry, but can also take a long time.

relaxTolerance (rt) float ../../../_images/create.gif
 
This sets the tolerance which is used to determine when the relaxation process can stop. Smaller tolerances yield better results but can take much longer.
shapeDetail (sd) float ../../../_images/create.gif
 

If the mapBorder flag is set to circular or square, then this flag will control how much of the border’s corresponding surface shape should be retained in the final mapped border.

Derived from mel command maya.cmds.untangleUV

Example:

import pymel.core as pm

pm.untangleUV( mb='shape_square' )
# Result: 0 #
# map the border associated with the selected UV trying to retain the
# shape of the object and use a square mapping to iron out crossings
pm.untangleUV( r='one_over_length', pb=True, ps=False, pu=False, rt=0.1 )
# Result: 0 #
# relax the shell associated with the selected UV using edge weights
# that are inversely proportional to length of world space lengths
# pin the UV on borders and use a tolerance of 0.1

Previous topic

pymel.core.modeling.unfold

Next topic

pymel.core.modeling.untrim

Core

Core Modules

Other Modules

This Page