BooleanUnion

Toolbar Menu

Main
Main2
Solid Tools

Solid

Union

 History enabled

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

Steps

  • Select the objects and press Enter.

    The objects combine into one polysurface.

Command-line options

DeleteInput

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

 History enabled

DeleteInput=No supports History recording.

BooleanDifference

Toolbar Menu

Solid Tools

Solid

Difference

 History enabled

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

Steps

  1. Select surfaces or polysurfaces to subtract from, and press Enter.

  2. Select surfaces or polysurfaces to subtract with, and press Enter.

Command-line options

DeleteInput

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

 History enabled

DeleteInput=No supports History recording.

DeleteCutters

When DeleteInput=Yes, deletes the object used to subtract the other 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.

BooleanIntersection

Toolbar Menu

Solid Tools

Solid

Intersection

 History enabled

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

Steps

  1. Select the first set of objects or a set of intersecting objects and press Enter.

  2. If a first set of objects was selected, select the second set of objects and press Enter.

DeleteInput

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

 History enabled

DeleteInput=No supports History recording.

BooleanSplit

Toolbar Menu

Solid Tools

Solid

Boolean Split

 History enabled

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

Steps

  1. Select the first set of objects and press Enter.

  2. Select the cutting objects and press Enter.
    The cutting objects and the objects to split can be the same objects.

Command-line options

DeleteInput

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

 History enabled

DeleteInput=No supports History recording.

Boolean2Objects

Toolbar Menu

Solid Tools

Solid

Boolean Two Objects

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

Steps

  1. Select two objects.

  2. Click the mouse in the viewport until you get the object you want.

    Union

    Difference A - B

    Difference B - A

    Intersection

    Inverse intersection

Command-line options

DeleteInput

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

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.

PlanarUnion

Toolbar

Menu

Planar Booleans

Surface Tools

Surface

Planar Boolean

The PlanarUnion command merges overlapped planar surfaces into a single surface.

PlanarDifference

Toolbar

Menu

Planar Booleans

Surface

Planar Boolean

The PlanarDifference command selects two overlapped planar surfaces and creates a surface from the first surface with the overlapped area trimmed off.

PlanarIntersection

Toolbar

Menu

Planar Booleans

Surface

Planar Boolean

The PlanarIntersection command creates a surface from the overlapped area of two planar surfaces.

See also

Rhino Wiki: Boolean FAQ

Boolean objects