Turns an Image into Braille Art with Pillow. (...or Unicode Art ...or "ASCII Art" (its not rly ascii))
Supports color now!
First make sure that you have Python 3 and pip installed. In the terminal:
git clone https://github.com/TheFel0x/img2braille
cd img2braille
python -m pip install -r requirements.txtThen to run the script:
python script.py --help| flag | value | description |
|---|---|---|
input |
string (path) | path to image file |
-w --width |
integer | output width (characters) |
-i --noinvert |
- | deactivates inverted dots. for light backgrounds with dark text |
-d --dither |
- | activates dithering |
--calc |
RGBsum R G B BW |
determines the way in which is checked wether a dot is black or white |
-n --noempty |
- | don't use U+2800 "Braille pattern dots-0" (some applications remove these symbols because they treat them as spaces) |
-c --color |
none ansi ansifg ansiall html htmlbg htmlall |
color support for either HTML style with font tags or ANSI escaped for cli use (html also puts br tags at the end of each line) htmlbg colors the background instead of the characters and all colors both |
-a --autocontrast |
- | enables autocontrast, to automatically adjust black and white values for calculations to the images max/min (recommended for black/white use) |
-b --blank |
- | all braille blocks are "full" blocks, in case you only care about the color output and not about the braille pattern |
python script.py 'lain.png' --color ansi --dither --noempty
python script.py 'lain.png' --dither
python script.py 'lain.png'
python script.py 'lain.png' --noinvert
- divide image into 2x4 pixel blocks
- calculate the blocks value by adding the dot values to
0x2800 - create braille character by outputting the final block value as a char (UTF-16 encoded)
| +1 | +8 |
| +2 | +16 |
| +4 | +32 |
| +64 | +128 |
For calculating which braille symbol represents a 2x4 pixel block. The braille symbol works similar to an 8-bit binary number.
Using the > operator, like this:
python script.py 'lain.png' > output.txt
- support for different dithering algorithms
- fix any bugs
- support 3, 4 and 8 bit ANSI color mode
- check if support for
U+1FB00toU+1FB3B(Block Sextant) might be possible - maybe edge detection filter?
- maybe IRC color option?
- color palette support? maybe using https://github.com/hbldh/hitherdither ?
- adjust-aspect-ratio option (for non-monospace fonts that mess up the aspect ration of the output)