svg2NameTag-Ren/README.md

# svg2nametag-Ren

<p align="center">
  <img src="/pwa-512x512.png" alt="Logo" width="128">
</p>

## 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 (You Are Here)**: A robust command-line interface for bulk-processing entire directories of SVGs on your local machine. Requires basic command line knowledge.
- **Web App (WASM)**: 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