=====
Usage
=====

To use asciju in a project::

    import asciju

Convert your image into ASCII art::
 
    from asciju import convert_img_ascii

    print(convert_img_ascii('yourimage.jpeg','output.txt'))

Run the python script::

    python3 nameofthescript.py


Output::

    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBSSSBBBBBBBBBBBBBBBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB&%%**%$&#SBBBBBBBBBBBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBS$:..::::!**$#BBBBBBBBBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBS#$!:::::!!!!!!*%$@&&#SBBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBSS#%:::::::!!!!!!!!!**%$&SBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBS@:.:!**!!:!!!!!!!!*****%@SBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB%::!%@#SS#&%*!!!!!!!*****%&BBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBS&BB@!!*&&&&&#BS#$****%%%**!**%#BBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBS$*@B*::*@@&SS#BS$*!*%@SSS##@**%SBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBB#**%$:::::!*%$@$%!:!*$SBB#@@$$**#BBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBB&*%*!!::::!!*!:::::!*%@###&#@**%SBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBB&!!!*!:!!**%$*!*::!!!***%%%$$**@BBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBB%!**!!*%$$$**$&@%*%$***!!!!!!*SSSBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBSS%:!!%@@%**%$&#@$$%****!!!!$@$SBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB$!!!%@#&&&&&@&#@%**%*****%@%&BBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB&**********%$$&###&$%%**%$$#BBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB&$*****!**%$%**%@&&$***$$%#BBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB%%$$$$****%$%%****%%**@BSSBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBS**%&S##&@$$%%$%%%$%%$#BBBBBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBS&**%$&SBBBBSSSSS##&@@SBBBBBBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBSSB@**%$$$#SBBBBBBBBBS@$SBBBBBBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBS#SBB$**%$$$@&#####&&&&@$$SBBBBBBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBS#SBBS$**%%$$$@&&@@@$$$@@$@SBBBBBBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBSS#SBBBB@%%%%$$$$@@@$$$$$$$$#BBBBBBBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBSS#SBBBBS&$$$$$$$$$$$$$$$$$$@SBBBBBBBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBSSSBBBBBBS@$$$$$$$@@@$$$$$$@@#BBBBBBBBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBS$%%%$$$$$$$$$$$@@@&SBBBBBBSSBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBSS$%%**%%%$$$$%%$$$@#BBBBBBBSBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBS##@%****%%%%%%%%%%%@SSBBBBBBBBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBS##&$%**%%%%%*%%%%%@#SBSBBBBBBBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBSS##@%**%%%%%***$&SSSSBBBBBBBBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBSS@%**%%****$#SSSSBBBBBBBBBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBS&$%****$@#BBBBBBBBBBBBBBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBS@@@%$@&SBBBBBBBBBBBBBBBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB#$$###BBBBBBBBBBBBBBBBBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBSBBS&#SBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
    BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB