# txtpic
> Generate Unicode art from images

## Installation
You'll need [Cargo](http://doc.crates.io) to install `txtpic`.

    $ cargo install txtpic

## Usage

    txtpic 1.2.4
    Jeremy Dormitzer <jeremy.dormitzer@gmail.com>
    Generates text representations of images

    USAGE:
    txtpic [FLAGS] [OPTIONS] <IMAGE>

    FLAGS:
    -h, --help       Prints help information
    -i, --invert     Invert the result to make it suitable for black text on a white background
    -V, --version    Prints version information

    OPTIONS:
    -c, --character-set <CHARACTERS>    An alternate character set to use
    -p, --preset <PRESET NAME>          A preset character set to use [default: small]  [values: small, medium, large, emoji]
    -w, --width <WIDTH>                 An approximate width value for the result [default: 80]

    ARGS:
    <IMAGE>    The input image

    Note: the --width option attempts find a width close to the target width that preserves 
    the aspect ratio of the original image. For certain images, there may be only one or two 
    valid widths within a reasonable range, so the --width option may not appear to have an effect.
    In this case, try extremely high or extremely low width values to affect the output.

## Example
Here is an adorable cat.

![Adorable cat](./example/cat.jpg)

Converting it with:

    $ txtpic --width 100 cat.jpg

Gives the [output](./example/cat.txt):

![Text cat](./example/text-cat.png)