BooleanUnion

Toolbar	Menu
Main Main2 Solid Tools	Solid Union

The BooleanUnion command trims the shared areas of selected polysurfaces or surfaces and creates a single polysurface from the unshared areas.

Toolbar	Menu
Solid Tools	Solid Difference

The BooleanDifference command trims the shared areas of selected polysurfaces or surfaces with another set of polysurfaces or surfaces.

Command-line options

DeleteInput

Deletes (Yes) or keeps (No) the input object.

Rhino is a surface modeler. It's not possible to subtract a sphere inside another sphere to create a tennis ball-like object that has a solid wall enclosing a void.

Toolbar	Menu
Solid Tools	Solid Intersection

 History enabled

The BooleanIntersection command trims the unshared areas of selected polysurfaces or surfaces.

Toolbar	Menu
Solid Tools	Solid Boolean Split

The BooleanSplit command splits shared areas of selected polysurfaces or surfaces and creates separate polysurfaces from the shared and unshared parts.

Command-line options

DeleteInput

Deletes (Yes) or keeps (No) the input object.

Toolbar	Menu
Solid Tools	Solid Boolean Two Objects

The Boolean2Objects command cycles through possible Boolean operations between two objects with mouse clicks.

Command-line options

DeleteInput

Deletes (Yes) or keeps (No) the input object.

Troubleshoot Boolean Operations

If the Boolean operation fails, text dots that indicate the area where there is a naked edge or a bad intersection are placed in the model. Search for these dots to examine the area causing the problem.

Detailed information about the error is contained in the dot properties under Secondary text.

Boolean commands can be used with surfaces and open polysurfaces. The result depends on the direction of the normals of the object. Use the Dir command to see the direction. If the results are the opposite of what you want, reverse the direction of the surface with the Dir or Flip commands and try again.

Try the Join command first on surfaces.

For mesh objects the steps are the same as for the NURBS Boolean equivalent. The result of a command is always a mesh regardless of the input object type.

What makes Boolean operations fail?

Boolean operations can fail for a number of reasons:

• Normals may not point the way you expect.
• Control points tend to stack up at the intersection of the two objects.
• Objects may have overlapping surface areas.

Surface Normals

The Boolean operations use the surface normal to determine which parts to keep and which to throw away. When you attempt a BooleanDifference and you get a BooleanUnion instead, or vice versa, this is because the objects have normals that are the opposite of what you expect. This tends to happen often if one or more objects are not fully closed. If an object is not closed, Rhino has no way to determine which side is outside and which is inside. Use the Dir command to see which way the normals point on these objects and use the Flip option as needed to make sure the normal direction is what you consider to be the outside of the object. Fully closed objects will always have normals pointing outward.

Coincident Control Points

Coincident control points occur when the control points at the edge of a surface are at an identical location. For example, the tip of a cone or an untrimmed surface with three edges, or the pole of a sphere. You can also move control points to the same location. This point is also called a singularity.

When a singularity point occurs at the intersection of two objects you want to Boolean, the operation can fail.

Overlapping Surface Area

Overlapping surface areas occur when two surfaces share the same area. In this example, the two boxes are just touching along one side. The objects will Union, but Difference, and Intersection will not work.

Nonmanifold edges

In addition to overlapping surfaces, non-manifold edges can also cause failures.

Edges of polysurfaces or meshes that have more than two faces joined to a single edge are non-manifold.

What to do

If your objects won't Boolean, you can use other techniques to get the results you want.

In this example, the apex of the cone is exactly at the corner of the box. This is one of the situations that can cause the Boolean operations to fail.

Instead of using Boolean operations in this case, use the Explode command to separate polysurfaces into single surfaces if necessary. Use the Intersect command to create curves that represent the intersection of the two surfaces. To create the parts, use these curves to Trim and/or Split and then Join them back together.

See also

Rhino Wiki: Boolean FAQ

Boolean objects