polyStraightenUVBorder

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

Synopsis

polyStraightenUVBorder( selection of UVs , [blendOriginal=float], [constructionHistory=boolean], [curvature=float], [gapTolerance=int], [name=string], [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.

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. In query mode, this flag needs a value.
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. In query mode, this flag needs a value.
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. In query mode, this flag needs a value.
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. In query mode, this flag needs a value.
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. In query mode, this flag needs a value.
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. In query mode, this flag needs a value.

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.

Return value

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()