Skip to main content

Python library to convert images into accii chararters text file and ascii characters colored images.

Project description

Ascii-Image-Art

######## README ########

  • 🌱 ASCII_IMAGE_ART package for converting images into ASCII character strings and ASCII character colored images.

"Elephant ASCII Conversion" human female ASCII Conversion" chicken

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ascii_image_art-0.0.4.11.tar.gz (5.1 kB view hashes)

Uploaded Source

Built Distribution

ascii_image_art-0.0.4.11-py3-none-any.whl (6.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page