Metadata-Version: 2.1
Name: ascii-image-art
Version: 0.0.4.11
Summary: Python library to convert images into accii chararters text file and ascii characters colored images.
Author: Mohammad Asad
License: MIT
Keywords: python,ascii,image to text,image to ascii,color ascii image,text image,asad,ascii_art,acii_image
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: BSD License
Description-Content-Type: text/markdown
License-File: LICENCE


# Ascii-Image-Art

######## README ######## 
- 🌱 ASCII_IMAGE_ART package for converting images into ASCII character strings and ASCII character colored images.



!["Elephant ASCII Conversion"](elephant.png)
![human](human_inverted.png)
![female ASCII Conversion"](female.png")
![chicken](chicken_inverted.png)

<img href='elephant.png'>

**Import**

- 🔗 from ascii_image_art import ASCIIArt


**Parameters**

```obj = ASCIIArt( path = 'path to file without dots'[mandatory], scale = 0.1 [optional], chars = 'string of characters'[optional], filename = 'name of file you want to save with without extension'[optional] )```

- 🔗 path = absolute path to image file available locally. Don't use dots in the file name or file path. 
- 🔗 filename = name of file you would be saving the final processed results with. Don't provide any extension like '.txt' or '.png' just the name.
- 🔗 scale = from 0.01 to 1. The scaled percentage of image of you want your end text and image with. By default = 0.1 or 10%.
- 🔗 chars = character 'string' you want to recreate the image with.


**Methods**

a.getPath()
a.convert()
a.printASCII()
- 🔗 getPath() : incase you don't want to pass the mandatory path to image and want to ask for image path at runtime from user. 
- 🔗 convert() : to convert image to ascii. Use - `obj.convert()`
- 🔗 getASCII() : returns an ascii image in string format.
- 🔗 printASCII() : prints the ascii string like below.



                                                                         
                                                                         
                              D..AA.AD                                   
                             A   . S..                                   
                                      S                                  
                            D AAASSAA                                    
                              S..AA A..                                  
                             SSAASAAAAA                                  
                              AAA..A..A                                  
                             A ..AA.  AD                                 
                            SDA       AS                                 
                       DDDDDDDA      .SDDS                               
                      DDDDDDDDS.    SASSDDDDD                            
                      DDDDDDDDDSSA   SDDDDDDD                            
                     DDDDDDDDDDDDS  DDDDDDDDD                            
                    DDDDDSDDDDDDDD. DDDDDDDDD                            
                   DDDDDDDDDDDDDD. SDDDDDDDDD                            
                   DDDDDDSDDDDDDD .DDDDDDSDDD                            
                  DDDDDDDDDDDDDDDS.DDSDDDDDDD                            
                  DDDDDDDDDDDDDDDDDDDDDDDDDDD                            
                  DDDDDDDDDDDDDDDDDDDDDDDDDDD                            
                  DDDDDDDDDDDDDDD DSDDDSDDDD                             
                  DDDDDDDDDDDDDDDDSDDDSDDDDD                             
                   DSDDDDDDDDDDDDSDDDDDDDDS                              
                    DDDDDDDDDDDDSDDDDDDDDD                               
                    DDDDDDDDDDDD DDDDDDDD                                
                    DSDDDSDSDDDD.DDDDDDD                                 
                   DDDDDDDDDDDA.AAADDDSS                                 
                  SDDDDDDDDDAAA .AAADSSS                                 
                  DDDDDDDDSA.AAAA..SSSSS                                 
                  DDDDDDDDDS.AA...SSSDDD                                 
                   SDDDDDDSDDSDDSSDDDD.                                  
                   DDDSDSDDDDDDDDDDDD                                    
                   DDDDDDDSDDSDDDDDDDD                                   
                   DDDDDDDSD DDDDDDDDD                                   
                   DDDDDDSS  DDDDDDDD                                    
                   DDDDDDDS  SDDDDDDD                                    
                   DDDDDDS   DDDDDDDD                                    
                   DDDDDDS   DDDDDDDD                                    
                   DDDDDDS   DDDDDDDD                                    
                   SDDDSS   DDDDDDDDA                                    
                   DDDDSS DDDDDDDDDD                                     
                   DDDSSSDDDDDDDDDD                                      
                   DDDSDDDDDDDDDDS                                       
                   DSDDDDDDDDDDS                                         
                   DDDDDDDDDDDD                                          
                  DDDDDDDDDDD                                            



- 💞️ Thank You. Mohammad ASAD


