Metadata-Version: 1.1
Name: Imgscii
Version: 1.0.2
Summary: Create ASCII artwork from images.
Home-page: https://github.com/campbellized/imgscii
Author: Chris Campbell
Author-email: campbellized@gmail.com
License: MIT
Description: # Imgscii

        Imgscii is a simple program that converts images into ASCII artwork. Follow the prompts and your ASCII art will be printed to your console. I plan on adding more features and improvements in the future.

        

        ## Getting Started

        You can get started by installing Imgscii using PIP:

        

        ```

        pip install imgscii

        ```

        

        ## Usage

        ### As A Module

        After you have installed the package from PIP you can import Imgscii into your project.

        

        ```

        import imgscii

        

        imgscii.printscii("images/my-photo.jpg")

        ```

        

        Imgscii currently supports a small set of keyword arguments.

        

        **monochrome**: ASCII art will be printed with default console style... no color!

        ```

        imgscii.printscii("images/my-photo.jpg", monochrome=True)

        ```

        

        **columns**: Define the width of your ASCII art in columns. Aspect ratio will be maintained.

        ```

        imgscii.printscii("images/my-photo.jpg", columns=75)

        ```

        

        **char_set**: Provide your own character set.

        ```

        imgscii.printscii("images/my-photo.jpg", char_set=("#", "$", "Q", "v", "j", ";", "."))

        ```

        

        ### From The Console

        Imgscii can be executed from the console as well. Use `cd` to navigate to the directory containing

        `imgscii.py`and run the program with the following command:

        

        ```

        python imgscii.py

        ```

        

        You can also use command line arguments.

        

        **-m, --monochrome**: Print ASCII art without colors

        **-c, --columns**: Define the width of ASCII art in columns.

        

        ## To-Dos

        * Add more options for printing

        * Create more ASCII artwork

        
Keywords: ascii art images
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
