Adafruit GFX Library

Perpustakaan Adafruit GFX

Ini adalah pustaka grafis inti untuk semua tampilan kami, memberikan satu set umum grafis primitif (titik, garis, lingkaran, dll.). Perlu dipasangkan dengan pustaka khusus perangkat keras untuk setiap perangkat tampilan yang kami bawa (untuk menangani fungsi tingkat bawah).

Adafruit menginvestasikan waktu dan sumber daya yang menyediakan kode open source ini, harap dukung ADAFRUIT dan perangkat keras open-source dengan membeli produk dari Adafruit!

Ditulis oleh Limor Fried/Ladyada untuk industri Adafruit. Lisensi BSD, periksa lisensi.txt untuk informasi lebih lanjut. Semua teks di atas harus dimasukkan dalam redistribusi apa pun.

Rilis IDE Arduino terbaru termasuk Manajer Perpustakaan untuk instalasi yang mudah. Kalau tidak, untuk mengunduh, klik tombol Download Zip, Uncompress, dan ganti nama folder yang tidak terkompresi AdaFruit_GFX. Konfirmasikan bahwa folder Adafruit_GFX berisi Adafruit_Gfx.cpp dan Adafruit_GFX.h. Tempatkan folder pustaka Adafruit_GFX Anda Arduinosketchfolder/ Libraries/ Folder. Anda mungkin perlu membuat subfolder perpustakaan jika ini perpustakaan pertama Anda. Mulai ulang IDE.

Anda juga perlu menginstal perpustakaan ADAFRUIT BUSIO terbaru. Cari "Adafruit Busio" di manajer perpustakaan, atau instal dengan tangan dari https://github.com/adafruit/adafruit_busio

Sumber daya yang berguna

• Image2Code: Ini adalah utilitas Java GUI yang praktis untuk mengonversi file BMP menjadi kode array yang diperlukan untuk menampilkan gambar dengan fungsi drawbitmap. Lihat kode di repositori gitub ehubin: https://github.com/ehubin/adafruit-gfx-library/tree/master/img2code

• Fungsi DrawXBitMap: Anda dapat menggunakan editor foto GIMP untuk menyimpan file .xbm dan menggunakan array yang disimpan dalam file untuk menggambar bitmap dengan fungsi drawxbitmap. Lihat permintaan tarik di sini untuk detail lebih lanjut: #31

• Folder 'Fonts' berisi font bitmap untuk digunakan dengan ADAFRUIT_GFX (1.1 dan yang lebih baru). Untuk menggunakan font dalam sketsa Arduino Anda, #termasuk file .h yang sesuai dan alamat lulus dari gfxfont struct ke setFont (). Lewati nol untuk kembali ke font bitmap spasi tetap 'klasik'.

• Folder 'FontConvert' berisi alat baris perintah untuk mengonversi font TTF ke format header Adafruit_GFX.

• Anda juga dapat menggunakan alat kustomer font GFX ini ( versi web di sini ) untuk menyesuaikan atau memperbaiki output dari fontConvert, dan membuat font dengan hanya subset karakter untuk mengoptimalkan ukuran.

---

Peta jalan

Petunjuk utama adalah untuk mempertahankan kompatibilitas ke belakang dengan sketsa Arduino yang ada - banyak yang di -host di tempat lain dan tidak melacak perubahan di sini, beberapa dicetak dan tidak akan pernah bisa diubah! Perpustakaan "kecil" ini telah tumbuh secara organik dari waktu ke waktu dan kadang -kadang kita melukis diri kita ke sudut desain dan hanya harus hidup dengannya atau menambahkan solusi yang semakin fasik.

Kami berterima kasih atas kontribusi semua orang, tetapi permintaan tarik untuk hal -hal berikut tidak akan digabungkan:

• Format font tambahan atau tidak kompatibel (lihat Petunjuk Prime di atas). Sudah ada dua format dan kodenya cukup kembung di sana. Ini juga menciptakan kewajiban untuk alat dan dokumentasi. Apa yang tidak sempurna tetapi itu berhasil.

• Format bitmap tambahan atau tidak kompatibel, untuk alasan yang sama. Semakin berantakan.

• Menambahkan warna latar belakang ke font khusus untuk menghapus konten layar sebelumnya. Satu -satunya metode yang dapat diterima adalah membersihkan area dengan rect yang diisi, atau (untuk menghindari flicker) menggambar teks ke dalam gfxcanvas1 dan menyalin ke layar dengan drawbitmap () dengan warna latar belakang. Ini sengaja dan desain. Kami telah membahas ini. Mesin terbang bisa tumpang tindih.

• Menggulir, apakah perangkat keras atau perangkat lunak berbasis. Implementasi seperti itu cenderung mengandalkan fitur-fitur khusus perangkat keras (tidak tersedia secara universal), baca akses ke framebuffer layar (ditto) dan/atau penambahan fungsi virtual di GFX yang harus ditambahkan di setiap subkelas, di mana ada banyak. API GFX sebagian besar "ditetapkan" pada titik ini dan ini hanyalah batasan yang kita jalani sekarang.

• Tolong jangan memformat ulang kode demi memformat ulang kode. "Visual Diff" besar yang dihasilkan membuat tidak mungkin untuk mengurai perbaikan bug yang sebenarnya dari garis yang disusun ulang. Format dentang akan menjadi wasit terakhir.

• Harap tidak ada lagi PR yang menggambar pentagram. Setiap fungsi gambar khusus yang aneh dapat masuk dalam kode Anda sendiri dan tidak membantu dalam konteks perpustakaan.

Jika Anda harus memiliki salah satu fitur ini, pertimbangkan untuk membuat garpu dengan fitur yang diperlukan untuk proyek Anda ... mudah untuk tetap disinkronkan dengan kode hulu.