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

Synopsis

nurbsBoolean [-caching boolean] [-constructionHistory boolean] [-name string] [-nodeState int] [-nsrfsInFirstShell int] [-object boolean] [-operation int] [-smartConnection boolean] [-tolerance linear] surface surface

nurbsBoolean is undoable, queryable, and editable.

This command performs a boolean operation.

Return value

string[]Object name and node name

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

Flags

caching, constructionHistory, name, nodeState, nsrfsInFirstShell, object, operation, smartConnection, tolerance
Long name (short name) Argument types Properties
-operation(-op) int createqueryedit
Type of Boolean operation.
Default: 0
-tolerance(-tlb) linear createqueryedit
fitting tolerance.
Default: 0.01
Common flags
-constructionHistory(-ch) boolean create
Turn the construction history on or off.
-name(-n) string create
Sets the name of the newly-created node. If it contains namespace path, the new node will be created under the specified namespace; if the namespace does not exist, it will be created.
-nsrfsInFirstShell(-nsf) int create
The number of selection items comprising the first shell.
-object(-o) boolean create
Create the result, or just the dependency node.
-smartConnection(-sc) boolean create
Look for any of the selection items having a boolean operation as history.
Default is true.
Advanced flags
-caching(-cch) boolean createqueryedit
Modifies the node caching mode. See the node documentation for more information.
Note: For advanced users only.
-nodeState(-nds) int createqueryedit
Modifies the node state. See the node documentation for more information.
Note: For advanced users only.

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

// To do a union between two cubes.
nurbsBoolean -nsf 1 -op 0  nurbsCube1 nurbsCube2;

// To do a subtract between a cube and a sphere.
// i.e cube - sphere
nurbsBoolean -op 1 -nsf 1 nurbsCube1 nurbsSphere1;

// To do an intersect between two spheres.
nurbsBoolean -op 2 -nsf 1 nurbsSphere1 nurbsSphere2;