Trình soạn thảo

Hiển thị ảnh trên màn hình MicroPython

Biến một tệp PNG hoặc JPG thành module Python mà hàm bitmap() của driver màn hình vẽ ra.

Vì sao một tệp ảnh thông thường không dùng được

Các driver màn hình của Russ Hughes (gc9a01py, st7789py và driver ILI9342C) vẽ ảnh bằng tft.bitmap(module, x, y). module phải chứa WIDTH, HEIGHT, BPP, PALETTE và BITMAP, đó chính là thứ mà imgtobitmap.py của anh ấy ghi ra. Một tệp chỉ có WIDTH, HEIGHT và một khối dữ liệu sẽ dừng với thông báo "module has nothing called BITMAP", trên Mokxi cũng như trên bo mạch thật. Mokxi tạo đúng tệp giúp bạn.

Tạo module

  1. Mở một dự án MicroPython (một bo mạch có main.py). Dự án CircuitPython khi nhấn + chỉ hỏi tên tệp.
  2. Nhấn + trong các tab tệp và chọn Add image as bitmap.
  3. Chọn một ảnh PNG hoặc JPG.
  4. Đặt Width và Height. Đổi một bên thì bên kia đổi theo để ảnh giữ nguyên hình dáng. Chúng bắt đầu ở kích thước lớn nhất vừa với 240 x 240, hoặc với màn hình trong mạch của bạn nếu có.
  5. Chọn Colors: 2, 4, 16 hoặc 256. Nhiều màu hơn thì đẹp hơn nhưng tốn chỗ hơn: ảnh 70 x 70 chiếm 613 byte ở 1 bit một điểm ảnh với 2 màu, và 4,900 byte ở 8 bit một điểm ảnh với 256 màu.
  6. Xem bản xem trước, đổi tên tệp nếu bạn muốn, rồi nhấn Add to project.

Tệp <name>.py mới mở trong tab riêng của nó. Không có gì được tải lên cả: ảnh được đọc và thu nhỏ ngay trong trình duyệt của bạn.

Vẽ ảnh

Chép driver vào dự án như bạn vẫn làm với mọi thư viện, rồi import module mới vào cạnh nó. Với màn hình tròn 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)

Ảnh phải vừa trên màn hình tính từ tọa độ x, y mà bạn đưa vào: driver sẽ không vẽ gì, hoặc vẽ thừa ra ngoài, nếu ảnh không vừa.

Nếu màu sắc sai

Bảng màu được lưu theo cách các driver C đọc, với hai byte của mỗi màu bị hoán đổi. st7789py đọc như vậy khi needs_swap bật, và đọc ngược thứ tự byte khi tắt. Nếu đỏ và xanh đổi chỗ cho nhau trên màn hình của bạn, đó chính là việc hoán đổi đó. Cùng một driver và tệp sẽ hoạt động y như vậy trên bo mạch thật.

Bản gc9a01py đã xuất bản tính hai byte của mỗi điểm ảnh trong bitmap() với một sai sót ở một dòng (color & 0xff00 >> 8 được tính thành color & 0xff), nên byte thấp là chỉ số bảng màu thay vì một phần của màu. Điều này thể hiện qua các sắc màu hơi sai. Đổi hai dòng đó thành buffer[i] = color & 0xff và buffer[i + 1] = color >> 8 sẽ khắc phục được.