[](https://github.com/hkattelu/Asciify)
[](https://crates.io/crates/asciify)
[](https://docs.rs/asciify)
# Asciify
A rust library for converting images to a readable format on the command line
To use the code, simply construct a builder and set the properties desired.
You can then choose to print the text straight to the console, or convert
it to a string for later use:
```rust
// Printing to console with color
AsciiBuilder::new_from_path(opt.input)
.set_deep(false);
.set_invert(false);
.to_std_out(true);
```
![Ascii chocobo](https://raw.githubusercontent.com/Hkattelu/Asciify/d719722f3e68c13f13782dcb0f67cb75d889a8dd/images/ascii-chocobo.PNG)
```rust
// Generating a string and resizing
AsciiBuilder::new_from_path(opt.input)
.set_deep(true);
.set_resize(Some(32, 32));
.build();
```
![Ascii chocobo after resizing](https://raw.githubusercontent.com/Hkattelu/Asciify/d719722f3e68c13f13782dcb0f67cb75d889a8dd/images/ascii-chocobo-resized.PNG)
```shell
$ ./asciify ./test-images/SPECIAL(ChocoboA)900.png -c
```
![Ascii chocobo with color](https://raw.githubusercontent.com/Hkattelu/Asciify/d719722f3e68c13f13782dcb0f67cb75d889a8dd/images/ascii-chocobo-color.PNG)