LaunchKit · 2026
Back to Skills

image-to-relief-stl

Turn a source image (or multi-color mask image)

2
2.0k downloads
by @ajmwagar

Setup & Installation

openclaw skills install @ajmwagar/image-to-relief-stl

Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:

npx clawhub install image-to-relief-stl

What This Skill Does

Converts an image into a watertight, 3D-printable bas-relief STL by mapping colors or grayscale values to surface heights. Works in palette mode for flat-color images with exact color-to-height assignments, or grayscale mode for continuous height mapping. Designed to pair with image generation skills so a generated image becomes a physical model.

Uses a raster heightfield approach that needs no CAD software or heavy 3D modeling dependencies, just Python and potrace.

When to use it

  • Converting AI-generated flat-color art into printable wall plaques
  • Turning a logo or icon into a bas-relief badge
  • Making lithophanes from grayscale source images
  • Creating embossed signs or name tags from simple illustrations
  • Producing physical keepsakes from digitally generated artwork

Example Workflow

Here's how your AI assistant might use this skill in practice.

INPUT

User asks: convert my flat-color PNG logo into a printable STL with dark areas raised

AGENT
  1. 1Receive the input PNG and identify the target color-to-height mapping
  2. 2Run image_to_relief.sh in palette mode with hex color codes mapped to heights
  3. 3Set base thickness and pixel resolution parameters
  4. 4Generate the heightfield mesh and write out the ASCII STL
  5. 5Produce an SVG preview via potrace for visual confirmation
OUTPUT

A watertight out.stl file ready for slicing, plus an optional out-preview.svg

Requirements

Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.

potrace and mkbitmap installed (apt: sudo apt install potrace, or brew: brew install potrace)