image_converter.py

Convert an image file to a python module for use with the bitmap method. Use redirection to save the output to a file. The image is converted to a bitmap using the number of bits per pixel you specify. The bitmap is saved as a python module that can be imported and used with the bitmap method.

See also

• alien.py.

Example

# create python module from cat.png with 4 bits per pixel and save it to cat_bitmap.py.
# Use '-s' to swap the color bytes for the GC9A01 display.

./image_converter cat.png 4 -s > cat_bitmap.py

# cross compile the python module
mpy-cross cat_bitmap.py

# upload the compiled module to the board
mpremote cp cat_bitmap.mpy :

The python file can be imported and displayed with the bitmap method. For example:

import tft_config
import cat_bitmap
tft = tft_config.config(1)
tft.bitmap(cat_bitmap, 0, 0)

Usage

usage: image_converter.py [-h] [-s] image_file bits_per_pixel

Convert image file to python module for use with bitmap method.

positional arguments:
image_file      Name of file containing image to convert
bits_per_pixel  The number of bits to use per pixel (1..8)

optional arguments:
-h, --help      show this help message and exit
-s, --swap      Swap color565 bytes