Kenapa file gambar biasa tidak cukup
Driver layar milik Russ Hughes (gc9a01py, st7789py dan yang ILI9342C) menggambar gambar dengan tft.bitmap(module, x, y). module harus berisi WIDTH, HEIGHT, BPP, PALETTE, dan BITMAP, itulah yang ditulis oleh imgtobitmap.py miliknya. File yang hanya berisi WIDTH, HEIGHT dan blok data akan berhenti dengan "module has nothing called BITMAP", baik di Mokxi maupun di board sungguhan. Mokxi membuatkan file yang benar untukmu.
Membuat modulnya
- Buka proyek MicroPython (board dengan
main.py). Tanda + pada proyek CircuitPython hanya meminta nama file. - Klik + di tab file dan pilih Tambahkan gambar sebagai bitmap.
- Pilih PNG atau JPG.
- Atur Width dan Height. Mengubah satu akan mengubah yang lain supaya gambar tetap menjaga bentuknya. Ukurannya dimulai dari ukuran terbesar yang muat di 240 x 240, atau layar di rangkaianmu jika ada.
- Pilih Colors: 2, 4, 16 atau 256. Warna lebih banyak terlihat lebih bagus tapi butuh ruang lebih besar: gambar 70 x 70 berukuran 613 byte pada 1 bit per piksel dengan 2 warna, dan 4.900 byte pada 8 bit per piksel dengan 256 warna.
- Periksa pratinjau, ganti nama file jika kamu mau, lalu tekan Tambahkan ke proyek.
File <name>.py yang baru terbuka di tab tersendiri. Tidak ada yang diunggah: gambar dibaca dan diperkecil di browser-mu.
Gambarlah
Salin driver ke proyek seperti cara kamu menyalin library apa pun, lalu import modul barunya di sebelahnya. Untuk layar bulat 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)
Gambar harus muat di layar dari x, y yang kamu berikan: driver tidak menggambar apa-apa, atau menggambar terlalu banyak, kalau tidak muat.
Kalau warnanya terlihat salah
Palet disimpan seperti yang dibaca driver C, dengan dua byte tiap warna ditukar. st7789py membacanya begitu saat needs_swap-nya aktif, dan menampilkan byte dengan urutan sebaliknya saat nonaktif. Kalau merah dan biru bertukar tempat di layarmu, itu dia pertukarannya. Driver dan file yang sama berperilaku sama di board sungguhan.
gc9a01py yang dipublikasikan menghitung dua byte tiap piksel di bitmap() dengan kesalahan di satu baris (color & 0xff00 >> 8 dikelompokkan sebagai color & 0xff), jadi byte rendahnya menjadi indeks palet alih-alih bagian dari warna. Itu terlihat sebagai rona yang sedikit salah. Mengubah dua baris itu menjadi buffer[i] = color & 0xff dan buffer[i + 1] = color >> 8 memperbaikinya.