Element

Subtraction Operation

Boolean subtraction for complex geometry

Overview

The Subtraction operation allows you to create complex shapes by subtracting one 3D object (the tool) from another (the target). This is useful for creating holes, cutouts, and other negative space features in your 3D models.

Key Features

  • Create holes and cutouts in solid objects
  • Reference other objects as tools
  • Build complex geometry from simple primitives
  • Chain multiple subtractions for intricate designs

How It Works

The subtraction operation takes two objects:

  • Target: The object to subtract from
  • Tool: The object used for subtraction (the shape being "cut out")

The result is the target object with the volume of the tool removed from it.

Parameters

Configure your subtraction operation.

Parameter Description Example
target Reference to the object to subtract from cube1
tool Reference to the object used for subtraction cylinder1

Object References

Both target and tool parameters reference other objects in your scene by their name. The referenced objects must be defined before the subtraction operation.

Usage Example

Create a cube with a cylindrical hole.

Step 1: Create the Target Object

First, create the object you want to cut from:

Name Type Width Length Height Material
cube1 cube 100 100 100 #445566

Step 2: Create the Tool Object

Then, create the object that will be "cut out":

Name Type Radius Height Material
cylinder1 cylinder 20 150 #FF0000

Position the cylinder so it intersects with the cube where you want the hole.

Step 3: Apply Subtraction

Type Target Tool
subtraction cube1 cylinder1

This creates a cylindrical hole through the cube.

Best Practices

Tips for working with boolean subtraction.

Recommendations

  • Ensure the tool object intersects with the target object
  • Position the tool object precisely before subtraction
  • Use appropriate sizes for both objects
  • Consider the order of multiple subtractions
  • Keep track of object references

Common Applications

  • Creating holes for bolts and screws
  • Making cutouts in panels
  • Creating complex architectural features
  • Designing mechanical parts with cavities
  • Making slots and grooves

Tips for Complex Operations

  • Plan your subtractions in advance
  • Use simple shapes for subtraction tools when possible
  • Consider using multiple subtractions for complex shapes
  • Test subtractions with simple shapes first
  • Keep track of object hierarchies

Performance Considerations

  • Complex subtractions may impact rendering performance
  • Use the minimum necessary geometry complexity
  • Consider combining multiple subtractions when possible
  • Optimize tool shapes for better performance

Common Issues and Solutions

Solutions to frequently encountered problems.

No visible effect after subtraction

Verify that the tool object intersects with the target object. If the tool is completely outside the target, no subtraction will occur.

Unexpected results

Check the positioning and orientation of both objects. Make sure the tool is in the correct position and the references point to the right objects.

Reference errors

Ensure both target and tool objects exist and are correctly named. Object names are case-sensitive.

Ready to build?

Start creating complex shapes

Get Started