Go to: Synopsis. Return value. Flags. Python examples.
polyCreateFacetCtx([append=boolean], [maximumNumberOfPoints=int],
[planarConstraint=boolean],
[subdivision=int])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
polyCreateFacetCtx is undoable, queryable, and editable.
Create a new context to create polygonal objects
None
In query mode, return type is based on queried flag.
append, maximumNumberOfPoints, planarConstraint, subdivision
| Long name (short name) |
Argument types |
Properties |
subdivision(s) |
int |
   |
|
number of sub-edges created for each new edge. Default is
1. |
|
planarConstraint(pc) |
boolean |
|
|
allows/avoid new facet to be non-planar.
If on, all new points will be projected onto current facet
plane. |
|
append(ap) |
boolean |
|
|
Allows to switch to polyAppendFacetCtx tool |
|
maximumNumberOfPoints(mp) |
int |
|
|
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. |
|
| 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
# Create a new poly facet create context, set it to add four vertices per new edge, then switch to it
cmds.polyCreateFacetCtx('polyCreateFacetCtx1', s=4)
cmds.setToolTo('polyCreateFacetCtx1')