Go to: Return value. Related commands. Flags. Examples.

Synopsis

polySplit [flags]

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.

Return value

string The node name.

Related commands

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

Flags

constructionHistory, edgepoint, facepoint, name, smoothingangle, subdivision

Long name (short name)[argument types]Properties
-edgepoint (-ep) int floatcreatemultiuse
The given edge is split into two new edges by inserting a new vertex located the given percentage along the edge.
-facepoint (-fp) int float float floatcreatemultiuse
A new vertex is inserted, lying at the given coordinates inside the given face. Coordinates are given in the local object space.
-subdivision (-s) intquerycreateedit
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.
-smoothingangle (-sma) anglecreate
Subdivide new edges will be soft if less then this angle.
C: Default is 0.0

Common flags

-name (-n) stringcreate
Gives a name to the created node.
-constructionHistory (-ch) booleanquerycreate
Turn the construction history on or off (where applicable).
Q: When queried, this flag returns an int.
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

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;