Pixel Bead Pattern Generator

What It Solves

Turns a photo or text description into a printable bead mosaic pattern. It does not only generate a pixel-style image; it also produces usable grid cells, color references, and a purchase list. Manual conversion often fails on grid size, color quantization, background handling, and bead counts, so this skill breaks the workflow into explicit stages and pauses at high-risk checkpoints.

How It Works

• It first confirms style, grid size, background mode, maximum colors, and required details in plain language, then writes spec.json.
• It branches by input: photos use edit.py, text-only prompts use generate.py, and candidates are generated with visible grid lines.
• After the user selects a candidate, it runs extract_svg.py, quantize.py, and rendering to produce pattern.png, pattern.svg, and bom.csv.
• Key constraints: background cells are not counted as beads, color quantization uses Lab / CIEDE2000, extraction does not snap early, and grid-size mismatches must be escalated instead of silently re-running.

Where It Fits Best

It works best for subject-centered patterns with a controlled color count. If the source photo has dense detail, complex transparency, or requires strict fidelity, multiple confirmation rounds may be needed. It does not automatically perform segmentation, iconification, or aspect correction; background and subject separation rely on the current pipeline's output.