Go to: Synopsis. Return value. Flags. Python examples.
nurbsBoolean(
surface surface
, [caching=boolean], [constructionHistory=boolean], [name=string], [nodeState=int], [nsrfsInFirstShell=int], [object=boolean], [operation=int], [smartConnection=boolean], [tolerance=linear])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
nurbsBoolean is undoable, queryable, and editable.
This command performs a boolean operation.
| string[] | Object name and node name |
In query mode, return type is based on queried flag.
caching, constructionHistory, name, nodeState, nsrfsInFirstShell, object, operation, smartConnection, tolerance
| Long name (short name) |
Argument types |
Properties |
|
operation(op)
|
int
|
  
|
|
Type of Boolean operation.
Default: 0
|
|
tolerance(tlb)
|
linear
|
|
|
fitting tolerance.
Default: 0.01
|
|
| Common flags |
constructionHistory(ch)
|
boolean
|
|
|
Turn the construction history on or off.
|
|
name(n)
|
string
|
|
|
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
|
|
|
The number of selection items comprising the first shell.
|
|
object(o)
|
boolean
|
|
|
Create the result, or just the dependency node.
|
|
smartConnection(sc)
|
boolean
|
|
|
Look for any of the selection items having a boolean operation as
history.
Default is true.
|
|
| Advanced flags |
caching(cch)
|
boolean
|
|
|
Modifies the node caching mode. See the node documentation for more information.
Note: For advanced users only.
|
|
nodeState(nds)
|
int
|
|
|
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 have multiple arguments, passed either as a tuple or a list.
|
import maya.cmds as cmds
# To do a union between two cubes.
cmds.nurbsBoolean( 'nurbsCube1', 'nurbsCube2', nsf=1, op=0 )
# To do a subtract between a cube and a sphere.
# i.e cube - sphere
cmds.nurbsBoolean( 'nurbsCube1', 'nurbsSphere1', op=1, nsf=1 )
# To do an intersect between two spheres.
cmds.nurbsBoolean( 'nurbsSphere1', 'nurbsSphere2', op=2, nsf=1 )