TFT Görsel Çevirici

Resmi TFT ekranda göstermenin kısa yolu

Bir mikrodenetleyicide ekrana resim basmanın yolu dosya okumak değil, resmi derleme zamanında bir C dizisine çevirmektir. ILI9341, ST7789, ST7735, GC9A01 ve ILI9488 gibi sürücülerin hepsi piksel başına 16 bit RGB565 bekler. Bu sayfa görseli o biçime indirger, sonucu panelin gerçek çözünürlüğünde gösterir ve ortaya çıkan dizinin kaç bayt tuttuğunu söyler.

RGB565 nasıl paketlenir

Kırmızının üst 5 biti, yeşilin üst 6 biti ve mavinin üst 5 biti tek bir 16 bitlik sözcüğe sıkıştırılır:

uint16_t rgb565 = ((r & 0xF8) << 8) | ((g & 0xFC) << 3) | (b >> 3);

Yeşile bir bit fazla verilmesinin sebebi göz duyarlılığıdır. Sonuçta kanal başına 32, 64 ve 32 kademe kalır; 24 bitlik kaynaktaki yumuşak geçişler bu kademelere oturduğu için gradyanlarda bantlanma görürsünüz. Bantlanmayı kırmak için dithering seçeneğini açın, Floyd-Steinberg yuvarlama hatasını komşu piksellere dağıtır.

Diziyi ekrana basmak

TFT_eSPI tarafında tek satır yeterlidir. Kütüphanenin diziyi doğru okuması için bayt sırasının bir kez ayarlanması gerekir:

#include <TFT_eSPI.h>
#include "tft_image.h"

TFT_eSPI tft = TFT_eSPI();

void setup() {
  tft.init();
  tft.fillScreen(TFT_BLACK);
  tft.setSwapBytes(true);           // dizi big-endian üretildiyse
  tft.pushImage(0, 0, TFT_IMAGE_WIDTH, TFT_IMAGE_HEIGHT, tft_image);
}

Adafruit_GFX kullanıyorsanız karşılığı tft.drawRGBBitmap(x, y, dizi, genislik, yukseklik) olur. Bu API bayt çevirmez, dolayısıyla Adafruit tarafında Bayt sırasını çevir seçeneğini kapalı bırakın.

Renkler ters çıkıyorsa

Mavi ile kırmızının yer değiştirmesi, resmin bozuk olduğu anlamına gelmez; iki baytın sürücüye ters sırada gitmesi demektir. Çözüm tek bir yerde: ya diziyi çevrilmiş üretin ya da kütüphaneye çevirtin, ikisini birden yapmayın. Aynı görsel bir kartta doğru, diğerinde ters görünüyorsa aradaki fark genellikle bu satırdır.

Flash maliyeti ve nereye sığdığı

RGB565'te bir görselin boyutu basitçe genişlik x yükseklik x 2'dir. Birkaç yaygın ölçü:

• 128x128 = 32.768 bayt (32 KB)
• 160x128 = 40.960 bayt (40 KB)
• 240x240 = 115.200 bayt (112,5 KB)
• 320x240 = 153.600 bayt (150 KB)
• 480x320 = 307.200 bayt (300 KB)

Yani tek bir tam ekran görsel Arduino Uno'nun 32 KB flash'ının tamamını aşar, ESP32'nin 1,25 MB uygulama bölümünde ise rahatça durur. Sayfadaki bütçe çubukları bu karşılaştırmayı anlık yapar. Yer sıkıntısı varsa sırasıyla şunları deneyin: görseli küçültün, RGB332 veya 8 bit gri seçin, ya da tek renkli bir logo için LCD Assistant ile 1 bit bitmap üretin, o biçim piksel başına 1 bit tutar.

Yuvarlak ekranlar ve saydamlık

GC9A01 gibi yuvarlak paneller yine kare bir tampon bekler, sadece köşeleri göstermez. Yuvarlak maske seçeneği daire dışındaki pikselleri arka plan rengine boyar ve önizlemeyi gerçek çerçeveye geçirir, böylece taşan köşeler yüzünden hizalama yanılgısı yaşamazsınız. Arka planı ekranda görünmesin istemiyorsanız saydam renk kutusunu işaretleyin; üretilen taslak pushImage çağrısına o rengi saydam olarak geçirir, o renkteki pikseller ekranda olduğu gibi bırakılır.

Çoklu kare ve animasyon

Birden fazla dosya seçerseniz hepsi tek başlık dosyasına girer ve sona bir _frames[] işaretçi tablosu eklenir; üretilen TFT_eSPI taslağı da bu tabloyu döngüde gezer. Kaynak bir GIF ise kareleri tek tek ayırmak yerine GIF'ten OLED animasyon aracına bakın. Tek bir rengin RGB565 karşılığını merak ediyorsanız RGB565 renk çevirici daha hızlı, LVGL kullanıyorsanız LVGL görsel çevirici lv_image_dsc_t biçimini üretir.