Library Documentation
Known Issues
Drawing of images and animations doesn’t work completely well with
cmd
andpowershell
(tested in Windows Terminal).Description: Some lines of the image seem to extend beyond the number of columns that it should normally occupy by about one or two columns. This behaviour causes animations to go bizzare.
Comment: First of all, the issue is inherent to these shells and neither a fault of this library nor the Windows Terminal, as drawing images and animations works properly with WSL within Windows Terminal.
Solution: A workaround is to leave some horizontal allowance of at least two columns to ensure the image never reaches the right edge of the terminal. This can be achieved in the library by using the h_allow parameter of
TermImage.set_size()
.
Planned Features
Performance improvements
Support for terminal graphics protocols (See #23)
More text-based render styles
Greyscale rendering (Good for 256-color terminals)
ASCII-based rendering (Support for terminals without unicode or 24-bit color support)
Black and white rendering
Support for open file objects and
Pathlike
objectsDetermination of frame duration per frame during animations and image iteration
Image source type property
Framing formatting option
Jumping to a specified frame during image iteration
Image zoom and pan functionalities
Addition of urwid widgets for displaying images
etc…