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

Synopsis

polyCutCtx [-deleteFaces boolean] [-exists] [-extractFaces boolean] [-extractOffset linear linear linear] [-image1 string] [-image2 string] [-image3 string]

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) 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 be used more than once in a command.

MEL examples

// Create a poly plane
polyPlane -w 10 -h 10 -sx 1 -sy 1 -n pPlane1;

// Create a new cut facets context, then switch to it
polyCutCtx polyCutCtx1;
setToolTo polyCutCtx1;