Converts pictures into ASCII art
Project description
ASCII Magic
Python package that converts images into ASCII art. Requires colorama and PIL.
Basic usage
import ascii_magic
output = ascii_magic.from_image_file('picture.jpg')
ascii_magic.to_terminal(output)
Available functions
from_image_file()
Converts an image file into ASCII art with terminal color codes.
from_image_file(
path:str,
columns:int=120,
width_ratio:float=2.5,
char:str=None
) -> str
- path => a PIL-compatible file, such as picture.jpg
- columns (optional) => the number of characters per row, more columns = wider art
- pixel_width (optional) => ASCII characters are not square, so this adjusts the width to height ratio
- char (optional) => instead of using many different ASCII glyphs, you can use a single one, such as '#'
Example:
from_image_file('images/1.jpg', columns=100, width_ratio=2.6, char='@')
from_image()
As above, but using an image loaded with Pillow.
from_image(
img:Image,
# ... as above
) -> str
- img => PIL image
Example:
import ascii_magic
from PIL import Image
img = Image.open('images/1.jpg')
ascii_art = ascii_magic.from_image_file(img, columns=100)
img.close()
to_terminal()
Initializes colorama (which is required on Windows) and prints ASCII art to the terminal. It's the same as doing colorama.init()
before printing normally.
to_terminal(ascii_art:str) -> None
Licence
Copyright (c) 2020 Leandro Barone.
Usage is provided under the MIT License. See LICENSE for the full details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
ascii_magic-1.0.0.tar.gz
(3.2 kB
view hashes)
Built Distribution
Close
Hashes for ascii_magic-1.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3e9c51954488b1e3b66741ca1738172fb4a2fad095ffd37990e2560a36242129 |
|
MD5 | 9d078c40c062507848aa10b822577ae7 |
|
BLAKE2b-256 | 8d8b35723de37a842bf7c70cb5d270f0837efcfb6cdb5873fe22486676fbc656 |