# Brick mosaic maker > How do you turn a photo into a brick mosaic? A mosaic of small toy-brick plates from your photo: colours, how many pieces of each, baseplates and a real-size printout. Turn a photo into a mosaic of 1 × 1 toy-brick plates or tiles: piece colours and counts, baseplates needed and a real-size chart to print. On your device. - Page: https://how.box/brick-mosaic/ - Runs entirely in the browser. - License: HowToolbox's own text and data (titles, explanations, FAQs, tool descriptions and schemas, this file) are CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/); AI training and answers are welcome. Attribute "HowToolbox (how.box)" with a link to the page used. Third-party data keeps its own terms; the name and logo are not licensed. Publisher: HowToolbox, contact@how.box. Terms: https://how.box/about/terms/ ## Inputs Answer link: https://how.box/brick-mosaic/?by={by}&w={w}&h={h}&fw={fw}&fh={fh}&u={u}&p={p}&c={c}&d={d}&ds={ds}&clean={clean}&en={en}&br={br}&ct={ct}&sa={sa}&bg={bg}&min={min}&b={b}&crop={crop}&z={z}&cx={cx}&cy={cy}&pp={pp}&po={po}&pc={pc} - `by` (studs or size): Size given in studs or as finished size. Example: `studs`. - `w` (whole number 8 to 200): Studs across. Example: `32`. - `h` (whole number 8 to 200): Studs down. Example: `32`. - `fw` (number 1 to 300): Finished width. Example: `25.6`. - `fh` (number 1 to 300): Finished height. Example: `25.6`. - `u` (cm or in): Length unit: cm or in. Example: `cm`. - `p` (full or basic): Colour set. Example: `full`. - `c` (whole number 2 to 32): Most colours. Example: `16`. - `d` (none, floyd-steinberg, atkinson, jarvis-judice-ninke, stucki, sierra, sierra-two-row, sierra-lite, burkes, bayer-2, bayer-4, bayer-8 or blue-noise): Dithering method. Example: `none`. - `ds` (whole number 0 to 100): Dithering strength in percent. Example: `75`. - `clean` (boolean): Clean up small specks before palette matching. Example: `true`. - `en` (boolean): Enhance colours (auto levels and a little more colour). Example: `true`. - `br` (whole number -100 to 100): Picture brightness, -100 to 100. Example: `0`. - `ct` (whole number -100 to 100): Picture contrast, -100 to 100. Example: `0`. - `sa` (whole number -100 to 100): Picture colour strength, -100 to 100. Example: `0`. - `bg` (fill or skip): Fill or skip the background. Example: `fill`. - `min` (whole number 0 to 50): Fewest pieces a colour keeps. Example: `3`. - `b` (whole number 8 to 64): Studs per baseplate side. Example: `32`. - `crop` (picture, square, landscape_4_3, portrait_3_4, landscape_3_2, portrait_2_3, landscape_16_9 or portrait_9_16): Crop shape. Example: `picture`. - `z` (whole number 100 to 400): Crop zoom in percent. Example: `100`. - `cx` (whole number 0 to 100): Crop centre across, percent. Example: `50`. - `cy` (whole number 0 to 100): Crop centre down, percent. Example: `50`. - `pp` (a4 or letter): Printed chart paper. Example: `a4`. - `po` (portrait or landscape): Printed chart orientation. Example: `portrait`. - `pc` (boolean): Coloured chart (true) or black symbols (false). Example: `true`. Example answer: https://how.box/brick-mosaic/?by=studs&w=32&h=32&fw=25.6&fh=25.6&u=cm&p=full&c=16&d=none&ds=75&clean=1&en=1&br=0&ct=0&sa=0&bg=fill&min=3&b=32&crop=picture&z=100&cx=50&cy=50&pp=a4&po=portrait&pc=1 The page computes the answer in the browser: read results from the agent tools below, not from the page HTML. ## Agent tools - `brick_mosaic_plan`: Plan a mosaic of small toy-brick plates or tiles without a picture: from studs across and down (size_by "studs", 8–200 each) or a finished size in cm or in (size_by "size", at 8 mm per stud) and the studs per square baseplate side (32 for the common large baseplate). - MCP, one POST to https://how.box/mcp: `{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"brick_mosaic_plan","arguments":{"size_by":"studs","cols":32,"rows":32,"width":25.6,"height":25.6,"unit":"cm","plate":32}}}` - GET: https://how.box/mcp/run/brick_mosaic_plan?size_by=studs&cols=32&rows=32&width=25.6&height=25.6&unit=cm&plate=32 ## How it works A brick mosaic is the picture cut into a grid with one square per stud. Each square takes the average colour of the part of the picture it covers, and that colour is matched to the nearest colour of the set. Nearness is measured the way eyes see colour (the CIEDE2000 colour difference), not by comparing RGB numbers. With a limit on colours, the tool first picks the colours that represent the whole picture best, then matches every square to them; colours used for only a few pieces are merged into their nearest neighbour. Small toy-brick plates and tiles sit 8 mm apart, so the finished size is the studs times 8 mm. Baseplates needed = ⌈studs across ÷ studs per side⌉ × ⌈studs down ÷ studs per side⌉: a 64 × 64 mosaic takes four 32 × 32 baseplates. The chart prints at real size, so a baseplate can be laid over it. On-screen colours are approximations of coloured plastic and the colour names only describe them, so compare with your real parts. Buying exactly the counts shown leaves no spare: add a few percent for lost pieces. Dithering suggests extra shades with scattered pieces; it helps photos but makes the build fiddly. ## FAQ **How big is a mosaic on one baseplate?** A common large baseplate has 32 × 32 studs: at 8 mm per stud that is 25.6 cm, about 10 in, a side, and 1,024 pieces when full. **How many colours should I use?** Eight to sixteen for portraits, logos and pixel art; up to 32 for a photo. Fewer colours are easier to sort and to buy; the merge setting removes colours used for only a few pieces. **Which pieces does it count?** One piece per stud: 1 × 1 plates or tiles, the pieces a mosaic is usually made of. Larger pieces would cover several studs of one colour; use the chart to combine them yourself. **Can I print the pattern at real size?** Yes. The chart prints at the real 8 mm stud spacing, with whole baseplates on a page when that takes no extra paper. Print at 100 % without fitting to the page and check the 50 mm line by the colour key. **Is my picture uploaded?** No. The picture is read and turned into a mosaic in your browser. A shared link carries only the settings, so the other person needs the same picture. **Does it also work for bathroom or kitchen tile mosaics?** The idea is the same, but the sizes and colours differ: use the studs as tiles and compare the colour list with your tile samples. The colours here describe toy-brick colours, not tile ranges. More: [HowToolbox index](https://how.box/llms.txt) · [Agent Skill](https://how.box/skill.md) · [agent terms](https://how.box/about/agents/)