Go to: Synopsis. Return value. Flags. Python examples.
polyAppendFacetCtx([append=boolean], [exists=boolean], [image1=string], [image2=string], [image3=string], [isRotateAvailable=boolean], [maximumNumberOfPoints=int], [planarConstraint=boolean], [rotate=float], [subdivision=int], [texture=int])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
polyAppendFacetCtx is undoable, queryable, and editable.
Create a new context to append facets on polygonal objects
None
In query mode, return type is based on queried flag.
append, exists, image1, image2, image3, isRotateAvailable, maximumNumberOfPoints, planarConstraint, rotate, subdivision, texture
| Long name (short name) |
Argument types |
Properties |
|
append(ap)
|
boolean
|
  
|
|
Allows to switch to polyCreateFacetCtx tool
|
|
exists(ex)
|
boolean
|
|
|
Returns true or false depending upon whether the
specified object exists. Other flags are ignored.
|
|
image1(i1)
|
string
|
|
|
First of three possible icons representing the tool
associated with the context.
|
|
image2(i2)
|
string
|
|
|
Second of three possible icons representing the tool
associated with the context.
|
|
image3(i3)
|
string
|
|
|
Third of three possible icons representing the tool
associated with the context.
|
|
isRotateAvailable(isr)
|
boolean
|
|
|
Tells if the control associated to rotate flag is available.
If several edges are already selected and they are not aligned
(thus there is no "rotation axis") the rotation is no longer available.
|
|
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.
|
|
planarConstraint(pc)
|
boolean
|
|
|
Allows/avoid new facet to be non-planar.
If on, all new points will be projected onto
current facet plane. Selected edges will be checked as well.
|
|
rotate(r)
|
float
|
|
|
Rotate current facet around the first edge selected.
|
|
subdivision(s)
|
int
|
|
|
Number of sub-edges created for each new edge. Default is 1.
|
|
texture(tx)
|
int
|
|
|
Number of textures. Default is 1.
|
|
|
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 poly plane
cmds.polyPlane(w=10, h=10, sx=10, sy=10, n='pPlane1')
# Create a new poly append facet context, set it to add four vertices per new edge, and then switch to it
cmds.polyAppendFacetCtx('polyAppendFacetCtx1', s=4)
cmds.setToolTo('polyAppendFacetCtx1')