polyBooleanCmd

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

Synopsis

polyBooleanCmd [-addMesh name] [-changeSmoothMesh name boolean] [-classification int] [-interactiveUpdate boolean] [-newInputDisplay int] [-newInputOperation int] [-operation int] [-removeMesh name] [-reorderMesh name int]

polyBooleanCmd is undoable, queryable, and editable.

Return value

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

Related

Flags

Long name (short name)	Argument types	Properties
-addMesh(-am)	name
Add a new mesh to the boolean stack.
-changeSmoothMesh(-csm)	name boolean
Set one of the inputs to use a smoothed version of the mesh.
-classification(-cls)	int
Changes how intersections of open and closed manifolds are treated. 1 = Edge. 2 = Normal. 3 = Auto
-interactiveUpdate(-iu)	boolean
Changes how interactive manipulation of input meshes trigger updates of the boolean node. If true, will trigger compute while dragging a manipulator. If false, will not trigger a compute until the manipulator is released.
-newInputDisplay(-nid)	int
Default display mode to apply to new inputs. 0 = Wireframe. 1 = Shaded. 2 = Bounding Box. 3 = X-Ray. 4 = Hidden.
-newInputOperation(-nio)	int
Default boolean operation to apply to new inputs if not specified. Values are: 1=Union, 2=Difference A-B, 3=Intersection, 4=Difference B-A, 5=Split, 6=Split Edges, 7=Hole Punch, 8=Cut Out
-operation(-op)	int
Specifies the boolean operation to run. Values are: 1=Union, 2=Difference A-B, 3=Intersection, 4=Difference B-A, 5=Split, 6=Split Edges, 7=Hole Punch, 8=Cut Out
-removeMesh(-rm)	name
Remove a mesh from the boolean stack.
-reorderMesh(-rom)	name int
Change the position of a mesh in the boolean stack to a specific index.

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 few objects
polyTorus;
polySphere;
polyCube;

// Diff A-B boolean between the torus and sphere
polyBooleanCmd -operation 2 pTorus1 pSphere1;

// Now add the cube to the existing boolean as a Union
polyBooleanCmd -edit -addMesh pCube1 -operation 1 polyBoolean1;