Go to: Synopsis. Flags. Return value. Related. Python examples.
polySplit([constructionHistory=boolean], [edgepoint=[int, float]], [facepoint=[int, float, float, float]], [insertpoint=[string, int, float[]]], [name=string], [smoothingangle=angle], [subdivision=int])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
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.
constructionHistory, edgepoint, facepoint, insertpoint, name, smoothingangle, subdivision
Long name (short name) |
[argument types] |
Properties |
edgepoint(ep)
|
[int, float]
|

|
|
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]
|

|
|
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[]]
|

|
|
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
|
 
|
|
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
|
|
|
Subdivide new edges will be soft if less then this angle.
C: Default is 0.0
|
|
name(n)
|
string
|
|
|
Gives a name to the created node.
|
|
constructionHistory(ch)
|
boolean
|

|
|
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.
|
string The node name.
polyAppend, polyAppendVertex, polyBevel, polyChipOff, polyCreateFacet, polyExtrudeEdge, polyExtrudeFacet, polySmooth, polySplitVertex, polySubdivideEdge, polySubdivideFacet, polyTriangulate
import maya.cmds as cmds
# Note that in Python, you must use the ip/insertpoint flag which determines
# whether you are splitting an edge or a face based on the number of
# arguments to the flag (2 for an edge, and 4 for a face)
cmds.polyCreateFacet( p=[(0, 2, 0), (0, -2, 0), (4, -2, 0), (4, 2, 0)] )
cmds.polySplit( ip=[(2, 0.1), (3, 0.5), (0, 2, -1, 0.0), (0, 0.9)] )