لماذا لا تكفي ملف صورة عادي
برامج تشغيل الشاشات من Russ Hughes (gc9a01py وst7789py وبرنامج ILI9342C) ترسم صورة عبر tft.bitmap(module, x, y). يجب أن يحتوي module على WIDTH وHEIGHT وBPP وPALETTE وBITMAP، وهو ما يكتبه ملفّه imgtobitmap.py. الملف الذي يحتوي على WIDTH وHEIGHT وكتلة بيانات فقط يتوقف مع رسالة "module has nothing called BITMAP"، على Mokxi كما على لوحة حقيقية. ينشئ Mokxi لك الملف الصحيح.
أنشئ الوحدة
- افتح مشروع MicroPython (لوحة بها
main.py). زر + في مشروع CircuitPython يطلب اسم ملف فقط. - اضغط + في تبويبات الملفات واختر إضافة صورة كصورة نقطية.
- اختر ملف PNG أو JPG.
- اضبط العرض والارتفاع. تغيير أحدهما يغيّر الآخر لتحافظ الصورة على شكلها. يبدآن عند أكبر حجم يناسب 240 x 240، أو شاشتك في الدائرة إن وُجدت.
- اختر الألوان: 2 أو 4 أو 16 أو 256. الألوان الأكثر تبدو أفضل وتشغل مساحة أكبر: صورة 70 x 70 تبلغ 613 بايت بمعدل بت واحد لكل بكسل في لونين، و4,900 بايت بمعدل 8 بتات لكل بكسل في 256 لونًا.
- تحقق من المعاينة، وغيّر اسم الملف إن أردت، ثم اضغط إضافة إلى المشروع.
يُفتح <name>.py الجديد في تبويبه الخاص. لا يُرفع شيء: تُقرأ الصورة وتُصغَّر في متصفحك.
ارسمها
انسخ المشغّل إلى المشروع كما تفعل مع أي مكتبة، ثم استورد الوحدة الجديدة بجانبه. لشاشة 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)
يجب أن تتسع الصورة على الشاشة بدءًا من x وy اللذين تحددهما: لا يرسم المشغّل شيئًا، أو يرسم زيادة، عندما لا تتسع.
إذا بدت الألوان خاطئة
تُخزَّن لوحة الألوان بالطريقة التي تقرأها بها مشغّلات C، مع تبديل بايتي كل لون. يقرؤها st7789py بهذه الطريقة عندما يكون needs_swap مفعّلًا، ويعرض البايتات بالترتيب المعاكس عندما يكون معطّلًا. إذا تبادل الأحمر والأزرق مكانيهما على شاشتك، فهذا هو التبديل. المشغّل والملف نفسهما يتصرفان بنفس الطريقة على لوحة حقيقية.
يحسب gc9a01py المنشور البايتين لكل بكسل في bitmap() مع خطأ في سطر واحد (color & 0xff00 >> 8 تُجمَّع كـ color & 0xff)، فيكون بايته المنخفض فهرسًا في لوحة الألوان لا جزءًا من اللون. يظهر ذلك كدرجات لونية خاطئة قليلًا. تغيير هذين السطرين إلى buffer[i] = color & 0xff وbuffer[i + 1] = color >> 8 يحل المشكلة.