A deterministic image-processing pipeline that converts raster images into editable pixel-bead patterns.
The pipeline transforms an input image into a structured grid whose cells reference a versioned physical bead palette. The result can be edited, validated, counted by material, and exported as PNG or PDF.
This repository contains the reusable image-conversion core behind Pixel Bead Studio.
- Converts raster images into structured bead grids
- Supports explicit grid dimensions and contain/crop framing
- Applies brightness, contrast, and saturation adjustments
- Removes edge-connected backgrounds
- Maps colors using CIEDE2000 perceptual distance
- Limits output to an active palette
- Supports optional Floyd–Steinberg-style dithering
- Produces editable project data instead of a flattened image
- Provides material counts and PNG/PDF export geometry
decode → framing → adjustments → background removal → grid resize
→ active palette selection → CIEDE2000 matching → optional dithering
→ structured project output
npm install
npm run checkThe reusable TypeScript surface is exported from src/index.ts.
- It does not use an image-generation model.
- It does not perform semantic subject detection.
- It does not guarantee that digital colors match every physical bead batch.
- It does not include authentication, cloud storage, billing, or product accounts.
- Algorithm overview
- Project format
- Color matching
- Background removal
- Dithering
- Limitations
- Source-backed technical note
Use the complete workflow in Pixel Bead Studio's image converter.
This repository contains reusable conversion techniques used by Pixel Bead Studio.
The original source code is available under the MIT License. Palette data must retain its original provenance and license information before redistribution. See palettes/README.md.