ansipix 0.1.2

A rust library for converting images to ANSI strings to print in a terminal
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

# ansipix
A rust library for converting images to ANSI strings to print in a terminal

## Usage
### Add as dependency
Add the following to your `Cargo.toml`
```toml
ansipix = "0.1.2"
```

### Get an ANSI string
```rust
use std::path::PathBuf;

let img = ansipix::of_image(PathBuf::from("path/to/image"), (50, 50), 100, false);
```
Refer to the [docs](https://docs.rs/ansipix/latest/ansipix/) for more information about the parameters.

### Specify a different filter type
`ansipix` uses the `image` crate for opening and resizing the image. The `of_image` function uses `FilterType::Nearest` for resizing. To specify a different one, add the `image` crate to your dependencies and use `of_image_with_filter`:
```rust
use std::path::PathBuf;
use image::imageops::FilterType;

let img = ansipix::of_image_with_filter(PathBuf::from("path/to/image"), (32, 32), 255, false, FilterType::Triangle);
```

### Print Image to the Terminal
```rust
println!("{}", img.unwrap_or_else(|e| {
    eprintln!("Error while opening the file: {}", e);
    std::process::exit(1);
}));
```