Image To Relief Stl — 技能 — openclaw中文资讯站

技能详情（站内镜像，无评论）

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.

媒体与内容

许可证：MIT-0

MIT-0 ·免费使用、修改和重新分发。无需归因。

版本：v0.1.0

统计：⭐ 2 · 2.1k · 2 current installs · 3 all-time installs

⭐ 2

安装量（当前） 3

🛡 VirusTotal ：良性 · OpenClaw ：良性

Package：ajmwagar/image-to-relief-stl

安全扫描（ClawHub）

VirusTotal ：良性
OpenClaw ：良性

OpenClaw 评估

The skill's files, required tools, and runtime instructions are consistent with its stated purpose (converting images to bas-relief STL); nothing appears to request unrelated credentials or perform unexpected I/O or network exfiltration.

目的

Name/description match the actual requirements: python3 plus potrace/mkbitmap are reasonable for raster processing and optional SVG preview. The included scripts implement a local heightfield→STL pipeline consistent with the description.

说明范围

SKILL.md and scripts confine actions to converting the provided input image to STL and optionally generating a potrace SVG preview. The scripts read only the supplied input image, write the specified output files, and do not reference unrelated system files or external endpoints.

安装机制

The install entries are apt/brew for potrace (a legitimate source for the required binaries). There are no obscure download URLs or archive extraction steps. The runtime creates a local Python venv and installs Pillow via pip (expected for image handling).

证书

No credentials or sensitive environment variables are requested. The scripts use XDG_CACHE_HOME or HOME to place a per-skill venv, which is reasonable and explained in the wrapper script.

持久

The wrapper creates a persistent venv under ${XDG_CACHE_HOME:-$HOME/.cache}/agent-skills which survives across runs and will pip-install Pillow (network fetch). This is normal for convenience but means the skill will store installed packages on disk.

综合结论

This skill appears to do exactly what it says: convert an image to a bas-relief STL. Before installing, be aware that: (1) it expects potrace/mkbitmap available via apt or brew, (2) the wrapper will create a venv in ~/.cache (or $XDG_CACHE_HOME) and pip-install Pillow (which requires network access to PyPI), and (3) outputs are written to the paths you supply. If you’re comfortable allowing a local venv and a brief pip install, the skill is re…

安装（复制给龙虾 AI）

将下方整段复制到龙虾中文库对话中，由龙虾按 SKILL.md 完成安装。

请把本段交给龙虾中文库（龙虾 AI）执行：为本机安装 OpenClaw 技能「Image To Relief Stl」。简介：Turn a source image (or multi-color mask image) into a 3D-printable bas-relief …。
请 fetch 以下地址读取 SKILL.md 并按文档完成安装：https://raw.githubusercontent.com/openclaw/skills/refs/heads/main/skills/ajmwagar/image-to-relief-stl/SKILL.md
（来源：yingzhi8.cn 技能库）

SKILL.md

打开原始 SKILL.md（GitHub raw）

---
name: image-to-relief-stl
description: 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.
metadata:
  openclaw:
    requires:
      bins: ["python3", "potrace", "mkbitmap"]
    install:
      - id: apt
        kind: apt
        package: potrace
        bins: ["potrace", "mkbitmap"]
        label: Install potrace + mkbitmap (apt)
      - id: brew
        kind: brew
        formula: potrace
        bins: ["potrace", "mkbitmap"]
        label: Install potrace + mkbitmap (brew)
---

# image-to-relief-stl

Generate a **watertight, printable STL** from an input image by mapping colors (or grayscale) to heights.

This is an orchestrator-friendly workflow:
- Use **nano-banana-pro** (or any image model) to generate a **flat-color** image.
- Run this skill to convert it into a **bas-relief** model.

## Practical constraints (to make it work well)

Ask the image model for:
- **exactly N solid colors** (no gradients)
- **no shadows / no antialiasing**
- bold shapes with clear edges

That makes segmentation reliable.

## Quick start (given an image)

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

### Grayscale mode

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

## Outputs

- `out.stl` (ASCII STL)
- optional `out-preview.svg` (vector preview via potrace; best-effort)

## Notes

- This v0 uses a **raster heightfield** meshing approach (robust, no heavy CAD deps).
- The `--pixel` parameter controls resolution (smaller = higher detail, bigger STL).