nbgl_fonts.c

Go to the documentation of this file.

 
/*********************
 *      INCLUDES
 *********************/
#include <string.h>
#include "app_config.h"
#include "nbgl_debug.h"
#include "nbgl_draw.h"
#include "nbgl_fonts.h"
#include "os_helpers.h"
#include "os_pic.h"
#include "os_task.h"
#include "ux_loc.h"
 
/*********************
 *      DEFINES
 *********************/
#define PIC_FONT(x)       ((nbgl_font_t const *) PIC(x))
#define BAGL_FONT_ID_MASK 0x0FFF
 
#define IS_WORD_DELIM(c) (c == ' ' || c == '\n' || c == '\b' || c == '\f' || c == '-' || c == '_')
 
/**********************
 *      TYPEDEFS
 **********************/
 
/**********************
 *  STATIC VARIABLES
 **********************/
static nbgl_unicode_ctx_t unicodeCtx = {0};
 
/**********************
 *      VARIABLES
 **********************/
 
static const LANGUAGE_PACK *language_pack;
 
#if SMALL_FONT_HEIGHT == 24
#include "nbgl_font_inter_regular_24.inc"
#include "nbgl_font_inter_semibold_24.inc"
#include "nbgl_font_inter_medium_32.inc"
#include "nbgl_font_inter_regular_24_1bpp.inc"
#include "nbgl_font_inter_semibold_24_1bpp.inc"
#include "nbgl_font_inter_medium_32_1bpp.inc"
#elif SMALL_FONT_HEIGHT == 28
#include "nbgl_font_inter_regular_28.inc"
#include "nbgl_font_inter_semibold_28.inc"
#include "nbgl_font_inter_medium_36.inc"
#include "nbgl_font_inter_regular_28_1bpp.inc"
#include "nbgl_font_inter_semibold_28_1bpp.inc"
#include "nbgl_font_inter_medium_36_1bpp.inc"
#elif SMALL_FONT_HEIGHT == 18
#include "nbgl_font_nanotext_medium_18_1bpp.inc"
#include "nbgl_font_nanotext_bold_18_1bpp.inc"
#include "nbgl_font_nanodisplay_semibold_24_1bpp.inc"
#elif SMALL_FONT_HEIGHT == 11
#include "nbgl_font_open_sans_extrabold_11.inc"
#include "nbgl_font_open_sans_regular_11.inc"
#include "nbgl_font_open_sans_light_16.inc"
#endif  // SMALL_FONT_HEIGHT
 
__attribute__((section("._nbgl_fonts_"))) const nbgl_font_t *const C_nbgl_fonts[] = {
 
#include "nbgl_font_rom_struct.inc"
 
};
__attribute__((section("._nbgl_fonts_"))) const unsigned int C_nbgl_fonts_count
    = sizeof(C_nbgl_fonts) / sizeof(C_nbgl_fonts[0]);
 
#if (defined(HAVE_BOLOS) && !defined(BOLOS_OS_UPGRADER_APP))
#endif  // HAVE_BOLOS
 
#ifdef BUILD_SCREENSHOTS
// Variables used to store important values (nb lines, bold state etc)
uint16_t last_nb_lines   = 0;
uint16_t last_nb_pages   = 0;
bool     last_bold_state = false;
 
// Used to detect when a hyphenation (caesura) has been forced.
bool hard_caesura = false;
#endif  // BUILD_SCREENSHOTS
 
/**********************
 *  STATIC PROTOTYPES
 **********************/
 
/**********************
 *   GLOBAL FUNCTIONS
 **********************/
 
const nbgl_font_t *nbgl_getFont(nbgl_font_id_e fontId)
{
    unsigned int i = C_nbgl_fonts_count;
    fontId &= BAGL_FONT_ID_MASK;
 
    while (i--) {
        // font id match this entry (non indexed array)
        if (PIC_FONT(C_nbgl_fonts[i])->font_id == fontId) {
            return PIC_FONT(C_nbgl_fonts[i]);
        }
    }
 
    // id not found
    return NULL;
}
 
uint32_t nbgl_popUnicodeChar(const uint8_t **text, uint16_t *textLen, bool *is_unicode)
{
    // Be sure there are still some characters to read;
    if (!*textLen) {
        return 0;
    }
    const uint8_t *txt      = *text;
    uint8_t        cur_char = *txt++;
    uint32_t       unicode;
 
    *is_unicode = true;
    // Handle UTF-8 decoding (RFC3629): (https://www.ietf.org/rfc/rfc3629.txt
    // Char. number range  |        UTF-8 octet sequence
    // (hexadecimal)    |              (binary)
    // --------------------+---------------------------------------------
    // 0000 0000-0000 007F | 0xxxxxxx
    // 0000 0080-0000 07FF | 110xxxxx 10xxxxxx
    // 0000 0800-0000 FFFF | 1110xxxx 10xxxxxx 10xxxxxx
    // 0001 0000-0010 FFFF | 11110xxx 10xxxxxx 10xxxxxx 10xxxxxx
 
    // 4 bytes UTF-8, Unicode 0x1000 to 0x1FFFF
    if ((cur_char >= 0xF0) && (*textLen >= 4)) {
        unicode = (cur_char & 0x07) << 18;
        unicode |= (*txt++ & 0x3F) << 12;
        unicode |= (*txt++ & 0x3F) << 6;
        unicode |= (*txt++ & 0x3F);
 
        // 3 bytes, from 0x800 to 0xFFFF
    }
    else if ((cur_char >= 0xE0) && (*textLen >= 3)) {
        unicode = (cur_char & 0x0F) << 12;
        unicode |= (*txt++ & 0x3F) << 6;
        unicode |= (*txt++ & 0x3F);
 
        // 2 bytes UTF-8, Unicode 0x80 to 0x7FF
        // (0xC0 & 0xC1 are unused and can be used to store something else)
    }
    else if ((cur_char >= 0xC2) && (*textLen >= 2)) {
        unicode = (cur_char & 0x1F) << 6;
        unicode |= (*txt++ & 0x3F);
    }
    else {
        *is_unicode = false;
        unicode     = cur_char;
    }
    *textLen = *textLen - (txt - *text);
    *text    = txt;
    return unicode;
}
 
static uint8_t getCharWidth(const nbgl_font_t *font, uint32_t unicode, bool is_unicode)
{
    if (is_unicode) {
        const nbgl_font_unicode_character_t *unicodeCharacter
            = nbgl_getUnicodeFontCharacter(unicode);
        if (!unicodeCharacter) {
            return 0;
        }
        // Don't take in account width of combined characters displayed over previous ones
#ifdef SCREEN_SIZE_WALLET
        if (unicodeCharacter->over_previous) {
            return 0;
        }
#endif  // SCREEN_SIZE_WALLET
        return unicodeCharacter->width - font->char_kerning;
    }
    else {
        const nbgl_font_character_t *character;  // non-unicode char
        if ((unicode < font->first_char) || (unicode > font->last_char)) {
            return 0;
        }
        character
            = (const nbgl_font_character_t *) PIC(&font->characters[unicode - font->first_char]);
        return character->width - font->char_kerning;
    }
}
 
static uint16_t getTextWidth(nbgl_font_id_e fontId,
                             const char    *text,
                             bool           breakOnLineEnd,
                             uint16_t       maxLen)
{
#ifdef BUILD_SCREENSHOTS
    uint16_t nb_lines = 0;
#endif  // BUILD_SCREENSHOTS
    uint16_t            line_width = 0;
    uint16_t            max_width  = 0;
    const nbgl_font_t  *font       = nbgl_getFont(fontId);
    uint16_t            textLen;
    nbgl_unicode_ctx_t *unicode_ctx = NULL;
 
    if (text == NULL) {
        return 0;
    }
    textLen = MIN(strlen(text), maxLen);
 
#ifdef BUILD_SCREENSHOTS
    last_bold_state      = fontId == BAGL_FONT_OPEN_SANS_EXTRABOLD_11px_1bpp;  // True if Bold
    bool next_bold_state = last_bold_state;
#endif  // BUILD_SCREENSHOTS
 
    // end loop text len is NULL (max reached)
    while (textLen) {
        uint8_t  char_width;
        uint32_t unicode;
        bool     is_unicode;
 
        unicode = nbgl_popUnicodeChar((const uint8_t **) &text, &textLen, &is_unicode);
        // Do we still have some characters to read?
        if (!unicode) {
            break;
        }
        if (is_unicode && !unicode_ctx) {
            unicode_ctx = nbgl_getUnicodeFont(fontId);
        }
        if (unicode == '\n') {
            if (breakOnLineEnd) {
                break;
            }
            // reset line width for next line
            line_width = 0;
            continue;
        }
        // if \b, switch fontId
        else if (unicode == '\b') {
            if (fontId == BAGL_FONT_OPEN_SANS_REGULAR_11px_1bpp) {  // switch to bold
                fontId      = BAGL_FONT_OPEN_SANS_EXTRABOLD_11px_1bpp;
                unicode_ctx = NULL;
                font        = nbgl_getFont(fontId);
#ifdef BUILD_SCREENSHOTS
                next_bold_state = true;
#endif  // BUILD_SCREENSHOTS
            }
            else if (fontId == BAGL_FONT_OPEN_SANS_EXTRABOLD_11px_1bpp) {  // switch to regular
                fontId      = BAGL_FONT_OPEN_SANS_REGULAR_11px_1bpp;
                unicode_ctx = NULL;
                font        = nbgl_getFont(fontId);
#ifdef BUILD_SCREENSHOTS
                next_bold_state = false;
#endif  // BUILD_SCREENSHOTS
            }
            continue;
        }
        char_width = getCharWidth(font, unicode, is_unicode);
#ifdef BUILD_SCREENSHOTS
        if (char_width != 0) {
            // Update last 'displayed' char with current bold status
            last_bold_state = next_bold_state;
        }
#endif  // BUILD_SCREENSHOTS
        line_width += char_width;
        // memorize max line width if greater than current
        if (line_width > max_width) {
            max_width = line_width;
        }
    }
#ifdef BUILD_SCREENSHOTS
    if (line_width != 0) {
        ++nb_lines;
    }
    last_nb_lines = nb_lines;
#endif  // BUILD_SCREENSHOTS
 
    return max_width;
}
 
uint16_t nbgl_getSingleLineTextWidth(nbgl_font_id_e fontId, const char *text)
{
    return getTextWidth(fontId, text, true, 0xFFFF);
}
 
uint16_t nbgl_getSingleLineTextWidthInLen(nbgl_font_id_e fontId, const char *text, uint16_t maxLen)
{
    return getTextWidth(fontId, text, true, maxLen);
}
 
uint16_t nbgl_getTextWidth(nbgl_font_id_e fontId, const char *text)
{
    return getTextWidth(fontId, text, false, 0xFFFF);
}
 
uint8_t nbgl_getCharWidth(nbgl_font_id_e fontId, const char *text)
{
    const nbgl_font_t *font = nbgl_getFont(fontId);
    uint32_t           unicode;
    bool               is_unicode;
    uint16_t           textLen = 4;  // max len for a char
 
    unicode = nbgl_popUnicodeChar((const uint8_t **) &text, &textLen, &is_unicode);
    if (is_unicode) {
        nbgl_getUnicodeFont(fontId);
    }
 
    return getCharWidth(font, unicode, is_unicode);
}
 
uint8_t nbgl_getFontHeight(nbgl_font_id_e fontId)
{
    // Unicode combined fonts can be higher than normal ones, due to supperposition of 'accents'
    nbgl_unicode_ctx_t *unicode_ctx = nbgl_getUnicodeFont(fontId);
    if (unicode_ctx) {
        return unicode_ctx->font->height;
    }
    else {
        const nbgl_font_t *font = nbgl_getFont(fontId);
        return font->height;
    }
}
 
uint8_t nbgl_getFontLineHeight(nbgl_font_id_e fontId)
{
    // Unicode combined fonts can be higher than normal ones, due to supperposition of 'accents'
    nbgl_unicode_ctx_t *unicode_ctx = nbgl_getUnicodeFont(fontId);
    if (unicode_ctx) {
        return unicode_ctx->font->line_height;
    }
    else {
        const nbgl_font_t *font = nbgl_getFont(fontId);
        return font->line_height;
    }
}
 
uint16_t nbgl_getTextNbLines(const char *text)
{
    uint16_t nbLines = 1;
    while (*text) {
        if (*text == '\n') {
            nbLines++;
        }
        text++;
    }
    return nbLines;
}
 
uint16_t nbgl_getTextHeight(nbgl_font_id_e fontId, const char *text)
{
    const nbgl_font_t *font = nbgl_getFont(fontId);
    return (nbgl_getTextNbLines(text) * font->line_height);
}
 
uint16_t nbgl_getTextLength(const char *text)
{
    const char *origText = text;
    while (*text) {
        if (*text == '\f') {
            break;
        }
        else if (*text == '\n') {
            break;
        }
        text++;
    }
    return text - origText;
}
 
void nbgl_getTextMaxLenAndWidth(nbgl_font_id_e fontId,
                                const char    *text,
                                uint16_t       maxWidth,
                                uint16_t      *len,
                                uint16_t      *width,
                                bool           wrapping)
{
    const nbgl_font_t  *font               = nbgl_getFont(fontId);
    uint16_t            textLen            = nbgl_getTextLength(text);
    uint32_t            lenAtLastDelimiter = 0, widthAtlastDelimiter = 0;
    nbgl_unicode_ctx_t *unicode_ctx = NULL;
 
    *width = 0;
    *len   = 0;
    while (textLen) {
        uint8_t  char_width;
        uint32_t unicode;
        bool     is_unicode;
        uint16_t curTextLen = textLen;
 
        unicode = nbgl_popUnicodeChar((const uint8_t **) &text, &textLen, &is_unicode);
        if (is_unicode && !unicode_ctx) {
            unicode_ctx = nbgl_getUnicodeFont(fontId);
        }
        // if EOS or \f or \n, exit loop
        if (!unicode || (unicode == '\f') || (unicode == '\n')) {
            *len += curTextLen - textLen;
            return;
        }
        // if \b, switch fontId
        else if (unicode == '\b') {
            if (fontId == BAGL_FONT_OPEN_SANS_REGULAR_11px_1bpp) {  // switch to bold
                fontId      = BAGL_FONT_OPEN_SANS_EXTRABOLD_11px_1bpp;
                unicode_ctx = NULL;
                font        = nbgl_getFont(fontId);
            }
            else if (fontId == BAGL_FONT_OPEN_SANS_EXTRABOLD_11px_1bpp) {  // switch to regular
                fontId      = BAGL_FONT_OPEN_SANS_REGULAR_11px_1bpp;
                unicode_ctx = NULL;
                font        = nbgl_getFont(fontId);
            }
            *len += curTextLen - textLen;
            continue;
        }
 
        char_width = getCharWidth(font, unicode, is_unicode);
        if (char_width == 0) {
            *len += curTextLen - textLen;
            continue;
        }
 
        // memorize cursors at last found sepator, when wrapping
        if ((wrapping == true) && IS_WORD_DELIM(unicode)) {
            lenAtLastDelimiter   = *len;
            widthAtlastDelimiter = *width;
        }
        if ((*width + char_width) > maxWidth) {
            if ((wrapping == true) && (widthAtlastDelimiter > 0)) {
                *len   = lenAtLastDelimiter + 1;
                *width = widthAtlastDelimiter;
            }
            return;
        }
        *len += curTextLen - textLen;
        *width = *width + char_width;
    }
}
 
bool nbgl_getTextMaxLenInNbLines(nbgl_font_id_e fontId,
                                 const char    *text,
                                 uint16_t       maxWidth,
                                 uint16_t       maxNbLines,
                                 uint16_t      *len,
                                 bool           wrapping)
{
    const nbgl_font_t  *font = nbgl_getFont(fontId);
    uint16_t            textLen;
    uint16_t            width              = 0;
    const char         *lastDelimiter      = NULL;
    uint32_t            lenAtLastDelimiter = 0;
    const char         *origText           = text;
    const char         *previousText;
    nbgl_unicode_ctx_t *unicode_ctx = NULL;
 
    if (text == NULL) {
        *len = 0;
        return false;
    }
    textLen = strlen(text);
 
    while ((textLen) && (maxNbLines > 0)) {
        uint8_t  char_width;
        uint32_t unicode;
        bool     is_unicode = false;
 
        previousText = text;
        unicode      = nbgl_popUnicodeChar((const uint8_t **) &text, &textLen, &is_unicode);
        if (is_unicode && !unicode_ctx) {
            unicode_ctx = nbgl_getUnicodeFont(fontId);
        }
        // memorize cursors at last found delimiter
        if ((wrapping == true) && (IS_WORD_DELIM(unicode))) {
            lastDelimiter      = text;
            lenAtLastDelimiter = textLen;
        }
 
        // if \n, reset width
        if (unicode == '\n') {
            maxNbLines--;
            // if last line is reached, let's rewind before carriage return
            if (maxNbLines == 0) {
                text--;
            }
            lastDelimiter = NULL;
            width         = 0;
            continue;
        }
        // if \f, exit
        else if (unicode == '\f') {
            maxNbLines = 0;
            break;
        }
        // if \b, switch fontId
        else if (unicode == '\b') {
            if (fontId == BAGL_FONT_OPEN_SANS_REGULAR_11px_1bpp) {  // switch to bold
                fontId      = BAGL_FONT_OPEN_SANS_EXTRABOLD_11px_1bpp;
                unicode_ctx = NULL;
                font        = nbgl_getFont(fontId);
            }
            else if (fontId == BAGL_FONT_OPEN_SANS_EXTRABOLD_11px_1bpp) {  // switch to regular
                fontId      = BAGL_FONT_OPEN_SANS_REGULAR_11px_1bpp;
                unicode_ctx = NULL;
                font        = nbgl_getFont(fontId);
            }
            continue;
        }
 
        char_width = getCharWidth(font, unicode, is_unicode);
        if (char_width == 0) {
            continue;
        }
 
        if ((width + char_width) > maxWidth) {
            if ((wrapping == true) && (lastDelimiter != NULL)) {
                text          = lastDelimiter;
                lastDelimiter = NULL;
                textLen       = lenAtLastDelimiter;
            }
            else {
                textLen += text - previousText;
                text = previousText;
            }
            width = 0;
            maxNbLines--;
            continue;
        }
        width += char_width;
    }
    *len = text - origText;
    return (maxNbLines == 0);
}
 
bool nbgl_getTextMaxLenAndWidthFromEnd(nbgl_font_id_e fontId,
                                       const char    *text,
                                       uint16_t       maxWidth,
                                       uint16_t      *len,
                                       uint16_t      *width)
{
    const nbgl_font_t *font    = nbgl_getFont(fontId);
    uint16_t           textLen = nbgl_getTextLength(text);
 
    *width = 0;
    *len   = 0;
    while (textLen) {
        const nbgl_font_character_t *character;
        uint8_t                      char_width;
        char                         cur_char;
 
        textLen--;
        cur_char = text[textLen];
        // if \n, exit
        if (cur_char == '\n') {
            *len = *len + 1;
            continue;
        }
 
        // skip not printable char
        if ((cur_char < font->first_char) || (cur_char > font->last_char)) {
            continue;
        }
        character
            = (const nbgl_font_character_t *) PIC(&font->characters[cur_char - font->first_char]);
        char_width = character->width;
 
        if ((*width + char_width) > maxWidth) {
            return true;
        }
        *len   = *len + 1;
        *width = *width + char_width;
    }
    return false;
}
 
uint16_t nbgl_getTextNbLinesInWidth(nbgl_font_id_e fontId,
                                    const char    *text,
                                    uint16_t       maxWidth,
                                    bool           wrapping)
{
    const nbgl_font_t *font  = nbgl_getFont(fontId);
    uint16_t           width = 0;
#ifdef SCREEN_SIZE_NANO
    uint16_t nbLines = 0;
#else   // SCREEN_SIZE_NANO
    uint16_t nbLines = 1;
#endif  // SCREEN_SIZE_NANO
    uint16_t            textLen;
    const char         *lastDelimiter      = NULL;
    uint32_t            lenAtLastDelimiter = 0;
    const char         *prevText           = NULL;
    nbgl_unicode_ctx_t *unicode_ctx        = NULL;
 
#ifdef BUILD_SCREENSHOTS
    hard_caesura         = false;
    last_nb_lines        = 0;
    last_nb_pages        = 1;
    last_bold_state      = fontId == BAGL_FONT_OPEN_SANS_EXTRABOLD_11px_1bpp;  // True if Bold
    bool next_bold_state = last_bold_state;
#endif  // BUILD_SCREENSHOTS
 
    if (text == NULL) {
        return 1;
    }
    textLen = strlen(text);
    // end loop when a '\0' is uncountered
    while (textLen) {
        uint8_t  char_width;
        uint32_t unicode;
        bool     is_unicode = false;
 
        // memorize the last char
        prevText = text;
        unicode  = nbgl_popUnicodeChar((const uint8_t **) &text, &textLen, &is_unicode);
        if (is_unicode && !unicode_ctx) {
            unicode_ctx = nbgl_getUnicodeFont(fontId);
        }
 
        // memorize cursors at last found space
        if ((wrapping == true) && (IS_WORD_DELIM(unicode))) {
            lastDelimiter      = prevText;
            lenAtLastDelimiter = textLen;
        }
        // if \f, exit loop
        if (unicode == '\f') {
#ifdef BUILD_SCREENSHOTS
            if (textLen) {
                ++last_nb_pages;
            }
#endif  // BUILD_SCREENSHOTS
            break;
        }
        // if \n, increment the number of lines
        else if (unicode == '\n') {
            nbLines++;
#if defined(BUILD_SCREENSHOTS) && defined(SCREEN_SIZE_NANO)
            if (!(nbLines % 4)) {
                if (textLen) {
                    ++last_nb_pages;
                }
            }
#endif  // defined(BUILD_SCREENSHOTS) && defined(SCREEN_SIZE_NANO)
            width         = 0;
            lastDelimiter = NULL;
            continue;
        }
        // if \b, switch fontId
        else if (unicode == '\b') {
            if (fontId == BAGL_FONT_OPEN_SANS_REGULAR_11px_1bpp) {  // switch to bold
                fontId      = BAGL_FONT_OPEN_SANS_EXTRABOLD_11px_1bpp;
                unicode_ctx = NULL;
                font        = nbgl_getFont(fontId);
#ifdef BUILD_SCREENSHOTS
                next_bold_state = true;
#endif  // BUILD_SCREENSHOTS
            }
            else if (fontId == BAGL_FONT_OPEN_SANS_EXTRABOLD_11px_1bpp) {  // switch to regular
                fontId      = BAGL_FONT_OPEN_SANS_REGULAR_11px_1bpp;
                unicode_ctx = NULL;
                font        = nbgl_getFont(fontId);
#ifdef BUILD_SCREENSHOTS
                next_bold_state = false;
#endif  // BUILD_SCREENSHOTS
            }
            continue;
        }
 
        char_width = getCharWidth(font, unicode, is_unicode);
        if (char_width == 0) {
            continue;
        }
#ifdef BUILD_SCREENSHOTS
        // Update last 'displayed' char with current bold status
        last_bold_state = next_bold_state;
#endif  // BUILD_SCREENSHOTS
 
        // if about to reach max len, increment the number of lines
        if ((width + char_width) > maxWidth) {
            if ((wrapping == true) && (lastDelimiter != NULL)) {
                text          = lastDelimiter + 1;
                lastDelimiter = NULL;
                textLen       = lenAtLastDelimiter;
                width         = 0;
            }
            else {
#ifdef BUILD_SCREENSHOTS
                // An hyphenation (caesura) has been forced.
                hard_caesura = true;
#endif  // BUILD_SCREENSHOTS
                width = char_width;
            }
            nbLines++;
#if defined(BUILD_SCREENSHOTS) && defined(SCREEN_SIZE_NANO)
            if (!(nbLines % 4)) {
                if (textLen) {
                    ++last_nb_pages;
                }
            }
#endif  // defined(BUILD_SCREENSHOTS) && defined(SCREEN_SIZE_NANO)
        }
        else {
            width += char_width;
        }
    }
#ifdef SCREEN_SIZE_NANO
    if (width != 0) {
        ++nbLines;
    }
#endif  // SCREEN_SIZE_NANO
#ifdef BUILD_SCREENSHOTS
    last_nb_lines = nbLines;
#endif  // BUILD_SCREENSHOTS
    return nbLines;
}
 
uint8_t nbgl_getTextNbPagesInWidth(nbgl_font_id_e fontId,
                                   const char    *text,
                                   uint8_t        nbLinesPerPage,
                                   uint16_t       maxWidth)
{
    const nbgl_font_t  *font    = nbgl_getFont(fontId);
    uint16_t            width   = 0;
    uint16_t            nbLines = 0;
    uint8_t             nbPages = 1;
    uint16_t            textLen;
    const char         *lastDelimiter      = NULL;
    uint32_t            lenAtLastDelimiter = 0;
    const char         *prevText           = NULL;
    nbgl_unicode_ctx_t *unicode_ctx        = NULL;
 
#ifdef BUILD_SCREENSHOTS
    last_nb_lines        = nbLines;
    last_nb_pages        = nbPages;
    last_bold_state      = fontId == BAGL_FONT_OPEN_SANS_EXTRABOLD_11px_1bpp;  // True if Bold
    bool next_bold_state = last_bold_state;
#endif  // BUILD_SCREENSHOTS
 
    if (text == NULL) {
        return 1;
    }
    textLen = strlen(text);
 
    // end loop when a '\0' is uncountered
    while (textLen) {
        uint8_t  char_width;
        uint32_t unicode;
        bool     is_unicode = false;
 
        // memorize the last char
        prevText = text;
        unicode  = nbgl_popUnicodeChar((const uint8_t **) &text, &textLen, &is_unicode);
        if (is_unicode && !unicode_ctx) {
            unicode_ctx = nbgl_getUnicodeFont(fontId);
        }
 
        // memorize cursors at last found space
        if (IS_WORD_DELIM(unicode)) {
            lastDelimiter      = prevText;
            lenAtLastDelimiter = textLen;
        }
        // if \f, updates page number
        if (unicode == '\f') {
            nbPages++;
#ifdef BUILD_SCREENSHOTS
#ifdef SCREEN_SIZE_NANO
            if (width != 0) {
#endif  // SCREEN_SIZE_NANO
                ++nbLines;
#ifdef SCREEN_SIZE_NANO
            }
#endif  // SCREEN_SIZE_NANO
            if (last_nb_lines < nbLines) {
                last_nb_lines = nbLines;
            }
#endif  // BUILD_SCREENSHOTS
            nbLines = 0;
            width   = 0;
            continue;
        }
        // if \n, increment the number of lines
        else if (unicode == '\n') {
            nbLines++;
#ifdef BUILD_SCREENSHOTS
            if (last_nb_lines < nbLines) {
                last_nb_lines = nbLines;
            }
#endif  // BUILD_SCREENSHOTS
            if (nbLines == nbLinesPerPage && textLen) {
                nbPages++;
                nbLines = 0;
            }
 
            width         = 0;
            lastDelimiter = NULL;
            continue;
        }
        // if \b, switch fontId
        else if (unicode == '\b') {
            if (fontId == BAGL_FONT_OPEN_SANS_REGULAR_11px_1bpp) {  // switch to bold
                fontId      = BAGL_FONT_OPEN_SANS_EXTRABOLD_11px_1bpp;
                unicode_ctx = NULL;
                font        = nbgl_getFont(fontId);
#ifdef BUILD_SCREENSHOTS
                next_bold_state = true;
#endif  // BUILD_SCREENSHOTS
            }
            else if (fontId == BAGL_FONT_OPEN_SANS_EXTRABOLD_11px_1bpp) {  // switch to regular
                fontId      = BAGL_FONT_OPEN_SANS_REGULAR_11px_1bpp;
                unicode_ctx = NULL;
                font        = nbgl_getFont(fontId);
#ifdef BUILD_SCREENSHOTS
                next_bold_state = false;
#endif  // BUILD_SCREENSHOTS
            }
            continue;
        }
 
        char_width = getCharWidth(font, unicode, is_unicode);
        if (char_width == 0) {
            continue;
        }
 
#ifdef BUILD_SCREENSHOTS
        // Update last 'displayed' char with current bold status
        last_bold_state = next_bold_state;
#endif  // BUILD_SCREENSHOTS
 
        // if about to reach max len, increment the number of lines/pages
        if ((width + char_width) > maxWidth) {
            if (lastDelimiter != NULL) {
                text          = lastDelimiter + 1;
                lastDelimiter = NULL;
                textLen       = lenAtLastDelimiter;
                width         = 0;
            }
            else {
                width = char_width;
            }
            nbLines++;
#ifdef BUILD_SCREENSHOTS
            if (last_nb_lines < nbLines) {
                last_nb_lines = nbLines;
            }
#endif  // BUILD_SCREENSHOTS
            if (nbLines == nbLinesPerPage) {
                nbPages++;
                nbLines = 0;
            }
        }
        else {
            width += char_width;
        }
    }
#ifdef BUILD_SCREENSHOTS
#ifdef SCREEN_SIZE_NANO
    if (width != 0) {
        ++nbLines;
    }
#endif  // SCREEN_SIZE_NANO
    if (last_nb_lines < nbLines) {
        last_nb_lines = nbLines;
    }
    last_nb_pages = nbPages;
#endif  // BUILD_SCREENSHOTS
    return nbPages;
}
 
uint16_t nbgl_getTextHeightInWidth(nbgl_font_id_e fontId,
                                   const char    *text,
                                   uint16_t       maxWidth,
                                   bool           wrapping)
{
    const nbgl_font_t *font = nbgl_getFont(fontId);
    return (nbgl_getTextNbLinesInWidth(fontId, text, maxWidth, wrapping) * font->line_height);
}
 
#ifndef OS_UNIT_TEST
void nbgl_textWrapOnNbLines(nbgl_font_id_e fontId, char *text, uint16_t maxWidth, uint8_t nbLines)
{
    const nbgl_font_t  *font               = nbgl_getFont(fontId);
    uint16_t            textLen            = nbgl_getTextLength(text);
    uint16_t            width              = 0;
    uint8_t             currentNbLines     = 1;
    char               *lastDelimiter      = NULL;
    uint32_t            lenAtLastDelimiter = 0;
    char               *prevText[4]        = {0};  // queue of last positions
    uint16_t            prevWidth[2]       = {0};  // queue of last widths
    nbgl_unicode_ctx_t *unicode_ctx        = NULL;
 
    while (*text) {
        uint8_t  char_width;
        uint32_t unicode;
        bool     is_unicode;
 
        // memorize the last positions in the queue
        // the oldest is at the highest index
        prevText[3] = prevText[2];
        prevText[2] = prevText[1];
        prevText[1] = prevText[0];
        prevText[0] = text;
        unicode     = nbgl_popUnicodeChar((const uint8_t **) &text, &textLen, &is_unicode);
        // if \n, reset width
        if (unicode == '\n') {
            width = 0;
            currentNbLines++;
            lastDelimiter = NULL;
            continue;
        }
        if (is_unicode && !unicode_ctx) {
            unicode_ctx = nbgl_getUnicodeFont(fontId);
        }
        char_width = getCharWidth(font, unicode, is_unicode);
        if (char_width == 0) {
            continue;
        }
 
        // memorize cursors at last found space
        if (IS_WORD_DELIM(unicode)) {
            lastDelimiter      = prevText[0];
            lenAtLastDelimiter = textLen + 1;
        }
        // if the width is about to overpass maxWidth, do something
        if ((width + char_width) > maxWidth) {
            // if the max number of lines has not been reached, try to wrap on last space
            // encountered
            if (currentNbLines < nbLines) {
                currentNbLines++;
                // replace last found space by a \n
                if (lastDelimiter != NULL) {
                    *lastDelimiter++ = '\n';
                    text             = lastDelimiter;
                    lastDelimiter    = NULL;
                    textLen          = lenAtLastDelimiter - 1;
                }
                else {
                    textLen += text - prevText[0];
                    text = prevText[0];
                }
                // reset width for next line
                width = 0;
                continue;
            }
            else {
                uint32_t i;
                // replace the 1, 2 or 3 last chars by '...'
                // try at first with 1, then with 2, if it fits
                for (i = 0; i < 2; i++) {
                    if ((prevText[i + 1] != NULL)
                        && ((prevWidth[i] + (3 * getCharWidth(font, '.', false))) <= maxWidth)) {
                        break;
                    }
                }
                // at worth we are sure it works by replacing the 3 last chars (if i ==2)
                if (prevText[i + 1] != NULL) {
                    memcpy(prevText[i + 1], "...", 4);
                }
                return;
            }
        }
        // memorize the 2 last widths in a queue
        prevWidth[1] = prevWidth[0];
        prevWidth[0] = width;
        width += char_width;
    }
}
#endif  // OS_UNIT_TEST
 
void nbgl_textReduceOnNbLines(nbgl_font_id_e fontId,
                              const char    *origText,
                              uint16_t       maxWidth,
                              uint8_t        nbLines,
                              char          *reducedText,
                              uint16_t       reducedTextLen)
{
    const nbgl_font_t *font           = nbgl_getFont(fontId);
    uint16_t           textLen        = strlen(origText);
    uint16_t           width          = 0;
    uint8_t            currentNbLines = 1;
    uint32_t           i = 0, j = 0;
    const uint16_t     halfWidth = (maxWidth - nbgl_getTextWidth(fontId, " ... ")) / 2;
 
    if ((nbLines & 0x1) == 0) {
        LOG_FATAL(MISC_LOGGER, "nbgl_textReduceOnNbLines: the number of line must be odd\n");
        return;
    }
    while ((i < textLen) && (j < reducedTextLen)) {
        uint8_t char_width;
        char    curChar;
 
        curChar = origText[i];
 
        char_width = getCharWidth(font, curChar, false);
        if (char_width == 0) {
            reducedText[j] = curChar;
            j++;
            i++;
            continue;
        }
 
        // if the width is about to exceed maxWidth, increment number of lines
        if ((width + char_width) > maxWidth) {
            currentNbLines++;
            // reset width for next line
            width = 0;
            continue;
        }
        else if ((currentNbLines == ((nbLines / 2) + 1)) && ((width + char_width) > halfWidth)) {
            uint32_t halfFullWidth = (nbLines / 2) * maxWidth + halfWidth;
            uint32_t countDown     = textLen;
            // if this if the central line, we have to insert the '...' in the middle of it
            reducedText[j - 1] = '.';
            reducedText[j]     = '.';
            reducedText[j + 1] = '.';
            // then start from the end
            width = 0;
            while (width < halfFullWidth) {
                countDown--;
                curChar    = origText[countDown];
                char_width = getCharWidth(font, curChar, false);
                width += char_width;
            }
            memcpy(&reducedText[j + 2], &origText[countDown + 1], textLen - countDown + 1);
            return;
        }
        else {
            reducedText[j] = curChar;
            j++;
            i++;
        }
        width += char_width;
    }
    reducedText[j] = '\0';
}
 
nbgl_unicode_ctx_t *nbgl_getUnicodeFont(nbgl_font_id_e fontId)
{
    // if in Apps, do not support unicode
    if (os_sched_current_task() != TASK_BOLOS_UX) {
        return NULL;
    }
    if ((unicodeCtx.font != NULL) && (unicodeCtx.font->font_id == fontId)) {
        return &unicodeCtx;
    }
    // Be sure we need to change font
    const uint8_t             *ptr  = (const uint8_t *) language_pack;
    const nbgl_font_unicode_t *font = (const void *) (ptr + language_pack->fonts_offset);
    unicodeCtx.characters
        = (const nbgl_font_unicode_character_t *) (ptr + language_pack->characters_offset);
    unicodeCtx.bitmap = (const uint8_t *) (ptr + language_pack->bitmaps_offset);
 
    for (uint32_t i = 0; i < language_pack->nb_fonts; i++) {
        if (font->font_id == fontId) {
            // Update all other global variables
            unicodeCtx.font = font;
            return &unicodeCtx;
        }
        // Compute next Bitmap offset
        unicodeCtx.bitmap += font->bitmap_len;
 
        // Update all pointers for next font
        unicodeCtx.characters += language_pack->nb_characters;
        font++;
    }
    // id not found
    return NULL;
}
 
const nbgl_font_unicode_character_t *nbgl_getUnicodeFontCharacter(uint32_t unicode)
{
    // if in Apps, do not support unicode
    if (os_sched_current_task() != TASK_BOLOS_UX) {
        return NULL;
    }
    const nbgl_font_unicode_character_t *characters
        = (const nbgl_font_unicode_character_t *) PIC(unicodeCtx.characters);
    uint32_t n = language_pack->nb_characters;
    if (characters == NULL) {
        return NULL;
    }
    // For the moment, let just parse the full array, but at the end let use
    // binary search as data are sorted by unicode value !
    for (unsigned i = 0; i < n - 1; i++, characters++) {
        if (characters->char_unicode == unicode) {
            // Compute & store the number of bytes used to display this character
            unicodeCtx.unicode_character_byte_count
                = (characters + 1)->bitmap_offset - characters->bitmap_offset;
            return characters;
        }
    }
    // By default, let's use the last Unicode character, which should be the
    // 0x00FFFD one, used to replace unrecognized or unrepresentable character.
 
    // Compute & store the number of bytes used to display this character
    unicodeCtx.unicode_character_byte_count
        = unicodeCtx.font->bitmap_len - characters->bitmap_offset;
    return characters;
}
 
uint32_t nbgl_getUnicodeFontCharacterByteCount(void)
{
    // if in Apps, do not support unicode
    if (os_sched_current_task() != TASK_BOLOS_UX) {
        return 0;
    }
    return unicodeCtx.unicode_character_byte_count;
}
 
void nbgl_refreshUnicodeFont(const LANGUAGE_PACK *lp)
{
    language_pack         = lp;
    unicodeCtx.font       = NULL;
    unicodeCtx.characters = NULL;
}