splice_mesh_at_z
Combine the top geometry from one STL with the bottom geometry from another STL at a specified z-plane, creating a hybrid mesh without boolean operations.
Instructions
Splice two meshes at a z-plane: top from one STL, bottom from another.
Takes geometry ABOVE *z_plane* from *top_path* and geometry BELOW
*z_plane* from *bottom_path*. Triangles crossing the boundary are
clipped cleanly. No boolean ops -- works on non-manifold meshes.
**Use case:** Combine a body with the correct top (e.g. logo from
v5.3) with a body that has the correct bottom (e.g. larger pocket
from v5.4) to create the next design iteration.
:param top_path: STL providing geometry above z_plane.
:param bottom_path: STL providing geometry below z_plane.
:param z_plane: Z height (mm) where the splice happens.
:param output_path: Output STL path. Auto-generated if empty.
:returns: Dict with splice stats and output path.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| z_plane | Yes | ||
| top_path | Yes | ||
| bottom_path | Yes | ||
| output_path | No |