https://github.com/gastonchenet/ascii
🎨 Ascii is a simple command line tool that allows you to convert any PNG image to an ascii art
https://github.com/gastonchenet/ascii
ascii ascii-art braille cpp
Last synced: 10 months ago
JSON representation
🎨 Ascii is a simple command line tool that allows you to convert any PNG image to an ascii art
- Host: GitHub
- URL: https://github.com/gastonchenet/ascii
- Owner: gastonchenet
- License: mit
- Created: 2024-12-06T15:11:35.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-12-07T19:50:21.000Z (over 1 year ago)
- Last Synced: 2025-06-07T10:48:42.474Z (about 1 year ago)
- Topics: ascii, ascii-art, braille, cpp
- Language: C++
- Homepage:
- Size: 144 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ASCII Art Generator
This is a simple ASCII art generator that converts images to ASCII art. It uses the C++ 'stb_image.h' library to read images. The ASCII art is generated by converting the image to grayscale and then mapping the grayscale values to ASCII braille characters.
## Usage
The usage is simple. Just run the program and pass the path to the image you want to convert to ASCII art as an argument. For example:
```bash
./ascii_art_generator image.jpg
```
The program will then generate the ASCII art and print it to the console.
### Arguments
- `--help` or `-h`: Show the help message.
- `--size` or `-s`: The width of the output ASCII art. Default is 100.
- `--invert` or `-i`: Invert the colors of the ASCII art. Default is false.
- `--threshold` or `-t`: The threshold for converting grayscale values to ASCII characters (between 0 and 255). Default is 200.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.