ptit 0.1.0

Converts an image to block characters
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
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

# ptit
> Put this in text

A CLI for turning images ~~or videos~~ into block text elements to view in the terminal

## Installation
### Cargo
> Requires a Rust install
```shell
cargo install ptit
```

## Usage
### URL
##### Input
```shell
cargo run -- -cr url "https://raw.githubusercontent.com/PokeAPI/sprites/master/sprites/pokemon/132.png"
```
##### Output
[![](.github/image/ditto.png)]

### File
##### Input
```shell
cargo run -- -cr file "~/Downloads/63.png"
```
[![](.github/image/abra.png)]

## Flags
### Crop
Adding the `-c`/`--crop` flag will crop the image to it's content, removing all surrounding transparent pixels
#### Example
> Used in combination with `-r` to avoid large images
##### Without
![](.github/image/wurmple_uncropped.png)
##### With
![](.github/image/wurmple_cropped.png)

### Resize
Using the `-r`/`--resize` flag will resize the image to fit to your terminal, either squashing or biggering the image
#### Example
> Used in combination with `-c` to avoid large images
##### Without
![](.github/image/ekans_big.png)
##### With
![](.github/image/ekans_small.png)

### Solid
Using the `-s`/`--solid` flag will stop dithering on pixels with an alpha of less than 255
> I had to use XTerm for these screenshots, hence bad colours
#### Example
##### Without
![](.github/image/gradient.png)
##### With
![](.github/image/gradient_solid.png)