A bead pattern creator. Convert any imagine into a suitable color palette pixel by pixel in order to be able to create a matching, beadable pattern. It also shows you a statistic about the used beads.
- Cross-platform
- Uses all available CPU cores to process the image
- Supports gif/jpg/png as input file formats
- Can output a HTML file with detailed info on which bead to use for each pixel
- Color matching based on CIEDE2000
- Included bead palettes: Hama
- Optional image resizing
- Image filters to preprocess the input image
Compiling the tool from source code needs to have a recent version of Golang installed.
go install github.com/cornelk/beadmachine@latest
Bead pattern creator
--verbose, -v verbose output
--input INPUT, -i INPUT
image to process
--output OUTPUT, -o OUTPUT
output filename for the converted PNG image
--html HTML, -l HTML output filename for a HTML based bead pattern file
--palette PALETTE, -p PALETTE
filename of the bead palette [default: colors_hama.json]
--width WIDTH, -w WIDTH
resize image to width in pixel
--height HEIGHT,
865D
-e HEIGHT
resize image to height in pixel
--boardwidth BOARDWIDTH, -x BOARDWIDTH
resize image to width in amount of boards
--boardheight BOARDHEIGHT, -y BOARDHEIGHT
resize image to height in amount of boards
--boarddimension BOARDDIMENSION, -y BOARDDIMENSION
dimension of a board [default: 20]
--beadstyle, -b make output file look like a beads board
--translucent, -t include translucent colors for the conversion
--nocolormatching, -n
skip the bead color matching
--grey, -g convert the image to greyscale
--blur BLUR apply blur filter (0.0 - 10.0)
--sharpen apply sharpen filter
--gamma GAMMA apply gamma filter (0.0 - 10.0)
--contrast CONTRAST apply contrast adjustment (-100 - 100)
--brightness BRIGHTNESS
apply brightness adjustment (-1 - 1)
--help, -h display this help and exit
To convert the sample yoshi image to Hama bead colors:
./beadmachine -i examples/yoshi_thinking_in.png -o out.png -l pattern.html ->
And will print out a statistic:
2023-08-01 19:22:28 INFO Image pixels {"width":28,"height":32}
2023-08-01 19:22:28 INFO Bead board used {"width":1,"height":1}
2023-08-01 19:22:28 INFO Bead board measurement in cm {"width":14,"height":16}
2023-08-01 19:22:28 INFO Bead colors {"count":9}
2023-08-01 19:22:28 INFO Beads used {"color":"H38 Neon orange","count":18}
2023-08-01 19:22:28 INFO Beads used {"color":"H35 Neon red","count":13}
2023-08-01 19:22:28 INFO Beads used {"color":"H1 White","count":525}
2023-08-01 19:22:28 INFO Beads used {"color":"H18 Black","count":179}
2023-08-01 19:22:28 INFO Beads used {"color":"H10 Green","count":30}
2023-08-01 19:22:28 INFO Beads used {"color":"H42 fluorescent green","count":38}
2023-08-01 19:22:28 INFO Beads used {"color":"H47 Pastel Green","count":72}
2023-08-01 19:22:28 INFO Beads used {"color":"H4 Orange","count":10}
2023-08-01 19:22:28 INFO Beads used {"color":"H27 Beige","count":11}The output of the HTML pattern file will look similar to this:
To convert the sample Mona Lisa image to Hama bead colors, resize to a width of 58 pixel and create a bead style output:
./beadmachine -i examples/mona_lisa_in.jpg -o out.png -w 58 -b --blur 2 ->
And will print out a statistic:
2023-08-01 19:22:28 INFO Image pixels {"width":722,"height":1074}
2023-08-01 19:22:28 INFO Bead board used {"width":2,"height":3}
2023-08-01 19:22:28 INFO Bead board measurement in cm {"width":29,"height":43}
2023-08-01 19:22:28 INFO Output image pixels {"width":58,"height":86}
2023-08-01 19:22:28 INFO Bead colors {"count":17}