Boolean 3D geometry

Performs boolean operations on 3D geometry.

Inputs

• geometry

  • Accepts multiple geometry connections.

• operation type

  • Sets the type of boolean operation to perform on input geometry. This can be: Union, Subtraction, Reverse subtraction, Intersection, or XOR.

• weld

  • Sets whether to pre-weld input geometry or not.

Outputs

• geometry

  • Output primitives.

• points

  • The list of points of the output primitives.

• points.x

  • The list of x values of the points of the output primitives.

• points.y

  • The list of y values of the points of the output primitives.

• points.z

  • The list of z values of the points of the output primitives.

Note(s)

• This node specifically operates on PolyMesh type primitives. Therefore there are a couple things to keep in mind to get consistent results when using this node:

  • Avoid coplanar faces

    • Specifically this means geometry that is being operated on has faces that are within the same plane as each other (one example may be when unioning two boxes that have been aligned directly next to each other, where one side of each box touches a side of another). Often stretching an input geometry (with either the transform or smart size nodes) so that there is a clear overlap, can help with more consistent behavior.

  • Edges and vertices,

    • A mesh 3D boolean operation utilizes vertices and edges of input meshes to perform operations. Therefore, it is often useful to pay attention to where particular geometries are positioned. Say for example we have a box that is subtracting from another box where the position of the subtracting box is positioned so that it lies directly in the middle of a triangle of the first box's mesh. In this instance, there are no intersecting edges or vertices of either mesh, thus making it difficult to calculate consistently.

• This node is a destructive operation.

• Other names for this node include: MeshBoolean, Mesh boolean, 3D boolean, and CSG.

Example(s)

• Boolean 3D geometry