image-to-relief-stl图像转浮雕STL

Turn a source image (or multi-color mask image) into a 3D-printable bas-relief STL by mapping colors (or grayscale) to heights. Use when you have an image from an image-gen skill (nano-banana-pro, etc.) and want a real, printable model (STL) via a deterministic pipeline.

作者: admin | 来源: ClawHub

image-to-relief-stl

通过将颜色（或灰度）映射为高度，从输入图像生成防水、可打印的STL文件。

这是一个适合编排器的工作流程：

- 使用 nano-banana-pro（或任何图像模型）生成纯色图像。
运行此技能将其转换为浅浮雕模型。

实用约束（以确保良好效果）

要求图像模型具备：

- 恰好N种纯色（无渐变）
无阴影/无抗锯齿
边缘清晰的粗体形状

这样可确保分割的可靠性。

快速开始（给定图像）

bash
bash scripts/imagetorelief.sh input.png --out out.stl \
--mode palette \
--palette #000000=3.0,#ffffff=0.0 \
--base 1.5 \
--pixel 0.4

灰度模式

bash
bash scripts/imagetorelief.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文件越大）。

image-to-relief-stl图像转浮雕STL