Skip to content
TakoAPI
Back to skills

image-to-relief-stl

by ajmwagar

Transportation
2.0kDownloads reported by clawskills.sh
2Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

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

Description

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

INPUT

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

AGENT
  1. 1

    Receive the input PNG and identify the target color-to-height mapping

  2. 2

    Run image_to_relief.sh in palette mode with hex color codes mapped to heights

  3. 3

    Set base thickness and pixel resolution parameters

  4. 4

    Generate the heightfield mesh and write out the ASCII STL

  5. 5

    Produce an SVG preview via potrace for visual confirmation

OUTPUT

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

Requirements

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

Installation

clawhub install ajmwagar/image-to-relief-stl

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links