Text

Beschreibung

Mit dieser Klasse lassen sich anpassbare Textinhalte erstellen. Die Klasse erbt von Item.

Funktionen

	Text (const std::string text, uint8_t size, const Color& color = Color(0, 0, 0))
	Text (const std::string text, const uint8_t sizeX, const uint8_t sizeY, const Color& color = Color(0, 0, 0))
void	draw (uint16_t x, uint16_t y, Display* disp, const Color& color) override
void	draw (uint16_t x, uint16_t y, Display* disp) override
void	drawOn (uint16_t x, uint16_t y, Display* disp) override
void	drawOff (uint16_t x, uint16_t y, Display* disp) override
void	setResolution (const uint16_t width, const uint16_t height, const bool override = false) override
void	setSize (const uint8_t borderSize, const bool override) override

Variablen und Konstanten

const uint8_t	size
const „Color	color
const std::string	text
uint16_t	width
uint16_t	height

Funktionen Beschreibung

Text(const std::string text, uint8_t size, const Color& color = Color(0, 0, 0))

Text::Text(const std::string text, uint8_t size, const Color& color)
    : size(size), color(color), text(text) {}

Der Konstruktor wird bei der Erzeugung eines neuen Text Objektes aufgerufen. Als Parameter nimmt der Konstruktor einen String, der den anzuzeigenden text enthält (text), die gewünschte Textgröße (size) und die Farbe, in der der Text angezeigt werden soll (color). Dieser ist standardmäßig schwarz. In der Initialisierungsliste werden die Variablen text, size, und color mit den korrespondierenden Variablen initialisiert.

Text(const std::string text, const uint8_t sizeX, const uint8_t sizeY, const Color& color = Color(0, 0, 0))

Text::Text(const std::string text, const uint8_t sizeX, const uint8_t sizeY, const Color& color)
    : size(1), color(color), text(text) {}

Der Konstruktor wird bei der Erzeugung eines neuen Text Objektes aufgerufen. Als Parameter nimmt der Konstruktor einen String, der den anzuzeigenden text enthält (text), die gewünschte Breite und Höhe des Texts (sizeX bzw. sizeY) und die Farbe, in der der Text angezeigt werden soll (color). Dieser ist standardmäßig schwarz. In der Initialisierungsliste werden die Variablen text und color mit den korrespondierenden Variablen initialisiert.

void draw(uint16_t x, uint16_t y, Display* disp, const Color& color) override

void Text::draw(uint16_t x, uint16_t y, Display* disp, const Color& textColor) {
    // LOGGER_PATTERN("schreibe text '_' an der Stelle _/_ in der Farbe _ und der Size: _", text.c_str(), x, y, textColor.toString(), size)
    // LOGGER_PATTERN("Text: '_'", text.c_str())
    disp->text_center(x, y, size, text.c_str(), textColor);
}

Zeichnet den Text auf das Display Objekt disp mithilfe der text_center Funktion. Dafür werden der Funktion die x und y Koordinate übergeben, bei welchen der Text gezeichnet werden soll, die Textgröße (size), die Textfarbe textColor sowie der Text an sich (text), welcher mit .c_str() von einem String zu einem character array umgewandelt wird.

void draw(uint16_t x, uint16_t y, Display* disp) override

void Text::draw(uint16_t x, uint16_t y, Display* disp) {
    draw(x, y, disp, color);
}

Ruft die draw Funktion mit color als Argument auf.

void drawOn(uint16_t x, uint16_t y, Display* disp) override

void Text::drawOn(uint16_t x, uint16_t y, Display* disp) {
    draw(x, y, disp, color);
}

Ruft die draw Funktion mit color als Argument auf. Diese Funktion wird verwendet, wenn ein Element einen aktivierten und deaktivierten Zustand hat, und ein Text für den aktivierten Zustand gezeichnet werden soll.

void drawOff(uint16_t x, uint16_t y, Display* disp) override

void Text::drawOff(uint16_t x, uint16_t y, Display* disp) {
    draw(x, y, disp, color.getSecondaryColor());
}

Ruft die draw Funktion mit color.getSecondaryColor() als Argument auf. Diese Funktion wird verwendet, wenn ein Element einen aktivierten und deaktivierten Zustand hat, und ein Text für den deaktivierten Zustand gezeichnet werden soll.

void setResolution(const uint16_t width, const uint16_t height, const bool override = false) override

void Text::setResolution(const uint16_t w, const uint16_t h, const bool override) {
    if (!override) {
        width = w;
        height = h;
    }
}

Mit dieser Funktion wird die Auflösung von Objekten der Text Klasse gesetzt. Dafür wird width auf den Wert von w gesetzt und height auf den Wert von h, solange override true ist.

void setSize(const uint8_t borderSize, const bool override) override

void Text::setSize(const uint8_t _size, const bool override) {
    if (!override) size = _size;
}

Mit dieser Funktion lässt sich eine neue size setzen.

Variablen und Konstanten Beschreibung

const uint8_t size

Die Schriftgröße des Texts.

const Color color

Die Farbe des Texts.

const std::string text

Dieser String enthält den tatsächlichen Textinhalt, der auf dem Display angezeigt werden soll.

uint16_t width

Die Breite des Texts.

uint16_t height

Die Höhe des Texts.