/** * Marlin 3D Printer Firmware * Copyright (c) 2020 MarlinFirmware [https://github.com/MarlinFirmware/Marlin] * * Based on Sprinter and grbl. * Copyright (c) 2011 Camiel Gubbels / Erik van der Zalm * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . * */ #pragma once // TODO: Make AVR-compatible with separate ROM / RAM string methods #include #include "../fontutils.h" extern const uint8_t ISO10646_1_5x7[]; extern const uint8_t font10x20[]; extern const uint8_t Helvetica12Bold[]; extern const uint8_t Helvetica14[], Helvetica14_symbols[]; extern const uint8_t Helvetica18[], Helvetica18_symbols[]; #define NO_GLYPH 0xFF typedef struct __attribute__((__packed__)) { uint8_t Format; uint8_t BBXWidth; uint8_t BBXHeight; int8_t BBXOffsetX; int8_t BBXOffsetY; uint8_t CapitalAHeight; uint16_t Encoding65Pos; uint16_t Encoding97Pos; uint8_t FontStartEncoding; uint8_t FontEndEncoding; int8_t LowerGDescent; int8_t FontAscent; int8_t FontDescent; int8_t FontXAscent; int8_t FontXDescent; } font_t; typedef struct __attribute__((__packed__)) { uint8_t BBXWidth; uint8_t BBXHeight; uint8_t DataSize; int8_t DWidth; int8_t BBXOffsetX; int8_t BBXOffsetY; } glyph_t; #define MAX_STRING_LENGTH 64 class TFT_String { private: static glyph_t *glyphs[256]; static font_t *font_header; static char data[MAX_STRING_LENGTH + 1]; static uint16_t span; // in pixels static void add_character(const char character); static void eol() { data[length] = '\0'; } public: static uint8_t length; // in characters static void set_font(const uint8_t *font); static void add_glyphs(const uint8_t *font); static font_t *font() { return font_header; }; static uint16_t font_height() { return font_header->FontAscent - font_header->FontDescent; } static glyph_t *glyph(uint8_t character) { return glyphs[character] ?: glyphs[0x3F]; } /* Use '?' for unknown glyphs */ static glyph_t *glyph(uint8_t *character) { return glyph(*character); } /** * @brief Set the string empty */ static void set(); /** * @brief Append an ASCII character and EOL * * @param character The ASCII character */ static void add(const char character) { add_character(character); eol(); } static void set(const lchar_t &character) { set(); add(character); } /** * @brief Append / Set C-string * * @param cstr The string * @param max_len Character limit */ static void add(const char *cstr, uint8_t max_len=MAX_STRING_LENGTH); static void set(const char *cstr, uint8_t max_len=MAX_STRING_LENGTH) { set(); add(cstr, max_len); } /** * @brief Append / Set F-string * * @param fstr The string * @param max_len Character limit */ static void add(FSTR_P const fstr, uint8_t max_len=MAX_STRING_LENGTH) { add(FTOP(fstr), max_len); } static void set(FSTR_P const fstr, uint8_t max_len=MAX_STRING_LENGTH) { set(FTOP(fstr), max_len); } /** * @brief Append / Set C-string with optional substitution * * @param tpl A string with optional substitution * @param index An index * @param cstr An SRAM C-string to use for $ substitution * @param fstr A ROM F-string to use for $ substitution */ static void add(const char *tpl, const int8_t index, const char *cstr=nullptr, FSTR_P const fstr=nullptr); static void set(const char *tpl, const int8_t index, const char *cstr=nullptr, FSTR_P const fstr=nullptr) { set(); add(tpl, index, cstr, fstr); } /** * @brief Append / Set F-string with optional substitution * * @param ftpl A ROM F-string with optional substitution * @param index An index * @param cstr An SRAM C-string to use for $ substitution * @param fstr A ROM F-string to use for $ substitution */ static void add(FSTR_P const ftpl, const int8_t index, const char *cstr=nullptr, FSTR_P const fstr=nullptr) { add(FTOP(ftpl), index, cstr, fstr); } static void set(FSTR_P const ftpl, const int8_t index, const char *cstr=nullptr, FSTR_P const fstr=nullptr) { set(); add(ftpl, index, cstr, fstr); } // Common string ops static void trim(const char character=' '); static void rtrim(const char character=' '); static void ltrim(const char character=' '); static void truncate(const uint8_t maxlen) { if (length > maxlen) { length = maxlen; eol(); } } // Accessors static char *string() { return data; } static uint16_t width() { return span; } static uint16_t center(const uint16_t width) { return span > width ? 0 : (width - span) / 2; } }; extern TFT_String tft_string;