svg2NameTag-Ren/README.md

svg2nametag-Ren

Overview

svg2nametag-Ren is a specialized toolset designed to convert 2D SVG designs into 3D printable nametag models (STL). It specifically handles multi-material or multi-color 3D prints by automatically separating SVG layers into distinct STL files optimized for Bambu Studio, OrcaSlicer, or PrusaSlicer.

The project offers two primary ways to work:

• Python CLI: A robust command-line interface for bulk-processing entire directories of SVGs on your local machine. Requires basic command line knowledge.
• Web App (WASM) (You Are Here): A high-performance, client-side web application powered by Manifold 3D. It runs entirely in the browser, supports batch folder uploads, and works offline as a PWA.

Technical Specifications

Every model produced by the converter follows a precise set of dimensions to ensure consistency and professional-grade print results:

• Automatic Scaling: All nametags are normalized to a standard width of 87.80mm, or 150% scale.
• Background Layer: The background is set to a thickness of 3.0mm.
• Text/Graphic Layers: Primary and accent layers are extruded to a height of 2.0mm.
• Optimized Offsets: Text layers are offset by 3.0mm along the Z-axis, ensuring they sit perfectly on top of the background. (They end up at a coords 4mm.)
• Hole Handling: Implements a robust Even-Odd fill rule to correctly render internal contours in complex typography (e.g., the centers of 'B', 'O', or 'R').
• Layer Classification: Recognizes SVG classes (st1, st2) to split designs into separate STL components for easy filament assignment.
• Relatively Low Poly Count Won't explode your slicer