difference
Booleans · api.md § difference · all operations
definition
difference(a: Solid, b: Solid) -> Solid
Cuts one solid from another. Returns the regularized a ∖ b, where a ∖ b is what a holds and b does not.
Example. Solid 1 is a 10 × 20 × 30 mm box with one corner at the origin. Solid 2 is a cylinder of radius 5 and height 20 on the z axis.
> {"cmd": "difference", "a": 1, "b": 2}
< {"ok": 3}common to booleans
Every boolean returns the regularized set operation, which is the closure of the interior of the set result. The result may be empty. It may also be several pieces, touching as Types allows. Pieces that share an area of boundary are returned as one. The operands are left as they were.
| Function | Fields | Returns |
|---|---|---|
union | a, b | Solid |
intersection | a, b | Solid |
difference | a, b | Solid |
union_all | solids | Solid |
difference_all | target, tools | Solid |