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

Synopsis

polyTriangulate([constructionHistory=boolean], [name=string])

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

polyTriangulate is undoable, queryable, and editable.

Triangulation breaks polygons down into triangles, ensuring that all faces are planar and non-holed. Triangulation of models can be beneficial in many areas.

Flags

constructionHistory, name
Long name (short name) [argument types] Properties
name(n) string create
Name the resulting object.
constructionHistory(ch) boolean createquery
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


string The node name.

Related

polyAppend, polyAppendVertex, polyBevel, polyChipOff, polyCreateFacet, polyExtrudeEdge, polyExtrudeFacet, polySmooth, polySplit, polySplitVertex, polySubdivideEdge, polySubdivideFacet

Python examples

import maya.cmds as cmds

#<I>non-planar faces</I>
cmds.polyPlane( n='plg1', sx=5, sy=5, w=5, h=5 )
cmds.move( -6, 0, 0 )
cmds.polyMoveVertex( 'plg1.vtx[7]', 'plg1.vtx[10]', 'plg1.vtx[25]', 'plg1.vtx[28]', ltz=1 )
cmds.polyTriangulate( 'plg1.f[0:1]', 'plg1.f[5:6]', 'plg1.f[3:4]', 'plg1.f[8:9]', 'plg1.f[15:16]', 'plg1.f[20:21]', 'plg1.f[18:19]', 'plg1.f[23:24]' )

#<I>holed faces</I>
maya.cmds.polyCreateFacet( p=[(2.5, 0, 2.5), (2.5, 0, -2.5), (-2.5, 0, -2.5), (-2.5, 0, 2.5), (), (1, 0, -1), (-1, 0, -1), (-1, 0, 1), (1, 0, 1)],  n='plg2' )
cmds.polyTriangulate( 'plg2.f[0]' )

#<I>both holed and non-planar facets</I>
cmds.polyPlane( n='plg3', sx=3, sy=3, h=5, w=5 )
cmds.move( 6, 0, 0 )
cmds.polyChipOff( 'plg3.f[4]', dup=1, ltz=1, ls=(.25, .25, .25) )
cmds.polyMergeFacet( 'plg3', ch=True, ff=4, sf=9 )
cmds.polyTriangulate( 'plg3.f[4]' )