介绍
# image-to-relief-stl
通过将颜色（或灰度）映射到高度，从输入图像生成一个**水密、可打印的 STL** 文件。
这是一个对编排器友好的工作流： - 使用 **nano-banana-pro**（或任何图像模型）生成一张**纯色**图像。 - 运行此技能将其转换为**浅浮雕**模型。
## 实用约束（以确保良好效果）
要求图像模型提供： - **恰好 N 种纯色**（无渐变） - **无阴影 / 无抗锯齿** - 具有清晰边缘的粗犷形状
这可以确保分割的可靠性。
## 快速开始（给定一张图像）
```bash bash scripts/image_to_relief.sh input.png --out out.stl \ --mode palette \ --palette '#000000=3.0,#ffffff=0.0' \ --base 1.5 \ --pixel 0.4 ```
### 灰度模式
```bash bash scripts/image_to_relief.sh input.png --out out.stl \ --mode grayscale \ --min-height 0.0 \ --max-height 3.0 \ --base 1.5 \ --pixel 0.4 ```
## 输出
- `out.stl`（ASCII STL 格式） - 可选的 `out-preview.svg`（通过 potrace 生成的矢量预览；尽力而为）
## 说明
- 此 v0 版本使用**光栅高度场**网格化方法（稳健，无重型 CAD 依赖）。 - `--pixel` 参数控制分辨率（数值越小 = 细节越高，STL 文件越大）。