Converts pictures into ASCII art
Project description
ASCII Magic
Python package that converts images into ASCII art for terminals and HTML. Thanks to Colorama it's compatible with the Windows terminal. Code based on ProfOak's Ascii Py.
Basic usage
import ascii_magic
output = ascii_magic.from_image_file('images/moon.jpg')
ascii_magic.to_terminal(output)
Result:
Available functions
from_image_file()
Converts an image file into ASCII art.
ascii_magic.from_image_file(
path: str,
columns: int = 120,
width_ratio: float = 2.5,
char: str = None,
back: Back = None,
mode: Modes = Modes.TERMINAL,
) -> str
- path => a PIL-compatible file, such as a jpeg or png
- columns (optional) => the number of characters per row, more columns = wider art
- width_ratio (optional) => ASCII characters are not squares, 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 '#'
- back (optional) => In terminal mode, sets the background color with one of:
ascii_magic.Back.BLACK
ascii_magic.Back.RED
ascii_magic.Back.GREEN
ascii_magic.Back.YELLOW
ascii_magic.Back.BLUE
ascii_magic.Back.MAGENTA
ascii_magic.Back.CYAN
ascii_magic.Back.WHITE
- mode (optional) => one of:
ascii_magic.Modes.TERMINAL
=> outputs ASCII with terminal color codes (8 tones)ascii_magic.Modes.ASCII
=> outputs pure ASCII with no color codes, resulting in a "grayscale" imageascii_magic.Modes.HTML_TERMINAL
=> outputs HTML simulating terminal colors; wrap it in a<pre>
ascii_magic.Modes.HTML
=> as above, but with full color
Example:
output = ascii_magic.from_image_file(
'images/lion.jpg',
columns=200,
back=ascii_magic.Back.BLUE
)
Result:
Example:
output = ascii_magic.from_image_file(
'images/lion.jpg',
columns=200,
width_ratio=2,
mode=ascii_magic.Modes.HTML
)
Result:
Example:
output = ascii_magic.from_image_file(
'images/lion.jpg',
columns=200,
mode=ascii_magic.Modes.ASCII
)
Result:
from_url()
As above, but using the URL of an image.
ascii_magic.from_url(
url: str,
# ... as above
) -> str
- url => an URL which will be loaded via urllib (supports redirects)
Example:
img_url = 'https://source.unsplash.com/800x600?nature'
output = ascii_magic.from_url(img_url, columns=100)
from_clipboard()
As above, but with the contents of the clipboard. Raises ValueError if the clipboard doesn't contain an image.
ascii_magic.from_clipboard(
# ... as above
) -> str
Example:
output = ascii_magic.from_clipboard(columns=100)
from_image()
As above, but using an image loaded with Pillow.
ascii_magic.from_image(
img: Image,
# ... as above
) -> str
- img => PIL image object
Example:
from PIL import Image
with Image.open('images/1.jpg') as img:
output = ascii_magic.from_image(img, columns=100)
to_terminal()
Initializes Colorama, which is required on Windows for displaying art in terminal mode, and prints the input. It's the same as doing colorama.init()
before running print()
.
ascii_magic.to_terminal(input: str) -> None
quick_test()
Runs ascii_magic with a random Unsplash picture with the default parameters and prints it to the terminal.
ascii_magic.quick_test() -> 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
Built Distribution
Hashes for ascii_magic-1.5.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b848ccb8c52c062dbe6c0059cf4ae1e585e584339c98a81f0cd62622748fd5c2 |
|
MD5 | 2d15ad486c5dca24958714a268c8af61 |
|
BLAKE2b-256 | dea4cb2a0999ea89b87905be9377d73c9561b75f402b0205bc5a60855c17a8de |