A Rich-compatible library for writing pixels and other colourful grids to the terminal.
Project description
Rich Pixels
A Rich-compatible library for writing pixel images and other colourful grids to the terminal.
Installation
Get rich-pixels
from PyPI.
pip install rich-pixels[image]
Be sure to install the image
extras if you want to display images!
Most functionality (currently) depends on these extras, so you'll probably need them.
Basic Usage
Images
Requires the image
extras to be installed (this will install Pillow
).
Image from a file
You can load an image file from a path using from_image_path
:
from rich_pixels import Pixels
from rich.console import Console
console = Console()
pixels = Pixels.from_image_path("pokemon/bulbasaur.png")
console.print(pixels)
Pillow image object
You can create a PIL image object yourself and pass it in to from_image
.
from rich_pixels import Pixels
from rich.console import Console
from PIL import Image
console = Console()
with Image.open("path/to/image.png") as image:
pixels = Pixels.from_image(image)
console.print(pixels)
Using this approach means you can modify your PIL Image
beforehard.
ASCII Art
You can quickly build shapes using a tool like asciiflow, and apply styles the ASCII characters. This provides a quick way of sketching out shapes.
from rich_pixels import Pixels
from rich.console import Console
console = Console()
# Draw your shapes using any character you want
grid = """\
xx xx
ox ox
Ox Ox
xx xx
xxxxxxxxxxxxxxxxx
"""
# Map characters to different characters/styles
mapping = {
"x": Segment(" ", Style.parse("yellow on yellow")),
"o": Segment(" ", Style.parse("on white")),
"O": Segment(" ", Style.parse("on blue")),
}
pixels = Pixels.from_ascii(grid, mapping)
console.print(pixels)
Using with Textual
Pixels
can be integrated into Textual
applications just like any other Rich renderable.
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 rich_pixels-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f556206434b1cee3f41e9018f20a9dd291f25f9b032a2c5bde9cd36154221c29 |
|
MD5 | a5d154a36f8bdacb4544da38819de318 |
|
BLAKE2b-256 | 5482b50ba14355b4e03161b1b088bfa0221695d1ef7499af4198e58be3c0f787 |