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

Synopsis

polySplit [-constructionHistory boolean] [-edgepoint int float] [-facepoint int float float float] [-insertpoint string int float[]] [-name string] [-smoothingangle angle] [-subdivision int]

polySplit is undoable, queryable, and editable.

Split facets/edges of a polygonal object. The first and last arguments must be edges. Intermediate points may lie on either a shared face or an edge which neighbors the previous point.

Flags

constructionHistory, edgepoint, facepoint, insertpoint, name, smoothingangle, subdivision
Long name (short name) [argument types] Properties
-edgepoint(-ep) int float createmultiuse
The given edge is split into two new edges by inserting a new vertex located the given percentage along the edge. Note: this flag is not recommended for use from Python. See the insertpoint flag instead.
-facepoint(-fp) int float float float createmultiuse
A new vertex is inserted, lying at the given coordinates inside the given face. Coordinates are given in the local object space. Note: this flag is not recommended for use from Python. See the insertpoint flag instead.
-insertpoint(-ip) string int float[] createmultiuse
This flag allows the caller to insert a new vertex into an edge or a face. To insert a new vertex in an edge, pass the index of the edge and a percentage along the edge at which to insert the new vertex. When used to insert a vertex into an edge, this flag takes two arguments. To insert a new vertex into a face, pass the index of the face and three values which define the coordinates for the insertion in local object space. When used to insert a vertex into a face, this flag takes four arguments. This flag replaces the edgepoint and facepoint flags.
-subdivision(-s) int createqueryedit
Subdivide new edges into the given number of sections. Edges involving free points won't be subdivided.
C: Default is 1 (no subdivision).
Q: When queried, this flag returns an int.

In query mode, this flag needs a value.
-smoothingangle(-sma) angle create
Subdivide new edges will be soft if less then this angle.
C: Default is 0.0
-name(-n) string create
Gives a name to the created node.
-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 be used more than once in a command

Return value


string The node name.

Related

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

MEL examples

polyCreateFacet -p 0 2 0 -p 0 -2 0 -p 4 -2 0 -p 4 2 0;
polySplit -ep 2 0.1 -ep 3 0.5 -fp 0 2 -1 0.0 -ep 0 0.9;