pymel.core.context.polySplitCtx

static context.polySplitCtx(*args, **kwargs)

Create a new context to split facets on polygonal objects In query mode, return type is based on queried flag.

Flags:
Long name (short name) Argument Types Properties
enablesnap (es) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Enable/disable custom magnet snapping to start/middle/end of edge
exists (ex) bool  
   
image1 (i1) unicode  
   
image2 (i2) unicode  
   
image3 (i3) unicode  
   
magnetsnap (ms) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
number of extra magnets to snap onto, regularly spaced along the edge
precsnap (ps) float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
precision for custom magnet snapping. Range[0,100]. Value 100 means any click on an edge will snap to either extremities or magnets.
smoothingangle (sma) float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

the threshold that controls whether newly created edges are hard or soft Flag can have multiple arguments, passed either as a tuple or a list.

snaptoedge (ste) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

Enable/disable snapping to edge. If enabled any click in the current face will snap to the closest valid edge. If there is no valid edge, the click will be ignored. NOTE: This is different from magnet snapping, which causes the click to snap to certain points along the edge.

subdivision (s) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
number of sub-edges to add between 2 consecutive edge points. Default is 1.

Derived from mel command maya.cmds.polySplitCtx

Example:

import pymel.core as pm

# Create a poly plane
pm.polyPlane(w=10, h=10, sx=1, sy=1, n='pPlane1')

# Create a new poly split context, then switch to it
pm.polySplitCtx('polySplitCtx1')
pm.setToolTo('polySplitCtx1')

Previous topic

pymel.core.context.polySlideEdgeCtx

Next topic

pymel.core.context.polySuperCtx

Core

Core Modules

Other Modules

This Page