El editor

Mostrar una imagen en una pantalla de MicroPython

Convierte un PNG o JPG en el módulo de Python que el método bitmap() de un controlador de pantalla dibuja.

Por qué un archivo de imagen común no sirve

Los controladores de pantalla de Russ Hughes (gc9a01py, st7789py y el de ILI9342C) dibujan una imagen con tft.bitmap(module, x, y). El module debe contener WIDTH, HEIGHT, BPP, un PALETTE y un BITMAP, que es lo que escribe su imgtobitmap.py. Un archivo con solo WIDTH, HEIGHT y un bloque de datos se detiene con "module has nothing called BITMAP", tanto en Mokxi como en una placa real. Mokxi crea el archivo correcto por ti.

Crear el módulo

  1. Abre un proyecto de MicroPython (una placa con un main.py). El botón + de un proyecto de CircuitPython solo pide un nombre de archivo.
  2. Haz clic en + en las pestañas de archivos y elige Agregar imagen como bitmap.
  3. Elige un PNG o JPG.
  4. Ajusta el ancho y el alto. Cambiar uno cambia el otro para que la imagen conserve su forma. Empiezan en el tamaño más grande que cabe en 240 x 240, o en el de la pantalla de tu circuito cuando la hay.
  5. Elige los colores: 2, 4, 16 o 256. Más colores se ven mejor y ocupan más espacio: una imagen de 70 x 70 ocupa 613 bytes con 1 bit por píxel en 2 colores, y 4,900 bytes con 8 bits por píxel en 256 colores.
  6. Revisa la vista previa, cambia el nombre del archivo si quieres y presiona Agregar al proyecto.

El nuevo <name>.py se abre en su propia pestaña. No se sube nada: la imagen se lee y se reduce en tu navegador.

Dibujarla

Copia el controlador al proyecto como lo haces con cualquier biblioteca, y luego importa el módulo nuevo junto a él. Para una pantalla redonda GC9A01:

from machine import Pin, SPI
import gc9a01py
import happy

spi = SPI(2, baudrate=40000000, sck=Pin(8), mosi=Pin(11))
tft = gc9a01py.GC9A01(spi, dc=Pin(19, Pin.OUT), cs=Pin(3, Pin.OUT), reset=Pin(37, Pin.OUT))
tft.fill(0)
tft.bitmap(happy, 70, 70)

La imagen debe caber en la pantalla desde la x, y que indiques: cuando no cabe, un controlador no dibuja nada, o dibuja de más.

Si los colores se ven mal

La paleta se guarda tal como la leen los controladores de C, con los dos bytes de cada color intercambiados. st7789py la lee así cuando su needs_swap está activado, y muestra los bytes al revés cuando está desactivado. Si el rojo y el azul se intercambian en tu pantalla, eso es el intercambio. El mismo controlador y archivo se comportan igual en una placa real.

El gc9a01py publicado calcula los dos bytes de cada píxel en bitmap() con un error en una línea (color & 0xff00 >> 8 se agrupa como color & 0xff), así que su byte bajo es el índice de la paleta y no parte del color. Eso se nota como tonos ligeramente incorrectos. Cambiar esas dos líneas a buffer[i] = color & 0xff y buffer[i + 1] = color >> 8 lo corrige.