Startseite › Entwickler-Tools › Bild in C-Array

Bild in C-Array

Wandle ein Bild in ein C-Byte-Array um, das bereit für ein Embedded-Display ist. Wähle die Displaygröße, entscheide dich für Monochrom mit Schwellenwert und Dithering, Graustufen, RGB565 oder RGB888 und sieh genau, was das Display zeigen wird, bevor du den Code kopierst.

Zuletzt aktualisiert:

Umgewandelte Vorschau
Anzeige
Anzeige

Anleitung: Bild in C-Array

  1. Zieh ein Bild hierher, wähle eines aus oder füge es mit Strg+V ein. Ein Beispiel ist geladen, damit du die Einstellungen zuerst ausprobieren kannst.
  2. Wähle die Displaygröße aus den Voreinstellungen oder gib eine eigene Breite und Höhe ein und wähle dann, wie das Bild skaliert wird.
  3. Wähle das Farbformat, das dein Treiber erwartet: Monochrom für die meisten OLEDs, RGB565 für Farb-TFTs.
  4. Optimiere das Ergebnis mit Schwellenwert, Dithering, Invertieren und Byte-Layout, während du die Vorschau beobachtest.
  5. Kopiere das Array oder lade die .h-Datei herunter und zeichne es mit deiner Display-Bibliothek.

Farbformate und Speicherbedarf

FormatBits pro Pixel128 × 64240 × 240Typische Displays
Monochrom 1 Bit11,024 B7,200 BSSD1306, SH1106, PCD8544 (Nokia 5110), E-Paper
Graustufen 4 Bit44,096 B28,800 BSSD1322, SSD1327 Graustufen-OLEDs
Graustufen 8 Bit / RGB33288,192 B57,600 BSprites mit 8-Bit-Paletten, LVGL L8
RGB5651616,384 B115,200 BILI9341, ST7735, ST7789, GC9A01, SSD1351
RGB8882424,576 B172,800 BDesktop-Framebuffer, LED-Matrizen, Bildverarbeitung

Ein Arduino Uno hat 32 KB Flash, ein bildschirmfüllendes 128 × 64 Monochrombild passt also problemlos, aber ein 240 × 240 RGB565-Bild (112.5 KB) braucht ein Board wie einen ESP32 oder RP2040.

Das Array zeichnen

// Adafruit SSD1306 / GFX: horizontal, MSB first
display.drawBitmap(0, 0, image, IMAGE_WIDTH, IMAGE_HEIGHT, SSD1306_WHITE);
display.display();

// u8g2: horizontal, LSB first (XBM)
u8g2.drawXBMP(0, 0, IMAGE_WIDTH, IMAGE_HEIGHT, image);

// TFT_eSPI: RGB565 as uint16_t words
tft.pushImage(0, 0, IMAGE_WIDTH, IMAGE_HEIGHT, image);

Tipps für scharfe Ergebnisse

  • Gestalte in der Endgröße. Wird ein großes Foto auf 128 × 64 verkleinert, gehen Details verloren; Text und Symbole, die in der exakten Auflösung des Displays gezeichnet sind, bleiben scharf.
  • Prüfe die Vorschau im Zoom: Sie zeigt genau die Pixel, die leuchten werden, einschließlich Dithering-Mustern und der Auffüllung, wenn die Breite kein Vielfaches von 8 ist.
  • Transparente PNGs werden zuerst auf Schwarz oder Weiß gelegt; wähle die Farbe, die zum Hintergrund deines Bildschirms passt.
  • Farben auf einem TFT falsch? Wenn Rot und Blau vertauscht sind, ist das Panel im BGR-Modus; wenn Farben verrauscht aussehen, probiere die Option RGB565 mit vertauschten Bytes (Big-Endian) oder setSwapBytes() deiner Bibliothek.

Häufige Fragen

Welches Byte-Layout braucht meine OLED-Bibliothek?

Adafruit GFX drawBitmap() erwartet horizontale Zeilen, höchstwertiges Bit zuerst, jede Zeile auf ein ganzes Byte aufgefüllt. u8g2 drawXBM() erwartet horizontale Zeilen mit dem niedrigstwertigen Bit zuerst (XBM-Format). Direktes Schreiben in einen SSD1306- oder SH1106-Framebuffer braucht vertikale Pages: Jedes Byte ist eine Spalte aus 8 Pixeln mit Bit 0 oben.

Was ist RGB565?

RGB565 packt eine Farbe in 16 Bit: 5 Bit Rot, 6 Grün und 5 Blau, berechnet als ((R & 0xF8) << 8) | ((G & 0xFC) << 3) | (B >> 3). Es ist das native Format der meisten SPI-TFT-Controller wie ILI9341, ST7735 und ST7789. Bibliotheken wie TFT_eSPI und drawRGBBitmap() von Adafruit GFX nehmen uint16_t-Arrays; manche DMA-Routinen brauchen die zwei Bytes vertauscht (Big-Endian).

Wie groß wird das Array?

Ein monochromes Bild braucht Breite × Höhe ÷ 8 Bytes, ein 128 × 64 OLED-Bildschirm also 1,024 Bytes. Graustufen mit 4 Bit brauchen ein halbes Byte pro Pixel, RGB332 und 8-Bit-Graustufen ein Byte, RGB565 zwei Bytes und RGB888 drei Bytes pro Pixel, ein 240 × 240 RGB565-Bild hat also 115,200 Bytes.

Wann sollte ich Dithering verwenden?

Verwende Dithering für Fotos, Verläufe und schattierte Logos auf 1-Bit-Bildschirmen: Es simuliert Graustufen durch Punktmuster. Floyd–Steinberg liefert das weichste Ergebnis, Atkinson behält mehr Kontrast, und geordnetes (Bayer-)Dithering erzeugt ein regelmäßiges Muster, das auf kleinen Displays gut aussieht. Für Text, Symbole und Strichzeichnungen ist einfacher Schwellenwert schärfer.

Was bewirkt der Schwellenwert?

Die Helligkeit jedes Pixels wird als 0.299 R + 0.587 G + 0.114 B (0 bis 255) berechnet. Pixel auf oder über dem Schwellenwert werden zu 1 (leuchtend), dunklere zu 0. Senke den Schwellenwert, um mehr Pixel leuchten zu lassen, erhöhe ihn für weniger, oder aktiviere Invertieren, um sie zu tauschen.

Brauche ich PROGMEM?

Auf AVR-Boards wie Arduino Uno oder Nano ja: Ohne PROGMEM wird ein konstantes Array beim Start in die 2 KB RAM kopiert. Bibliotheken wie Adafruit GFX lesen PROGMEM-Bitmaps mit pgm_read_byte(). Auf ESP32-, ESP8266-, RP2040- und ARM-Boards bleiben const-Daten ohnehin im Flash, und PROGMEM ist aus Kompatibilitätsgründen leer definiert.

Wird mein Bild hochgeladen?

Nein. Das Bild wird mit der Canvas-API in deinem Browser dekodiert, skaliert und umgewandelt, und der Code wird auf deinem Gerät erzeugt.

Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?

Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.

Ähnliche Tools

Alle Daten- & Dateiformat-Konverter ansehen →