Python Terminal Image Renderer
Project description
PTIR (Python Terminal Image Renderer)
Installation
pip install ptir
Usage
import ptir
image_path = ...
# Render the given image
ptir.render(image_path)
# Display entire 8-bit colour space
ptir.view8BitPalette()
# Display entire 24-bit colour space
ptir.view24BitPalette()
Documentation
ptir.render(image_path, width=100, height=100, interp_method='bilinear', only8Bit=False, only24Bit=False)
image_path
: Path to the image that will be renderedwidth
: The width of the output (will be 2 *width
characters wide)height
: The height of the output (will beheight
characters tall)interp_method
: Rescale interpolation method (Either 'bilinear' or 'nearest_neighbour')only8Bit
: If True the image will be rendered without any 24-bit colouronly24Bit
: If True the image will be rendered without any 8-bit colour. This mode is recommended to be used only if you are confident that the terminal will support 24-bit colour but are unsure if unicode characters are supported by the terminal font
- Not all terminal windows support 24-bit colour (Visit this website for more information on TrueColour support)
- The macOS default Terminal.app DOES NOT support 24-bit colour!
- By default the image will be rendered with two layers, 24-bit foreground to display properly on supporting terminals, and a 8-bit background to display if 24-bit colour is not available
Example #1
Original:
24-bit:
8-bit:
Example #2
Original:
24-bit:
8-bit:
Dependencies
pillow
numpy
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
ptir-1.2.1.tar.gz
(3.2 kB
view hashes)
Built Distribution
ptir-1.2.1-py3-none-any.whl
(3.9 kB
view hashes)