pymel.core.modeling.polySplit

polySplit(*args, **kwargs)

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:

Long Name / Short Name Argument Types Properties
adjustEdgeFlow / aef float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  The weight value of the edge vertices to be positioned.
constructionHistory / ch bool ../../../_images/create.gif ../../../_images/query.gif
  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.
detachEdges / de bool ../../../_images/create.gif
  Value of the detachEdges attribute for the resulting poly split node.
edgepoint / ep int, float ../../../_images/create.gif
  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 ../../../_images/create.gif
  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.
insertWithEdgeFlow / ief bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  True to enable edge flow. Otherwise, the edge flow is disabled.
insertpoint / ip int, float, float, float ../../../_images/create.gif
  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.
name / n unicode ../../../_images/create.gif
  Sets the name of the newly-created node. If it contains namespace path, the new node will be created under the specified namespace; if the namespace does not exist, it will be created. Flag can have multiple arguments, passed either as a tuple or a list.
projectedCurve / pc PyNode ../../../_images/create.gif
  Curves to be projected.
projectedCurveTolerance / pct float ../../../_images/create.gif
  Tolerance for curve projection.
smoothingangle / sma float ../../../_images/create.gif
  Subdivide new edges will be soft if less then this angle. C: Default is 0.0
subdivision / s int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  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. Common poly creation operation flags

Derived from mel command maya.cmds.polySplit

Example:

import pymel.core as pm

# 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)
pm.polyCreateFacet( p=[(0, 2, 0), (0, -2, 0), (4, -2, 0), (4, 2, 0)] )
pm.polySplit( ip=[(2, 0.1), (3, 0.5), (0, 2, -1, 0.0), (0, 0.9)] )