cut_object
Cuts a 3D object along a horizontal or angled plane, keeping both, top, or bottom pieces. Adds optional peg, dowel, or dovetail connectors so cut parts align for gluing.
Instructions
Cut an object with a plane, optionally with connectors that line the pieces up for gluing (like the
connectors of Bambu Studio's Cut tool). keep: both | bottom | top.
The plane is horizontal at height z (mm from the object's bottom), or goes through point [x, y, z] (plate mm,
z above the bed) with normal [nx, ny, nz]: [1, 0, 0] cuts vertically across x, [0.5, 0, 1] is tilted.
place: auto = the lower piece stays as it is and the upper one lies on its cut face; cut_down = both lie on their
cut faces; keep = both as they were.
connector: none | plug (a peg on the piece whose cut face is up, a hole with clearance mm per side in the
other) | dowel (holes in both pieces and a separate pin, added to the plate) | dovetail (a tongue across the
whole cut, along its length, and a slot in the other piece: they slide together from the side).
shape: cylinder | square | hexagon; style: prism | frustum (tapered, centers itself); size: diameter or side in
mm, or the dovetail's narrow width (0 = from the cut); depth: peg, pin or dovetail height (0 = automatic);
count: 0 = one per piece of the cut (two along a long one), N = spread over the cut; positions: [[x, y], ...] or
[[x, y, z]] in plate mm, taken on the plane (for a dovetail: a point on its middle line). Holes keep 2 mm of material from the
edge and get shallower where a piece is thin; connectors that do not fit are listed as skipped.
Modifiers, negative parts and painted colors are kept on the pieces.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| z | No | ||
| keep | No | both | |
| size | No | ||
| count | No | ||
| depth | No | ||
| place | No | auto | |
| point | No | ||
| shape | No | cylinder | |
| style | No | prism | |
| normal | No | ||
| object | Yes | ||
| clearance | No | ||
| connector | No | none | |
| positions | No |