FreeCAD Additive vs Subtractive Primitives

In FreeCAD's Part Design workbench, primitive shapes serve as quick, parametric 3D building blocks that do not require an initial 2D sketch. The core difference between additive and subtractive primitives is their fundamental boolean interaction with an existing model: additive primitives fuse new material to build up a body, while subtractive primitives cut away existing material to create voids, holes, or carved features.

Understanding Additive Primitives

Additive primitives create positive solid volume. Available shapes include the Additive Box, Cylinder, Sphere, Cone, Torus, Prism, and Wedge.

  • Behavior: When added to an active Body, an additive primitive performs a boolean union, merging its geometry seamlessly with any intersecting solids in that body.
  • Base Feature Creation: An additive primitive can be the very first feature in a new Body. If no solid exists yet, the additive primitive forms the base solid upon which subsequent features are built.
  • Common Uses: Creating basic body foundations, adding bosses, mounting posts, or extending geometry without drawing and extruding sketches.

Understanding Subtractive Primitives

Subtractive primitives create negative volume. They mirror the available shapes of additive primitives (Subtractive Box, Cylinder, Sphere, Cone, Torus, Prism, and Wedge), but function in reverse.

  • Behavior: When inserted into an active Body, a subtractive primitive executes a boolean difference, removing any volume where its shape intersects with existing geometry.
  • Dependency on Existing Solids: A subtractive primitive cannot be the first feature in a Body. Because its function is to remove material, it requires an existing solid feature to cut into. Attempting to use a subtractive primitive in an empty body results in an error.
  • Common Uses: Boring holes with a subtractive cylinder, cutting channels with a subtractive box, or carving complex interior cavities without relying on the Pocket or Groove tools.

Key Differences at a Glance

  • Boolean Operation: Additive shapes perform a Union; subtractive shapes perform a Difference.
  • Workflow Order: Additive shapes can initiate a model; subtractive shapes strictly require pre-existing solid mass.
  • Design Intent: Additive shapes increase the mass and outer boundaries of a part; subtractive shapes carve cavities, countersinks, and cutouts to refine the final shape.