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


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.

Move border UVs along a simple curve.

Return value

stringThe node name

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


blendOriginal, caching, constructionHistory, curvature, gapTolerance, name, nodeState, preserveLength, uvSetName
Long name (short name) Argument types Properties
curvature(c) float createquery
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 createquery
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 createquery
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 createquery
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 createquery
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 create
Give a name to the resulting node.
constructionHistory(ch) boolean createquery
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 createedit
Toggle caching for all attributes so that no recomputation is needed
nodeState(nds) int createqueryedit
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.select( 'pPlane1.map[0:65]', r=True )

# Straighten half the border