Hello world

Što ovaj primjer prikazuje

Najmanja korisna skica: pokrenite biblioteku, upišite Hello World! crnom bojom u frame buffer i jednom osvježite zaslon. Sve što crtate najprije ide u frame buffer, a na zaslonu se ništa ne mijenja dok ne pozovete display().

Primjer koda

Prije prijenosa programa na pločicu odaberite Soldered Inkplate 7SPECTRA u izborniku Tools → Board.

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
}

Korištene funkcije

Inkplate()returns None

Stvara Inkplate objekt. Inkplate 7SPECTRA ima jedan šestobojni način rada, pa konstruktor ne prima argument načina rada.

ReturnsKonstruktor; nema povratne vrijednosti.

display.begin()returns void

Inicijalizira biblioteku, periferiju i frame buffer, koji je na početku bijel. Pozovite ga jednom u setup(); kasniji pozivi se zanemaruju.

ReturnsNišta.

display.clearDisplay()returns void

Ispunjava frame buffer bijelom bojom. Ne mijenja prikaz na zaslonu; za to nakon toga pozovite display().

ReturnsNišta.

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

Postavlja mjesto na kojem počinje sljedeći ispisani tekst, u pikselima od gornjeg lijevog kuta. Dolazi iz klase Adafruit GFX na kojoj se biblioteka temelji.

ReturnsNišta.

Parametri

Tip	Naziv	Opis
int16_t	x	X koordinata, od 0 do 799.
int16_t	y	Y koordinata, od 0 do 479.

display.setTextSize(uint8_t s)returns void

Postavlja povećanje teksta. Veličina 1 je osnovni font od 5×7 piksela; veličina 3 čini ga tri puta većim.

ReturnsNišta.

Parametri

Tip	Naziv	Opis
uint8_t	s	Množitelj veličine teksta.

display.setTextColor(uint16_t c)returns void

Postavlja boju teksta. Koristite jednu od šest konstanti boja: INKPLATE_BLACK, INKPLATE_WHITE, INKPLATE_YELLOW, INKPLATE_RED, INKPLATE_BLUE, INKPLATE_GREEN.

ReturnsNišta.

Parametri

Tip	Naziv	Opis
uint16_t	c	Indeks boje, od 0 do 5.

display.print(value)returns size_t

Ispisuje tekst, znak ili broj na položaju kursora, u frame buffer. Objekt display nasljeđuje Arduino klasu Print, pa ispisuje jednako kao Serial.

ReturnsBroj ispisanih bajtova.

Parametri

Tip	Naziv	Opis
tekst, znak ili broj	value	Što ispisati.

display.display(bool _leaveOn = 0)returns void

Šalje cijeli frame buffer na zaslon i osvježava ga (potpuno osvježavanje, jedini koji ovaj zaslon podržava).

ReturnsNišta.

Parametri

Tip	Naziv	Opis
bool	_leaveOn	Ako je true, napajanje zaslona ostaje uključeno nakon osvježavanja. Zadano je 0.

Što očekivati

Hello World! pojavljuje se crnom bojom blizu gornjeg lijevog kuta, u trostruko većoj veličini od osnovne veličine teksta. Skica ništa ne ispisuje u Serial Monitor.

🔗Otvorite cjeloviti primjer

examples/Inkplate7SPECTRA/Basic/Inkplate7SPECTRA_Hello_World

→