polyStraightenUVBorder

Go to: Synopsis. Return value. Flags. Python examples.

Synopsis

polyStraightenUVBorder( selectionList , [blendOriginal=float], [caching=boolean], [constructionHistory=boolean], [curvature=float], [gapTolerance=int], [name=string], [nodeState=int], [preserveLength=float], [uvSetName=string])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

polyStraightenUVBorder is undoable, queryable, and editable.

Return value

In query mode, return type is based on queried flag.

Flags

Long name (short name)	Argument types	Properties
curvature(c)	float
How curved the UV path will be. 0 is a straight line. When the values is 1, the mid point of the curve will be moved away from a straight line by 1/2 the length of the UV segment.
blendOriginal(bo)	float
Interpolation factor between the target and original UV shape. When the value is 0, the UVs will exactly fit the target curve. When the value is 1, no UV move.
preserveLength(pl)	float
How much we want to respect the UV edge ratios. When the value is 1, we build new UV position along the desired curve, respecting the original UV spacings. When the value is 0, new UVs are equally spaced along the curve.
gapTolerance(gt)	int
When non 0, Small gaps between UV selection are filled. The integer number represent how many UVs must be traversed to connect togeterh selected pieces.
uvSetName(uvs)	string
Specifies the name of the uv set to edit uvs on. If not specified will use the current uv set if it exists.
Common flags
name(n)	string
Give a name to the resulting node.
constructionHistory(ch)	boolean
Turn the construction history on or off (where applicable). If construction history is on then the corresponding node will be inserted into the history chain for the mesh. If construction history is off then the operation will be performed directly on the object. Note: If the object already has construction history then this flag is ignored and the node will always be inserted into the history chain.
caching(cch)	boolean
Toggle caching for all attributes so that no recomputation is needed
nodeState(nds)	int
Defines how to evaluate the node. 0: Normal 1: PassThrough 2: Blocking 3: Internally disabled. Will return to Normal state when enabled 4: Internally disabled. Will return to PassThrough state when enabled 5: Internally disabled. Will return to Blocking state when enabled

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 have multiple arguments, passed either as a tuple or a list.

Python examples

import maya.cmds as cmds

# Create a plane and select it.
cmds.polyPlane()
cmds.select( 'pPlane1.map[0:65]', r=True )

# Straighten half the border
cmds.polyStraightenUVBorder()