pymel.core.context.polyCreateFacetCtx

polyCreateFacetCtx(*args, **kwargs)

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

Flags:

Long Name / Short Name Argument Types Properties
append / ap bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Allows to switch to polyAppendFacetCtx tool
exists / ex bool  
   
image1 / i1 unicode  
   
image2 / i2 unicode  
   
image3 / i3 unicode  
   
maximumNumberOfPoints / mp int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Allows the ability to set a upper bound on the number of points in interactively place before polygon is created. A value less than 2 will mean that there is no upper bound.
planarConstraint / pc bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  allows/avoid new facet to be non-planar. If on, all new points will be projected onto current facet plane.
subdivision / s int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  number of sub-edges created for each new edge. Default is 1. Flag can have multiple arguments, passed either as a tuple or a list.
texture / tx int  
   

Derived from mel command maya.cmds.polyCreateFacetCtx

Example:

import pymel.core as pm

# Create a new poly facet create context, set it to add four vertices per new edge, then switch to it
pm.polyCreateFacetCtx('polyCreateFacetCtx1', s=4)
pm.setToolTo('polyCreateFacetCtx1')