Por que um arquivo de imagem comum não serve
Os drivers de display do Russ Hughes (gc9a01py, st7789py e o da ILI9342C) desenham uma imagem com tft.bitmap(module, x, y). O module precisa conter WIDTH, HEIGHT, BPP, uma PALETTE e uma BITMAP, que é o que o imgtobitmap.py dele escreve. Um arquivo com apenas WIDTH, HEIGHT e um bloco de dados para com "module has nothing called BITMAP", no Mokxi e numa placa de verdade igualmente. O Mokxi cria o arquivo certo para você.
Criar o módulo
- Abra um projeto MicroPython (uma placa com um
main.py). O + de um projeto CircuitPython pede apenas um nome de arquivo. - Clique em + nas abas de arquivo e escolha Adicionar imagem como bitmap.
- Escolha um PNG ou JPG.
- Defina a Largura e a Altura. Mudar uma muda a outra para a imagem manter a forma. Elas começam no maior tamanho que cabe em 240 x 240, ou no display do seu circuito quando ele tem um.
- Escolha as Cores: 2, 4, 16 ou 256. Mais cores ficam melhores e ocupam mais espaço: uma imagem de 70 x 70 tem 613 bytes a 1 bit por pixel em 2 cores, e 4.900 bytes a 8 bits por pixel em 256 cores.
- Confira a prévia, mude o nome do arquivo se quiser e aperte Adicionar ao projeto.
O novo <name>.py abre na própria aba. Nada é enviado: a imagem é lida e reduzida no seu navegador.
Desenhá-la
Copie o driver para o projeto como você faz com qualquer biblioteca, depois importe o novo módulo ao lado dele. Para um display GC9A01 redondo:
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)
A imagem precisa caber no display a partir do x, y que você informar: um driver não desenha nada, ou desenha demais, quando não cabe.
Se as cores ficarem erradas
A paleta é armazenada como os drivers em C a leem, com os dois bytes de cada cor trocados. O st7789py lê assim quando seu needs_swap está ativado, e mostra os bytes na ordem contrária quando está desativado. Se vermelho e azul trocarem de lugar no seu display, é essa troca. O mesmo driver e o mesmo arquivo se comportam igual numa placa de verdade.
O gc9a01py publicado calcula os dois bytes de cada pixel em bitmap() com um erro em uma linha (color & 0xff00 >> 8 agrupa como color & 0xff), então seu byte baixo é o índice da paleta em vez de parte da cor. Isso aparece como tons levemente errados. Trocar essas duas linhas por buffer[i] = color & 0xff e buffer[i + 1] = color >> 8 resolve.