Go to: Synopsis. Return value. Related. Flags. Python examples.
polySplit([constructionHistory=boolean], [edgepoint=[int, float]], [facepoint=[int, float, float, float]], [insertpoint=[int, float, float, 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.
In query mode, return type is based on queried flag.
polyAppend, polyAppendVertex, polyBevel, polyChipOff, polyCreateFacet, polyExtrudeEdge, polyExtrudeFacet, polySmooth, polySplitVertex, polySubdivideEdge, polySubdivideFacet, polyTriangulate
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)
|
[int, float, float, 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.
|
|
smoothingangle(sma)
|
angle
|
|
|
Subdivide new edges will be soft if less then this angle.
C: Default is 0.0
|
|
Common flags |
name(n)
|
string
|
|
|
Give a name to the resulting node.
|
|
constructionHistory(ch)
|
boolean
|
|
|
Turn the construction history on or off (where applicable). If
construction history is on then the corresponding node will be
inserted into the history chain for the mesh. If construction history
is off then the operation will be performed directly on the object.
Note: If the object already has construction history then
this flag is ignored and the node will always be inserted into
the history chain.
|
|
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.
|
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)] )