Boolean

Status: Implemented

Boolean combines existing solids. Face names carry through to the result, so downstream selections survive.

Walkthrough

Inputs

• id – a string, default null.
• targetSolid – a single (multiple: false) reference_selection filtered to SOLID, default null. It supplies the base body.
• boolean – a boolean_operation, default { targets: [], operation: "UNION", mergeCoplanarFaces: true }. Its targets are the tool solids (duplicates are ignored); operation accepts UNION, SUBTRACT, or INTERSECT, while NONE leaves the scene unchanged; mergeCoplanarFaces controls merging adjacent coplanar result faces.

Behaviour

• UNION and INTERSECT treat the target as the base body. Their result takes the first tool's name; SUBTRACT's result keeps the target's name.
• SUBTRACT unions all tool solids first, then removes that volume from the target.
• The target and every tool are removed; only the result remains.
• A missing target or tool is reported as unresolved. The operation proceeds when the target and at least one tool resolve; unresolved extra tools are skipped.