# 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)