Go to: Related nodes. Attributes.

Split faces and edges of a polygonal object. New vertices can be inserted along existing edges or placed as free points within existing faces. First and last new points must lie on existing edges.

Node nameParentsClassificationMFn typeCompatible function sets
polySplitpolyModifiergeometrykPolySplitkBase
kNamedObject
kDependencyNode
kMidModifier
kPolySplit

Related nodes

polyTweak, polyTweakUV, polyMapCut, polyMapDel, polyMapSew, polyNormal, polyMoveUV, polyMoveFacetUV, polyFlipEdge, polySmoothFace, polySmooth, polyReduce, polyDelFacet, polyDelVertex, polyMergeFace, polyAppendVertex, polySubdFace, polyCollapseF, polyCloseBorder, polyAppend, polyCollapseEdge, polyTriangulate, polyDelEdge, polyMergeEdge, polyColorPerVertex, polyNormalPerVertex, deleteUVSet, polySeparate

Attributes (23)

adjustEdgeFlow, baryCoord, baryCoord1, baryCoord2, baryCoord3, clean2Verts, desc, detachEdges, edge, face, insertWithEdgeFlow, maya2015, maya70, projectedCurveTolerance, smoothingAngle, splitPoint, splitPoints, subdivision, triangle, vertices, vtxx, vtxy, vtxz

Long name (short name)TypeDefaultFlags
adjustEdgeFlow (aef) float1.0foutputinputconnectablestorablekeyable
The weight value of the edge vertices to be positioned.
clean2Verts (c2v) boolboolfalseoutputinputconnectablestorablehidden
If true, the valence two vertices along the cut line will be deleted after the operation completes.
desc (d) integer0arrayoutputinputconnectablestorable
Array (multi-attribute) of descriptors indicating whether the new point to be inserted should be placed on an existing edge or inside a face (as a free point). If a free point, the desc value for that index will be the face number. If the new point is to be on an existing edge, the desc value will be the edge number bitwise ANDed with either 0x40000000 for a hole border edge or 0x80000000 otherwise.
detachEdges (de) boolboolfalseoutputinputconnectablestorable
If true, and the split has been done using the splitPoint attribute, then a detach edge operation will be run on the resulting new edges.
edge (e) float0.0arrayoutputinputconnectablestorablekeyable
Array (multi-attribute) of edge distance ratios used to create new points on existing edges. Range of edge values is [0.0, 1.0]. A value of 0 puts the new point at the start of the edge, 1 specifies the new point should go at the endpoint. This array has the same size as the desc array. A free point index in desc will correspond with a -1.0 edge value for that index.
insertWithEdgeFlow (ief) boolfalseoutputinputconnectablestorablekeyable
True to enable edge flow. Otherwise, the edge flow is disabled.
maya2015 (m2015) boolfalseoutputinputstorablehidden
Enable Maya 2015 behaviour. This attribute is not meant to be modified through command line.
maya70 (m70) booltrueoutputinputstorablehidden
Enable Maya 7.0 behaviour. This attribute is not meant to be modified through command line.
projectedCurveTolerance (pct) float0.0001foutputinputconnectablestorable
Tolerance to use when spliting with a projected curve.
smoothingAngle (sma) angle (double)0.0degoutputinputconnectablestorable
Angle below which new edges will be smoothed
splitPoints (sps) compoundn/aarrayoutputinputconnectablestorable
Each entry is a set of connected split points.
splitPoint (sp) compoundn/aarrayoutputinputconnectablestorable
contains a face id, triangle within the face, and the barycentric coordinates within the triangle of a new vertex position.
face (f) integer0outputinputconnectablestorable
face id of a split point
triangle (t) integer0outputinputconnectablestorable
which triangle within the face
baryCoord (bc) double3outputinputconnectablestorable
barycentric coordinate within the triangle of the point to be split
baryCoord1 (bc1) distance (double)0.0cmoutputinputconnectablestorable
First bary coord
baryCoord2 (bc2) distance (double)0.0cmoutputinputconnectablestorable
Second bary coord
baryCoord3 (bc3) distance (double)0.0cmoutputinputconnectablestorable
Third bary coord
subdivision (s) integer1outputinputconnectablestorablekeyable
Edge subdivision. New edges for which both vertices lie on existing edges will have this many subdivisions. New edges involving free points are not subdivided.
vertices (v) float3arrayoutputinputconnectablestorable
Array (multi-attribute) of new free vertices (used to create a new point in a face). The order of the array corresponds to the order of the free points, but is not the same size and does not line up with the desc array (it only contains entries for free points).
vtxx (vx) distance (float)0.0cmoutputinputconnectablekeyable
New vertex x coord
vtxy (vy) distance (float)0.0cmoutputinputconnectablekeyable
New vertex y coord
vtxz (vz) distance (float)0.0cmoutputinputconnectablekeyable
New vertex z coord