Go to: Synopsis. Return value. Flags. Python examples.

Synopsis

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

Return value

None

In query mode, return type is based on queried flag.

Flags

deleteFaces, exists, extractFaces, extractOffset, image1, image2, image3
Long name (short name) Argument types Properties
deleteFaces(df) boolean createqueryedit
whether to delete the one-half of the cut-faces of the poly. If true, they are deleted.
Default: false
exists(ex) boolean create
Returns true or false depending upon whether the specified object exists. Other flags are ignored.
extractFaces(ef) boolean createqueryedit
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] createqueryedit
The displacement offset of the cut faces.
Default: 0.5, 0.5, 0.5
image1(i1) string createqueryedit
First of three possible icons representing the tool associated with the context.
image2(i2) string createqueryedit
Second of three possible icons representing the tool associated with the context.
image3(i3) string createqueryedit
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.

Python examples

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')