Legofy 
What is it?
Legofy is a python program that takes a static image or gif and makes it so that it looks as if it was built out of LEGO.
Requirements
- Python
- Python modules: Pillow, click # pip will install these automatically if using
pip install legofy - imagemagick # not needed but recommended
Bugs
If you find a bug:
- Check in the open issues if the bug already exists.
- If the bug is not there, create a new issue with clear steps on how to reproduce it.
Quickstart
$ pip install legofy
or install from source
$ git clone https://github.com/JuanPotato/Legofy.git
$ cd Legofy
$ python setup.py install
Wait! I don't know what any of this means? Use pip then, or if you really want to install from source have some help.
Usage
Usage: legofy [OPTIONS] IMAGE [OUTPUT]
Legofy an image!
Options:
--size INTEGER Number of bricks the longest side of the legofied image should have.
--dither / --no-dither Use dither algorithm to spread the color approximation error.
--palette [all, effects, mono, solid, transparent]
Palette to use based on real Lego colors.
--help Show this message and exit.
Palette
There are 3 palettes: solid (33 colors), transparent (14 colors) and effects (4 colors).
You can use one of them or all the 3.
$ legofy --palette solid image.jpg
$ legofy --palette transparent image.jpg
$ legofy --palette effects image.jpg
$ legofy --palette all image.jpg
There is another one palette, mono, with only 2 colors (black and white...). It's just for test and fun...
Troubleshooting
Installation
- Download and install all requirements
- python from the official python website
- imagemagick from the official imagemagick website
- Download this project by using the download zip button on this page, or running
git clone https://github.com/JuanPotato/Legofy
- If you downloaded a zip file, please unzip it
- Open a command line and navigate to the project folder
- Run
python setup.py installwhile in the project folder - You can now use Legofy anywhere, see usage for more help
Forks
- JavaScript: Legofy