Hello world

Was dieses Beispiel zeigt

Der kleinste sinnvolle Sketch: Er startet die Bibliothek, schreibt Hello World! in Schwarz in den Framebuffer und aktualisiert den Bildschirm einmal. Alles, was Sie zeichnen, landet zuerst im Framebuffer, und auf dem Panel ändert sich nichts, bis Sie display() aufrufen.

Beispielcode

Wählen Sie vor dem Hochladen unter Tools → Board die Option Soldered Inkplate 7SPECTRA aus.

Select Board

Inkplate7SPECTRA_Hello_World.ino

#include "Inkplate.h" // Include the Inkplate library
Inkplate display; // Create an Inkplate object for Inkplate 7SPECTRA

void setup() {
    display.begin();             // Initialize the display hardware
    display.clearDisplay();      // Clear the frame buffer (does NOT clear the physical screen)
    display.setCursor(10, 10);   // Set the text position to (10, 10) pixels
    display.setTextSize(3);      // Set text size to 3 (default is 1)
    display.setTextColor(INKPLATE_BLACK); // Set text color to black
    display.print("Hello World!"); // Print "Hello World!" at the set position
    display.display();           // Refresh the e-paper display to show changes
}

void loop() {
    // No code needed here for this example
}

Verwendete Funktionen

Inkplate()returns None

Erstellt das Inkplate-Objekt. Inkplate 7SPECTRA hat einen einzigen Sechs-Farben-Modus, daher erwartet der Konstruktor kein Modus-Argument.

ReturnsKonstruktor; kein Rückgabewert.

display.begin()returns void

Initialisiert die Bibliothek, die Peripherie und den Framebuffer, der zunächst weiß ist. Rufen Sie sie einmal in setup() auf; spätere Aufrufe werden ignoriert.

ReturnsNichts.

display.clearDisplay()returns void

Füllt den Framebuffer mit Weiß. Das Panel wird dadurch nicht verändert; rufen Sie dafür anschließend display() auf.

ReturnsNichts.

display.setCursor(int16_t x, int16_t y)returns void

Legt fest, wo der nächste ausgegebene Text beginnt, in Pixeln von der oberen linken Ecke aus. Stammt aus der Adafruit-GFX-Klasse, auf der die Bibliothek aufbaut.

ReturnsNichts.

Parameter

Typ	Name	Beschreibung
int16_t	x	X-Koordinate, 0 bis 799.
int16_t	y	Y-Koordinate, 0 bis 479.

display.setTextSize(uint8_t s)returns void

Legt die Textvergrößerung fest. Größe 1 ist die Basisschrift mit 5×7 Pixeln; 3 macht sie dreimal so groß.

ReturnsNichts.

Parameter

Typ	Name	Beschreibung
uint8_t	s	Multiplikator der Textgröße.

display.setTextColor(uint16_t c)returns void

Legt die Textfarbe fest. Verwenden Sie eine der sechs Farbkonstanten: INKPLATE_BLACK, INKPLATE_WHITE, INKPLATE_YELLOW, INKPLATE_RED, INKPLATE_BLUE, INKPLATE_GREEN.

ReturnsNichts.

Parameter

Typ	Name	Beschreibung
uint16_t	c	Farbindex, 0 bis 5.

display.print(value)returns size_t

Gibt Text, ein Zeichen oder eine Zahl an der Cursorposition in den Framebuffer aus. Das Display-Objekt erbt von der Arduino-Klasse Print, daher gibt es Text so aus wie Serial.

ReturnsAnzahl der ausgegebenen Bytes.

Parameter

Typ	Name	Beschreibung
Text, Zeichen oder Zahl	value	Was ausgegeben werden soll.

display.display(bool _leaveOn = 0)returns void

Sendet den gesamten Framebuffer an das Panel und aktualisiert es (eine vollständige Aktualisierung, die einzige Art, die dieses Panel unterstützt).

ReturnsNichts.

Parameter

Typ	Name	Beschreibung
bool	_leaveOn	Wenn true, bleibt die Versorgung des Panels nach der Aktualisierung eingeschaltet. Standardwert ist 0.

Was Sie erwarten können

Hello World! erscheint in Schwarz nahe der oberen linken Ecke, in dreifacher Basistextgröße. Der Sketch gibt nichts im Serial Monitor aus.

🔗Das vollständige Beispiel öffnen

examples/Inkplate7SPECTRA/Basic/Inkplate7SPECTRA_Hello_World

→