Go to: Synopsis. Return value. Flags. Python examples.
polyCutCtx([deleteFaces=boolean], [exists=boolean], [extractFaces=boolean], [extractOffset=[linear, linear, linear]], [image1=string], [image2=string], [image3=string])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
polyCutCtx is undoable, queryable, and editable.
Create a new context to cut facets on polygonal objects
None
In query mode, return type is based on queried flag.
deleteFaces, exists, extractFaces, extractOffset, image1, image2, image3
Long name (short name) |
Argument types |
Properties |
|
deleteFaces(df)
|
boolean
|
|
|
whether to delete the one-half of the cut-faces
of the poly. If true, they are deleted.
Default: false
|
|
exists(ex)
|
boolean
|
|
|
Returns true or false depending upon whether the
specified object exists. Other flags are ignored.
|
|
extractFaces(ef)
|
boolean
|
|
|
whether to extract the cut-faces of the poly
into a separate shell. If true, they are extracted.
Default: false
|
|
extractOffset(eo)
|
[linear, linear, linear]
|
|
|
The displacement offset of the cut faces.
Default: 0.5, 0.5, 0.5
|
|
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.
|
|
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=1, sy=1, n='pPlane1')
# Create a new cut facets context, then switch to it
cmds.polyCutCtx('polyCutCtx1')
cmds.setToolTo('polyCutCtx1')