Introduction to Asciify

Asciify is a versatile library designed to convert text and images into ASCII art. This powerful toolkit comes with a plethora of APIs that allow developers to fine-tune the transformation process to their needs. Whether you are creating art-driven applications or adding a unique twist to your projects, Asciify has you covered.

API Examples and Code Snippets

Basic Text to ASCII Conversion

Convert simple text into ASCII art effortlessly:

from asciify import convert_text_to_ascii
 
text = "Hello, World!"
ascii_art = convert_text_to_ascii(text)
print(ascii_art)

Image to ASCII Conversion

Transform an image into stunning ASCII art:

from asciify.image import convert_image_to_ascii
 
image_path = "path/to/your/image.jpg"
ascii_art = convert_image_to_ascii(image_path)
print(ascii_art)

Customizing ASCII Art

Customize the ASCII characters and scale to achieve the desired result:

from asciify import convert_text_to_ascii
 
text = "Custom Art"
custom_chars = ['@', '#', '%', '=', '*', '+', '-', ':', '.', ' ']
ascii_art = convert_text_to_ascii(text, chars=custom_chars, scale=2)
print(ascii_art)

Adjusting Brightness and Contrast

Enhance image-to-ASCII conversion by tweaking brightness and contrast:

from asciify.image import convert_image_to_ascii
 
image_path = "path/to/your/image.jpg"
ascii_art = convert_image_to_ascii(image_path, brightness=10, contrast=5)
print(ascii_art)

Using ANSI Colors

Add flair to your ASCII art by incorporating ANSI colors:

from asciify import convert_text_to_ascii
 
text = "Colorful Art"
ascii_art = convert_text_to_ascii(text, use_colors=True)
print(ascii_art)

Building an Application with Asciify

Let’s create a simple web application that allows users to convert text to ASCII art. We’ll use Flask for the web framework and Asciify for the conversion.

from flask import Flask, request, render_template
from asciify import convert_text_to_ascii
 
app = Flask(__name__)
 
@app.route("/", methods=["GET", "POST"])
def index():
    ascii_art = ""
    if request.method == "POST":
        text = request.form["text"]
        ascii_art = convert_text_to_ascii(text)
    return render_template("index.html", ascii_art=ascii_art)
 
if __name__ == "__main__":
    app.run(debug=True)

index.html Template

Create a simple HTML form to input the text:

    
    
    


    
ASCII Art Generator
    

        

        Convert to ASCII
    
    
{{ ascii_art }}



Hash: a5dd63c6646f27aa8179b850764d79491aa98b095fb119adfc94ffdfeeebf873