图像转浮雕STL

技能简介

将源图像（或多色遮罩图）转换为可3D打印的浅浮雕STL文件，通过颜色或灰度值映射为高度信息。

能做什么

• 把AI生成的平面彩色图转为实体浮雕模型
• 支持调色板模式（指定颜色对应高度）和灰度模式
• 输出水密性良好的可打印STL文件
• 可选生成矢量预览SVG

使用说明

安装依赖

# Ubuntu/Debian
sudo apt install potrace

# macOS
brew install potrace

调色板模式示例

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 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

图像准备建议：要求纯色块、无渐变、无阴影、边缘清晰，以获得可靠的分割效果。

输入与输出

见下方输入与输出表格。

风险提示

• 渐变或抗锯齿图像会导致分割失败
• –pixel参数过小会产生过大文件
• 输出为ASCII格式STL，体积较大
• 矢量预览为尽力而为，非精确对应

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/ajmwagar/image-to-relief-stl/SKILL.md
来源类型：GitHub仓库