/braille-image

A command-line util for producing braille character art from images, featuring optional edge detection.

Primary LanguageRustMIT LicenseMIT

braille-image

Binary rust crate that generates "ascii" art from images. (Not really ascii, since the braille characters are unicode)

For usage, run braille-image --help.

As an example, executing braille-image -s 0.1 -i images/ferris_outline.png produces:

⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⣀⠁⠁⠁⢀⣤⣄⠁⠁⠁⢀⡀⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁ ⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⢀⣠⣀⠁⠁⡾⠉⠻⣦⣠⡟⠁⠘⣧⣠⡾⠋⠹⡆⠁⢀⣠⣀⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁ ⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⡀⠁⠁⣾⠁⠈⠻⠾⠃⠁⠁⠈⠋⠁⠁⠁⠈⠋⠁⠁⠁⠻⠾⠋⠁⢹⡆⠁⢀⡀⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁ ⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⢠⡟⠉⠛⠶⠏⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠘⠷⠞⠋⠙⣧⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁ ⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⣠⣤⣄⣸⡇⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⣟⣀⣤⣤⡀⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁ ⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⣏⠁⠁⠉⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠉⠁⠁⢈⡇⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁ ⠁⠁⠁⠁⠁⠁⠁⣠⣤⣤⣿⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⢸⣧⣤⣤⡀⠁⠁⠁⠁⠁⠁⠁ ⠁⠁⠁⠁⠁⠁⠸⡇⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⡿⠁⠁⠁⠁⠁⠁⠁ ⠁⠁⠁⠁⠁⠁⣀⣻⡄⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⣼⣃⡀⠁⠁⠁⠁⠁⠁ ⠁⠁⠁⠁⣼⠋⠉⠉⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠈⠉⠉⢻⡄⠁⠁⠁⠁ ⠁⠁⠁⠁⠘⢧⡀⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠈⣿⣷⡄⠁⠁⠁⠁⢠⠁⠈⢻⣷⡄⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⣠⠟⠁⠁⠁⠁⠁ ⠁⠁⠁⠁⣠⡾⠃⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⣧⣀⣠⣿⣿⣿⠁⠁⠁⠁⣿⣄⣠⣾⣿⣿⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠻⢦⣀⠁⠁⠁⠁ ⠁⠁⣠⡾⠋⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠻⣿⣿⣿⣿⡟⠁⠁⠁⠁⠹⣿⣿⣿⣿⠟⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠉⠳⣤⡀⠁ ⠁⢰⠋⠁⠁⠁⢀⡀⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠈⠙⠋⠁⠁⠁⠁⠁⠁⠁⠈⠉⠉⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⢀⠁⠁⣀⠁⠁⠁⢈⡗⠁ ⠁⠘⢧⡀⠁⠁⠈⢿⣆⠁⠱⣦⣄⠁⠁⠁⠁⠁⠁⢀⠤⠒⠋⠉⠛⠲⢤⡀⠁⠁⠁⠁⢀⠴⠊⠉⠉⠉⠑⠠⡀⠁⠁⠁⠁⠁⠁⠁⣠⣾⡏⠁⣴⡏⠁⠁⢠⡞⠁⠁ ⠁⠁⠁⠙⢦⡀⠁⠈⢿⣷⡄⠹⣿⢦⡀⠁⠁⠢⠄⠁⠁⠁⠁⠁⠁⠁⠁⠉⢢⡀⢀⡔⠁⠁⠁⠁⠁⠁⠁⠁⠈⠦⠖⠁⠁⠁⣠⡾⢫⡟⢀⣾⡿⠁⠁⣰⠏⠁⠁⠁ ⠁⠁⠁⠁⠁⠙⢦⡀⠈⠻⣿⣦⡹⣆⠻⢦⣀⠁⠁⠁⠁⠁⠠⣤⣤⠤⠶⠶⠶⠟⠿⠖⠛⠛⠛⢒⣶⠆⠁⠁⠁⠁⢀⣠⡴⠞⠉⢀⡟⣰⠏⣼⠁⢀⡾⠃⠁⠁⠁⠁ ⠁⠁⠁⠁⠁⠁⠁⠙⢦⡀⠙⣮⠳⠿⠁⠁⠉⠛⢶⡀⠁⠁⠁⠈⠙⠳⠦⣤⣤⡀⣀⣀⣠⣤⠶⠛⠁⠁⠁⠁⢀⡴⠋⠁⠁⠁⠁⠸⠷⠋⣼⠃⣠⠟⠁⠁⠁⠁⠁⠁ ⠁⠁⠁⠁⠁⠁⠁⠁⠁⠙⢦⡘⣇⠁⠁⠁⠁⠁⠁⠙⢦⣄⠁⠁⠁⠁⠁⢀⡼⠁⠿⣍⡀⠁⠁⠁⠁⢀⣠⠶⠋⠁⠁⠁⠁⠁⠁⠁⠁⢰⡏⣴⠋⠁⠁⠁⠁⠁⠁⠁ ⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠈⠙⠋⠁⠁⠁⠁⠁⠁⠁⠁⠉⠛⠶⠦⠴⠞⠋⠁⠁⠁⠈⠙⠛⠛⠛⠛⠉⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠁⠈⠛⠁⠁⠁⠁⠁⠁⠁⠁⠁