Metadata-Version: 2.1
Name: ita-converter
Version: 0.9.2
Summary: ita-converter - convert your images to ASCII art easily!
Author-email: Lyubomir T <ternavski103@gmail.com>
Description-Content-Type: text/markdown
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python
Requires-Dist: numpy
Requires-Dist: Pillow

# ita-converter

ita-converter is a lightweight and fast Python library that converts an image to ASCII art. It allows users to resize images, convert them to grayscale, and customize the symbols used to create the ASCII art. [View on PyPi!](https://pypi.org/project/ita-converter/)

## Installation

You can install ita-converter using pip:
```
pip install ita-converter 
```

## Usage

To use ita-converter, simply import the `get_ascii_art()` function and pass in the path to the image file you want to convert. By default, the function will use a set of ASCII characters to create the art, but you can also pass in your own symbol set.

```python
from ita_converter import get_ascii_art

ascii_art = get_ascii_art("path/to/image.png", symbol_set=["@", "#", "*", " "])
print(ascii_art)
```
By default, the function will use color in the output. If you want a black and white output, set `color` to `False`.
```python
ascii_art = get_ascii_art("path/to/image.png", color=False)
print(ascii_art)
```
You can also resize the image and specify the width and height of the output. If you only specify the width, the height will be adjusted automatically to maintain the aspect ratio.
```python
ascii_art = get_ascii_art("path/to/image.png", width=50, height=50)
print(ascii_art)
```
You can specify the `colour_type`. By default it is ANSI, but you can also set it to HTML.
```python
ascii_art = get_ascii_art("path/to/image.png", colour_type="html")
print(ascii_art)
```
or
```python
ascii_art = get_ascii_art("path/to/image.png", colour_type="ansi")
```
## Contributing

Contributions are welcome! If you have an idea for a new feature or want to report a bug, please open an issue. If you want to contribute code, please fork the [repository](https://github.com/LyubomirT/ita-converter), make your changes, and submit a pull request.

## License

ita-converter is licensed under the [MIT License](https://opensource.org/licenses/MIT).
