nbgl_draw_text.c

Go to the documentation of this file.

 
/*********************
 *      INCLUDES
 *********************/
#include <string.h>
#include "nbgl_front.h"
#include "nbgl_draw.h"
#include "nbgl_fonts.h"
#include "nbgl_debug.h"
#include "nbgl_side.h"
#ifdef BUILD_SCREENSHOTS
#include <assert.h>
#endif  // BUILD_SCREENSHOTS
#include "os_pic.h"
#include "os_utils.h"
 
/*********************
 *      DEFINES
 *********************/
 
#ifdef SCREEN_SIZE_WALLET
#define MAX_FONT_HEIGHT    54
#define AVERAGE_CHAR_WIDTH 40
#else  // SCREEN_SIZE_WALLET
#define MAX_FONT_HEIGHT    24
#define AVERAGE_CHAR_WIDTH 24
#endif  // SCREEN_SIZE_WALLET
 
// Additional height for displaying combined characters
#define COMBINED_HEIGHT 9
 
// Maximum number of pixels used for RLE COPY
#define MAX_RLE_COPY_PIXELS 6
 
/**********************
 *      TYPEDEFS
 **********************/
// Structure used to hold character information
typedef struct {
    uint32_t       unicode;
    const uint8_t *buffer;
    uint16_t       byte_cnt;
    int16_t        x_min;
    int16_t        y_min;
    int16_t        x_max;
    int16_t        y_max;
    uint16_t       width;
    uint16_t       height;
    int16_t        real_y_min;
    uint16_t       real_height;
    uint8_t        encoding;
    uint8_t        nb_skipped_bytes;
    bool           is_unicode;
    bool           over_previous;
 
} character_info_t;
 
// Structure used to handle RLE context
typedef struct {
    // Part containing the data to be decoded
    uint32_t       read_cnt;
    uint32_t       buffer_len;
    const uint8_t *buffer;
    uint8_t        byte;
    // Part containing the decoded pixels
    uint8_t nb_pix;
    uint8_t color;                        // if color <= 15 it is a FILL, else a COPY
    uint8_t pixels[MAX_RLE_COPY_PIXELS];  // Maximum 6 pixels (COPY)
 
} rle_context_t;
 
/**********************
 *  STATIC PROTOTYPES
 **********************/
/**********************
 *  STATIC VARIABLES
 **********************/
/**********************
 *      VARIABLES
 **********************/
 
static uint16_t get_bitmap_byte_cnt(const nbgl_font_t *font, uint8_t charId)
{
    if ((charId < font->first_char) || (charId > font->last_char)) {
        return 0;
    }
 
    uint16_t baseId = charId - font->first_char;
    if (charId < font->last_char) {
        const nbgl_font_character_t *character
            = (const nbgl_font_character_t *) PIC(&font->characters[baseId]);
        const nbgl_font_character_t *nextCharacter
            = (const nbgl_font_character_t *) PIC(&font->characters[baseId + 1]);
        return (nextCharacter->bitmap_offset - character->bitmap_offset);
    }
    else if (charId == font->last_char) {
        return (font->bitmap_len - font->characters[baseId].bitmap_offset);
    }
    return 0;
}
 
//=============================================================================
#ifdef SCREEN_SIZE_WALLET
static void nbgl_draw1BPPImageRle(nbgl_area_t   *area,
                                  const uint8_t *buffer,
                                  uint32_t       buffer_len,
                                  nbgl_area_t   *buf_area,
                                  uint8_t       *dst,
                                  uint8_t        nb_skipped_bytes)
{
    size_t index = 0;
    // Set the initial number of transparent pixels
    size_t nb_zeros = (size_t) nb_skipped_bytes * 8;
    size_t nb_ones  = 0;
    // Width & Height are rotated 90° on Flex/Stax
    size_t  remaining_height = area->width;
    size_t  remaining_width  = area->height;
    size_t  dst_index        = 0;
    uint8_t pixels;
    uint8_t white_pixel;
 
#ifdef BUILD_SCREENSHOTS
    assert((buf_area->width & 7) == 0);
    assert((buf_area->height & 7) == 0);
#endif  // BUILD_SCREENSHOTS
 
    dst += buf_area->y0 * buf_area->width / 8;
    dst += buf_area->x0 / 8;
    white_pixel = 0x80 >> (buf_area->x0 & 7);
    pixels      = 0;
 
    while (remaining_height && (index < buffer_len || nb_zeros || nb_ones)) {
        // Reload nb_zeros & nb_ones if needed
        while (!nb_zeros && !nb_ones && index < buffer_len) {
            uint8_t byte = buffer[index++];
            nb_ones      = byte & 0x0F;
            nb_zeros     = byte >> 4;
        }
        // Get next pixel
        if (nb_zeros) {
            --nb_zeros;
            // Useless, but kept for clarity
            pixels |= 0;
        }
        else if (nb_ones) {
            --nb_ones;
            pixels |= white_pixel;
        }
        white_pixel >>= 1;
        if (!white_pixel) {
            white_pixel = 0x80;
            dst[dst_index++] |= pixels;  // OR because we handle transparency
            pixels = 0;
        }
        --remaining_width;
 
        // Have we reached the end of the line?
        if (!remaining_width) {
            // Width & Height are rotated 90° on Flex/Stax
            remaining_width = area->height;
 
            // Store current pixel content
            dst[dst_index] |= pixels;  // OR because we handle transparency
 
            // Start next line
            dst += buf_area->width / 8;
            dst_index   = 0;
            pixels      = 0;
            white_pixel = 0x80 >> (buf_area->x0 & 7);
 
            --remaining_height;
        }
    }
    // Store remaining pixels
    if (pixels) {
        dst[dst_index] |= pixels;  // OR because we handle transparency
    }
}
 
// Get next pixel(s) and update Rle_context content
static inline void get_next_pixels(rle_context_t *context, size_t remaining_width)
{
    // Is there still remaining data to read?
    if (context->read_cnt >= context->buffer_len) {
        // Just return the number of pixels to skip
        context->nb_pix = remaining_width;
        context->color  = 0xF;  // Background color, which is considered as transparent
        return;
    }
 
    // Uncompress next data
    uint8_t byte = context->buffer[context->read_cnt++];
 
    if (byte & 0x80) {
        if (byte & 0x40) {
            // CMD=11 + RRRRRR => FILL White (max=63+1)
            context->nb_pix = (byte & 0x3F) + 1;
            context->color  = 0x0F;
        }
        else {
            // CMD=10 + RR + VVVV + WWWWXXXX + YYYYZZZZ + QQQQ0000 : COPY Quartets x Repeat+1
            // - RR is repeat count - 3 of quartets (max=3+3 => 6 quartets)
            // - VVVV: value of 1st 4BPP pixel
            // - WWWW: value of 2nd 4BPP pixel
            // - XXXX: value of 3rd 4BPP pixel
            // - YYYY: value of 4th 4BPP pixel
            // - ZZZZ: value of 5th 4BPP pixel
            // - QQQQ: value of 6th 4BPP pixel
            context->nb_pix = ((byte & 0x30) >> 4);
            context->nb_pix += 3;
            context->pixels[0] = byte & 0x0F;  // Store VVVV
            byte               = context->buffer[context->read_cnt++];
            context->pixels[1] = byte >> 4;    // Store WWWW
            context->pixels[2] = byte & 0x0F;  // Store XXXX
            if (context->nb_pix >= 4) {
                byte               = context->buffer[context->read_cnt++];
                context->pixels[3] = byte >> 4;    // Store YYYY
                context->pixels[4] = byte & 0x0F;  // Store ZZZZ
                if (context->nb_pix >= 6) {
                    byte               = context->buffer[context->read_cnt++];
                    context->pixels[5] = byte >> 4;  // Store QQQQ
                }
            }
            context->color = 0x10;  // COPY command + pixels offset=0
        }
    }
    else {
        // CMD=0 + RRR + VVVV : FILL Value x Repeat+1 (max=7+1)
        context->nb_pix = (byte & 0x70) >> 4;
        context->nb_pix += 1;
        context->color = byte & 0x0F;
    }
}
 
static void nbgl_draw4BPPImageRle(nbgl_area_t   *area,
                                  const uint8_t *buffer,
                                  uint32_t       buffer_len,
                                  nbgl_area_t   *buf_area,
                                  uint8_t       *dst,
                                  uint8_t        nb_skipped_bytes)
{
    // Width & Height are rotated 90° on Flex/Stax
    size_t        remaining_height = area->width;
    size_t        remaining_width  = area->height;
    size_t        dst_index        = 0;
    uint8_t       dst_shift        = 4;  // Next pixel must be shift left 4 bit
    rle_context_t context          = {0};
    uint8_t       dst_pixel;
 
    if (!buffer_len) {
        return;
    }
 
#ifdef BUILD_SCREENSHOTS
    assert((buf_area->width & 7) == 0);
    assert((buf_area->height & 7) == 0);
#endif  // BUILD_SCREENSHOTS
 
    context.buffer     = buffer;
    context.buffer_len = buffer_len;
 
    // Handle 'transparent' pixels
    if (nb_skipped_bytes) {
        context.nb_pix = nb_skipped_bytes * 2;
        context.color  = 0xF;  // Background color, which is considered as transparent
    }
 
    dst += buf_area->y0 * buf_area->width / 2;
    dst += buf_area->x0 / 2;
    dst_pixel = *dst;
 
    if (buf_area->x0 & 1) {
        dst_shift = 0;
    }
 
    while (remaining_height) {
        uint8_t nb_pix;
 
        // if the context is empty, let's fill it
        if (context.nb_pix == 0) {
            get_next_pixels(&context, remaining_width);
        }
        // Write those pixels in the RAM buffer
        nb_pix = context.nb_pix;
        if (nb_pix > remaining_width) {
            nb_pix = remaining_width;
        }
 
        // if color <= 0x0F it is a FILL command, else it is a COPY
        if (context.color <= 0x0F) {
            // Do we need to just skip transparent pixels?
            if (context.color == 0x0F) {
                dst[dst_index] = dst_pixel;
                dst_index += nb_pix / 2;
                if (nb_pix & 1) {
                    dst_shift ^= 4;
                    if (dst_shift) {
                        ++dst_index;
                    }
                }
                dst_pixel = dst[dst_index];
                // FILL nb_pix pixels with context.color
            }
            else {
                for (uint8_t i = 0; i < nb_pix; i++) {
                    dst_pixel &= ~(0x0F << dst_shift);
                    dst_pixel |= context.color << dst_shift;
                    dst_shift ^= 4;
                    // Do we need to go to next byte?
                    if (dst_shift) {
                        dst[dst_index] = dst_pixel;
                        ++dst_index;
                        dst_pixel = dst[dst_index];
                    }
                }
            }
        }
        else {
            uint8_t *pixels = context.pixels;
            // LSB of context.color contains the offset of the pixels to copy
            pixels += context.color & 0x0F;
 
            // We can consider there is at least 1 used pixel, otherwise it would be a FILL!
            // COPY nb_pix pixels from &context.pixels[i]
            for (uint8_t i = 0; i < nb_pix; i++) {
                uint8_t color = pixels[i];
                // Handle transparency
                if (color != 0x0F) {
                    dst_pixel &= ~(0x0F << dst_shift);
                    dst_pixel |= color << dst_shift;
                }
                dst_shift ^= 4;
                // Do we need to go to next byte?
                if (dst_shift) {
                    dst[dst_index] = dst_pixel;
                    ++dst_index;
                    dst_pixel = dst[dst_index];
                }
            }
            // Update offset of the pixels to copy
            context.color += nb_pix;
        }
 
        // Take in account displayed pixels
        context.nb_pix -= nb_pix;
        remaining_width -= nb_pix;
 
        // Have we reached the end of the line?
        if (remaining_width == 0) {
            // Width & Height are rotated 90° on Flex/Stax
            remaining_width = area->height;
 
            // Store last pixels
            dst[dst_index] = dst_pixel;
            // Start next line
            dst_index = 0;
            dst += buf_area->width / 2;
            dst_pixel = dst[dst_index];
            if (buf_area->x0 & 1) {
                dst_shift = 0;
            }
            else {
                dst_shift = 4;
            }
            --remaining_height;
        }
    }
}
 
static void nbgl_drawImageRle(nbgl_area_t   *text_area,
                              const uint8_t *buffer,
                              uint32_t       buffer_len,
                              nbgl_area_t   *buf_area,
                              uint8_t       *dst,
                              uint8_t        nb_skipped_bytes)
{
    if (text_area->bpp == NBGL_BPP_4) {
        nbgl_draw4BPPImageRle(text_area, buffer, buffer_len, buf_area, dst, nb_skipped_bytes);
    }
    else if (text_area->bpp == NBGL_BPP_1) {
        nbgl_draw1BPPImageRle(text_area, buffer, buffer_len, buf_area, dst, nb_skipped_bytes);
    }
}
 
static void nbgl_draw4BPPImage(nbgl_area_t   *area,
                               const uint8_t *buffer,
                               nbgl_area_t   *buf_area,
                               uint8_t       *dst)
{
    uint32_t buffer_len = ((area->width * area->height) + 1) / 2;
    uint32_t index      = 0;
    // Width & Height are rotated 90° on Flex/Stax
    size_t  remaining_height = area->width;
    size_t  remaining_width  = area->height;
    size_t  dst_index        = 0;
    uint8_t dst_shift        = 4;  // Next pixel must be shift left 4 bit
    uint8_t dst_pixel;
    uint8_t src_nb_pix, src_pixels[2];
 
    if (!buffer_len) {
        return;
    }
 
#ifdef BUILD_SCREENSHOTS
    assert((buf_area->width & 7) == 0);
    assert((buf_area->height & 7) == 0);
#endif  // BUILD_SCREENSHOTS
 
    dst += buf_area->y0 * buf_area->width / 2;
    dst += buf_area->x0 / 2;
    dst_pixel = *dst;
 
    if (buf_area->x0 & 1) {
        dst_shift = 0;
    }
    src_pixels[0] = buffer[index++];
    src_pixels[1] = src_pixels[0] >> 4;
    src_pixels[0] &= 0x0F;
    src_nb_pix = 2;
 
    while (remaining_height) {
        uint8_t nb_pix;
 
        // refill data if ncecessary
        if (src_nb_pix == 0) {
            if (index < buffer_len) {
                src_pixels[0] = buffer[index++];
                src_pixels[1] = src_pixels[0] >> 4;
                src_pixels[0] &= 0x0F;
                src_nb_pix = 2;
            }
            else {
                // We have no more src data => fill with transparent color
                // Background color, which is considered as transparent
                src_pixels[0] = 0x0F;
                src_pixels[1] = 0x0F;
                src_nb_pix    = remaining_width;
            }
        }
        // Write those pixels in the RAM buffer
        nb_pix = src_nb_pix;
        if (nb_pix > remaining_width) {
            nb_pix = remaining_width;
        }
 
        for (uint8_t i = 0; i < nb_pix; i++) {
            uint8_t color = src_pixels[i];
            // Handle transparency
            if (color != 0x0F) {
                dst_pixel &= ~(0x0F << dst_shift);
                dst_pixel |= color << dst_shift;
            }
            dst_shift ^= 4;
            // Do we need to go to next byte?
            if (dst_shift) {
                dst[dst_index] = dst_pixel;
                ++dst_index;
                dst_pixel = dst[dst_index];
            }
        }
 
        // Take in account displayed pixels
        src_nb_pix -= nb_pix;
        remaining_width -= nb_pix;
 
        // Have we reached the end of the line?
        if (remaining_width == 0) {
            // Width & Height are rotated 90° on Flex/Stax
            remaining_width = area->height;
 
            // Store last pixels
            dst[dst_index] = dst_pixel;
            // Start next line
            dst_index = 0;
            dst += buf_area->width / 2;
            dst_pixel = dst[dst_index];
            if (buf_area->x0 & 1) {
                dst_shift = 0;
            }
            else {
                dst_shift = 4;
            }
            --remaining_height;
        }
    }
}
 
static void nbgl_draw1BPPImage(nbgl_area_t   *area,
                               const uint8_t *buffer,
                               nbgl_area_t   *buf_area,
                               uint8_t       *dst)
{
    size_t   index      = 0;
    uint32_t buffer_len = ((area->width * area->height) + 7) / 8;
    // Width & Height are rotated 90° on Flex/Stax
    size_t  remaining_height = area->width;
    size_t  remaining_width  = area->height;
    size_t  dst_index        = 0;
    uint8_t pixels;
    uint8_t white_pixel;
    uint8_t src_byte, src_msk;
 
#ifdef BUILD_SCREENSHOTS
    assert((buf_area->width & 7) == 0);
    assert((buf_area->height & 7) == 0);
#endif  // BUILD_SCREENSHOTS
 
    dst += buf_area->y0 * buf_area->width / 8;
    dst += buf_area->x0 / 8;
    white_pixel = 0x80 >> (buf_area->x0 & 7);
    pixels      = 0;
 
    src_byte = buffer[index++];
    src_msk  = 0x80;
 
    while (remaining_height && (index < buffer_len || src_msk)) {
        // Reload data if needed
        if (!src_msk && index < buffer_len) {
            src_byte = buffer[index++];
            src_msk  = 0x80;
        }
        // Get next pixel
        if (src_byte & src_msk) {
            pixels |= white_pixel;
        }
        else {
            // Useless, but kept for clarity
            pixels |= 0;
        }
        src_msk >>= 1;
        white_pixel >>= 1;
        if (!white_pixel) {
            white_pixel = 0x80;
            dst[dst_index++] |= pixels;  // OR because we handle transparency
            pixels = 0;
        }
        --remaining_width;
 
        // Have we reached the end of the line?
        if (!remaining_width) {
            // Width & Height are rotated 90° on Flex/Stax
            remaining_width = area->height;
 
            // Store current pixel content
            dst[dst_index] |= pixels;  // OR because we handle transparency
 
            // Start next line
            dst += buf_area->width / 8;
            dst_index   = 0;
            pixels      = 0;
            white_pixel = 0x80 >> (buf_area->x0 & 7);
 
            --remaining_height;
        }
    }
    // Store remaining pixels
    if (pixels) {
        dst[dst_index] |= pixels;  // OR because we handle transparency
    }
}
 
static void nbgl_drawImage(nbgl_area_t   *text_area,
                           const uint8_t *buffer,
                           nbgl_area_t   *buf_area,
                           uint8_t       *dst)
{
    if (text_area->bpp == NBGL_BPP_4) {
        nbgl_draw4BPPImage(text_area, buffer, buf_area, dst);
    }
    else if (text_area->bpp == NBGL_BPP_1) {
        nbgl_draw1BPPImage(text_area, buffer, buf_area, dst);
    }
}
 
static void pack_ram_buffer(nbgl_area_t *area, uint16_t width, uint16_t height)
{
    uint8_t *src = ramBuffer;
    uint8_t *dst = ramBuffer;
 
    if (area->bpp == NBGL_BPP_4) {
        uint16_t bytes_per_line;
        uint16_t skip;
 
        src += area->y0 * area->width / 2;
        src += area->x0 / 2;
        bytes_per_line = (width + 1) / 2;
        skip           = (area->width + 1) / 2;
 
        // Do we need to copy quartet by quartet, or can we copy byte by byte?
        if (area->x0 & 1) {
            // We need to copy quartet by quartet
            skip -= bytes_per_line;
            for (uint16_t h = 0; h < height; h++) {
                for (uint16_t w = 0; w < bytes_per_line; w++) {
                    uint8_t byte = *src++ & 0x0F;  // 1st quartet
                    byte <<= 4;
                    byte |= *src >> 4;
                    *dst++ = byte;
                }
                src += skip;
            }
        }
        else {
            for (uint16_t y = 0; y < height; y++) {
                memmove(dst, src, bytes_per_line);
                dst += bytes_per_line;
                src += skip;
            }
        }
    }
    else {
        uint8_t src_pixel;
        uint8_t src_shift;
        uint8_t src_index;
        uint8_t dst_pixel = 0;
        uint8_t dst_shift = 7;
 
        src += area->y0 * area->width / 8;
        src += area->x0 / 8;
        for (uint16_t y = 0; y < height; y++) {
            src_shift = (7 - (area->x0 & 7));
            src_pixel = *src;
            src_index = 0;
            for (uint16_t x = 0; x < width; x++) {
                dst_pixel |= ((src_pixel >> src_shift) & 1) << dst_shift;
                if (dst_shift == 0) {
                    dst_shift = 8;
                    *dst++    = dst_pixel;
                    dst_pixel = 0;
                }
                --dst_shift;
 
                if (src_shift == 0) {
                    src_shift = 8;
                    ++src_index;
                    src_pixel = src[src_index];
                }
                --src_shift;
            }
            src += area->width / 8;
        }
        // Write last byte, if any
        if (dst_shift != 7) {
            *dst++ = dst_pixel;
        }
    }
}
 
static void display_ram_buffer(int16_t            x_min,
                               int16_t            y_min,
                               int16_t            x_max,
                               int16_t            y_max,
                               const nbgl_area_t *area,
                               nbgl_area_t       *buf_area,
                               nbgl_area_t       *char_area,
                               color_t            fontColor)
{
    //  Move the data at the beginning of RAM buffer, in a packed way
    buf_area->x0      = x_min;
    buf_area->y0      = y_min;
    char_area->height = ((x_max - x_min) + 3) & 0xFFFC;
    char_area->width  = y_max - y_min;
 
    pack_ram_buffer(buf_area, char_area->height, char_area->width);
 
    char_area->y0 = area->y0 + x_min - COMBINED_HEIGHT;
 
    nbgl_frontDrawImage(char_area, ramBuffer, NO_TRANSFORMATION, fontColor);
}
#endif  // SCREEN_SIZE_WALLET
 
static void update_char_info(character_info_t   *char_info,
                             const uint8_t     **text,
                             uint16_t           *textLen,
                             nbgl_unicode_ctx_t *unicode_ctx,
                             const nbgl_font_t  *font)
{
    char_info->unicode = nbgl_popUnicodeChar(text, textLen, &char_info->is_unicode);
 
    // Do we still have some characters to read?
    if (!char_info->unicode) {
        return;
    }
 
    // Retrieves information depending on whether it is an ASCII character or not.
    if (char_info->is_unicode) {
        const nbgl_font_unicode_character_t *unicodeCharacter
            = nbgl_getUnicodeFontCharacter(char_info->unicode);
        // if not supported char, go to next one (this should never happen, except in Apps, if a
        // unicode is used !!)
        if (unicodeCharacter == NULL) {
#ifdef BUILD_SCREENSHOTS
            fprintf(stdout,
                    "Inside update_char_info, unicode (%c)[0x%X] is not supported!\n",
                    char_info->unicode,
                    char_info->unicode);
#endif  // BUILD_SCREENSHOTS
            update_char_info(char_info, text, textLen, unicode_ctx, font);
            return;
        }
        char_info->width  = unicodeCharacter->width;
        char_info->buffer = unicode_ctx->bitmap;
        char_info->buffer += unicodeCharacter->bitmap_offset;
 
        char_info->x_max = char_info->width;
        char_info->y_max = unicode_ctx->font->height;
#ifdef SCREEN_SIZE_WALLET
        char_info->over_previous = unicodeCharacter->over_previous;
#else   // SCREEN_SIZE_WALLET
        char_info->over_previous = 0;
#endif  // SCREEN_SIZE_WALLET
 
        if (!unicode_ctx->font->crop) {
            // Take in account the skipped bytes, if any
            char_info->nb_skipped_bytes = (unicodeCharacter->x_min_offset & 7) << 3;
            char_info->nb_skipped_bytes |= unicodeCharacter->y_min_offset & 7;
            char_info->x_min = 0;
            char_info->y_min = 0;
        }
        else {
            char_info->nb_skipped_bytes = 0;
            char_info->y_min            = unicode_ctx->font->y_min;
            char_info->y_min += (uint16_t) unicodeCharacter->y_min_offset;
            char_info->y_max -= (uint16_t) unicodeCharacter->y_max_offset;
 
            if (char_info->over_previous) {
                // That character will be displayed over the previous one: get correct X coords
                char_info->x_min = -(int16_t) unicodeCharacter->width;
                char_info->width = 16 * (uint16_t) unicodeCharacter->x_min_offset;
                char_info->width += (uint16_t) unicodeCharacter->x_max_offset;
                char_info->x_max = char_info->x_min + char_info->width;
            }
            else {
                char_info->x_min = (uint16_t) unicodeCharacter->x_min_offset;
                char_info->x_max -= (uint16_t) unicodeCharacter->x_max_offset;
            }
        }
        char_info->byte_cnt = nbgl_getUnicodeFontCharacterByteCount();
        char_info->encoding = unicodeCharacter->encoding;
        char_info->height   = char_info->y_max - char_info->y_min;
    }
    else {
        // Special character: nothing special to do here
        if (char_info->unicode == '\f' || char_info->unicode == '\b') {
            return;
        }
        // if not supported char, go to next one (this should never happen!!)
        if ((char_info->unicode < font->first_char) || (char_info->unicode > font->last_char)) {
#ifdef BUILD_SCREENSHOTS
            fprintf(stdout,
                    "Inside update_char_info, unicode (%c)[0x%X] is not supported!\n",
                    char_info->unicode,
                    char_info->unicode);
#endif  // BUILD_SCREENSHOTS
            update_char_info(char_info, text, textLen, unicode_ctx, font);
            return;
        }
        const nbgl_font_character_t *character = (const nbgl_font_character_t *) PIC(
            &font->characters[char_info->unicode - font->first_char]);
 
        char_info->buffer        = (const uint8_t *) PIC(&font->bitmap[character->bitmap_offset]);
        char_info->width         = character->width;
        char_info->encoding      = character->encoding;
        char_info->over_previous = 0;
 
        char_info->x_max = char_info->width;
        char_info->y_max = font->height;
 
        if (!font->crop) {
            // Take in account the skipped bytes, if any
            char_info->nb_skipped_bytes = (character->x_min_offset & 7) << 3;
            char_info->nb_skipped_bytes |= character->y_min_offset & 7;
            char_info->x_min = 0;
            char_info->y_min = 0;
        }
        else {
            char_info->nb_skipped_bytes = 0;
            char_info->x_min            = (uint16_t) character->x_min_offset;
            char_info->y_min            = font->y_min;
            char_info->y_min += (uint16_t) character->y_min_offset;
            char_info->x_max -= (uint16_t) character->x_max_offset;
            char_info->y_max -= (uint16_t) character->y_max_offset;
        }
 
        char_info->byte_cnt = get_bitmap_byte_cnt(font, char_info->unicode);
        char_info->height   = char_info->y_max - char_info->y_min;
    }
}
 
nbgl_font_id_e nbgl_drawText(const nbgl_area_t *area,
                             const char        *text,
                             uint16_t           textLen,
                             nbgl_font_id_e     fontId,
                             color_t            fontColor)
{
    // text is a series of characters, each character being a bitmap
    // we need to align bitmaps on width multiple of 4 limitation.
    int16_t             x = area->x0;
    nbgl_area_t         current_area;
    character_info_t    current_char = {0};
    const nbgl_font_t  *font         = nbgl_getFont(fontId);
    nbgl_unicode_ctx_t *unicode_ctx  = nbgl_getUnicodeFont(fontId);
#ifdef SCREEN_SIZE_WALLET
    int16_t          next_x        = x;
    character_info_t previous_char = {0};
    character_info_t next_char     = {0};
    nbgl_area_t      previous_area;
    int16_t          buf_x_min;
    int16_t          buf_y_min;
    int16_t          buf_x_max;
    int16_t          buf_y_max;
    // Flag set to 1 when there is data to be drawn in RAM buffer
    uint8_t redraw_buf_area = 0;
 
    //  Area representing the RAM buffer and in which the glyphs will be drawn
    nbgl_area_t buf_area = {0};
    // ensure that the ramBuffer also used for image file decompression is big enough
    // 4bpp: size of ram_buffer is (font->height * 3*AVERAGE_CHAR_WIDTH/2) / 2
    // 1bpp: size of ram_buffer is (font->height * 3*AVERAGE_CHAR_WIDTH/2) / 8
    CCASSERT(ram_buffer,
             (MAX_FONT_HEIGHT * 3 * AVERAGE_CHAR_WIDTH / 4) <= GZLIB_UNCOMPRESSED_CHUNK);
    // TODO Investigate why area->bpp is not always initialized correctly
    buf_area.bpp = (nbgl_bpp_t) font->bpp;
    // Width & Height are rotated 90° on Flex/Stax
    if (unicode_ctx) {
        buf_area.width
            = (unicode_ctx->font->line_height + 7) & 0xFFF8;  // Modulo 8 is better for 1BPP
    }
    else {
        buf_area.width = (MAX_FONT_HEIGHT + 7) & 0xFFF8;  // Modulo 8 is better for 1BPP
    }
    buf_area.height = ((3 * AVERAGE_CHAR_WIDTH / 2) + 7) & 0xFFF8;
    if (buf_area.bpp == NBGL_BPP_4) {
        buf_area.backgroundColor = 0xF;  // This will be the transparent color
    }
    else {
        buf_area.backgroundColor = 0;  // This will be the transparent color
    }
#ifdef BUILD_SCREENSHOTS
    assert((buf_area.height * buf_area.width / 2) <= GZLIB_UNCOMPRESSED_CHUNK);
#endif  // BUILD_SCREENSHOTS
 
    // Those variables will be updated with current_char dimension
    buf_x_min = AVERAGE_CHAR_WIDTH;
    buf_y_min = MAX_FONT_HEIGHT;
    buf_x_max = 0;
    buf_y_max = 0;
#endif  // SCREEN_SIZE_WALLET
 
    LOG_DEBUG(DRAW_LOGGER,
              "nbgl_drawText: x0 = %d, y0 = %d, w = %d, h = %d, fontColor = %d, "
              "backgroundColor=%d, text = %s\n",
              area->x0,
              area->y0,
              area->width,
              area->height,
              fontColor,
              area->backgroundColor,
              text);
 
    current_area.backgroundColor = area->backgroundColor;
    current_area.bpp             = (nbgl_bpp_t) font->bpp;
 
#ifndef SCREEN_SIZE_WALLET
    while (textLen > 0) {
        // Get info for current character
        update_char_info(&current_char, (const uint8_t **) &text, &textLen, unicode_ctx, font);
 
        // Handle special characters (for LNX & LNS+ devices)
        if (!current_char.is_unicode) {
            // If '\f', that string si completed
            if (current_char.unicode == '\f') {
                break;
            }
            // if \b, switch fontId
            if (current_char.unicode == '\b') {
                if (fontId == BAGL_FONT_OPEN_SANS_REGULAR_11px_1bpp) {  // switch to bold
                    fontId      = BAGL_FONT_OPEN_SANS_EXTRABOLD_11px_1bpp;
                    unicode_ctx = nbgl_getUnicodeFont(fontId);
                    font        = (const nbgl_font_t *) 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 = nbgl_getUnicodeFont(fontId);
                    font        = (const nbgl_font_t *) nbgl_getFont(fontId);
                }
                continue;
            }
        }
 
        current_area.x0     = x + current_char.x_min;
        current_area.y0     = area->y0 + current_char.y_min;
        current_area.height = (current_char.y_max - current_char.y_min);
        current_area.width  = (current_char.x_max - current_char.x_min);
 
        //  If char_byte_cnt = 0, call nbgl_frontDrawImageRle to let speculos notice
        //  a space character was 'displayed'
        if (!current_char.byte_cnt || current_char.encoding == 1) {
            // Draw that character in the RAM buffer, with transparency
            nbgl_frontDrawImageRle(&current_area,
                                   current_char.buffer,
                                   current_char.byte_cnt,
                                   fontColor,
                                   current_char.nb_skipped_bytes);
            // WARNING: current_area was adjusted to height of what was really displayed!
        }
        else {
            nbgl_frontDrawImage(&current_area, current_char.buffer, NO_TRANSFORMATION, fontColor);
        }
        x += current_char.width - font->char_kerning;
    }
#else  // SCREEN_SIZE_WALLET
    // Get the first character, that will go into 'current_char'
    // (to correctly handle languages using 'combined characters', we need to
    // know current, previous & next characters)
    update_char_info(&next_char, (const uint8_t **) &text, &textLen, unicode_ctx, font);
 
    while (textLen > 0 || next_char.unicode) {
        // Get the character we already read
        current_char = next_char;
        // Get info for next character
        update_char_info(&next_char, (const uint8_t **) &text, &textLen, unicode_ctx, font);
 
        // Render current character in current_area
        if (!current_char.over_previous) {
            // This character will not be displayed over previous one => update x
            if (next_x > x) {
                x = next_x;
            }
            current_area.x0 = x + current_char.x_min;
        }
        current_area.y0     = area->y0 + current_char.y_min;
        current_area.height = (current_char.y_max - current_char.y_min);
        current_area.width  = (current_char.x_max - current_char.x_min);
 
        //  if current character should not be displayed over previous one,
        //  send RAM buffer to display
        if (!current_char.over_previous) {
            // Send RAM buffer content (previous character) to display
            if (redraw_buf_area) {
                display_ram_buffer(buf_x_min,
                                   buf_y_min,
                                   buf_x_max,
                                   buf_y_max,
                                   area,
                                   &buf_area,
                                   &previous_area,
                                   fontColor);
                // Reset that flag
                redraw_buf_area = 0;
                buf_x_min       = AVERAGE_CHAR_WIDTH;
                buf_y_min       = MAX_FONT_HEIGHT;
                buf_x_max       = 0;
                buf_y_max       = 0;
            }
            // To handle transparency, ramBuffer must be filled with background color
            // => Fill ramBuffer with background color (0x0F for 4bpp & 0 for 1bpp)
            if (buf_area.bpp == NBGL_BPP_4) {
                memset(ramBuffer, 0xFF, (buf_area.height * buf_area.width / 2));
            }
            else {
                memset(ramBuffer, 0x0, (buf_area.height * buf_area.width / 8));
            }
            // Update display coordinates of current char inside the RAM buffer
            //(X & Y are rotated 90° on Stax/Flex)
            buf_area.x0 = COMBINED_HEIGHT + current_char.y_min;
            buf_area.y0 = (AVERAGE_CHAR_WIDTH / 2) + current_char.x_min;
 
            buf_x_min = buf_area.x0;
            buf_x_max = buf_x_min + current_area.height;
            buf_y_min = buf_area.y0;
            buf_y_max = buf_y_min + current_area.width;
 
            // Compute next x with current char width, to be ready to display next one
            x += current_char.width - font->char_kerning;
            next_x = x;
        }
        else {
            // Security check: first character can't be a composed one!
            if (previous_char.unicode == 0) {
#ifdef BUILD_SCREENSHOTS
                fprintf(stdout,
                        "WARNING: First character '%c'(0x%X) is a composed one! (text=>%s<=)\n",
                        current_char.unicode,
                        current_char.unicode,
                        text);
#endif  // BUILD_SCREENSHOTS
                continue;
            }
            // Update next_x if this character is larger than original one
            // (except for vowel 0xE31 which is overflowing on purpose on right side)
            if (current_char.unicode != 0x00E31
                && (x + current_char.x_min + current_char.width) > next_x) {
                next_x = x + current_char.x_min + current_char.width;
                // That character is a special one, as it is displayed on top of previous
                // character and also on its right => give space for next character
                if (current_char.unicode == 0x00E33) {
                    next_x += 1;
                }
            }
            // Take in account current x_min (which is < 0)
            buf_area.x0 = COMBINED_HEIGHT + current_char.y_min;
            buf_area.y0 = (AVERAGE_CHAR_WIDTH / 2) - current_char.x_min - current_char.width;
 
            // Thai rules for displaying characters on top of each others
            // Order priority, from bottom to top
            // 1 - consonnant
            // 2 - vowel or sign 0x0E4D and 0x0E4E
            // 3 - tone 0x0E48, 0x0E49, 0x0E4A and 0x0E4B or sign 0x0E4C
            // => 0x0E48, 0x0E49, 0x0E4A, 0x0E4B & 0x0E4C MUST ALWAYS be displayed on top of
            // other characters! WARNING: some vowels, signs or tone may have to be displayed
            // left with some consonnant (0E1B, 0E1F etc)
 
            if (current_char.unicode >= 0x0E48 && current_char.unicode <= 0x0E4C) {
                if (next_char.unicode == 0x00E33) {
                    // Display current character up to next one
                    buf_area.x0 = COMBINED_HEIGHT + 0;
                    buf_area.x0
                        -= (current_char.y_max - current_char.y_min) - 2;  // minus height of cur
                                                                           // char TMP
                }
                else if (previous_char.unicode >= 0x0E31 && previous_char.unicode <= 0x0E37) {
                    // Take in account the height of previous character
                    buf_area.x0 = buf_x_min - (current_char.y_max - current_char.y_min) - 1;
                }
                else if (current_char.unicode == 0x0E4B && previous_char.unicode == 0x0E1B) {
                    // We must shift 0x0E4B to the left or we will overwrite 0x0E1B
                    buf_area.y0 -= current_char.x_min / 2;
                }
            }
            // Update RAM buffer x/y min/max
            if (buf_area.x0 < buf_x_min) {
                buf_x_min = buf_area.x0;
            }
            if ((buf_area.x0 + current_area.height) > buf_x_max) {
                buf_x_max = buf_area.x0 + current_area.height;
            }
            if (buf_area.y0 < buf_y_min) {
                buf_y_min = buf_area.y0;
            }
            if ((buf_area.y0 + current_area.width) > buf_y_max) {
                buf_y_max = buf_area.y0 + current_area.width;
            }
        }
        //  If char_byte_cnt = 0, call nbgl_frontDrawImageRle to let speculos notice
        //  a space character was 'displayed'
        if (!current_char.byte_cnt || current_char.encoding == 1) {
            // Draw that character in the RAM buffer, with transparency
            nbgl_drawImageRle(&current_area,
                              current_char.buffer,
                              current_char.byte_cnt,
                              &buf_area,
                              ramBuffer,
                              current_char.nb_skipped_bytes);
        }
        else {
            nbgl_drawImage(&current_area, current_char.buffer, &buf_area, ramBuffer);
        }
 
        // Set the flag telling that RAM buffer need to be displayed, if needed
        if (current_char.byte_cnt) {
            redraw_buf_area = 1;
            previous_area   = current_area;
        }
 
        previous_char = current_char;
    }
    // Do we need to send RAM buffer content (previous character) to display?
    if (redraw_buf_area) {
        // Move the data at the beginning of RAM buffer, in a packed way
        display_ram_buffer(
            buf_x_min, buf_y_min, buf_x_max, buf_y_max, area, &buf_area, &previous_area, fontColor);
    }
#endif  // SCREEN_SIZE_WALLET
    return fontId;
}