Image To Grid

Transform your images into printable color-coded grids

Click to upload or drag & drop

Supports: JPG, PNG, WEBP, BMP, GIF, ITG (project)

Technique

Color Palette

Paint Set

Grid Format

Pixels (grid size): 60

Quantization Block Size: 1

Averages NxN pixel blocks before choosing a palette colour. Larger values produce fewer, bigger colour regions. 1 = per-pixel.

Advanced Processing

Interface Style

Changes the complete interface layout. Studio Workspace keeps the light/dark icon in the banner.

Recipe display mode

Controls how paint mixing recipes are displayed in the legend: as parts, percentages, or both.

Recipe accuracy

Controls how exhaustively painting recipes search for the closest mix. Fast is the current default for quick experimentation; Balanced matches the previous solver behavior; High is slower but tests more paint combinations and ratios.

Enable Triangular Formats

Enables the "Triangular" and "Triangular Region" grid formats. When unchecked, the options are hidden and no triangular processing is performed.

Enable Color Contour Map

Enables the "Color Contour Map" grid format. When unchecked, the option is hidden and no contour processing is performed.

Show Quantization Block Size

Shows the Quantization Block Size slider in the main settings when Color Contour Map is selected.

Contour border smoothing

Smooths jagged colour boundaries in the contour map with a spatial majority filter.

Smoothing radius

Neighbourhood radius for the majority filter (1–4). Higher values produce smoother boundaries but may lose fine detail.

Smoothing passes

Number of majority-filter passes. More passes further smooth boundaries.

Suppress weak contour boundaries

Hides contour boundaries when the original image gradient is weak and the two neighbouring palette colours are very similar. Useful for smooth backgrounds such as walls, skies, or skin shading.

Remove small contour islands

Merges tiny isolated contour regions into the surrounding colour independently from contour smoothing.

Island max size (px)

Connected colour regions smaller than this are merged into the surrounding colour. 0 = disabled.

Smooth contour lines

Draws contour boundaries as smooth anti-aliased curves (Chaikin subdivision) instead of jagged pixel-level dots.

Smoothing method

Choose how contour polylines are converted into smooth curves.

Chaikin iterations

Higher values produce rounder contour curves, but can soften small corners and thin details.

Export mode

Original exports the SVG contour as shown on screen. Preserve Shape and Vector-Like apply geometric re-smoothing to a vectorial SVG — Vector-Like produces cleaner, more flowing outlines.

Export format

Choose the file format for downloads and printing. SVG produces scalable vector files. PNG produces high-resolution raster images that render faster in print preview.

Label placement

How large contour zones are split for label placement. Grid: regular rectangular cells. K-Means: spatial clustering. Bisection: recursive halving along the longest axis.

Show original vs closest

Hover color inspector

Enable this option, then move the mouse over a cell in the visual preview to see both the original extracted color and the closest palette color in RGB and HSV.

Show white-cell debug overlay

Shows the detection result directly in the visual preview: transparent = blue, outside white = red, inside white = green.

Compute inside/outside white cells

Classifies white cells as exterior or interior. Exterior white cells are converted to transparent; interior white cells can then be shown or hidden separately.

White detection method

White detection percentile

White-region connectivity

Fine white detection

Uses a finer hidden grid derived from the original image to classify white cells before projecting the result back to the user grid.

Fine scale

Interior subcell threshold (%)

Detection time: n/a

Show interior white cells

When inside/outside computation is enabled, enclosed white cells inside the drawing can stay visible or be hidden on demand. Exterior white cells remain transparent.

White-edge erosion

After processing, white cells adjacent to transparent cells are converted to transparent, removing stray white edge artifacts around the subject boundary.

Iterative erosion Near-white threshold

When enabled, the erosion repeats until no white cells with transparent neighbours remain. When disabled, only a single pass is applied. The near-white threshold sets how far from pure white a colour can be (Euclidean RGB distance) and still be treated as white for erosion (0 = exact white only).

Unanimous neighbour recolor

Cells whose neighbours agree on a single colour (or are all transparent) are converted to match. Min neighbours = how many must agree (6 = all hex neighbours).

Min neighbours

Iterative recolor

When iterative is enabled, the recolor repeats until no more cells change.

Cell Color Rule

Quantize Percentile

Grid Width

Grid Height

Resample Kernel

Quantization Mode

Color clustering method

Number of color clusters

Shadow / tone preservation

Reserves clustered color slots for meaningful darker tone bands inside large color families, preserving shadows without changing contour geometry.

Recipe display

Mixing order strategy

Production order for mixing paints. Only the stage-based strategy is active; others are planned.

Painting order strategy

Application order for painting cells. Only the dark-to-light strategy is active; others are planned.

Color Distance Metric

Family mismatch penalty

Neutral saturation cutoff

Skin max saturation

Brown max saturation

White Snap Luminance

Black Snap Luminance

Majority / mode filter

Recolor a cell when a different neighboring color clearly dominates around it.

Min dominant neighbors

Max same-color neighbors

Iterations

Remove tiny color islands

Merge very small connected same-color regions into their dominant surrounding color.

Max island size

Connectivity

Edge-aware smoothing

Smooth low-contrast areas while avoiding strong local edges from the extracted source colors.

Max local contrast

Min neighbor support

Iterations

Pre-quantization denoise

Filter extracted cell colors before palette matching to suppress noisy single-cell variations.

Method

Radius

Passes

Neighborhood-aware quantization

Bias palette selection toward colors that stay consistent with the surrounding cells.

Neighbor penalty

Iterations