nbgl_layout.c

Go to the documentation of this file.

 
#include "app_config.h"
 
#ifdef HAVE_SE_TOUCH
/*********************
 *      INCLUDES
 *********************/
#include <string.h>
#include <stdlib.h>
#include "nbgl_debug.h"
#include "nbgl_front.h"
#include "nbgl_layout_internal.h"
#include "nbgl_obj.h"
#include "nbgl_draw.h"
#include "nbgl_screen.h"
#include "nbgl_touch.h"
#include "glyphs.h"
#include "os_io_seph_ux.h"
#include "os_pic.h"
#include "os_helpers.h"
#include "lcx_rng.h"
 
/*********************
 *      DEFINES
 *********************/
// half internal margin, between items
#define INTERNAL_SPACE 16
// inner margin, between buttons
#define INNER_MARGIN   12
 
#define NB_MAX_LAYOUTS 3
 
// used by container
#define NB_MAX_CONTAINER_CHILDREN 20
 
#define TAG_VALUE_ICON_WIDTH 32
 
#if defined(TARGET_STAX)
#define RADIO_CHOICE_HEIGHT              96
#define BAR_INTERVALE                    12
#define FOOTER_BUTTON_HEIGHT             128
#define FOOTER_IN_PAIR_HEIGHT            80
#define ROUNDED_AND_FOOTER_FOOTER_HEIGHT 192
#define FOOTER_TEXT_AND_NAV_WIDTH        160
#define TAP_TO_CONTINUE_MARGIN           24
#define SUB_HEADER_MARGIN                24
#define PRE_FIRST_TEXT_MARGIN            24
#define INTER_PARAGRAPHS_MARGIN          40
#define PRE_TITLE_MARGIN                 24
#define PRE_DESCRIPTION_MARGIN           16
#define PRE_FIRST_ROW_MARGIN             32
#define INTER_ROWS_MARGIN                16
#define QR_PRE_TEXT_MARGIN               24
#define QR_INTER_TEXTS_MARGIN            40
#define SPINNER_TEXT_MARGIN              20
#define SPINNER_INTER_TEXTS_MARGIN       20
#define BAR_TEXT_MARGIN                  24
#define BAR_INTER_TEXTS_MARGIN           16
#define LEFT_CONTENT_TEXT_PADDING        0
#define BUTTON_FROM_BOTTOM_MARGIN        4
#define TOP_BUTTON_MARGIN                VERTICAL_BORDER_MARGIN
#define TOP_BUTTON_MARGIN_WITH_ACTION    VERTICAL_BORDER_MARGIN
#define SINGLE_BUTTON_MARGIN             24
#define LONG_PRESS_PROGRESS_HEIGHT       8
#define LONG_PRESS_PROGRESS_ALIGN        1
#define LEFT_CONTENT_ICON_TEXT_X         16
#define TIP_BOX_MARGIN_Y                 24
#define TIP_BOX_TEXT_ICON_MARGIN         24
#elif defined(TARGET_FLEX)
#define RADIO_CHOICE_HEIGHT              92
#define BAR_INTERVALE                    16
#define FOOTER_BUTTON_HEIGHT             136
#define FOOTER_IN_PAIR_HEIGHT            88
#define ROUNDED_AND_FOOTER_FOOTER_HEIGHT 208
#define FOOTER_TEXT_AND_NAV_WIDTH        192
#define TAP_TO_CONTINUE_MARGIN           30
#define SUB_HEADER_MARGIN                28
#define PRE_FIRST_TEXT_MARGIN            0
#define INTER_PARAGRAPHS_MARGIN          24
#define PRE_TITLE_MARGIN                 16
#define PRE_DESCRIPTION_MARGIN           24
#define PRE_FIRST_ROW_MARGIN             32
#define INTER_ROWS_MARGIN                24
#define QR_PRE_TEXT_MARGIN               24
#define QR_INTER_TEXTS_MARGIN            28
#define SPINNER_TEXT_MARGIN              24
#define SPINNER_INTER_TEXTS_MARGIN       16
#define BAR_TEXT_MARGIN                  24
#define BAR_INTER_TEXTS_MARGIN           16
#define LEFT_CONTENT_TEXT_PADDING        4
#define BUTTON_FROM_BOTTOM_MARGIN        4
#define TOP_BUTTON_MARGIN                VERTICAL_BORDER_MARGIN
#define TOP_BUTTON_MARGIN_WITH_ACTION    VERTICAL_BORDER_MARGIN
#define SINGLE_BUTTON_MARGIN             24
#define LONG_PRESS_PROGRESS_HEIGHT       8
#define LONG_PRESS_PROGRESS_ALIGN        1
#define LEFT_CONTENT_ICON_TEXT_X         16
#define TIP_BOX_MARGIN_Y                 24
#define TIP_BOX_TEXT_ICON_MARGIN         32
#elif defined(TARGET_APEX)
#define RADIO_CHOICE_HEIGHT              68
#define BAR_INTERVALE                    8
#define FOOTER_BUTTON_HEIGHT             88
#define FOOTER_IN_PAIR_HEIGHT            60
#define ROUNDED_AND_FOOTER_FOOTER_HEIGHT 128
#define FOOTER_TEXT_AND_NAV_WIDTH        120
#define TAP_TO_CONTINUE_MARGIN           30
#define SUB_HEADER_MARGIN                16
#define PRE_FIRST_TEXT_MARGIN            0
#define INTER_PARAGRAPHS_MARGIN          16
#define PRE_TITLE_MARGIN                 16
#define PRE_DESCRIPTION_MARGIN           12
#define PRE_FIRST_ROW_MARGIN             24
#define INTER_ROWS_MARGIN                12
#define QR_PRE_TEXT_MARGIN               16
#define QR_INTER_TEXTS_MARGIN            20
#define SPINNER_TEXT_MARGIN              16
#define SPINNER_INTER_TEXTS_MARGIN       16
#define BAR_TEXT_MARGIN                  16
#define BAR_INTER_TEXTS_MARGIN           12
#define LEFT_CONTENT_TEXT_PADDING        4
#define BUTTON_FROM_BOTTOM_MARGIN        0
#define TOP_BUTTON_MARGIN                12
#define TOP_BUTTON_MARGIN_WITH_ACTION    0
#define SINGLE_BUTTON_MARGIN             16
#define LONG_PRESS_PROGRESS_HEIGHT       4
#define LONG_PRESS_PROGRESS_ALIGN        0
#define LEFT_CONTENT_ICON_TEXT_X         8
#define TIP_BOX_MARGIN_Y                 12
#define TIP_BOX_TEXT_ICON_MARGIN         20
#else  // TARGETS
#error Undefined target
#endif  // TARGETS
 
// refresh period of the spinner, in ms
#define SPINNER_REFRESH_PERIOD 400
 
/**********************
 *      MACROS
 **********************/
 
/**********************
 *      TYPEDEFS
 **********************/
 
typedef enum {
    TOUCHABLE_BAR_ITEM,
    SWITCH_ITEM,
    TEXT_ITEM,
    NB_ITEM_TYPES
} listItemType_t;
 
// used to build either a touchable bar or a switch
typedef struct {
    listItemType_t             type;
    const nbgl_icon_details_t *iconLeft;   // a buffer containing the 1BPP icon for icon on
                                           // left (can be NULL)
    const nbgl_icon_details_t *iconRight;  // a buffer containing the 1BPP icon for icon 2 (can be
                                           // NULL). Dimensions must be the same as iconLeft
    const char  *text;                     // text (can be NULL)
    const char  *subText;                  // sub text (can be NULL)
    uint8_t      token;   // the token that will be used as argument of the callback
    nbgl_state_t state;   // state of the item
    bool         large;   // set to true only for the main level of OS settings
    uint8_t      index;   // index of obj (for callback)
    tune_index_e tuneId;  // if not @ref NBGL_NO_TUNE, a tune will be played
} listItem_t;
 
/**********************
 *      VARIABLES
 **********************/
 
static nbgl_layoutInternal_t gLayout[NB_MAX_LAYOUTS] = {0};
 
// current top of stack
static nbgl_layoutInternal_t *topLayout;
 
// numbers of touchable controls for the whole page
static uint8_t nbTouchableControls = 0;
 
/**********************
 *  STATIC PROTOTYPES
 **********************/
// extern const char *get_ux_loc_string(UX_LOC_STRINGS_INDEX index);
 
// Hold-to-approve parameters
#if defined(TARGET_FLEX)
// Percent of a single "hold-to-approve" bar
#define HOLD_TO_APPROVE_STEP_PERCENT     (7)
// Duration between two bars
#define HOLD_TO_APPROVE_STEP_DURATION_MS (100)
// Number of bars displayed when the user start the "hold-to-approve" mechanism
#define HOLD_TO_APPROVE_FIRST_STEP       (0)
#elif defined(TARGET_STAX)
#define HOLD_TO_APPROVE_STEP_PERCENT     (25)
#define HOLD_TO_APPROVE_STEP_DURATION_MS (400)
#define HOLD_TO_APPROVE_FIRST_STEP       (1)
#elif defined(TARGET_APEX)
#define HOLD_TO_APPROVE_STEP_PERCENT     (20)
#define HOLD_TO_APPROVE_STEP_DURATION_MS (300)
#define HOLD_TO_APPROVE_FIRST_STEP       (1)
#endif  // TARGETS
 
static inline uint8_t get_hold_to_approve_percent(uint32_t touch_duration)
{
    uint8_t current_step_nb
        = (touch_duration / HOLD_TO_APPROVE_STEP_DURATION_MS) + HOLD_TO_APPROVE_FIRST_STEP;
    return (current_step_nb * HOLD_TO_APPROVE_STEP_PERCENT);
}
 
// function used to retrieve the concerned layout and layout obj matching the given touched obj
static bool getLayoutAndLayoutObj(nbgl_obj_t             *obj,
                                  nbgl_layoutInternal_t **layout,
                                  layoutObj_t           **layoutObj)
{
    // only try to find the object on top layout on the stack (the other cannot receive touch
    // events)
    *layout = NULL;
    if ((topLayout) && (topLayout->isUsed)) {
        uint8_t j;
 
        // search index of obj in this layout
        for (j = 0; j < topLayout->nbUsedCallbackObjs; j++) {
            if (obj == topLayout->callbackObjPool[j].obj) {
                LOG_DEBUG(LAYOUT_LOGGER,
                          "getLayoutAndLayoutObj(): obj found in layout %p "
                          "nbUsedCallbackObjs = %d\n",
                          topLayout,
                          topLayout->nbUsedCallbackObjs);
                *layout    = topLayout;
                *layoutObj = &(topLayout->callbackObjPool[j]);
                return true;
            }
        }
    }
    // not found
    return false;
}
 
static void radioTouchCallback(nbgl_obj_t            *obj,
                               nbgl_touchType_t       eventType,
                               nbgl_layoutInternal_t *layout);
static void longTouchCallback(nbgl_obj_t            *obj,
                              nbgl_touchType_t       eventType,
                              nbgl_layoutInternal_t *layout,
                              layoutObj_t           *layoutObj);
 
// callback for most touched object
static void touchCallback(nbgl_obj_t *obj, nbgl_touchType_t eventType)
{
    nbgl_layoutInternal_t *layout;
    layoutObj_t           *layoutObj;
    bool                   needRefresh = false;
 
    if (obj == NULL) {
        return;
    }
    LOG_DEBUG(LAYOUT_LOGGER, "touchCallback(): eventType = %d, obj = %p\n", eventType, obj);
    if (getLayoutAndLayoutObj(obj, &layout, &layoutObj) == false) {
        // try with parent, if existing
        if (getLayoutAndLayoutObj(obj->parent, &layout, &layoutObj) == false) {
            LOG_WARN(
                LAYOUT_LOGGER,
                "touchCallback(): eventType = %d, obj = %p, no active layout or obj not found\n",
                eventType,
                obj);
            return;
        }
    }
 
    // case of swipe
    if (((eventType == SWIPED_UP) || (eventType == SWIPED_DOWN) || (eventType == SWIPED_LEFT)
         || (eventType == SWIPED_RIGHT))
        && (obj->type == CONTAINER)) {
#ifdef NBGL_KEYBOARD
        if (layout->swipeUsage == SWIPE_USAGE_SUGGESTIONS) {
            keyboardSwipeCallback(obj, eventType);
            return;
        }
#endif  // NBGL_KEYBOARD
        if (layout->swipeUsage == SWIPE_USAGE_CUSTOM) {
            layoutObj->index = eventType;
        }
        else if ((layout->swipeUsage == SWIPE_USAGE_NAVIGATION)
                 && ((nbgl_obj_t *) layout->container == obj)) {
            nbgl_container_t *navContainer;
            if (layout->footerType == FOOTER_NAV) {
                navContainer = (nbgl_container_t *) layout->footerContainer;
            }
            else if (layout->footerType == FOOTER_TEXT_AND_NAV) {
                navContainer = (nbgl_container_t *) layout->footerContainer->children[1];
            }
            else {
                return;
            }
 
            if (layoutNavigationCallback(
                    (nbgl_obj_t *) navContainer, eventType, layout->nbPages, &layout->activePage)
                == false) {
                // navigation was impossible
                return;
            }
            layoutObj->index = layout->activePage;
        }
    }
 
    // case of navigation bar
    if (((obj->parent == (nbgl_obj_t *) layout->footerContainer)
         && (layout->footerType == FOOTER_NAV))
        || ((obj->parent->type == CONTAINER)
            && (obj->parent->parent == (nbgl_obj_t *) layout->footerContainer)
            && (layout->footerType == FOOTER_TEXT_AND_NAV))) {
        if (layoutNavigationCallback(obj, eventType, layout->nbPages, &layout->activePage)
            == false) {
            // navigation was impossible
            return;
        }
        layoutObj->index = layout->activePage;
    }
 
    // case of switch
    if ((obj->type == CONTAINER) && (((nbgl_container_t *) obj)->nbChildren >= 2)
        && (((nbgl_container_t *) obj)->children[1] != NULL)
        && (((nbgl_container_t *) obj)->children[1]->type == SWITCH)) {
        nbgl_switch_t *lSwitch = (nbgl_switch_t *) ((nbgl_container_t *) obj)->children[1];
        lSwitch->state         = (lSwitch->state == ON_STATE) ? OFF_STATE : ON_STATE;
        nbgl_objDraw((nbgl_obj_t *) lSwitch);
        // refresh will be done after tune playback
        needRefresh = true;
        // index is used for state
        layoutObj->index = lSwitch->state;
    }
    // case of radio
    else if ((obj->type == CONTAINER) && (((nbgl_container_t *) obj)->nbChildren == 2)
             && (((nbgl_container_t *) obj)->children[1] != NULL)
             && (((nbgl_container_t *) obj)->children[1]->type == RADIO_BUTTON)) {
        radioTouchCallback(obj, eventType, layout);
        return;
    }
    // case of long press
    else if ((obj->type == CONTAINER) && (((nbgl_container_t *) obj)->nbChildren == 4)
             && (((nbgl_container_t *) obj)->children[3] != NULL)
             && (((nbgl_container_t *) obj)->children[3]->type == PROGRESS_BAR)) {
        longTouchCallback(obj, eventType, layout, layoutObj);
        return;
    }
    LOG_DEBUG(LAYOUT_LOGGER, "touchCallback(): layout->callback = %p\n", layout->callback);
    if ((layout->callback != NULL) && (layoutObj->token != NBGL_INVALID_TOKEN)) {
#ifdef HAVE_PIEZO_SOUND
        if (layoutObj->tuneId < NBGL_NO_TUNE) {
            os_io_seph_cmd_piezo_play_tune(layoutObj->tuneId);
        }
#endif  // HAVE_PIEZO_SOUND
        if (needRefresh) {
            nbgl_refreshSpecial(FULL_COLOR_PARTIAL_REFRESH);
        }
        layout->callback(layoutObj->token, layoutObj->index);
    }
}
 
// callback for long press button
static void longTouchCallback(nbgl_obj_t            *obj,
                              nbgl_touchType_t       eventType,
                              nbgl_layoutInternal_t *layout,
                              layoutObj_t           *layoutObj)
{
    nbgl_container_t *container = (nbgl_container_t *) obj;
    // 4th child of container is the progress bar
    nbgl_progress_bar_t *progressBar = (nbgl_progress_bar_t *) container->children[3];
 
    LOG_DEBUG(LAYOUT_LOGGER, "longTouchCallback(): eventType = %d, obj = %p\n", eventType, obj);
 
    // case of pressing a long press button
    if (eventType == TOUCHING) {
        uint32_t touchDuration = nbgl_touchGetTouchDuration(obj);
 
        // Compute the new progress bar state in %
        uint8_t new_state = get_hold_to_approve_percent(touchDuration);
 
        // Ensure the callback is triggered once,
        // when the progress bar state reaches 100%
        bool trigger_callback = (new_state >= 100) && (progressBar->state < 100);
 
        // Cap progress bar state at 100%
        if (new_state >= 100) {
            new_state = 100;
        }
 
        // Update progress bar state
        if (new_state != progressBar->state) {
            progressBar->partialRedraw = true;
            progressBar->state         = new_state;
 
            nbgl_objDraw((nbgl_obj_t *) progressBar);
            // Ensure progress bar is fully drawn
            // before calling the callback.
            nbgl_refreshSpecialWithPostRefresh(BLACK_AND_WHITE_FAST_REFRESH,
                                               POST_REFRESH_FORCE_POWER_ON_WITH_PIPELINE);
        }
 
        if (trigger_callback) {
            // End of progress bar reached: trigger callback
            if (layout->callback != NULL) {
                layout->callback(layoutObj->token, layoutObj->index);
            }
        }
    }
    // case of releasing a long press button (or getting out of it)
    else if ((eventType == TOUCH_RELEASED) || (eventType == OUT_OF_TOUCH)
             || (eventType == SWIPED_LEFT) || (eventType == SWIPED_RIGHT)) {
        nbgl_wait_pipeline();
        progressBar->partialRedraw = true;
        progressBar->state         = 0;
        nbgl_objDraw((nbgl_obj_t *) progressBar);
#ifdef TARGET_APEX
        // for Apex, it's necessary to redraw the dotted line, that has been partially wiped
        nbgl_line_t *line = (nbgl_line_t *) container->children[2];
        nbgl_objDraw((nbgl_obj_t *) line);
#endif  // TARGET_APEX
        nbgl_refreshSpecialWithPostRefresh(BLACK_AND_WHITE_REFRESH, POST_REFRESH_FORCE_POWER_OFF);
    }
}
 
// callback for radio button touch
static void radioTouchCallback(nbgl_obj_t            *obj,
                               nbgl_touchType_t       eventType,
                               nbgl_layoutInternal_t *layout)
{
    uint8_t i = NB_MAX_LAYOUTS, radioIndex = 0, foundRadio = 0xFF, foundRadioIndex;
 
    if (eventType != TOUCHED) {
        return;
    }
 
    i = 0;
    // parse all objs to find all containers of radio buttons
    while (i < layout->nbUsedCallbackObjs) {
        if ((obj == (nbgl_obj_t *) layout->callbackObjPool[i].obj)
            && (layout->callbackObjPool[i].obj->type == CONTAINER)) {
            nbgl_radio_t *radio
                = (nbgl_radio_t *) ((nbgl_container_t *) layout->callbackObjPool[i].obj)
                      ->children[1];
            nbgl_text_area_t *textArea
                = (nbgl_text_area_t *) ((nbgl_container_t *) layout->callbackObjPool[i].obj)
                      ->children[0];
            foundRadio      = i;
            foundRadioIndex = radioIndex;
            // set text as active (black and bold)
            textArea->textColor = BLACK;
            textArea->fontId    = SMALL_BOLD_FONT;
            // ensure that radio button is ON
            radio->state = ON_STATE;
            // redraw container
            nbgl_objDraw((nbgl_obj_t *) obj);
        }
        else if ((layout->callbackObjPool[i].obj->type == CONTAINER)
                 && (((nbgl_container_t *) layout->callbackObjPool[i].obj)->nbChildren == 2)
                 && (((nbgl_container_t *) layout->callbackObjPool[i].obj)->children[1]->type
                     == RADIO_BUTTON)) {
            nbgl_radio_t *radio
                = (nbgl_radio_t *) ((nbgl_container_t *) layout->callbackObjPool[i].obj)
                      ->children[1];
            nbgl_text_area_t *textArea
                = (nbgl_text_area_t *) ((nbgl_container_t *) layout->callbackObjPool[i].obj)
                      ->children[0];
            radioIndex++;
            // set to OFF the one that was in ON
            if (radio->state == ON_STATE) {
                radio->state = OFF_STATE;
                // set text it as inactive (gray and normal)
                textArea->textColor = LIGHT_TEXT_COLOR;
                textArea->fontId    = SMALL_REGULAR_FONT;
                // redraw container
                nbgl_objDraw((nbgl_obj_t *) layout->callbackObjPool[i].obj);
            }
        }
        i++;
    }
    // call callback after redraw to avoid asynchronicity
    if (foundRadio != 0xFF) {
        if (layout->callback != NULL) {
#ifdef HAVE_PIEZO_SOUND
            if (layout->callbackObjPool[foundRadio].tuneId < NBGL_NO_TUNE) {
                os_io_seph_cmd_piezo_play_tune(layout->callbackObjPool[foundRadio].tuneId);
            }
            nbgl_refreshSpecial(FULL_COLOR_PARTIAL_REFRESH);
#endif  // HAVE_PIEZO_SOUND
            layout->callback(layout->callbackObjPool[foundRadio].token, foundRadioIndex);
        }
    }
}
 
// callback for spinner ticker
static void spinnerTickerCallback(void)
{
    nbgl_spinner_t *spinner;
    uint8_t         i = 0;
 
    if (!topLayout || !topLayout->isUsed) {
        return;
    }
 
    // get index of obj
    while (i < topLayout->container->nbChildren) {
        if (topLayout->container->children[i]->type == CONTAINER) {
            nbgl_container_t *container = (nbgl_container_t *) topLayout->container->children[i];
            if (container->nbChildren && (container->children[0]->type == SPINNER)) {
                spinner = (nbgl_spinner_t *) container->children[0];
                spinner->position++;
                // there are only NB_SPINNER_POSITIONS positions
                if (spinner->position == NB_SPINNER_POSITIONS) {
                    spinner->position = 0;
                }
                nbgl_objDraw((nbgl_obj_t *) spinner);
                nbgl_refreshSpecial(BLACK_AND_WHITE_FAST_REFRESH);
                return;
            }
        }
        i++;
    }
}
 
// callback for animation ticker
static void animTickerCallback(void)
{
    nbgl_image_t          *image;
    uint8_t                i      = 0;
    nbgl_layoutInternal_t *layout = topLayout;
 
    if (!layout || !layout->isUsed || (layout->animation == NULL)) {
        return;
    }
 
    // get index of image obj
    while (i < layout->container->nbChildren) {
        if (layout->container->children[i]->type == CONTAINER) {
            nbgl_container_t *container = (nbgl_container_t *) layout->container->children[i];
            if (container->children[1]->type == IMAGE) {
                image = (nbgl_image_t *) container->children[1];
                if (layout->animation->parsing == LOOP_PARSING) {
                    if (layout->iconIdxInAnim == (layout->animation->nbIcons - 1)) {
                        layout->iconIdxInAnim = 0;
                    }
                    else {
                        layout->iconIdxInAnim++;
                    }
                }
                else {
                    // Flip incrementAnim when reaching upper or lower limit
                    if ((layout->incrementAnim)
                        && (layout->iconIdxInAnim >= layout->animation->nbIcons - 1)) {
                        layout->incrementAnim = false;
                    }
                    else if (layout->iconIdxInAnim == 0) {
                        layout->incrementAnim = true;
                    }
 
                    // Increase / Decrease index according to incrementAnim
                    if (layout->incrementAnim) {
                        layout->iconIdxInAnim++;
                    }
                    else {
                        layout->iconIdxInAnim--;
                    }
                }
                image->buffer = layout->animation->icons[layout->iconIdxInAnim];
                nbgl_objDraw((nbgl_obj_t *) image);
                nbgl_refreshSpecialWithPostRefresh(BLACK_AND_WHITE_FAST_REFRESH,
                                                   POST_REFRESH_FORCE_POWER_ON);
                return;
            }
        }
        i++;
    }
}
 
static nbgl_line_t *createHorizontalLine(uint8_t layer)
{
    nbgl_line_t *line;
 
    line                  = (nbgl_line_t *) nbgl_objPoolGet(LINE, layer);
    line->lineColor       = LIGHT_GRAY;
    line->obj.area.width  = SCREEN_WIDTH;
    line->obj.area.height = 1;
    line->direction       = HORIZONTAL;
    line->thickness       = 1;
    return line;
}
 
#ifdef TARGET_STAX
static nbgl_line_t *createLeftVerticalLine(uint8_t layer)
{
    nbgl_line_t *line;
 
    line                  = (nbgl_line_t *) nbgl_objPoolGet(LINE, layer);
    line->lineColor       = LIGHT_GRAY;
    line->obj.area.width  = 1;
    line->obj.area.height = SCREEN_HEIGHT;
    line->direction       = VERTICAL;
    line->thickness       = 1;
    line->obj.alignment   = MID_LEFT;
    return line;
}
#endif  // TARGET_STAX
 
// function adding a layout object in the callbackObjPool array for the given layout, and
// configuring it
layoutObj_t *layoutAddCallbackObj(nbgl_layoutInternal_t *layout,
                                  nbgl_obj_t            *obj,
                                  uint8_t                token,
                                  tune_index_e           tuneId)
{
    layoutObj_t *layoutObj = NULL;
 
    if (layout->nbUsedCallbackObjs < (LAYOUT_OBJ_POOL_LEN - 1)) {
        layoutObj = &layout->callbackObjPool[layout->nbUsedCallbackObjs];
        layout->nbUsedCallbackObjs++;
        layoutObj->obj    = obj;
        layoutObj->token  = token;
        layoutObj->tuneId = tuneId;
    }
    else {
        LOG_FATAL(LAYOUT_LOGGER, "layoutAddCallbackObj: no more callback obj\n");
    }
 
    return layoutObj;
}
 
void layoutAddObject(nbgl_layoutInternal_t *layout, nbgl_obj_t *obj)
{
    if (layout->container->nbChildren == NB_MAX_CONTAINER_CHILDREN) {
        LOG_FATAL(LAYOUT_LOGGER, "layoutAddObject(): No more object\n");
    }
    layout->container->children[layout->container->nbChildren] = obj;
    layout->container->nbChildren++;
}
 
static int addSwipeInternal(nbgl_layoutInternal_t *layoutInt,
                            uint16_t               swipesMask,
                            nbgl_swipe_usage_t     usage,
                            uint8_t                token,
                            tune_index_e           tuneId)
{
    layoutObj_t *obj;
 
    if ((swipesMask & SWIPE_MASK) == 0) {
        return -1;
    }
 
    obj = layoutAddCallbackObj(layoutInt, (nbgl_obj_t *) layoutInt->container, token, tuneId);
    if (obj == NULL) {
        return -1;
    }
    layoutInt->container->obj.touchMask = swipesMask;
    layoutInt->swipeUsage               = usage;
 
    return 0;
}
 
static nbgl_container_t *addListItem(nbgl_layoutInternal_t *layoutInt, const listItem_t *itemDesc)
{
    layoutObj_t      *obj;
    nbgl_text_area_t *textArea = NULL;
    nbgl_container_t *container;
    color_t color = ((itemDesc->type == TOUCHABLE_BAR_ITEM) && (itemDesc->state == OFF_STATE))
                        ? INACTIVE_TEXT_COLOR
                        : BLACK;
    nbgl_font_id_e fontId
        = (((itemDesc->type == TOUCHABLE_BAR_ITEM) || (itemDesc->type == SWITCH_ITEM))
           && (itemDesc->state == OFF_STATE))
              ? INACTIVE_SMALL_FONT
              : SMALL_BOLD_FONT;
 
    LOG_DEBUG(LAYOUT_LOGGER, "addListItem():\n");
 
    container = (nbgl_container_t *) nbgl_objPoolGet(CONTAINER, layoutInt->layer);
    obj       = layoutAddCallbackObj(
        layoutInt, (nbgl_obj_t *) container, itemDesc->token, itemDesc->tuneId);
    if (obj == NULL) {
        return NULL;
    }
    obj->index = itemDesc->index;
 
    // get container children (up to 4: text +  left+right icons +  sub text)
    container->children   = nbgl_containerPoolGet(4, layoutInt->layer);
    container->nbChildren = 0;
 
    container->obj.area.width = AVAILABLE_WIDTH;
    container->obj.area.height
        = LIST_ITEM_MIN_TEXT_HEIGHT
          + 2 * (itemDesc->large ? LIST_ITEM_PRE_HEADING_LARGE : LIST_ITEM_PRE_HEADING);
    container->layout               = HORIZONTAL;
    container->obj.alignmentMarginX = BORDER_MARGIN;
    container->obj.alignment        = NO_ALIGNMENT;
    container->obj.alignTo          = NULL;
    // the bar can only be touched if not inactive AND if one of the icon is present
    // otherwise it is seen as a title
    if (((itemDesc->type == TOUCHABLE_BAR_ITEM) && (itemDesc->state == ON_STATE))
        || (itemDesc->type == SWITCH_ITEM)) {
        container->obj.touchMask = (1 << TOUCHED);
        container->obj.touchId   = CONTROLS_ID + nbTouchableControls;
        nbTouchableControls++;
    }
 
    // allocate main text if not NULL
    if (itemDesc->text != NULL) {
        textArea            = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
        textArea->textColor = color;
        textArea->text      = PIC(itemDesc->text);
        textArea->onDrawCallback = NULL;
        textArea->fontId         = fontId;
        textArea->wrapping       = true;
        textArea->obj.area.width = container->obj.area.width;
        if (itemDesc->iconLeft != NULL) {
            // reduce text width accordingly
            textArea->obj.area.width
                -= ((nbgl_icon_details_t *) PIC(itemDesc->iconLeft))->width + BAR_INTERVALE;
        }
        if (itemDesc->iconRight != NULL) {
            // reduce text width accordingly
            textArea->obj.area.width
                -= ((nbgl_icon_details_t *) PIC(itemDesc->iconRight))->width + BAR_INTERVALE;
        }
        else if (itemDesc->type == SWITCH_ITEM) {
            textArea->obj.area.width -= SWITCH_ICON.width + BAR_INTERVALE;
        }
        textArea->obj.area.height = MAX(
            LIST_ITEM_MIN_TEXT_HEIGHT,
            nbgl_getTextHeightInWidth(
                textArea->fontId, textArea->text, textArea->obj.area.width, textArea->wrapping));
        textArea->style         = NO_STYLE;
        textArea->obj.alignment = TOP_LEFT;
        textArea->obj.alignmentMarginY
            = itemDesc->large ? LIST_ITEM_PRE_HEADING_LARGE : LIST_ITEM_PRE_HEADING;
        if (textArea->obj.area.height > LIST_ITEM_MIN_TEXT_HEIGHT) {
            textArea->obj.alignmentMarginY
                -= (textArea->obj.area.height - LIST_ITEM_MIN_TEXT_HEIGHT) / 2;
        }
        textArea->textAlignment                    = MID_LEFT;
        container->children[container->nbChildren] = (nbgl_obj_t *) textArea;
        container->nbChildren++;
    }
 
    // allocate left icon if present
    if (itemDesc->iconLeft != NULL) {
        nbgl_image_t *imageLeft    = (nbgl_image_t *) nbgl_objPoolGet(IMAGE, layoutInt->layer);
        imageLeft->foregroundColor = color;
        imageLeft->buffer          = PIC(itemDesc->iconLeft);
        // align at the left of text
        imageLeft->obj.alignment                   = MID_LEFT;
        imageLeft->obj.alignTo                     = (nbgl_obj_t *) textArea;
        imageLeft->obj.alignmentMarginX            = BAR_INTERVALE;
        container->children[container->nbChildren] = (nbgl_obj_t *) imageLeft;
        container->nbChildren++;
 
        if (textArea != NULL) {
            textArea->obj.alignmentMarginX = imageLeft->buffer->width + BAR_INTERVALE;
        }
    }
    // allocate right icon if present
    if (itemDesc->iconRight != NULL) {
        nbgl_image_t *imageRight    = (nbgl_image_t *) nbgl_objPoolGet(IMAGE, layoutInt->layer);
        imageRight->foregroundColor = color;
        imageRight->buffer          = PIC(itemDesc->iconRight);
        // align at the right of text
        imageRight->obj.alignment        = MID_RIGHT;
        imageRight->obj.alignmentMarginX = BAR_INTERVALE;
        imageRight->obj.alignTo          = (nbgl_obj_t *) textArea;
 
        container->children[container->nbChildren] = (nbgl_obj_t *) imageRight;
        container->nbChildren++;
    }
    else if (itemDesc->type == SWITCH_ITEM) {
        nbgl_switch_t *switchObj = (nbgl_switch_t *) nbgl_objPoolGet(SWITCH, layoutInt->layer);
        switchObj->onColor       = BLACK;
        switchObj->offColor      = LIGHT_GRAY;
        switchObj->state         = itemDesc->state;
        switchObj->obj.alignment = MID_RIGHT;
        switchObj->obj.alignmentMarginX = BAR_INTERVALE;
        switchObj->obj.alignTo          = (nbgl_obj_t *) textArea;
 
        container->children[container->nbChildren] = (nbgl_obj_t *) switchObj;
        container->nbChildren++;
    }
 
    if (itemDesc->subText != NULL) {
        nbgl_text_area_t *subTextArea
            = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
 
        subTextArea->textColor     = color;
        subTextArea->text          = PIC(itemDesc->subText);
        subTextArea->textAlignment = MID_LEFT;
        subTextArea->fontId        = SMALL_REGULAR_FONT;
        subTextArea->style         = NO_STYLE;
        subTextArea->wrapping      = true;
        if (itemDesc->text != NULL) {
            subTextArea->obj.alignment        = BOTTOM_LEFT;
            subTextArea->obj.alignTo          = (nbgl_obj_t *) textArea;
            subTextArea->obj.alignmentMarginY = LIST_ITEM_HEADING_SUB_TEXT;
        }
        else {
            subTextArea->obj.alignment        = TOP_LEFT;
            subTextArea->obj.alignmentMarginY = SUB_HEADER_MARGIN;
            container->obj.area.height        = SUB_HEADER_MARGIN;
        }
        if (itemDesc->iconLeft != NULL) {
            subTextArea->obj.alignmentMarginX
                = -(((nbgl_icon_details_t *) PIC(itemDesc->iconLeft))->width + BAR_INTERVALE);
        }
        subTextArea->obj.area.width                = container->obj.area.width;
        subTextArea->obj.area.height               = nbgl_getTextHeightInWidth(subTextArea->fontId,
                                                                 subTextArea->text,
                                                                 subTextArea->obj.area.width,
                                                                 subTextArea->wrapping);
        container->children[container->nbChildren] = (nbgl_obj_t *) subTextArea;
        container->nbChildren++;
        container->obj.area.height
            += subTextArea->obj.area.height + subTextArea->obj.alignmentMarginY;
    }
    // set this new container as child of main container
    layoutAddObject(layoutInt, (nbgl_obj_t *) container);
 
    return container;
}
 
static nbgl_container_t *addContentCenter(nbgl_layoutInternal_t      *layoutInt,
                                          const nbgl_contentCenter_t *info)
{
    nbgl_container_t *container;
    nbgl_text_area_t *textArea   = NULL;
    nbgl_image_t     *image      = NULL;
    uint16_t          fullHeight = 0;
 
    container = (nbgl_container_t *) nbgl_objPoolGet(CONTAINER, layoutInt->layer);
 
    // get container children
    container->nbChildren = 0;
    // the max number is: icon + anim + title + small title + description + sub-text
    container->children = nbgl_containerPoolGet(6, layoutInt->layer);
 
    // add icon or animation if present
    if (info->icon != NULL) {
        image                       = (nbgl_image_t *) nbgl_objPoolGet(IMAGE, layoutInt->layer);
        image->foregroundColor      = (layoutInt->invertedColors) ? WHITE : BLACK;
        image->buffer               = PIC(info->icon);
        image->obj.alignment        = TOP_MIDDLE;
        image->obj.alignmentMarginY = info->iconHug;
 
        fullHeight += image->buffer->height + info->iconHug;
        container->children[container->nbChildren] = (nbgl_obj_t *) image;
        container->nbChildren++;
 
        if (info->illustrType == ANIM_ILLUSTRATION) {
            nbgl_image_t *anim;
            anim                       = (nbgl_image_t *) nbgl_objPoolGet(IMAGE, layoutInt->layer);
            anim->foregroundColor      = (layoutInt->invertedColors) ? WHITE : BLACK;
            anim->buffer               = PIC(info->animation->icons[0]);
            anim->obj.alignment        = TOP_MIDDLE;
            anim->obj.alignmentMarginY = info->iconHug + info->animOffsetY;
            anim->obj.alignmentMarginX = info->animOffsetX;
 
            container->children[container->nbChildren] = (nbgl_obj_t *) anim;
            container->nbChildren++;
 
            layoutInt->animation     = info->animation;
            layoutInt->incrementAnim = true;
            layoutInt->iconIdxInAnim = 0;
 
            // update ticker to update the animation periodically
            nbgl_screenTickerConfiguration_t tickerCfg;
 
            tickerCfg.tickerIntervale = info->animation->delayMs;  // ms
            tickerCfg.tickerValue     = info->animation->delayMs;  // ms
            tickerCfg.tickerCallback  = &animTickerCallback;
            nbgl_screenUpdateTicker(layoutInt->layer, &tickerCfg);
        }
    }
    // add title if present
    if (info->title != NULL) {
        textArea                = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
        textArea->textColor     = (layoutInt->invertedColors) ? WHITE : BLACK;
        textArea->text          = PIC(info->title);
        textArea->textAlignment = CENTER;
        textArea->fontId        = LARGE_MEDIUM_FONT;
        textArea->wrapping      = true;
        textArea->obj.area.width  = AVAILABLE_WIDTH;
        textArea->obj.area.height = nbgl_getTextHeightInWidth(
            textArea->fontId, textArea->text, textArea->obj.area.width, textArea->wrapping);
 
        // if not the first child, put on bottom of the previous, with a margin
        if (container->nbChildren > 0) {
            textArea->obj.alignment        = BOTTOM_MIDDLE;
            textArea->obj.alignTo          = (nbgl_obj_t *) image;
            textArea->obj.alignmentMarginY = ICON_TITLE_MARGIN + info->iconHug;
        }
        else {
            textArea->obj.alignment = TOP_MIDDLE;
        }
 
        fullHeight += textArea->obj.area.height + textArea->obj.alignmentMarginY;
 
        container->children[container->nbChildren] = (nbgl_obj_t *) textArea;
        container->nbChildren++;
    }
    // add small title if present
    if (info->smallTitle != NULL) {
        textArea                = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
        textArea->textColor     = (layoutInt->invertedColors) ? WHITE : BLACK;
        textArea->text          = PIC(info->smallTitle);
        textArea->textAlignment = CENTER;
        textArea->fontId        = SMALL_BOLD_FONT;
        textArea->wrapping      = true;
        textArea->obj.area.width  = AVAILABLE_WIDTH;
        textArea->obj.area.height = nbgl_getTextHeightInWidth(
            textArea->fontId, textArea->text, textArea->obj.area.width, textArea->wrapping);
 
        // if not the first child, put on bottom of the previous, with a margin
        if (container->nbChildren > 0) {
            textArea->obj.alignment = BOTTOM_MIDDLE;
            textArea->obj.alignTo   = (nbgl_obj_t *) container->children[container->nbChildren - 1];
            textArea->obj.alignmentMarginY = VERTICAL_BORDER_MARGIN;
            if (container->children[container->nbChildren - 1]->type == IMAGE) {
                textArea->obj.alignmentMarginY = VERTICAL_BORDER_MARGIN + info->iconHug;
            }
            else {
                textArea->obj.alignmentMarginY = TITLE_DESC_MARGIN;
            }
        }
        else {
            textArea->obj.alignment = TOP_MIDDLE;
        }
 
        fullHeight += textArea->obj.area.height + textArea->obj.alignmentMarginY;
 
        container->children[container->nbChildren] = (nbgl_obj_t *) textArea;
        container->nbChildren++;
    }
    // add description if present
    if (info->description != NULL) {
        textArea                = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
        textArea->textColor     = (layoutInt->invertedColors) ? WHITE : BLACK;
        textArea->text          = PIC(info->description);
        textArea->textAlignment = CENTER;
        textArea->fontId        = SMALL_REGULAR_FONT;
        textArea->wrapping      = true;
        textArea->obj.area.width  = AVAILABLE_WIDTH;
        textArea->obj.area.height = nbgl_getTextHeightInWidth(
            textArea->fontId, textArea->text, textArea->obj.area.width, textArea->wrapping);
 
        // if not the first child, put on bottom of the previous, with a margin
        if (container->nbChildren > 0) {
            textArea->obj.alignment = BOTTOM_MIDDLE;
            textArea->obj.alignTo   = (nbgl_obj_t *) container->children[container->nbChildren - 1];
            if (container->children[container->nbChildren - 1]->type == TEXT_AREA) {
                // if previous element is text, only space of 16 px
                textArea->obj.alignmentMarginY = TITLE_DESC_MARGIN;
            }
            else {
                textArea->obj.alignmentMarginY = ICON_TITLE_MARGIN + info->iconHug;
            }
        }
        else {
            textArea->obj.alignment = TOP_MIDDLE;
        }
 
        fullHeight += textArea->obj.area.height + textArea->obj.alignmentMarginY;
 
        container->children[container->nbChildren] = (nbgl_obj_t *) textArea;
        container->nbChildren++;
    }
    // add sub-text if present
    if (info->subText != NULL) {
        textArea                = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
        textArea->textColor     = LIGHT_TEXT_COLOR;
        textArea->text          = PIC(info->subText);
        textArea->textAlignment = CENTER;
        textArea->fontId        = SMALL_REGULAR_FONT;
        textArea->wrapping      = true;
        textArea->obj.area.width  = AVAILABLE_WIDTH;
        textArea->obj.area.height = nbgl_getTextHeightInWidth(
            textArea->fontId, textArea->text, textArea->obj.area.width, textArea->wrapping);
        // sub-text is included in a hug of 8px
        textArea->obj.area.height += 2 * 8;
        // if not the first child, put on bottom of the previous, with a margin
        if (container->nbChildren > 0) {
            textArea->obj.alignment = BOTTOM_MIDDLE;
            textArea->obj.alignTo   = (nbgl_obj_t *) container->children[container->nbChildren - 1];
            textArea->obj.alignmentMarginY = 16;
            if (container->children[container->nbChildren - 1]->type == IMAGE) {
                textArea->obj.alignmentMarginY += info->iconHug;
            }
        }
        else {
            textArea->obj.alignment = TOP_MIDDLE;
        }
 
        fullHeight += textArea->obj.area.height + textArea->obj.alignmentMarginY;
 
        container->children[container->nbChildren] = (nbgl_obj_t *) textArea;
        container->nbChildren++;
    }
    container->layout          = VERTICAL;
    container->obj.alignment   = CENTER;
    container->obj.area.width  = AVAILABLE_WIDTH;
    container->obj.area.height = fullHeight;
    if (info->padding) {
        container->obj.area.height += 40;
    }
 
    // set this new container as child of main container
    layoutAddObject(layoutInt, (nbgl_obj_t *) container);
 
    return container;
}
 
/**********************
 *   GLOBAL FUNCTIONS
 **********************/
 
nbgl_layout_t *nbgl_layoutGet(const nbgl_layoutDescription_t *description)
{
    nbgl_layoutInternal_t *layout = NULL;
 
    if (description->modal) {
        int i;
        // find an empty layout in the array of layouts (0 is reserved for background)
        for (i = 1; i < NB_MAX_LAYOUTS; i++) {
            if (!gLayout[i].isUsed) {
                layout = &gLayout[i];
            }
        }
    }
    else {
        // always use layout 0 for background
        layout = &gLayout[0];
        if (topLayout == NULL) {
            topLayout = layout;
        }
    }
    if (layout == NULL) {
        LOG_WARN(LAYOUT_LOGGER, "nbgl_layoutGet(): impossible to get a layout!\n");
        return NULL;
    }
 
    // reset globals
    nbgl_layoutInternal_t *backgroundTop = gLayout[0].top;
    memset(layout, 0, sizeof(nbgl_layoutInternal_t));
    // link layout to other ones
    if (description->modal) {
        if (topLayout != NULL) {
            // if topLayout already existing, push this new one on top of it
            topLayout->top = layout;
            layout->bottom = topLayout;
        }
        else {
            // otherwise put it on top of background layout
            layout->bottom = &gLayout[0];
            gLayout[0].top = layout;
        }
        topLayout = layout;
    }
    else {
        // restore potentially valid background top layer
        gLayout[0].top = backgroundTop;
    }
 
    nbTouchableControls = 0;
 
    layout->callback       = (nbgl_layoutTouchCallback_t) PIC(description->onActionCallback);
    layout->modal          = description->modal;
    layout->withLeftBorder = description->withLeftBorder;
    if (description->modal) {
        layout->layer = nbgl_screenPush(&layout->children,
                                        NB_MAX_SCREEN_CHILDREN,
                                        &description->ticker,
                                        (nbgl_touchCallback_t) touchCallback);
    }
    else {
        nbgl_screenSet(&layout->children,
                       NB_MAX_SCREEN_CHILDREN,
                       &description->ticker,
                       (nbgl_touchCallback_t) touchCallback);
        layout->layer = 0;
    }
    layout->container = (nbgl_container_t *) nbgl_objPoolGet(CONTAINER, layout->layer);
    layout->container->obj.area.width  = SCREEN_WIDTH;
    layout->container->obj.area.height = SCREEN_HEIGHT;
    layout->container->layout          = VERTICAL;
    layout->container->children = nbgl_containerPoolGet(NB_MAX_CONTAINER_CHILDREN, layout->layer);
    // by default, if no header, main container is aligned on top-left
    layout->container->obj.alignment = TOP_LEFT;
    // main container is always the second object, leaving space for header
    layout->children[MAIN_CONTAINER_INDEX] = (nbgl_obj_t *) layout->container;
    layout->isUsed                         = true;
 
    // if a tap text is defined, make the container tapable and display this text in gray
    if (description->tapActionText != NULL) {
        layoutObj_t *obj;
        const char  *tapActionText = PIC(description->tapActionText);
 
        obj = &layout->callbackObjPool[layout->nbUsedCallbackObjs];
        layout->nbUsedCallbackObjs++;
        obj->obj                         = (nbgl_obj_t *) layout->container;
        obj->token                       = description->tapActionToken;
        obj->tuneId                      = description->tapTuneId;
        layout->container->obj.touchMask = (1 << TOUCHED);
        layout->container->obj.touchId   = WHOLE_SCREEN_ID;
 
        if (strlen(tapActionText) > 0) {
            nbgl_layoutUpFooter_t footerDesc;
            footerDesc.type        = UP_FOOTER_TEXT;
            footerDesc.text.text   = tapActionText;
            footerDesc.text.token  = description->tapActionToken;
            footerDesc.text.tuneId = description->tapTuneId;
            nbgl_layoutAddUpFooter((nbgl_layout_t *) layout, &footerDesc);
        }
    }
    return (nbgl_layout_t *) layout;
}
 
int nbgl_layoutAddSwipe(nbgl_layout_t *layout,
                        uint16_t       swipesMask,
                        const char    *text,
                        uint8_t        token,
                        tune_index_e   tuneId)
{
    nbgl_layoutInternal_t *layoutInt = (nbgl_layoutInternal_t *) layout;
 
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutAddSwipe():\n");
    if (layout == NULL) {
        return -1;
    }
 
    if (text) {
        // create 'tap to continue' text area
        layoutInt->tapText                  = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, 0);
        layoutInt->tapText->text            = PIC(text);
        layoutInt->tapText->textColor       = LIGHT_TEXT_COLOR;
        layoutInt->tapText->fontId          = SMALL_REGULAR_FONT;
        layoutInt->tapText->obj.area.width  = AVAILABLE_WIDTH;
        layoutInt->tapText->obj.area.height = nbgl_getFontLineHeight(layoutInt->tapText->fontId);
        layoutInt->tapText->textAlignment   = CENTER;
        layoutInt->tapText->obj.alignmentMarginY = TAP_TO_CONTINUE_MARGIN;
        layoutInt->tapText->obj.alignment        = BOTTOM_MIDDLE;
    }
    return addSwipeInternal(layoutInt, swipesMask, SWIPE_USAGE_CUSTOM, token, tuneId);
}
 
int nbgl_layoutInvertBackground(nbgl_layout_t *layout)
{
    nbgl_layoutInternal_t *layoutInt = (nbgl_layoutInternal_t *) layout;
 
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutInvertBackground():\n");
    if (layout == NULL) {
        return -1;
    }
    layoutInt->invertedColors = true;
    nbgl_screenUpdateBackgroundColor(layoutInt->layer, BLACK);
 
    // invert potential "Tap to continue"
    if ((layoutInt->upFooterContainer) && (layoutInt->upFooterContainer->nbChildren == 1)
        && (layoutInt->upFooterContainer->children[0]->type == TEXT_AREA)) {
        nbgl_text_area_t *textArea = (nbgl_text_area_t *) layoutInt->upFooterContainer->children[0];
        if (textArea->textColor == LIGHT_TEXT_COLOR) {
            textArea->textColor = INACTIVE_COLOR;
        }
    }
 
    return 0;
}
 
int nbgl_layoutAddTopRightButton(nbgl_layout_t             *layout,
                                 const nbgl_icon_details_t *icon,
                                 uint8_t                    token,
                                 tune_index_e               tuneId)
{
    nbgl_layoutInternal_t *layoutInt = (nbgl_layoutInternal_t *) layout;
    layoutObj_t           *obj;
    nbgl_button_t         *button;
 
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutAddTopRightButton():\n");
    if (layout == NULL) {
        return -1;
    }
    button = (nbgl_button_t *) nbgl_objPoolGet(BUTTON, layoutInt->layer);
    obj    = layoutAddCallbackObj(layoutInt, (nbgl_obj_t *) button, token, tuneId);
    if (obj == NULL) {
        return -1;
    }
 
    button->obj.area.width       = BUTTON_WIDTH;
    button->obj.area.height      = BUTTON_DIAMETER;
    button->radius               = BUTTON_RADIUS;
    button->obj.alignmentMarginX = BORDER_MARGIN;
    button->obj.alignmentMarginY = BORDER_MARGIN;
    button->foregroundColor      = BLACK;
    button->innerColor           = WHITE;
    button->borderColor          = LIGHT_GRAY;
    button->obj.touchMask        = (1 << TOUCHED);
    button->obj.touchId          = TOP_RIGHT_BUTTON_ID;
    button->icon                 = PIC(icon);
    button->obj.alignment        = TOP_RIGHT;
 
    // add to screen
    layoutInt->children[TOP_RIGHT_BUTTON_INDEX] = (nbgl_obj_t *) button;
 
    return 0;
}
 
int nbgl_layoutAddNavigationBar(nbgl_layout_t *layout, const nbgl_layoutNavigationBar_t *info)
{
    nbgl_layoutFooter_t footerDesc;
    footerDesc.type                         = FOOTER_NAV;
    footerDesc.separationLine               = info->withSeparationLine;
    footerDesc.navigation.activePage        = info->activePage;
    footerDesc.navigation.nbPages           = info->nbPages;
    footerDesc.navigation.withExitKey       = info->withExitKey;
    footerDesc.navigation.withBackKey       = info->withBackKey;
    footerDesc.navigation.withPageIndicator = false;
    footerDesc.navigation.token             = info->token;
    footerDesc.navigation.tuneId            = info->tuneId;
    return nbgl_layoutAddExtendedFooter(layout, &footerDesc);
}
 
int nbgl_layoutAddBottomButton(nbgl_layout_t             *layout,
                               const nbgl_icon_details_t *icon,
                               uint8_t                    token,
                               bool                       separationLine,
                               tune_index_e               tuneId)
{
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutAddBottomButton():\n");
    nbgl_layoutFooter_t footerDesc;
    footerDesc.type                  = FOOTER_SIMPLE_BUTTON;
    footerDesc.separationLine        = separationLine;
    footerDesc.button.fittingContent = false;
    footerDesc.button.icon           = PIC(icon);
    footerDesc.button.text           = NULL;
    footerDesc.button.token          = token;
    footerDesc.button.tuneId         = tuneId;
    footerDesc.button.style          = WHITE_BACKGROUND;
    return nbgl_layoutAddExtendedFooter(layout, &footerDesc);
}
 
int nbgl_layoutAddTouchableBar(nbgl_layout_t *layout, const nbgl_layoutBar_t *barLayout)
{
    nbgl_layoutInternal_t *layoutInt = (nbgl_layoutInternal_t *) layout;
    nbgl_container_t      *container;
    listItem_t             itemDesc = {0};
 
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutAddTouchableBar():\n");
    if (layout == NULL) {
        return -1;
    }
    // main text is mandatory
    if (barLayout->text == NULL) {
        LOG_FATAL(LAYOUT_LOGGER, "nbgl_layoutAddTouchableBar(): main text is mandatory\n");
    }
 
    itemDesc.iconLeft  = barLayout->iconLeft;
    itemDesc.iconRight = barLayout->iconRight;
    itemDesc.text      = barLayout->text;
    itemDesc.subText   = barLayout->subText;
    itemDesc.token     = barLayout->token;
    itemDesc.tuneId    = barLayout->tuneId;
    itemDesc.state     = (barLayout->inactive) ? OFF_STATE : ON_STATE;
    itemDesc.large     = barLayout->large;
    itemDesc.type      = TOUCHABLE_BAR_ITEM;
    container          = addListItem(layoutInt, &itemDesc);
 
    if (container == NULL) {
        return -1;
    }
    return container->obj.area.height;
}
 
int nbgl_layoutAddSwitch(nbgl_layout_t *layout, const nbgl_layoutSwitch_t *switchLayout)
{
    nbgl_layoutInternal_t *layoutInt = (nbgl_layoutInternal_t *) layout;
    nbgl_container_t      *container;
    listItem_t             itemDesc = {0};
 
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutAddSwitch():\n");
    if (layout == NULL) {
        return -1;
    }
    // main text is mandatory
    if (switchLayout->text == NULL) {
        LOG_FATAL(LAYOUT_LOGGER, "nbgl_layoutAddSwitch(): main text is mandatory\n");
    }
 
    itemDesc.text    = switchLayout->text;
    itemDesc.subText = switchLayout->subText;
    itemDesc.token   = switchLayout->token;
    itemDesc.tuneId  = switchLayout->tuneId;
    itemDesc.state   = switchLayout->initState;
    itemDesc.large   = false;
    itemDesc.type    = SWITCH_ITEM;
    container        = addListItem(layoutInt, &itemDesc);
 
    if (container == NULL) {
        return -1;
    }
    return container->obj.area.height;
}
 
int nbgl_layoutAddText(nbgl_layout_t *layout, const char *text, const char *subText)
{
    nbgl_layoutInternal_t *layoutInt = (nbgl_layoutInternal_t *) layout;
    nbgl_container_t      *container;
    listItem_t             itemDesc = {0};
 
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutAddText():\n");
    if (layout == NULL) {
        return -1;
    }
 
    itemDesc.text    = text;
    itemDesc.subText = subText;
    itemDesc.token   = NBGL_INVALID_TOKEN;
    itemDesc.tuneId  = NBGL_NO_TUNE;
    itemDesc.type    = TEXT_ITEM;
    container        = addListItem(layoutInt, &itemDesc);
 
    if (container == NULL) {
        return -1;
    }
    return container->obj.area.height;
}
 
int nbgl_layoutAddTextWithAlias(nbgl_layout_t *layout,
                                const char    *text,
                                const char    *subText,
                                uint8_t        token,
                                uint8_t        index)
{
    nbgl_layoutInternal_t *layoutInt = (nbgl_layoutInternal_t *) layout;
    nbgl_container_t      *container;
    listItem_t             itemDesc = {0};
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutAddTextWithAlias():\n");
    if (layout == NULL) {
        return -1;
    }
 
    itemDesc.text      = text;
    itemDesc.subText   = subText;
    itemDesc.iconRight = &MINI_PUSH_ICON;
    itemDesc.token     = token;
    itemDesc.tuneId    = NBGL_NO_TUNE;
    itemDesc.type      = TOUCHABLE_BAR_ITEM;
    itemDesc.index     = index;
    itemDesc.state     = ON_STATE;
    container          = addListItem(layoutInt, &itemDesc);
 
    if (container == NULL) {
        return -1;
    }
    return container->obj.area.height;
}
 
int nbgl_layoutAddLargeCaseText(nbgl_layout_t *layout, const char *text, bool grayedOut)
{
    nbgl_layoutInternal_t *layoutInt = (nbgl_layoutInternal_t *) layout;
    nbgl_text_area_t      *textArea;
 
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutAddLargeCaseText():\n");
    if (layout == NULL) {
        return -1;
    }
    textArea = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
 
    textArea->textColor       = grayedOut ? INACTIVE_TEXT_COLOR : BLACK;
    textArea->text            = PIC(text);
    textArea->textAlignment   = MID_LEFT;
    textArea->fontId          = LARGE_MEDIUM_FONT;
    textArea->obj.area.width  = AVAILABLE_WIDTH;
    textArea->wrapping        = true;
    textArea->obj.area.height = nbgl_getTextHeightInWidth(
        textArea->fontId, textArea->text, textArea->obj.area.width, textArea->wrapping);
    textArea->style                = NO_STYLE;
    textArea->obj.alignment        = NO_ALIGNMENT;
    textArea->obj.alignmentMarginX = BORDER_MARGIN;
    if (layoutInt->container->nbChildren == 0) {
        // if first object of container, increase the margin from top
        textArea->obj.alignmentMarginY += PRE_FIRST_TEXT_MARGIN;
    }
    else {
        textArea->obj.alignmentMarginY = INTER_PARAGRAPHS_MARGIN;  // between paragraphs
    }
 
    // set this new obj as child of main container
    layoutAddObject(layoutInt, (nbgl_obj_t *) textArea);
 
    return 0;
}
 
int nbgl_layoutAddTextContent(nbgl_layout_t *layout,
                              const char    *title,
                              const char    *description,
                              const char    *info)
{
    nbgl_layoutInternal_t *layoutInt = (nbgl_layoutInternal_t *) layout;
    nbgl_text_area_t      *textArea;
 
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutAddTextContent():\n");
    if (layout == NULL) {
        return -1;
    }
 
    // create title
    textArea                = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
    textArea->textColor     = BLACK;
    textArea->text          = PIC(title);
    textArea->textAlignment = MID_LEFT;
    textArea->fontId        = LARGE_MEDIUM_FONT;
    textArea->style         = NO_STYLE;
    textArea->wrapping      = true;
    textArea->obj.alignment = NO_ALIGNMENT;
    textArea->obj.alignmentMarginX = BORDER_MARGIN;
    textArea->obj.alignmentMarginY = PRE_TITLE_MARGIN;
    textArea->obj.area.width       = AVAILABLE_WIDTH;
    textArea->obj.area.height      = nbgl_getTextHeightInWidth(
        textArea->fontId, textArea->text, textArea->obj.area.width, textArea->wrapping);
    // set this new obj as child of main container
    layoutAddObject(layoutInt, (nbgl_obj_t *) textArea);
 
    // create description
    textArea                  = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
    textArea->textColor       = BLACK;
    textArea->text            = PIC(description);
    textArea->fontId          = SMALL_REGULAR_FONT;
    textArea->style           = NO_STYLE;
    textArea->wrapping        = true;
    textArea->obj.area.width  = AVAILABLE_WIDTH;
    textArea->obj.area.height = nbgl_getTextHeightInWidth(
        textArea->fontId, textArea->text, textArea->obj.area.width, textArea->wrapping);
    textArea->textAlignment        = MID_LEFT;
    textArea->obj.alignment        = NO_ALIGNMENT;
    textArea->obj.alignmentMarginX = BORDER_MARGIN;
    textArea->obj.alignmentMarginY = PRE_DESCRIPTION_MARGIN;
    // set this new obj as child of main container
    layoutAddObject(layoutInt, (nbgl_obj_t *) textArea);
 
    // create info on the bottom
    textArea                  = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
    textArea->textColor       = LIGHT_TEXT_COLOR;
    textArea->text            = PIC(info);
    textArea->fontId          = SMALL_REGULAR_FONT;
    textArea->style           = NO_STYLE;
    textArea->wrapping        = true;
    textArea->obj.area.width  = AVAILABLE_WIDTH;
    textArea->obj.area.height = nbgl_getTextHeightInWidth(
        textArea->fontId, textArea->text, textArea->obj.area.width, textArea->wrapping);
    textArea->textAlignment        = MID_LEFT;
    textArea->obj.alignment        = BOTTOM_LEFT;
    textArea->obj.alignmentMarginX = BORDER_MARGIN;
    textArea->obj.alignmentMarginY = 40;
    // set this new obj as child of main container
    layoutAddObject(layoutInt, (nbgl_obj_t *) textArea);
 
    return layoutInt->container->obj.area.height;
}
 
int nbgl_layoutAddRadioChoice(nbgl_layout_t *layout, const nbgl_layoutRadioChoice_t *choices)
{
    nbgl_layoutInternal_t *layoutInt = (nbgl_layoutInternal_t *) layout;
    layoutObj_t           *obj;
    uint8_t                i;
 
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutAddRadioChoice():\n");
    if (layout == NULL) {
        return -1;
    }
    for (i = 0; i < choices->nbChoices; i++) {
        nbgl_container_t *container;
        nbgl_text_area_t *textArea;
        nbgl_radio_t     *button;
        nbgl_line_t      *line;
 
        container = (nbgl_container_t *) nbgl_objPoolGet(CONTAINER, layoutInt->layer);
        textArea  = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
        button    = (nbgl_radio_t *) nbgl_objPoolGet(RADIO_BUTTON, layoutInt->layer);
 
        obj = layoutAddCallbackObj(
            layoutInt, (nbgl_obj_t *) container, choices->token, choices->tuneId);
        if (obj == NULL) {
            return -1;
        }
 
        // get container children (max 2)
        container->nbChildren      = 2;
        container->children        = nbgl_containerPoolGet(container->nbChildren, layoutInt->layer);
        container->obj.area.width  = AVAILABLE_WIDTH;
        container->obj.area.height = RADIO_CHOICE_HEIGHT;
        container->obj.alignment   = NO_ALIGNMENT;
        container->obj.alignmentMarginX = BORDER_MARGIN;
        container->obj.alignTo          = (nbgl_obj_t *) NULL;
 
        // init button for this choice
        button->activeColor    = BLACK;
        button->borderColor    = LIGHT_GRAY;
        button->obj.alignTo    = (nbgl_obj_t *) container;
        button->obj.alignment  = MID_RIGHT;
        button->state          = OFF_STATE;
        container->children[1] = (nbgl_obj_t *) button;
 
        // init text area for this choice
        if (choices->localized == true) {
#ifdef HAVE_LANGUAGE_PACK
            textArea->text = get_ux_loc_string(choices->nameIds[i]);
#endif  // HAVE_LANGUAGE_PACK
        }
        else {
            textArea->text = PIC(choices->names[i]);
        }
        textArea->textAlignment  = MID_LEFT;
        textArea->obj.area.width = container->obj.area.width - RADIO_WIDTH;
        textArea->style          = NO_STYLE;
        textArea->obj.alignment  = MID_LEFT;
        textArea->obj.alignTo    = (nbgl_obj_t *) container;
        container->children[0]   = (nbgl_obj_t *) textArea;
 
        // whole container should be touchable
        container->obj.touchMask = (1 << TOUCHED);
        container->obj.touchId   = CONTROLS_ID + nbTouchableControls;
        nbTouchableControls++;
 
        // highlight init choice
        if (i == choices->initChoice) {
            button->state       = ON_STATE;
            textArea->textColor = BLACK;
            textArea->fontId    = SMALL_BOLD_FONT;
        }
        else {
            button->state       = OFF_STATE;
            textArea->textColor = LIGHT_TEXT_COLOR;
            textArea->fontId    = SMALL_REGULAR_FONT;
        }
        textArea->obj.area.height = nbgl_getFontHeight(textArea->fontId);
 
        line                       = createHorizontalLine(layoutInt->layer);
        line->obj.alignmentMarginY = -1;
 
        // set these new objs as child of main container
        layoutAddObject(layoutInt, (nbgl_obj_t *) container);
        layoutAddObject(layoutInt, (nbgl_obj_t *) line);
    }
 
    return 0;
}
 
int nbgl_layoutAddCenteredInfo(nbgl_layout_t *layout, const nbgl_layoutCenteredInfo_t *info)
{
    nbgl_layoutInternal_t *layoutInt = (nbgl_layoutInternal_t *) layout;
    nbgl_container_t      *container;
    nbgl_contentCenter_t   centeredInfo = {0};
 
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutAddCenteredInfo():\n");
    if (layout == NULL) {
        return -1;
    }
 
    centeredInfo.icon        = info->icon;
    centeredInfo.illustrType = ICON_ILLUSTRATION;
 
    if (info->text1 != NULL) {
        if (info->style != NORMAL_INFO) {
            centeredInfo.title = info->text1;
        }
        else {
            centeredInfo.smallTitle = info->text1;
        }
    }
    if (info->text2 != NULL) {
        if (info->style != LARGE_CASE_BOLD_INFO) {
            centeredInfo.description = info->text2;
        }
        else {
            centeredInfo.smallTitle = info->text2;
        }
    }
    if (info->text3 != NULL) {
        if (info->style == LARGE_CASE_GRAY_INFO) {
            centeredInfo.subText = info->text3;
        }
        else {
            centeredInfo.description = info->text3;
        }
    }
    container = addContentCenter(layoutInt, &centeredInfo);
 
    if (info->onTop) {
        container->obj.alignmentMarginX = BORDER_MARGIN;
        container->obj.alignmentMarginY = BORDER_MARGIN + info->offsetY;
        container->obj.alignment        = NO_ALIGNMENT;
    }
    else {
        container->obj.alignmentMarginY = info->offsetY;
    }
 
    return container->obj.area.height;
}
 
int nbgl_layoutAddContentCenter(nbgl_layout_t *layout, const nbgl_contentCenter_t *info)
{
    nbgl_layoutInternal_t *layoutInt = (nbgl_layoutInternal_t *) layout;
    nbgl_container_t      *container;
 
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutAddContentCenter():\n");
    if (layout == NULL) {
        return -1;
    }
 
    container = addContentCenter(layoutInt, info);
 
    return container->obj.area.height;
}
 
int nbgl_layoutAddLeftContent(nbgl_layout_t *layout, const nbgl_layoutLeftContent_t *info)
{
    nbgl_layoutInternal_t *layoutInt = (nbgl_layoutInternal_t *) layout;
    nbgl_container_t      *container;
    nbgl_text_area_t      *textArea;
    uint8_t                row;
 
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutAddLeftContent():\n");
    if (layout == NULL) {
        return -1;
    }
    container = (nbgl_container_t *) nbgl_objPoolGet(CONTAINER, layoutInt->layer);
 
    // get container children
    container->nbChildren     = info->nbRows + 1;
    container->children       = nbgl_containerPoolGet(container->nbChildren, layoutInt->layer);
    container->layout         = VERTICAL;
    container->obj.area.width = AVAILABLE_WIDTH;
    container->obj.alignmentMarginX = BORDER_MARGIN;
 
    // create title
    textArea                = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
    textArea->textColor     = BLACK;
    textArea->text          = PIC(info->title);
    textArea->textAlignment = MID_LEFT;
    textArea->fontId        = LARGE_MEDIUM_FONT;
    textArea->wrapping      = true;
#ifdef TARGET_STAX
    textArea->obj.alignmentMarginY = 24;
#endif
    textArea->obj.area.width  = AVAILABLE_WIDTH;
    textArea->obj.area.height = nbgl_getTextHeightInWidth(
        textArea->fontId, textArea->text, textArea->obj.area.width, textArea->wrapping);
 
    container->obj.area.height += textArea->obj.area.height + textArea->obj.alignmentMarginY;
 
    container->children[0] = (nbgl_obj_t *) textArea;
 
    for (row = 0; row < info->nbRows; row++) {
        nbgl_container_t *rowContainer;
        nbgl_image_t     *image;
 
        // create a grid with 1 icon on the left column and 1 text on the right one
        rowContainer                 = (nbgl_container_t *) nbgl_objPoolGet(CONTAINER, 0);
        rowContainer->nbChildren     = 2;  // 1 icon +  1 text
        rowContainer->children       = nbgl_containerPoolGet(rowContainer->nbChildren, 0);
        rowContainer->obj.area.width = AVAILABLE_WIDTH;
 
        image                     = (nbgl_image_t *) nbgl_objPoolGet(IMAGE, 0);
        image->foregroundColor    = BLACK;
        image->buffer             = info->rowIcons[row];
        rowContainer->children[0] = (nbgl_obj_t *) image;
 
        textArea                = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, 0);
        textArea->textColor     = BLACK;
        textArea->text          = info->rowTexts[row];
        textArea->textAlignment = MID_LEFT;
        textArea->fontId        = SMALL_REGULAR_FONT;
        textArea->wrapping      = true;
        textArea->obj.area.width
            = AVAILABLE_WIDTH - image->buffer->width - LEFT_CONTENT_ICON_TEXT_X;
        textArea->obj.area.height = nbgl_getTextHeightInWidth(
            textArea->fontId, textArea->text, textArea->obj.area.width, textArea->wrapping);
        textArea->obj.alignment   = MID_RIGHT;
        rowContainer->children[1] = (nbgl_obj_t *) textArea;
        rowContainer->obj.area.height
            = MAX(image->buffer->height, textArea->obj.area.height + LEFT_CONTENT_TEXT_PADDING);
 
        if (row == 0) {
            rowContainer->obj.alignmentMarginY = PRE_FIRST_ROW_MARGIN;
        }
        else {
            rowContainer->obj.alignmentMarginY = INTER_ROWS_MARGIN;
        }
        container->children[1 + row] = (nbgl_obj_t *) rowContainer;
        container->obj.area.height
            += rowContainer->obj.area.height + rowContainer->obj.alignmentMarginY;
    }
    layoutAddObject(layoutInt, (nbgl_obj_t *) container);
 
    return container->obj.area.height;
}
 
#ifdef NBGL_QRCODE
int nbgl_layoutAddQRCode(nbgl_layout_t *layout, const nbgl_layoutQRCode_t *info)
{
    nbgl_layoutInternal_t *layoutInt = (nbgl_layoutInternal_t *) layout;
    nbgl_container_t      *container;
    nbgl_text_area_t      *textArea = NULL;
    nbgl_qrcode_t         *qrcode;
    uint16_t               fullHeight = 0;
 
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutAddQRCode():\n");
    if (layout == NULL) {
        return -1;
    }
 
    container = (nbgl_container_t *) nbgl_objPoolGet(CONTAINER, layoutInt->layer);
 
    // get container children (max 2 (QRCode + text1 + text2))
    container->children   = nbgl_containerPoolGet(3, layoutInt->layer);
    container->nbChildren = 0;
 
    qrcode = (nbgl_qrcode_t *) nbgl_objPoolGet(QR_CODE, layoutInt->layer);
    // version is forced to V10 if url is longer than 62 characters
    if (strlen(PIC(info->url)) > 62) {
        qrcode->version = QRCODE_V10;
    }
    else {
        qrcode->version = QRCODE_V4;
    }
    qrcode->foregroundColor = BLACK;
    // in QR V4, we use:
    // - 8*8 screen pixels for one QR pixel on Stax/Flex
    // - 5*5 screen pixels for one QR pixel on Apex
    // in QR V10, we use 4*4 screen pixels for one QR pixel
#ifndef TARGET_APEX
    qrcode->obj.area.width
        = (qrcode->version == QRCODE_V4) ? (QR_V4_NB_PIX_SIZE * 8) : (QR_V10_NB_PIX_SIZE * 4);
#else   // TARGET_APEX
    qrcode->obj.area.width
        = (qrcode->version == QRCODE_V4) ? (QR_V4_NB_PIX_SIZE * 5) : (QR_V10_NB_PIX_SIZE * 4);
#endif  // TARGET_APEX
    qrcode->obj.area.height = qrcode->obj.area.width;
    qrcode->text            = PIC(info->url);
    qrcode->obj.area.bpp    = NBGL_BPP_1;
    qrcode->obj.alignment   = TOP_MIDDLE;
 
    fullHeight += qrcode->obj.area.height;
    container->children[container->nbChildren] = (nbgl_obj_t *) qrcode;
    container->nbChildren++;
 
    if (info->text1 != NULL) {
        textArea                = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
        textArea->textColor     = BLACK;
        textArea->text          = PIC(info->text1);
        textArea->textAlignment = CENTER;
        textArea->fontId   = (info->largeText1 == true) ? LARGE_MEDIUM_FONT : SMALL_REGULAR_FONT;
        textArea->wrapping = true;
        textArea->obj.area.width  = AVAILABLE_WIDTH;
        textArea->obj.area.height = nbgl_getTextHeightInWidth(
            textArea->fontId, textArea->text, textArea->obj.area.width, textArea->wrapping);
        textArea->obj.alignment = BOTTOM_MIDDLE;
        textArea->obj.alignTo   = (nbgl_obj_t *) container->children[container->nbChildren - 1];
        textArea->obj.alignmentMarginY = QR_PRE_TEXT_MARGIN;
 
        fullHeight += textArea->obj.area.height + textArea->obj.alignmentMarginY;
 
        container->children[container->nbChildren] = (nbgl_obj_t *) textArea;
        container->nbChildren++;
    }
    if (info->text2 != NULL) {
        textArea                = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
        textArea->textColor     = LIGHT_TEXT_COLOR;
        textArea->text          = PIC(info->text2);
        textArea->textAlignment = CENTER;
        textArea->fontId        = SMALL_REGULAR_FONT;
        textArea->wrapping      = true;
        textArea->obj.area.width  = AVAILABLE_WIDTH;
        textArea->obj.area.height = nbgl_getTextHeightInWidth(
            textArea->fontId, textArea->text, textArea->obj.area.width, textArea->wrapping);
        textArea->obj.alignment = BOTTOM_MIDDLE;
        textArea->obj.alignTo   = (nbgl_obj_t *) container->children[container->nbChildren - 1];
        if (info->text1 != NULL) {
            textArea->obj.alignmentMarginY = QR_INTER_TEXTS_MARGIN;
        }
        else {
            textArea->obj.alignmentMarginY = QR_PRE_TEXT_MARGIN + 8;
        }
 
        fullHeight += textArea->obj.area.height + textArea->obj.alignmentMarginY + 8;
 
        container->children[container->nbChildren] = (nbgl_obj_t *) textArea;
        container->nbChildren++;
    }
    // ensure that fullHeight is fitting in main container height (with 16 px margin)
    if ((fullHeight >= (layoutInt->container->obj.area.height - 16))
        && (qrcode->version == QRCODE_V4)) {
        qrcode->version = QRCODE_V4_SMALL;
        // in QR V4 small, we use 4*4 screen pixels for one QR pixel
        qrcode->obj.area.width  = QR_V4_NB_PIX_SIZE * 4;
        qrcode->obj.area.height = qrcode->obj.area.width;
        fullHeight -= QR_V4_NB_PIX_SIZE * 4;
    }
    container->obj.area.height = fullHeight;
    container->layout          = VERTICAL;
    if (info->centered) {
        container->obj.alignment = CENTER;
    }
    else {
        container->obj.alignment = BOTTOM_MIDDLE;
        container->obj.alignTo
            = layoutInt->container->children[layoutInt->container->nbChildren - 1];
    }
    container->obj.alignmentMarginY = info->offsetY;
 
    container->obj.area.width = AVAILABLE_WIDTH;
 
    // set this new container as child of main container
    layoutAddObject(layoutInt, (nbgl_obj_t *) container);
 
    return fullHeight;
}
#endif  // NBGL_QRCODE
 
int nbgl_layoutAddChoiceButtons(nbgl_layout_t *layout, const nbgl_layoutChoiceButtons_t *info)
{
    nbgl_layoutFooter_t footerDesc;
    footerDesc.type                     = FOOTER_CHOICE_BUTTONS;
    footerDesc.separationLine           = false;
    footerDesc.choiceButtons.bottomText = info->bottomText;
    footerDesc.choiceButtons.token      = info->token;
    footerDesc.choiceButtons.topText    = info->topText;
    footerDesc.choiceButtons.topIcon    = info->topIcon;
    footerDesc.choiceButtons.style      = info->style;
    footerDesc.choiceButtons.tuneId     = info->tuneId;
    return nbgl_layoutAddExtendedFooter(layout, &footerDesc);
}
 
int nbgl_layoutAddHorizontalButtons(nbgl_layout_t                        *layout,
                                    const nbgl_layoutHorizontalButtons_t *info)
{
    nbgl_layoutUpFooter_t upFooterDesc = {.type = UP_FOOTER_HORIZONTAL_BUTTONS,
                                          .horizontalButtons.leftIcon   = info->leftIcon,
                                          .horizontalButtons.leftToken  = info->leftToken,
                                          .horizontalButtons.rightText  = info->rightText,
                                          .horizontalButtons.rightToken = info->rightToken,
                                          .horizontalButtons.tuneId     = info->tuneId};
 
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutAddHorizontalButtons():\n");
    return nbgl_layoutAddUpFooter(layout, &upFooterDesc);
}
 
int nbgl_layoutAddTagValueList(nbgl_layout_t *layout, const nbgl_layoutTagValueList_t *list)
{
    nbgl_layoutInternal_t *layoutInt = (nbgl_layoutInternal_t *) layout;
    nbgl_text_area_t      *itemTextArea;
    nbgl_text_area_t      *valueTextArea;
    nbgl_container_t      *container;
    uint8_t                i;
 
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutAddTagValueList():\n");
    if (layout == NULL) {
        return -1;
    }
 
    for (i = 0; i < list->nbPairs; i++) {
        const nbgl_layoutTagValue_t *pair;
        uint16_t                     fullHeight = 0;
        const nbgl_icon_details_t   *valueIcon  = NULL;
 
        if (list->pairs != NULL) {
            pair = &list->pairs[i];
        }
        else {
            pair = list->callback(list->startIndex + i);
        }
 
        container = (nbgl_container_t *) nbgl_objPoolGet(CONTAINER, layoutInt->layer);
 
        // get container children (max 3 if a valueIcon, otherwise 2)
        container->children
            = nbgl_containerPoolGet((pair->valueIcon != NULL) ? 3 : 2, layoutInt->layer);
 
        itemTextArea  = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
        valueTextArea = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
 
        // init text area for this choice
        itemTextArea->textColor       = LIGHT_TEXT_COLOR;
        itemTextArea->text            = PIC(pair->item);
        itemTextArea->textAlignment   = MID_LEFT;
        itemTextArea->fontId          = SMALL_REGULAR_FONT;
        itemTextArea->wrapping        = true;
        itemTextArea->obj.area.width  = AVAILABLE_WIDTH;
        itemTextArea->obj.area.height = nbgl_getTextHeightInWidth(
            itemTextArea->fontId, itemTextArea->text, AVAILABLE_WIDTH, itemTextArea->wrapping);
        itemTextArea->style                        = NO_STYLE;
        itemTextArea->obj.alignment                = NO_ALIGNMENT;
        itemTextArea->obj.alignmentMarginX         = 0;
        itemTextArea->obj.alignmentMarginY         = 0;
        itemTextArea->obj.alignTo                  = NULL;
        container->children[container->nbChildren] = (nbgl_obj_t *) itemTextArea;
        container->nbChildren++;
 
        fullHeight += itemTextArea->obj.area.height;
 
        // init button for this choice
        valueTextArea->textColor     = BLACK;
        valueTextArea->text          = PIC(pair->value);
        valueTextArea->textAlignment = MID_LEFT;
        if (list->smallCaseForValue) {
            valueTextArea->fontId = SMALL_BOLD_FONT;
        }
        else {
            valueTextArea->fontId = LARGE_MEDIUM_FONT;
        }
        if ((pair->aliasValue == 0) && (pair->valueIcon == NULL)) {
            valueTextArea->obj.area.width = AVAILABLE_WIDTH;
        }
        else {
            if (pair->aliasValue) {
                // if the value is an alias, we automatically display a (>) icon
                valueIcon = &MINI_PUSH_ICON;
            }
            else {
                // otherwise use the provided icon
                valueIcon = PIC(pair->valueIcon);
            }
            // decrease the available width for value text
            valueTextArea->obj.area.width = AVAILABLE_WIDTH - valueIcon->width - 12;
        }
 
        // handle the nbMaxLinesForValue parameter, used to automatically keep only
        // nbMaxLinesForValue lines
        uint16_t nbLines = nbgl_getTextNbLinesInWidth(valueTextArea->fontId,
                                                      valueTextArea->text,
                                                      valueTextArea->obj.area.width,
                                                      list->wrapping);
        // use this nbMaxLinesForValue parameter only if >0
        if ((list->nbMaxLinesForValue > 0) && (nbLines > list->nbMaxLinesForValue)) {
            nbLines                   = list->nbMaxLinesForValue;
            valueTextArea->nbMaxLines = list->nbMaxLinesForValue;
        }
        const nbgl_font_t *font                    = nbgl_getFont(valueTextArea->fontId);
        valueTextArea->obj.area.height             = nbLines * font->line_height;
        valueTextArea->style                       = NO_STYLE;
        valueTextArea->obj.alignment               = BOTTOM_LEFT;
        valueTextArea->obj.alignmentMarginY        = 4;
        valueTextArea->obj.alignTo                 = (nbgl_obj_t *) itemTextArea;
        valueTextArea->wrapping                    = list->wrapping;
        container->children[container->nbChildren] = (nbgl_obj_t *) valueTextArea;
        container->nbChildren++;
 
        fullHeight += valueTextArea->obj.area.height + valueTextArea->obj.alignmentMarginY;
        if (valueIcon != NULL) {
            nbgl_image_t *image = (nbgl_image_t *) nbgl_objPoolGet(IMAGE, layoutInt->layer);
            // set the container as touchable, not only the image
            layoutObj_t *obj = layoutAddCallbackObj(
                layoutInt, (nbgl_obj_t *) container, list->token, TUNE_TAP_CASUAL);
            obj->index                  = i;
            image->foregroundColor      = BLACK;
            image->buffer               = valueIcon;
            image->obj.alignment        = RIGHT_TOP;
            image->obj.alignmentMarginX = 12;
            image->obj.alignTo          = (nbgl_obj_t *) valueTextArea;
            // set the container as touchable, not only the image
            container->obj.touchMask = (1 << TOUCHED);
            container->obj.touchId   = VALUE_BUTTON_1_ID + i;
 
            container->children[container->nbChildren] = (nbgl_obj_t *) image;
            container->nbChildren++;
        }
 
        container->obj.area.width       = AVAILABLE_WIDTH;
        container->obj.area.height      = fullHeight;
        container->layout               = VERTICAL;
        container->obj.alignmentMarginX = BORDER_MARGIN;
        if (i > 0) {
            container->obj.alignmentMarginY = INTER_TAG_VALUE_MARGIN;
        }
        else {
            container->obj.alignmentMarginY = PRE_TAG_VALUE_MARGIN;
        }
        container->obj.alignment = NO_ALIGNMENT;
 
        layoutAddObject(layoutInt, (nbgl_obj_t *) container);
    }
 
    return 0;
}
 
int nbgl_layoutAddProgressBar(nbgl_layout_t *layout,
                              const char    *text,
                              const char    *subText,
                              uint8_t        percentage)
{
    nbgl_layoutInternal_t *layoutInt = (nbgl_layoutInternal_t *) layout;
    nbgl_container_t      *container;
    nbgl_text_area_t      *textArea;
    nbgl_progress_bar_t   *progress;
 
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutAddProgressBar():\n");
    if (layout == NULL) {
        return -1;
    }
 
    // First Create Container :
    container = (nbgl_container_t *) nbgl_objPoolGet(CONTAINER, layoutInt->layer);
    // progressbar + text + subText
    container->nbChildren = (subText != NULL) ? 3 : 2;
    container->children   = nbgl_containerPoolGet(container->nbChildren, layoutInt->layer);
 
    container->obj.area.width = AVAILABLE_WIDTH;
    container->layout         = VERTICAL;
    container->obj.alignment  = CENTER;
 
    // Create progressbar
    progress = (nbgl_progress_bar_t *) nbgl_objPoolGet(PROGRESS_BAR, layoutInt->layer);
    progress->foregroundColor = BLACK;
    progress->withBorder      = true;
    progress->state           = percentage;
    progress->obj.area.width  = PROGRESSBAR_WIDTH;
    progress->obj.area.height = PROGRESSBAR_HEIGHT;
    progress->obj.alignment   = TOP_MIDDLE;
 
    // set this new progressbar as child of the container
    container->children[0] = (nbgl_obj_t *) progress;
 
    // update container height
    container->obj.area.height = progress->obj.alignmentMarginY + progress->obj.area.height;
 
    // create text area
    textArea                = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
    textArea->textColor     = BLACK;
    textArea->text          = PIC(text);
    textArea->textAlignment = CENTER;
    textArea->fontId        = LARGE_MEDIUM_FONT;
    textArea->wrapping      = true;
    textArea->obj.alignmentMarginY = BAR_TEXT_MARGIN;
    textArea->obj.alignTo          = (nbgl_obj_t *) progress;
    textArea->obj.alignment        = BOTTOM_MIDDLE;
    textArea->obj.area.width       = AVAILABLE_WIDTH;
    textArea->obj.area.height      = nbgl_getTextHeightInWidth(
        textArea->fontId, textArea->text, textArea->obj.area.width, textArea->wrapping);
    textArea->style = NO_STYLE;
 
    // update container height
    container->obj.area.height += textArea->obj.alignmentMarginY + textArea->obj.area.height;
 
    // set this text as child of the container
    container->children[1] = (nbgl_obj_t *) textArea;
 
    if (subText != NULL) {
        nbgl_text_area_t *subTextArea;
        // create sub-text area
        subTextArea            = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
        subTextArea->textColor = BLACK;
        subTextArea->text      = PIC(subText);
        subTextArea->textAlignment        = CENTER;
        subTextArea->fontId               = SMALL_REGULAR_FONT;
        subTextArea->wrapping             = true;
        subTextArea->obj.alignmentMarginY = BAR_INTER_TEXTS_MARGIN;
        subTextArea->obj.alignTo          = (nbgl_obj_t *) textArea;
        subTextArea->obj.alignment        = BOTTOM_MIDDLE;
        subTextArea->obj.area.width       = AVAILABLE_WIDTH;
        subTextArea->obj.area.height      = nbgl_getTextHeightInWidth(subTextArea->fontId,
                                                                 subTextArea->text,
                                                                 subTextArea->obj.area.width,
                                                                 subTextArea->wrapping);
        subTextArea->style                = NO_STYLE;
 
        // update container height
        container->obj.area.height
            += subTextArea->obj.alignmentMarginY + subTextArea->obj.area.height;
 
        // set thissub-text as child of the container
        container->children[2] = (nbgl_obj_t *) subTextArea;
    }
    // The height of containers must be a multiple of eight
    container->obj.area.height = (container->obj.area.height + 7) & 0xFFF8;
 
    layoutAddObject(layoutInt, (nbgl_obj_t *) container);
 
    return 2;
}
 
int nbgl_layoutAddSeparationLine(nbgl_layout_t *layout)
{
    nbgl_layoutInternal_t *layoutInt = (nbgl_layoutInternal_t *) layout;
    nbgl_line_t           *line;
 
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutAddSeparationLine():\n");
    line                       = createHorizontalLine(layoutInt->layer);
    line->obj.alignmentMarginY = -1;
    layoutAddObject(layoutInt, (nbgl_obj_t *) line);
    return 0;
}
 
int nbgl_layoutAddButton(nbgl_layout_t *layout, const nbgl_layoutButton_t *buttonInfo)
{
    layoutObj_t           *obj;
    nbgl_button_t         *button;
    nbgl_layoutInternal_t *layoutInt = (nbgl_layoutInternal_t *) layout;
 
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutAddButton():\n");
    if (layout == NULL) {
        return -1;
    }
 
    // Add in footer if matching
    if ((buttonInfo->onBottom) && (!buttonInfo->fittingContent)) {
        if (layoutInt->footerContainer == NULL) {
            nbgl_layoutFooter_t footerDesc;
            footerDesc.type           = FOOTER_SIMPLE_BUTTON;
            footerDesc.separationLine = false;
            footerDesc.button.text    = buttonInfo->text;
            footerDesc.button.token   = buttonInfo->token;
            footerDesc.button.tuneId  = buttonInfo->tuneId;
            footerDesc.button.icon    = buttonInfo->icon;
            footerDesc.button.style   = buttonInfo->style;
            return nbgl_layoutAddExtendedFooter(layout, &footerDesc);
        }
        else {
            nbgl_layoutUpFooter_t upFooterDesc;
            upFooterDesc.type          = UP_FOOTER_BUTTON;
            upFooterDesc.button.text   = buttonInfo->text;
            upFooterDesc.button.token  = buttonInfo->token;
            upFooterDesc.button.tuneId = buttonInfo->tuneId;
            upFooterDesc.button.icon   = buttonInfo->icon;
            upFooterDesc.button.style  = buttonInfo->style;
            return nbgl_layoutAddUpFooter(layout, &upFooterDesc);
        }
    }
 
    button = (nbgl_button_t *) nbgl_objPoolGet(BUTTON, layoutInt->layer);
    obj    = layoutAddCallbackObj(
        layoutInt, (nbgl_obj_t *) button, buttonInfo->token, buttonInfo->tuneId);
    if (obj == NULL) {
        return -1;
    }
 
    button->obj.alignmentMarginX = BORDER_MARGIN;
    button->obj.alignmentMarginY = 12;
    button->obj.alignment        = NO_ALIGNMENT;
    if (buttonInfo->style == BLACK_BACKGROUND) {
        button->innerColor      = BLACK;
        button->foregroundColor = WHITE;
    }
    else {
        button->innerColor      = WHITE;
        button->foregroundColor = BLACK;
    }
    if (buttonInfo->style == NO_BORDER) {
        button->borderColor = WHITE;
    }
    else {
        if (buttonInfo->style == BLACK_BACKGROUND) {
            button->borderColor = BLACK;
        }
        else {
            button->borderColor = LIGHT_GRAY;
        }
    }
    button->text   = PIC(buttonInfo->text);
    button->fontId = SMALL_BOLD_FONT;
    button->icon   = PIC(buttonInfo->icon);
    if (buttonInfo->fittingContent == true) {
        button->obj.area.width = nbgl_getTextWidth(button->fontId, button->text)
                                 + SMALL_BUTTON_HEIGHT
                                 + ((button->icon) ? (button->icon->width + 12) : 0);
        button->obj.area.height = SMALL_BUTTON_HEIGHT;
        button->radius          = SMALL_BUTTON_RADIUS_INDEX;
        if (buttonInfo->onBottom != true) {
            button->obj.alignmentMarginX += (AVAILABLE_WIDTH - button->obj.area.width) / 2;
        }
    }
    else {
        button->obj.area.width  = AVAILABLE_WIDTH;
        button->obj.area.height = BUTTON_DIAMETER;
        button->radius          = BUTTON_RADIUS;
    }
    button->obj.alignTo   = NULL;
    button->obj.touchMask = (1 << TOUCHED);
    button->obj.touchId   = (buttonInfo->fittingContent) ? EXTRA_BUTTON_ID : SINGLE_BUTTON_ID;
    // set this new button as child of the container
    layoutAddObject(layoutInt, (nbgl_obj_t *) button);
 
    return 0;
}
 
int nbgl_layoutAddLongPressButton(nbgl_layout_t *layout,
                                  const char    *text,
                                  uint8_t        token,
                                  tune_index_e   tuneId)
{
    nbgl_layoutUpFooter_t upFooterDesc = {.type             = UP_FOOTER_LONG_PRESS,
                                          .longPress.text   = text,
                                          .longPress.token  = token,
                                          .longPress.tuneId = tuneId};
 
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutAddLongPressButton():\n");
    if (layout == NULL) {
        return -1;
    }
 
    return nbgl_layoutAddUpFooter(layout, &upFooterDesc);
}
 
int nbgl_layoutAddFooter(nbgl_layout_t *layout,
                         const char    *text,
                         uint8_t        token,
                         tune_index_e   tuneId)
{
    nbgl_layoutFooter_t footerDesc;
    footerDesc.type                = FOOTER_SIMPLE_TEXT;
    footerDesc.separationLine      = true;
    footerDesc.simpleText.text     = text;
    footerDesc.simpleText.mutedOut = false;
    footerDesc.simpleText.token    = token;
    footerDesc.simpleText.tuneId   = tuneId;
    return nbgl_layoutAddExtendedFooter(layout, &footerDesc);
}
 
int nbgl_layoutAddSplitFooter(nbgl_layout_t *layout,
                              const char    *leftText,
                              uint8_t        leftToken,
                              const char    *rightText,
                              uint8_t        rightToken,
                              tune_index_e   tuneId)
{
    nbgl_layoutFooter_t footerDesc;
    footerDesc.type                  = FOOTER_DOUBLE_TEXT;
    footerDesc.separationLine        = true;
    footerDesc.doubleText.leftText   = leftText;
    footerDesc.doubleText.leftToken  = leftToken;
    footerDesc.doubleText.rightText  = rightText;
    footerDesc.doubleText.rightToken = rightToken;
    footerDesc.doubleText.tuneId     = tuneId;
    return nbgl_layoutAddExtendedFooter(layout, &footerDesc);
}
 
int nbgl_layoutAddHeader(nbgl_layout_t *layout, const nbgl_layoutHeader_t *headerDesc)
{
    nbgl_layoutInternal_t *layoutInt = (nbgl_layoutInternal_t *) layout;
    layoutObj_t           *obj;
    nbgl_text_area_t      *textArea = NULL;
    nbgl_line_t           *line     = NULL;
    nbgl_image_t          *image    = NULL;
    nbgl_button_t         *button   = NULL;
 
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutAddHeader(): type = %d\n", headerDesc->type);
    if (layout == NULL) {
        return -1;
    }
    if ((headerDesc == NULL) || (headerDesc->type >= NB_HEADER_TYPES)) {
        return -2;
    }
 
    layoutInt->headerContainer = (nbgl_container_t *) nbgl_objPoolGet(CONTAINER, layoutInt->layer);
    layoutInt->headerContainer->obj.area.width = SCREEN_WIDTH;
    layoutInt->headerContainer->layout         = VERTICAL;
    layoutInt->headerContainer->children
        = (nbgl_obj_t **) nbgl_containerPoolGet(5, layoutInt->layer);
    layoutInt->headerContainer->obj.alignment = TOP_MIDDLE;
 
    switch (headerDesc->type) {
        case HEADER_EMPTY: {
            layoutInt->headerContainer->obj.area.height = headerDesc->emptySpace.height;
            break;
        }
        case HEADER_BACK_AND_TEXT:
        case HEADER_BACK_ICON_AND_TEXT:
        case HEADER_EXTENDED_BACK: {
            const char    *text         = (headerDesc->type == HEADER_EXTENDED_BACK)
                                              ? PIC(headerDesc->extendedBack.text)
                                              : PIC(headerDesc->backAndText.text);
            uint8_t        backToken    = (headerDesc->type == HEADER_EXTENDED_BACK)
                                              ? headerDesc->extendedBack.backToken
                                              : headerDesc->backAndText.token;
            nbgl_button_t *actionButton = NULL;
            // add back button
            button = (nbgl_button_t *) nbgl_objPoolGet(BUTTON, layoutInt->layer);
            // only make it active if valid token
            if (backToken != NBGL_INVALID_TOKEN) {
                obj = layoutAddCallbackObj(layoutInt,
                                           (nbgl_obj_t *) button,
                                           backToken,
                                           (headerDesc->type == HEADER_EXTENDED_BACK)
                                               ? headerDesc->extendedBack.tuneId
                                               : headerDesc->backAndText.tuneId);
                if (obj == NULL) {
                    return -1;
                }
            }
 
            button->obj.alignment   = MID_LEFT;
            button->innerColor      = WHITE;
            button->foregroundColor = (backToken != NBGL_INVALID_TOKEN) ? BLACK : WHITE;
            button->borderColor     = WHITE;
            button->obj.area.width  = BACK_KEY_WIDTH;
            button->obj.area.height = TOUCHABLE_HEADER_BAR_HEIGHT;
            button->text            = NULL;
            button->icon            = PIC(&LEFT_ARROW_ICON);
            button->obj.touchMask   = (backToken != NBGL_INVALID_TOKEN) ? (1 << TOUCHED) : 0;
            button->obj.touchId     = BACK_BUTTON_ID;
            layoutInt->headerContainer->children[layoutInt->headerContainer->nbChildren]
                = (nbgl_obj_t *) button;
            layoutInt->headerContainer->nbChildren++;
 
            // add optional text if needed
            if (text != NULL) {
                // add optional icon if type is HEADER_BACK_ICON_AND_TEXT
                if (headerDesc->type == HEADER_BACK_ICON_AND_TEXT) {
                    image         = (nbgl_image_t *) nbgl_objPoolGet(IMAGE, layoutInt->layer);
                    image->buffer = PIC(headerDesc->backAndText.icon);
                    image->foregroundColor = BLACK;
                    image->obj.alignment   = CENTER;
                    layoutInt->headerContainer->children[layoutInt->headerContainer->nbChildren]
                        = (nbgl_obj_t *) image;
                    layoutInt->headerContainer->nbChildren++;
                }
                textArea = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
                if ((headerDesc->type == HEADER_EXTENDED_BACK)
                    && (headerDesc->extendedBack.textToken != NBGL_INVALID_TOKEN)) {
                    obj = layoutAddCallbackObj(layoutInt,
                                               (nbgl_obj_t *) textArea,
                                               headerDesc->extendedBack.textToken,
                                               headerDesc->extendedBack.tuneId);
                    if (obj == NULL) {
                        return -1;
                    }
                    textArea->obj.touchMask = (1 << TOUCHED);
                }
                textArea->obj.alignment = CENTER;
                textArea->textColor     = BLACK;
                textArea->obj.area.width
                    = layoutInt->headerContainer->obj.area.width - 2 * BACK_KEY_WIDTH;
                // if icon, reduce to 1 line and fit text width
                if (headerDesc->type == HEADER_BACK_ICON_AND_TEXT) {
                    textArea->obj.area.width -= 16 + image->buffer->width;
                }
                textArea->obj.area.height = TOUCHABLE_HEADER_BAR_HEIGHT;
                textArea->text            = text;
                textArea->fontId          = SMALL_BOLD_FONT;
                textArea->textAlignment   = CENTER;
                textArea->wrapping        = true;
                uint8_t nbMaxLines        = (headerDesc->type == HEADER_BACK_ICON_AND_TEXT) ? 1 : 2;
                // ensure that text fits on 2 lines maximum
                if (nbgl_getTextNbLinesInWidth(textArea->fontId,
                                               textArea->text,
                                               textArea->obj.area.width,
                                               textArea->wrapping)
                    > nbMaxLines) {
                    LOG_WARN(LAYOUT_LOGGER,
                             "nbgl_layoutAddHeader: text [%s] is too long for header\n",
                             text);
                }
                if (headerDesc->type == HEADER_BACK_ICON_AND_TEXT) {
                    textArea->obj.area.width = nbgl_getTextWidth(textArea->fontId, textArea->text);
                }
                layoutInt->headerContainer->children[layoutInt->headerContainer->nbChildren]
                    = (nbgl_obj_t *) textArea;
                layoutInt->headerContainer->nbChildren++;
                // if icon, realign icon & text
                if (headerDesc->type == HEADER_BACK_ICON_AND_TEXT) {
                    textArea->obj.alignmentMarginX = 8 + image->buffer->width / 2;
                    image->obj.alignmentMarginX    = -8 - textArea->obj.area.width / 2;
                }
            }
            // add action key if the type is HEADER_EXTENDED_BACK
            if ((headerDesc->type == HEADER_EXTENDED_BACK)
                && (headerDesc->extendedBack.actionIcon)) {
                actionButton = (nbgl_button_t *) nbgl_objPoolGet(BUTTON, layoutInt->layer);
                // if token is valid
                if (headerDesc->extendedBack.actionToken != NBGL_INVALID_TOKEN) {
                    obj = layoutAddCallbackObj(layoutInt,
                                               (nbgl_obj_t *) actionButton,
                                               headerDesc->extendedBack.actionToken,
                                               headerDesc->extendedBack.tuneId);
                    if (obj == NULL) {
                        return -1;
                    }
                    actionButton->obj.touchMask = (1 << TOUCHED);
                }
 
                actionButton->obj.alignment = MID_RIGHT;
                actionButton->innerColor    = WHITE;
                button->foregroundColor
                    = (headerDesc->extendedBack.actionToken != NBGL_INVALID_TOKEN) ? BLACK
                                                                                   : LIGHT_GRAY;
                actionButton->borderColor     = WHITE;
                actionButton->obj.area.width  = BACK_KEY_WIDTH;
                actionButton->obj.area.height = TOUCHABLE_HEADER_BAR_HEIGHT;
                actionButton->text            = NULL;
                actionButton->icon            = PIC(headerDesc->extendedBack.actionIcon);
                actionButton->obj.touchId     = EXTRA_BUTTON_ID;
                layoutInt->headerContainer->children[layoutInt->headerContainer->nbChildren]
                    = (nbgl_obj_t *) actionButton;
                layoutInt->headerContainer->nbChildren++;
            }
 
            layoutInt->headerContainer->obj.area.height = TOUCHABLE_HEADER_BAR_HEIGHT;
            // add potential text under the line if the type is HEADER_EXTENDED_BACK
            if ((headerDesc->type == HEADER_EXTENDED_BACK)
                && (headerDesc->extendedBack.subText != NULL)) {
                nbgl_text_area_t *subTextArea;
 
                line                       = createHorizontalLine(layoutInt->layer);
                line->obj.alignment        = TOP_MIDDLE;
                line->obj.alignmentMarginY = TOUCHABLE_HEADER_BAR_HEIGHT;
                layoutInt->headerContainer->children[layoutInt->headerContainer->nbChildren]
                    = (nbgl_obj_t *) line;
                layoutInt->headerContainer->nbChildren++;
 
                subTextArea = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
                subTextArea->textColor            = BLACK;
                subTextArea->text                 = PIC(headerDesc->extendedBack.subText);
                subTextArea->textAlignment        = MID_LEFT;
                subTextArea->fontId               = SMALL_REGULAR_FONT;
                subTextArea->wrapping             = true;
                subTextArea->obj.alignment        = BOTTOM_MIDDLE;
                subTextArea->obj.alignmentMarginY = SUB_HEADER_MARGIN;
                subTextArea->obj.area.width       = AVAILABLE_WIDTH;
                subTextArea->obj.area.height
                    = nbgl_getTextHeightInWidth(subTextArea->fontId,
                                                subTextArea->text,
                                                subTextArea->obj.area.width,
                                                subTextArea->wrapping);
                layoutInt->headerContainer->children[layoutInt->headerContainer->nbChildren]
                    = (nbgl_obj_t *) subTextArea;
                layoutInt->headerContainer->nbChildren++;
                layoutInt->headerContainer->obj.area.height
                    += subTextArea->obj.area.height + 2 * SUB_HEADER_MARGIN;
                if (button != NULL) {
                    button->obj.alignmentMarginY
                        -= (subTextArea->obj.area.height + 2 * SUB_HEADER_MARGIN) / 2;
                }
                if (textArea != NULL) {
                    textArea->obj.alignmentMarginY
                        -= (subTextArea->obj.area.height + 2 * SUB_HEADER_MARGIN) / 2;
                }
                if (actionButton != NULL) {
                    actionButton->obj.alignmentMarginY
                        -= (subTextArea->obj.area.height + 2 * SUB_HEADER_MARGIN) / 2;
                }
            }
            break;
        }
        case HEADER_BACK_AND_PROGRESS: {
#ifdef TARGET_STAX
            // add optional back button
            if (headerDesc->progressAndBack.withBack) {
                button = (nbgl_button_t *) nbgl_objPoolGet(BUTTON, layoutInt->layer);
                obj    = layoutAddCallbackObj(layoutInt,
                                           (nbgl_obj_t *) button,
                                           headerDesc->progressAndBack.token,
                                           headerDesc->progressAndBack.tuneId);
                if (obj == NULL) {
                    return -1;
                }
 
                button->obj.alignment   = MID_LEFT;
                button->innerColor      = WHITE;
                button->foregroundColor = BLACK;
                button->borderColor     = WHITE;
                button->obj.area.width  = BACK_KEY_WIDTH;
                button->obj.area.height = TOUCHABLE_HEADER_BAR_HEIGHT;
                button->text            = NULL;
                button->icon            = PIC(&LEFT_ARROW_ICON);
                button->obj.touchMask   = (1 << TOUCHED);
                button->obj.touchId     = BACK_BUTTON_ID;
                // add to container
                layoutInt->headerContainer->children[layoutInt->headerContainer->nbChildren]
                    = (nbgl_obj_t *) button;
                layoutInt->headerContainer->nbChildren++;
            }
 
            // add progress indicator
            if (headerDesc->progressAndBack.nbPages > 1
                && headerDesc->progressAndBack.nbPages != NBGL_NO_PROGRESS_INDICATOR) {
                nbgl_page_indicator_t *progress;
 
                progress
                    = (nbgl_page_indicator_t *) nbgl_objPoolGet(PAGE_INDICATOR, layoutInt->layer);
                progress->activePage     = headerDesc->progressAndBack.activePage;
                progress->nbPages        = headerDesc->progressAndBack.nbPages;
                progress->obj.area.width = 224;
                progress->obj.alignment  = CENTER;
                // add to container
                layoutInt->headerContainer->children[layoutInt->headerContainer->nbChildren]
                    = (nbgl_obj_t *) progress;
                layoutInt->headerContainer->nbChildren++;
            }
            layoutInt->activePage                       = headerDesc->progressAndBack.activePage;
            layoutInt->nbPages                          = headerDesc->progressAndBack.nbPages;
            layoutInt->headerContainer->obj.area.height = TOUCHABLE_HEADER_BAR_HEIGHT;
#endif  // TARGET_STAX
            break;
        }
        case HEADER_TITLE: {
            textArea            = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
            textArea->textColor = BLACK;
            textArea->obj.area.width  = AVAILABLE_WIDTH;
            textArea->obj.area.height = TOUCHABLE_HEADER_BAR_HEIGHT;
            textArea->text            = PIC(headerDesc->title.text);
            textArea->fontId          = SMALL_BOLD_FONT;
            textArea->textAlignment   = CENTER;
            textArea->wrapping        = true;
            layoutInt->headerContainer->children[layoutInt->headerContainer->nbChildren]
                = (nbgl_obj_t *) textArea;
            layoutInt->headerContainer->nbChildren++;
            layoutInt->headerContainer->obj.area.height = textArea->obj.area.height;
            break;
        }
        case HEADER_RIGHT_TEXT: {
            textArea = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
            obj      = layoutAddCallbackObj(layoutInt,
                                       (nbgl_obj_t *) textArea,
                                       headerDesc->rightText.token,
                                       headerDesc->rightText.tuneId);
            if (obj == NULL) {
                return -1;
            }
            textArea->obj.alignment        = MID_RIGHT;
            textArea->obj.alignmentMarginX = BORDER_MARGIN;
            textArea->textColor            = BLACK;
            textArea->obj.area.width       = AVAILABLE_WIDTH;
            textArea->obj.area.height      = TOUCHABLE_HEADER_BAR_HEIGHT;
            textArea->text                 = PIC(headerDesc->rightText.text);
            textArea->fontId               = SMALL_BOLD_FONT;
            textArea->textAlignment        = MID_RIGHT;
            textArea->obj.touchMask        = (1 << TOUCHED);
            textArea->obj.touchId          = TOP_RIGHT_BUTTON_ID;
            // add to bottom container
            layoutInt->headerContainer->children[layoutInt->headerContainer->nbChildren]
                = (nbgl_obj_t *) textArea;
            layoutInt->headerContainer->nbChildren++;
            layoutInt->headerContainer->obj.area.height = textArea->obj.area.height;
            break;
        }
        default:
            return -2;
    }
    // draw separation line at bottom of container
    if (headerDesc->separationLine) {
        line                = createHorizontalLine(layoutInt->layer);
        line->obj.alignment = BOTTOM_MIDDLE;
        layoutInt->headerContainer->children[layoutInt->headerContainer->nbChildren]
            = (nbgl_obj_t *) line;
        layoutInt->headerContainer->nbChildren++;
    }
    // header must be the first child
    layoutInt->children[HEADER_INDEX] = (nbgl_obj_t *) layoutInt->headerContainer;
 
    // subtract header height from main container height
    layoutInt->container->obj.area.height -= layoutInt->headerContainer->obj.area.height;
    layoutInt->container->obj.alignTo   = (nbgl_obj_t *) layoutInt->headerContainer;
    layoutInt->container->obj.alignment = BOTTOM_LEFT;
 
    layoutInt->headerType = headerDesc->type;
 
    return layoutInt->headerContainer->obj.area.height;
}
 
int nbgl_layoutAddExtendedFooter(nbgl_layout_t *layout, const nbgl_layoutFooter_t *footerDesc)
{
    nbgl_layoutInternal_t *layoutInt = (nbgl_layoutInternal_t *) layout;
    layoutObj_t           *obj;
    nbgl_text_area_t      *textArea;
    nbgl_line_t           *line, *separationLine = NULL;
    nbgl_button_t         *button;
 
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutAddExtendedFooter():\n");
    if (layout == NULL) {
        return -1;
    }
    if ((footerDesc == NULL) || (footerDesc->type >= NB_FOOTER_TYPES)) {
        return -2;
    }
 
    layoutInt->footerContainer = (nbgl_container_t *) nbgl_objPoolGet(CONTAINER, layoutInt->layer);
    layoutInt->footerContainer->obj.area.width = SCREEN_WIDTH;
    layoutInt->footerContainer->layout         = VERTICAL;
    layoutInt->footerContainer->children
        = (nbgl_obj_t **) nbgl_containerPoolGet(5, layoutInt->layer);
    layoutInt->footerContainer->obj.alignment = BOTTOM_MIDDLE;
 
    switch (footerDesc->type) {
        case FOOTER_EMPTY: {
            layoutInt->footerContainer->obj.area.height = footerDesc->emptySpace.height;
            break;
        }
        case FOOTER_SIMPLE_TEXT: {
            textArea = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
            obj      = layoutAddCallbackObj(layoutInt,
                                       (nbgl_obj_t *) textArea,
                                       footerDesc->simpleText.token,
                                       footerDesc->simpleText.tuneId);
            if (obj == NULL) {
                return -1;
            }
 
            textArea->obj.alignment  = BOTTOM_MIDDLE;
            textArea->textColor      = (footerDesc->simpleText.mutedOut) ? LIGHT_TEXT_COLOR : BLACK;
            textArea->obj.area.width = AVAILABLE_WIDTH;
            textArea->obj.area.height
                = (footerDesc->simpleText.mutedOut) ? SMALL_FOOTER_HEIGHT : SIMPLE_FOOTER_HEIGHT;
            textArea->text = PIC(footerDesc->simpleText.text);
            textArea->fontId
                = (footerDesc->simpleText.mutedOut) ? SMALL_REGULAR_FONT : SMALL_BOLD_FONT;
            textArea->textAlignment = CENTER;
            textArea->obj.touchMask = (1 << TOUCHED);
            textArea->obj.touchId   = BOTTOM_BUTTON_ID;
            layoutInt->footerContainer->children[layoutInt->footerContainer->nbChildren]
                = (nbgl_obj_t *) textArea;
            layoutInt->footerContainer->nbChildren++;
            layoutInt->footerContainer->obj.area.height = textArea->obj.area.height;
            break;
        }
        case FOOTER_DOUBLE_TEXT: {
            textArea = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
            obj      = layoutAddCallbackObj(layoutInt,
                                       (nbgl_obj_t *) textArea,
                                       footerDesc->doubleText.leftToken,
                                       footerDesc->doubleText.tuneId);
            if (obj == NULL) {
                return -1;
            }
            textArea->obj.alignment   = BOTTOM_LEFT;
            textArea->textColor       = BLACK;
            textArea->obj.area.width  = AVAILABLE_WIDTH / 2;
            textArea->obj.area.height = SIMPLE_FOOTER_HEIGHT;
            textArea->text            = PIC(footerDesc->doubleText.leftText);
            textArea->fontId          = SMALL_BOLD_FONT;
            textArea->textAlignment   = CENTER;
            textArea->obj.touchMask   = (1 << TOUCHED);
            textArea->obj.touchId     = BOTTOM_BUTTON_ID;
            // add to bottom container
            layoutInt->footerContainer->children[layoutInt->footerContainer->nbChildren]
                = (nbgl_obj_t *) textArea;
            layoutInt->footerContainer->nbChildren++;
 
            // create right touchable text
            textArea = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
            obj      = layoutAddCallbackObj(layoutInt,
                                       (nbgl_obj_t *) textArea,
                                       footerDesc->doubleText.rightToken,
                                       footerDesc->doubleText.tuneId);
            if (obj == NULL) {
                return -1;
            }
 
            textArea->obj.alignment   = BOTTOM_RIGHT;
            textArea->textColor       = BLACK;
            textArea->obj.area.width  = AVAILABLE_WIDTH / 2;
            textArea->obj.area.height = SIMPLE_FOOTER_HEIGHT;
            textArea->text            = PIC(footerDesc->doubleText.rightText);
            textArea->fontId          = SMALL_BOLD_FONT;
            textArea->textAlignment   = CENTER;
            textArea->obj.touchMask   = (1 << TOUCHED);
            textArea->obj.touchId     = RIGHT_BUTTON_ID;
            // add to bottom container
            layoutInt->footerContainer->children[layoutInt->footerContainer->nbChildren]
                = (nbgl_obj_t *) textArea;
            layoutInt->footerContainer->nbChildren++;
            layoutInt->footerContainer->obj.area.height = textArea->obj.area.height;
 
            // create vertical line separating texts
            separationLine            = (nbgl_line_t *) nbgl_objPoolGet(LINE, layoutInt->layer);
            separationLine->lineColor = LIGHT_GRAY;
            separationLine->obj.area.width       = 1;
            separationLine->obj.area.height      = layoutInt->footerContainer->obj.area.height;
            separationLine->direction            = VERTICAL;
            separationLine->thickness            = 1;
            separationLine->obj.alignment        = MID_LEFT;
            separationLine->obj.alignTo          = (nbgl_obj_t *) textArea;
            separationLine->obj.alignmentMarginX = -1;
            break;
        }
        case FOOTER_TEXT_AND_NAV: {
            layoutInt->footerContainer->obj.area.height = SIMPLE_FOOTER_HEIGHT;
            // add touchable text on the left
            textArea = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
            obj      = layoutAddCallbackObj(layoutInt,
                                       (nbgl_obj_t *) textArea,
                                       footerDesc->textAndNav.token,
                                       footerDesc->textAndNav.tuneId);
            if (obj == NULL) {
                return -1;
            }
            textArea->obj.alignment   = BOTTOM_LEFT;
            textArea->textColor       = BLACK;
            textArea->obj.area.width  = FOOTER_TEXT_AND_NAV_WIDTH;
            textArea->obj.area.height = SIMPLE_FOOTER_HEIGHT;
            textArea->text            = PIC(footerDesc->textAndNav.text);
            textArea->fontId          = SMALL_BOLD_FONT;
            textArea->textAlignment   = CENTER;
            textArea->obj.touchMask   = (1 << TOUCHED);
            textArea->obj.touchId     = BOTTOM_BUTTON_ID;
            // add to bottom container
            layoutInt->footerContainer->children[layoutInt->footerContainer->nbChildren]
                = (nbgl_obj_t *) textArea;
            layoutInt->footerContainer->nbChildren++;
 
            // add navigation on the right
            nbgl_container_t *navContainer
                = (nbgl_container_t *) nbgl_objPoolGet(CONTAINER, layoutInt->layer);
            navContainer->obj.area.width = AVAILABLE_WIDTH;
            navContainer->layout         = VERTICAL;
            navContainer->nbChildren     = 4;
            navContainer->children
                = (nbgl_obj_t **) nbgl_containerPoolGet(navContainer->nbChildren, layoutInt->layer);
            navContainer->obj.alignment   = BOTTOM_RIGHT;
            navContainer->obj.area.width  = SCREEN_WIDTH - textArea->obj.area.width;
            navContainer->obj.area.height = SIMPLE_FOOTER_HEIGHT;
            layoutNavigationPopulate(navContainer, &footerDesc->navigation, layoutInt->layer);
            obj = layoutAddCallbackObj(layoutInt,
                                       (nbgl_obj_t *) navContainer,
                                       footerDesc->textAndNav.navigation.token,
                                       footerDesc->textAndNav.navigation.tuneId);
            if (obj == NULL) {
                return -1;
            }
 
            // create vertical line separating text from nav
            separationLine            = (nbgl_line_t *) nbgl_objPoolGet(LINE, layoutInt->layer);
            separationLine->lineColor = LIGHT_GRAY;
            separationLine->obj.area.width       = 1;
            separationLine->obj.area.height      = layoutInt->footerContainer->obj.area.height;
            separationLine->direction            = VERTICAL;
            separationLine->thickness            = 1;
            separationLine->obj.alignment        = MID_LEFT;
            separationLine->obj.alignTo          = (nbgl_obj_t *) navContainer;
            separationLine->obj.alignmentMarginX = -1;
 
            layoutInt->activePage = footerDesc->textAndNav.navigation.activePage;
            layoutInt->nbPages    = footerDesc->textAndNav.navigation.nbPages;
            // add to bottom container
            layoutInt->footerContainer->children[layoutInt->footerContainer->nbChildren]
                = (nbgl_obj_t *) navContainer;
            layoutInt->footerContainer->nbChildren++;
            break;
        }
        case FOOTER_NAV: {
            layoutInt->footerContainer->obj.area.height = SIMPLE_FOOTER_HEIGHT;
            layoutNavigationPopulate(
                layoutInt->footerContainer, &footerDesc->navigation, layoutInt->layer);
            layoutInt->footerContainer->nbChildren = 4;
            obj                                    = layoutAddCallbackObj(layoutInt,
                                       (nbgl_obj_t *) layoutInt->footerContainer,
                                       footerDesc->navigation.token,
                                       footerDesc->navigation.tuneId);
            if (obj == NULL) {
                return -1;
            }
 
            layoutInt->activePage = footerDesc->navigation.activePage;
            layoutInt->nbPages    = footerDesc->navigation.nbPages;
            break;
        }
        case FOOTER_SIMPLE_BUTTON: {
            button = (nbgl_button_t *) nbgl_objPoolGet(BUTTON, layoutInt->layer);
            obj    = layoutAddCallbackObj(layoutInt,
                                       (nbgl_obj_t *) button,
                                       footerDesc->button.token,
                                       footerDesc->button.tuneId);
            if (obj == NULL) {
                return -1;
            }
 
            button->obj.alignment        = BOTTOM_MIDDLE;
            button->obj.alignmentMarginY = SINGLE_BUTTON_MARGIN;
            if (footerDesc->button.style == BLACK_BACKGROUND) {
                button->innerColor      = BLACK;
                button->foregroundColor = WHITE;
            }
            else {
                button->innerColor      = WHITE;
                button->foregroundColor = BLACK;
            }
 
            if (footerDesc->button.style == NO_BORDER) {
                button->borderColor = WHITE;
            }
            else {
                if (footerDesc->button.style == BLACK_BACKGROUND) {
                    button->borderColor = BLACK;
                }
                else {
                    button->borderColor = LIGHT_GRAY;
                }
            }
            button->text                                = PIC(footerDesc->button.text);
            button->fontId                              = SMALL_BOLD_FONT;
            button->icon                                = PIC(footerDesc->button.icon);
            button->radius                              = BUTTON_RADIUS;
            button->obj.area.height                     = BUTTON_DIAMETER;
            layoutInt->footerContainer->obj.area.height = FOOTER_BUTTON_HEIGHT;
            if (footerDesc->button.text == NULL) {
                button->obj.area.width = BUTTON_DIAMETER;
            }
            else {
                button->obj.area.width = AVAILABLE_WIDTH;
            }
            button->obj.touchMask = (1 << TOUCHED);
            button->obj.touchId   = button->text ? SINGLE_BUTTON_ID : BOTTOM_BUTTON_ID;
            // add to bottom container
            layoutInt->footerContainer->children[layoutInt->footerContainer->nbChildren]
                = (nbgl_obj_t *) button;
            layoutInt->footerContainer->nbChildren++;
            break;
        }
        case FOOTER_CHOICE_BUTTONS: {
            // texts cannot be NULL
            if ((footerDesc->choiceButtons.bottomText == NULL)
                || (footerDesc->choiceButtons.topText == NULL)) {
                return -1;
            }
 
            // create bottom button (footer) at first
            button = (nbgl_button_t *) nbgl_objPoolGet(BUTTON, layoutInt->layer);
            obj    = layoutAddCallbackObj(layoutInt,
                                       (nbgl_obj_t *) button,
                                       footerDesc->choiceButtons.token,
                                       footerDesc->choiceButtons.tuneId);
            if (obj == NULL) {
                return -1;
            }
            // associate with with index 1
            obj->index = 1;
            // put at the bottom of the container
            button->obj.alignment = BOTTOM_MIDDLE;
            button->innerColor    = WHITE;
            if (footerDesc->choiceButtons.style == BOTH_ROUNDED_STYLE) {
                button->obj.alignmentMarginY
                    = SINGLE_BUTTON_MARGIN;  // pixels from bottom of container
                button->borderColor     = LIGHT_GRAY;
                button->obj.area.height = BUTTON_DIAMETER;
            }
            else {
                button->obj.alignmentMarginY
                    = BUTTON_FROM_BOTTOM_MARGIN;  // pixels from screen bottom
                button->borderColor     = WHITE;
                button->obj.area.height = FOOTER_IN_PAIR_HEIGHT;
            }
            button->foregroundColor = BLACK;
            button->obj.area.width  = AVAILABLE_WIDTH;
            button->radius          = BUTTON_RADIUS;
            button->text            = PIC(footerDesc->choiceButtons.bottomText);
            button->fontId          = SMALL_BOLD_FONT;
            button->obj.touchMask   = (1 << TOUCHED);
            button->obj.touchId     = CHOICE_2_ID;
            // add to bottom container
            layoutInt->footerContainer->children[layoutInt->footerContainer->nbChildren]
                = (nbgl_obj_t *) button;
            layoutInt->footerContainer->nbChildren++;
 
            // add line if needed
            if ((footerDesc->choiceButtons.style != ROUNDED_AND_FOOTER_STYLE)
                && (footerDesc->choiceButtons.style != BOTH_ROUNDED_STYLE)) {
                line                = createHorizontalLine(layoutInt->layer);
                line->obj.alignment = TOP_MIDDLE;
                line->obj.alignTo   = (nbgl_obj_t *) button;
                layoutInt->footerContainer->children[layoutInt->footerContainer->nbChildren]
                    = (nbgl_obj_t *) line;
                layoutInt->footerContainer->nbChildren++;
            }
 
            // then top button, on top of it
            button = (nbgl_button_t *) nbgl_objPoolGet(BUTTON, layoutInt->layer);
            obj    = layoutAddCallbackObj(layoutInt,
                                       (nbgl_obj_t *) button,
                                       footerDesc->choiceButtons.token,
                                       footerDesc->choiceButtons.tuneId);
            if (obj == NULL) {
                return -1;
            }
            // associate with with index 0
            obj->index            = 0;
            button->obj.alignment = TOP_MIDDLE;
            if (footerDesc->choiceButtons.style == ROUNDED_AND_FOOTER_STYLE) {
                button->obj.alignmentMarginY = TOP_BUTTON_MARGIN;  // pixels from top of container
            }
            else if (footerDesc->choiceButtons.style == BOTH_ROUNDED_STYLE) {
                button->obj.alignmentMarginY
                    = SINGLE_BUTTON_MARGIN;  // pixels from top of container
            }
            else {
                button->obj.alignmentMarginY
                    = TOP_BUTTON_MARGIN_WITH_ACTION;  // pixels from top of container
            }
            if (footerDesc->choiceButtons.style == SOFT_ACTION_AND_FOOTER_STYLE) {
                button->innerColor      = WHITE;
                button->borderColor     = LIGHT_GRAY;
                button->foregroundColor = BLACK;
            }
            else {
                button->innerColor      = BLACK;
                button->borderColor     = BLACK;
                button->foregroundColor = WHITE;
            }
            button->obj.area.width  = AVAILABLE_WIDTH;
            button->obj.area.height = BUTTON_DIAMETER;
            button->radius          = BUTTON_RADIUS;
            button->text            = PIC(footerDesc->choiceButtons.topText);
            button->icon            = (footerDesc->choiceButtons.style != ROUNDED_AND_FOOTER_STYLE)
                                          ? PIC(footerDesc->choiceButtons.topIcon)
                                          : NULL;
            button->fontId          = SMALL_BOLD_FONT;
            button->obj.touchMask   = (1 << TOUCHED);
            button->obj.touchId     = CHOICE_1_ID;
            // add to bottom container
            layoutInt->footerContainer->children[layoutInt->footerContainer->nbChildren]
                = (nbgl_obj_t *) button;
            layoutInt->footerContainer->nbChildren++;
 
            if (footerDesc->choiceButtons.style == ROUNDED_AND_FOOTER_STYLE) {
                layoutInt->footerContainer->obj.area.height = ROUNDED_AND_FOOTER_FOOTER_HEIGHT;
            }
            else if (footerDesc->choiceButtons.style == BOTH_ROUNDED_STYLE) {
                layoutInt->footerContainer->obj.area.height = BOTH_ROUNDED_FOOTER_HEIGHT;
            }
            else {
                layoutInt->footerContainer->obj.area.height = ACTION_AND_FOOTER_FOOTER_HEIGHT;
            }
 
            break;
        }
        default:
            return -2;
    }
 
    // add swipable feature for navigation
    if ((footerDesc->type == FOOTER_NAV) || (footerDesc->type == FOOTER_TEXT_AND_NAV)) {
        addSwipeInternal(layoutInt,
                         ((1 << SWIPED_LEFT) | (1 << SWIPED_RIGHT)),
                         SWIPE_USAGE_NAVIGATION,
                         (footerDesc->type == FOOTER_NAV) ? footerDesc->navigation.token
                                                          : footerDesc->textAndNav.navigation.token,
                         (footerDesc->type == FOOTER_NAV)
                             ? footerDesc->navigation.tuneId
                             : footerDesc->textAndNav.navigation.tuneId);
    }
 
    if (footerDesc->separationLine) {
        line                = createHorizontalLine(layoutInt->layer);
        line->obj.alignment = TOP_MIDDLE;
        layoutInt->footerContainer->children[layoutInt->footerContainer->nbChildren]
            = (nbgl_obj_t *) line;
        layoutInt->footerContainer->nbChildren++;
    }
    if (separationLine != NULL) {
        layoutInt->footerContainer->children[layoutInt->footerContainer->nbChildren]
            = (nbgl_obj_t *) separationLine;
        layoutInt->footerContainer->nbChildren++;
    }
 
    layoutInt->children[FOOTER_INDEX] = (nbgl_obj_t *) layoutInt->footerContainer;
 
    // subtract footer height from main container height
    layoutInt->container->obj.area.height -= layoutInt->footerContainer->obj.area.height;
 
    layoutInt->footerType = footerDesc->type;
 
    return layoutInt->footerContainer->obj.area.height;
}
 
int nbgl_layoutAddUpFooter(nbgl_layout_t *layout, const nbgl_layoutUpFooter_t *upFooterDesc)
{
    nbgl_layoutInternal_t *layoutInt = (nbgl_layoutInternal_t *) layout;
    layoutObj_t           *obj;
    nbgl_text_area_t      *textArea;
    nbgl_line_t           *line;
    nbgl_button_t         *button;
 
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutAddUpFooter():\n");
    if (layout == NULL) {
        return -1;
    }
    if ((upFooterDesc == NULL) || (upFooterDesc->type >= NB_UP_FOOTER_TYPES)) {
        return -2;
    }
 
    layoutInt->upFooterContainer
        = (nbgl_container_t *) nbgl_objPoolGet(CONTAINER, layoutInt->layer);
    layoutInt->upFooterContainer->obj.area.width = SCREEN_WIDTH;
    layoutInt->upFooterContainer->layout         = VERTICAL;
    // maximum 4 children for long press button
    layoutInt->upFooterContainer->children
        = (nbgl_obj_t **) nbgl_containerPoolGet(4, layoutInt->layer);
    layoutInt->upFooterContainer->obj.alignTo   = (nbgl_obj_t *) layoutInt->container;
    layoutInt->upFooterContainer->obj.alignment = BOTTOM_MIDDLE;
 
    switch (upFooterDesc->type) {
        case UP_FOOTER_LONG_PRESS: {
            nbgl_progress_bar_t *progressBar;
 
            obj = layoutAddCallbackObj(layoutInt,
                                       (nbgl_obj_t *) layoutInt->upFooterContainer,
                                       upFooterDesc->longPress.token,
                                       upFooterDesc->longPress.tuneId);
            if (obj == NULL) {
                return -1;
            }
            layoutInt->upFooterContainer->nbChildren      = 4;
            layoutInt->upFooterContainer->obj.area.height = LONG_PRESS_BUTTON_HEIGHT;
            layoutInt->upFooterContainer->obj.touchId     = LONG_PRESS_BUTTON_ID;
            layoutInt->upFooterContainer->obj.touchMask
                = ((1 << TOUCHING) | (1 << TOUCH_RELEASED) | (1 << OUT_OF_TOUCH)
                   | (1 << SWIPED_LEFT) | (1 << SWIPED_RIGHT));
 
            button = (nbgl_button_t *) nbgl_objPoolGet(BUTTON, layoutInt->layer);
            button->obj.alignmentMarginX              = BORDER_MARGIN;
            button->obj.alignment                     = MID_RIGHT;
            button->innerColor                        = BLACK;
            button->foregroundColor                   = WHITE;
            button->borderColor                       = BLACK;
            button->obj.area.width                    = BUTTON_DIAMETER;
            button->obj.area.height                   = BUTTON_DIAMETER;
            button->radius                            = BUTTON_RADIUS;
            button->icon                              = PIC(&VALIDATE_ICON);
            layoutInt->upFooterContainer->children[0] = (nbgl_obj_t *) button;
 
            textArea            = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
            textArea->textColor = BLACK;
            textArea->text      = PIC(upFooterDesc->longPress.text);
            textArea->textAlignment   = MID_LEFT;
            textArea->fontId          = LARGE_MEDIUM_FONT;
            textArea->wrapping        = true;
            textArea->obj.area.width  = SCREEN_WIDTH - 3 * BORDER_MARGIN - button->obj.area.width;
            textArea->obj.area.height = nbgl_getTextHeightInWidth(
                textArea->fontId, textArea->text, textArea->obj.area.width, textArea->wrapping);
            textArea->style                           = NO_STYLE;
            textArea->obj.alignment                   = MID_LEFT;
            textArea->obj.alignmentMarginX            = BORDER_MARGIN;
            layoutInt->upFooterContainer->children[1] = (nbgl_obj_t *) textArea;
 
            line                                      = createHorizontalLine(layoutInt->layer);
            line->obj.alignment                       = TOP_MIDDLE;
            layoutInt->upFooterContainer->children[2] = (nbgl_obj_t *) line;
 
            progressBar = (nbgl_progress_bar_t *) nbgl_objPoolGet(PROGRESS_BAR, layoutInt->layer);
            progressBar->obj.area.width               = SCREEN_WIDTH;
            progressBar->obj.area.height              = LONG_PRESS_PROGRESS_HEIGHT;
            progressBar->obj.alignment                = TOP_MIDDLE;
            progressBar->obj.alignmentMarginY         = LONG_PRESS_PROGRESS_ALIGN;
            progressBar->resetIfOverriden             = true;
            progressBar->partialRedraw                = true;
            layoutInt->upFooterContainer->children[3] = (nbgl_obj_t *) progressBar;
            break;
        }
        case UP_FOOTER_BUTTON: {
            button = (nbgl_button_t *) nbgl_objPoolGet(BUTTON, layoutInt->layer);
            obj    = layoutAddCallbackObj(layoutInt,
                                       (nbgl_obj_t *) button,
                                       upFooterDesc->button.token,
                                       upFooterDesc->button.tuneId);
            if (obj == NULL) {
                return -1;
            }
 
            layoutInt->upFooterContainer->nbChildren      = 1;
            layoutInt->upFooterContainer->obj.area.height = UP_FOOTER_BUTTON_HEIGHT;
            button->obj.alignment                         = CENTER;
 
            if (upFooterDesc->button.style == BLACK_BACKGROUND) {
                button->innerColor      = BLACK;
                button->foregroundColor = WHITE;
            }
            else {
                button->innerColor      = WHITE;
                button->foregroundColor = BLACK;
            }
            if (upFooterDesc->button.style == NO_BORDER) {
                button->borderColor = WHITE;
            }
            else {
                if (upFooterDesc->button.style == BLACK_BACKGROUND) {
                    button->borderColor = BLACK;
                }
                else {
                    button->borderColor = LIGHT_GRAY;
                }
            }
            button->text            = PIC(upFooterDesc->button.text);
            button->fontId          = SMALL_BOLD_FONT;
            button->icon            = PIC(upFooterDesc->button.icon);
            button->obj.area.width  = AVAILABLE_WIDTH;
            button->obj.area.height = BUTTON_DIAMETER;
            button->radius          = BUTTON_RADIUS;
 
            button->obj.alignTo                       = NULL;
            button->obj.touchMask                     = (1 << TOUCHED);
            button->obj.touchId                       = SINGLE_BUTTON_ID;
            layoutInt->upFooterContainer->children[0] = (nbgl_obj_t *) button;
            break;
        }
        case UP_FOOTER_HORIZONTAL_BUTTONS: {
            // icon & text cannot be NULL
            if ((upFooterDesc->horizontalButtons.leftIcon == NULL)
                || (upFooterDesc->horizontalButtons.rightText == NULL)) {
                return -1;
            }
 
            layoutInt->upFooterContainer->nbChildren      = 2;
            layoutInt->upFooterContainer->obj.area.height = UP_FOOTER_BUTTON_HEIGHT;
 
            // create left button (in white) at first
            button = (nbgl_button_t *) nbgl_objPoolGet(BUTTON, layoutInt->layer);
            obj    = layoutAddCallbackObj(layoutInt,
                                       (nbgl_obj_t *) button,
                                       upFooterDesc->horizontalButtons.leftToken,
                                       upFooterDesc->horizontalButtons.tuneId);
            if (obj == NULL) {
                return -1;
            }
            // associate with with index 1
            obj->index                   = 1;
            button->obj.alignment        = MID_LEFT;
            button->obj.alignmentMarginX = BORDER_MARGIN;
            button->borderColor          = LIGHT_GRAY;
            button->innerColor           = WHITE;
            button->foregroundColor      = BLACK;
            button->obj.area.width       = BUTTON_WIDTH;
            button->obj.area.height      = BUTTON_DIAMETER;
            button->radius               = BUTTON_RADIUS;
            button->icon                 = PIC(upFooterDesc->horizontalButtons.leftIcon);
            button->fontId               = SMALL_BOLD_FONT;
            button->obj.touchMask        = (1 << TOUCHED);
            button->obj.touchId          = CHOICE_2_ID;
            layoutInt->upFooterContainer->children[0] = (nbgl_obj_t *) button;
 
            // then black button, on right
            button = (nbgl_button_t *) nbgl_objPoolGet(BUTTON, layoutInt->layer);
            obj    = layoutAddCallbackObj(layoutInt,
                                       (nbgl_obj_t *) button,
                                       upFooterDesc->horizontalButtons.rightToken,
                                       upFooterDesc->horizontalButtons.tuneId);
            if (obj == NULL) {
                return -1;
            }
            // associate with with index 0
            obj->index                   = 0;
            button->obj.alignment        = MID_RIGHT;
            button->obj.alignmentMarginX = BORDER_MARGIN;
            button->innerColor           = BLACK;
            button->borderColor          = BLACK;
            button->foregroundColor      = WHITE;
            button->obj.area.width  = AVAILABLE_WIDTH - BUTTON_WIDTH - LEFT_CONTENT_ICON_TEXT_X;
            button->obj.area.height = BUTTON_DIAMETER;
            button->radius          = BUTTON_RADIUS;
            button->text            = PIC(upFooterDesc->horizontalButtons.rightText);
            button->fontId          = SMALL_BOLD_FONT;
            button->obj.touchMask   = (1 << TOUCHED);
            button->obj.touchId     = CHOICE_1_ID;
            layoutInt->upFooterContainer->children[1] = (nbgl_obj_t *) button;
            break;
        }
        case UP_FOOTER_TIP_BOX: {
            // text cannot be NULL
            if (upFooterDesc->tipBox.text == NULL) {
                return -1;
            }
            obj = layoutAddCallbackObj(layoutInt,
                                       (nbgl_obj_t *) layoutInt->upFooterContainer,
                                       upFooterDesc->tipBox.token,
                                       upFooterDesc->tipBox.tuneId);
            if (obj == NULL) {
                return -1;
            }
            layoutInt->upFooterContainer->nbChildren    = 3;
            layoutInt->upFooterContainer->obj.touchId   = TIP_BOX_ID;
            layoutInt->upFooterContainer->obj.touchMask = (1 << TOUCHED);
 
            textArea            = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
            textArea->textColor = BLACK;
            textArea->text      = PIC(upFooterDesc->tipBox.text);
            textArea->textAlignment  = MID_LEFT;
            textArea->fontId         = SMALL_REGULAR_FONT;
            textArea->wrapping       = true;
            textArea->obj.area.width = AVAILABLE_WIDTH;
            if (upFooterDesc->tipBox.icon != NULL) {
                textArea->obj.area.width
                    -= ((nbgl_icon_details_t *) PIC(upFooterDesc->tipBox.icon))->width
                       + TIP_BOX_TEXT_ICON_MARGIN;
            }
            textArea->obj.area.height = nbgl_getTextHeightInWidth(
                textArea->fontId, textArea->text, textArea->obj.area.width, textArea->wrapping);
            textArea->obj.alignment                       = MID_LEFT;
            textArea->obj.alignmentMarginX                = BORDER_MARGIN;
            layoutInt->upFooterContainer->children[0]     = (nbgl_obj_t *) textArea;
            layoutInt->upFooterContainer->obj.area.height = textArea->obj.area.height;
 
            line                                      = createHorizontalLine(layoutInt->layer);
            line->obj.alignment                       = TOP_MIDDLE;
            layoutInt->upFooterContainer->children[1] = (nbgl_obj_t *) line;
 
            if (upFooterDesc->tipBox.icon != NULL) {
                nbgl_image_t *image = (nbgl_image_t *) nbgl_objPoolGet(IMAGE, layoutInt->layer);
                image->obj.alignmentMarginX               = BORDER_MARGIN;
                image->obj.alignment                      = MID_RIGHT;
                image->foregroundColor                    = BLACK;
                image->buffer                             = PIC(upFooterDesc->tipBox.icon);
                layoutInt->upFooterContainer->children[2] = (nbgl_obj_t *) image;
                if (layoutInt->upFooterContainer->obj.area.height < image->buffer->height) {
                    layoutInt->upFooterContainer->obj.area.height = image->buffer->height;
                }
            }
            layoutInt->upFooterContainer->obj.area.height += 2 * TIP_BOX_MARGIN_Y;
 
            break;
        }
        case UP_FOOTER_TEXT: {
            obj = layoutAddCallbackObj(layoutInt,
                                       (nbgl_obj_t *) layoutInt->upFooterContainer,
                                       upFooterDesc->text.token,
                                       upFooterDesc->text.tuneId);
            if (obj == NULL) {
                return -1;
            }
            layoutInt->upFooterContainer->nbChildren      = 1;
            layoutInt->upFooterContainer->obj.area.height = SMALL_FOOTER_HEIGHT;
            layoutInt->upFooterContainer->obj.touchId     = WHOLE_SCREEN_ID;
            layoutInt->upFooterContainer->obj.touchMask   = (1 << TOUCHED);
 
            // only create text_area if text is not empty
            if (strlen(PIC(upFooterDesc->text.text))) {
                textArea = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
                textArea->textColor       = LIGHT_TEXT_COLOR;
                textArea->text            = PIC(upFooterDesc->text.text);
                textArea->textAlignment   = CENTER;
                textArea->fontId          = SMALL_REGULAR_FONT;
                textArea->wrapping        = true;
                textArea->obj.area.width  = AVAILABLE_WIDTH;
                textArea->obj.area.height = nbgl_getTextHeightInWidth(
                    textArea->fontId, textArea->text, textArea->obj.area.width, textArea->wrapping);
                textArea->obj.alignment                   = CENTER;
                layoutInt->upFooterContainer->children[0] = (nbgl_obj_t *) textArea;
            }
            break;
        }
        default:
            return -2;
    }
 
    // subtract up footer height from main container height
    layoutInt->container->obj.area.height -= layoutInt->upFooterContainer->obj.area.height;
 
    layoutInt->children[UP_FOOTER_INDEX] = (nbgl_obj_t *) layoutInt->upFooterContainer;
 
    layoutInt->upFooterType = upFooterDesc->type;
 
    return layoutInt->upFooterContainer->obj.area.height;
}
 
int nbgl_layoutAddProgressIndicator(nbgl_layout_t *layout,
                                    uint8_t        activePage,
                                    uint8_t        nbPages,
                                    bool           withBack,
                                    uint8_t        backToken,
                                    tune_index_e   tuneId)
{
    nbgl_layoutHeader_t headerDesc = {.type                        = HEADER_BACK_AND_PROGRESS,
                                      .separationLine              = false,
                                      .progressAndBack.activePage  = activePage,
                                      .progressAndBack.nbPages     = nbPages,
                                      .progressAndBack.token       = backToken,
                                      .progressAndBack.tuneId      = tuneId,
                                      .progressAndBack.withBack    = withBack,
                                      .progressAndBack.actionIcon  = NULL,
                                      .progressAndBack.actionToken = NBGL_INVALID_TOKEN};
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutAddProgressIndicator():\n");
 
    return nbgl_layoutAddHeader(layout, &headerDesc);
}
 
int nbgl_layoutAddSpinner(nbgl_layout_t *layout,
                          const char    *text,
                          const char    *subText,
                          uint8_t        initPosition)
{
    nbgl_layoutInternal_t *layoutInt = (nbgl_layoutInternal_t *) layout;
    nbgl_container_t      *container;
    nbgl_text_area_t      *textArea;
    nbgl_spinner_t        *spinner;
 
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutAddSpinner():\n");
    if (layout == NULL) {
        return -1;
    }
 
    container = (nbgl_container_t *) nbgl_objPoolGet(CONTAINER, layoutInt->layer);
    // spinner + text + subText
    container->nbChildren = 3;
    container->children   = nbgl_containerPoolGet(container->nbChildren, layoutInt->layer);
 
    container->obj.area.width = AVAILABLE_WIDTH;
    container->layout         = VERTICAL;
    container->obj.alignment  = CENTER;
 
    // create spinner
    spinner                = (nbgl_spinner_t *) nbgl_objPoolGet(SPINNER, layoutInt->layer);
    spinner->position      = initPosition;
    spinner->obj.alignment = TOP_MIDDLE;
    // set this new spinner as child of the container
    container->children[0] = (nbgl_obj_t *) spinner;
 
    // update container height
    container->obj.area.height += SPINNER_HEIGHT;
 
    // create text area
    textArea                = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
    textArea->textColor     = BLACK;
    textArea->text          = PIC(text);
    textArea->textAlignment = CENTER;
    textArea->fontId        = (subText != NULL) ? LARGE_MEDIUM_FONT : SMALL_REGULAR_FONT;
    textArea->wrapping      = true;
    textArea->obj.alignmentMarginY = SPINNER_TEXT_MARGIN;
    textArea->obj.alignTo          = (nbgl_obj_t *) spinner;
    textArea->obj.alignment        = BOTTOM_MIDDLE;
    textArea->obj.area.width       = AVAILABLE_WIDTH;
    textArea->obj.area.height      = nbgl_getTextHeightInWidth(
        textArea->fontId, textArea->text, textArea->obj.area.width, textArea->wrapping);
    textArea->style = NO_STYLE;
 
    // update container height
    container->obj.area.height += textArea->obj.alignmentMarginY + textArea->obj.area.height;
 
    // set this text as child of the container
    container->children[1] = (nbgl_obj_t *) textArea;
 
    if (subText != NULL) {
        nbgl_text_area_t *subTextArea;
        // create sub-text area
        subTextArea            = (nbgl_text_area_t *) nbgl_objPoolGet(TEXT_AREA, layoutInt->layer);
        subTextArea->textColor = BLACK;
        subTextArea->text      = PIC(subText);
        subTextArea->textAlignment        = CENTER;
        subTextArea->fontId               = SMALL_REGULAR_FONT;
        subTextArea->wrapping             = true;
        subTextArea->obj.alignmentMarginY = SPINNER_INTER_TEXTS_MARGIN;
        subTextArea->obj.alignTo          = (nbgl_obj_t *) textArea;
        subTextArea->obj.alignment        = BOTTOM_MIDDLE;
        subTextArea->obj.area.width       = AVAILABLE_WIDTH;
        subTextArea->obj.area.height      = nbgl_getTextHeightInWidth(subTextArea->fontId,
                                                                 subTextArea->text,
                                                                 subTextArea->obj.area.width,
                                                                 subTextArea->wrapping);
        subTextArea->style                = NO_STYLE;
 
        // update container height
        container->obj.area.height
            += subTextArea->obj.alignmentMarginY + subTextArea->obj.area.height;
 
        // set thissub-text as child of the container
        container->children[2] = (nbgl_obj_t *) subTextArea;
    }
    layoutAddObject(layoutInt, (nbgl_obj_t *) container);
 
    if (initPosition != SPINNER_FIXED) {
        // update ticker to update the spinner periodically
        nbgl_screenTickerConfiguration_t tickerCfg;
 
        tickerCfg.tickerIntervale = SPINNER_REFRESH_PERIOD;  // ms
        tickerCfg.tickerValue     = SPINNER_REFRESH_PERIOD;  // ms
        tickerCfg.tickerCallback  = &spinnerTickerCallback;
        nbgl_screenUpdateTicker(layoutInt->layer, &tickerCfg);
    }
 
    return 0;
}
 
int nbgl_layoutUpdateSpinner(nbgl_layout_t *layout,
                             const char    *text,
                             const char    *subText,
                             uint8_t        position)
{
    nbgl_layoutInternal_t *layoutInt = (nbgl_layoutInternal_t *) layout;
    nbgl_container_t      *container;
    nbgl_text_area_t      *textArea;
    nbgl_spinner_t        *spinner;
    int                    ret = 0;
 
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutUpdateSpinner():\n");
    if ((layout == NULL) || (layoutInt->container->nbChildren == 0)) {
        return -1;
    }
 
    container = (nbgl_container_t *) layoutInt->container->children[0];
    if ((container->obj.type != CONTAINER) || (container->nbChildren < 2)) {
        return -1;
    }
 
    spinner = (nbgl_spinner_t *) container->children[0];
    if (spinner->obj.type != SPINNER) {
        return -1;
    }
    // if position is different, redraw
    if (spinner->position != position) {
        spinner->position = position;
        nbgl_objDraw((nbgl_obj_t *) spinner);
        ret = 1;
    }
 
    // update text area if necessary
    textArea = (nbgl_text_area_t *) container->children[1];
    if (textArea->obj.type != TEXT_AREA) {
        return -1;
    }
    const char *newText    = PIC(text);
    size_t      newTextLen = strlen(newText);
    // if text is different, redraw (don't use strcmp because it crashes with Rust SDK)
    if ((newTextLen != strlen(textArea->text)) || memcmp(textArea->text, newText, newTextLen)) {
        textArea->text = newText;
        nbgl_objDraw((nbgl_obj_t *) textArea);
        ret = 2;
    }
 
    if (subText != NULL) {
        nbgl_text_area_t *subTextArea;
 
        if (container->nbChildren != 3) {
            return -1;
        }
        subTextArea = (nbgl_text_area_t *) container->children[2];
        if (subTextArea->obj.type != TEXT_AREA) {
            return -1;
        }
        const char *newSubText    = PIC(subText);
        size_t      newSubTextLen = strlen(newSubText);
        // if text is different, redraw
        if ((newSubTextLen != strlen(subTextArea->text))
            || memcmp(subTextArea->text, newSubText, newSubTextLen)) {
            subTextArea->text = newSubText;
            nbgl_objDraw((nbgl_obj_t *) subTextArea);
            ret = 2;
        }
    }
 
    return ret;
}
 
int nbgl_layoutDraw(nbgl_layout_t *layoutParam)
{
    nbgl_layoutInternal_t *layout = (nbgl_layoutInternal_t *) layoutParam;
 
    if (layout == NULL) {
        return -1;
    }
    LOG_DEBUG(LAYOUT_LOGGER, "nbgl_layoutDraw(): layout->isUsed = %d\n", layout->isUsed);
    if (layout->tapText) {
        // set this new container as child of main container
        layoutAddObject(layout, (nbgl_obj_t *) layout->tapText);
    }
#ifdef TARGET_STAX
    if (layout->withLeftBorder == true) {
        // draw now the line
        nbgl_line_t *line                   = createLeftVerticalLine(layout->layer);
        layout->children[LEFT_BORDER_INDEX] = (nbgl_obj_t *) line;
    }
#endif  // TARGET_STAX
    nbgl_screenRedraw();
 
    return 0;
}
 
int nbgl_layoutRelease(nbgl_layout_t *layoutParam)
{
    nbgl_layoutInternal_t *layout = (nbgl_layoutInternal_t *) layoutParam;
    LOG_DEBUG(PAGE_LOGGER, "nbgl_layoutRelease(): \n");
    if ((layout == NULL) || (!layout->isUsed)) {
        return -1;
    }
    // if modal
    if (layout->modal) {
        nbgl_screenPop(layout->layer);
        // if this layout was on top, use its bottom layout as top
        if (layout == topLayout) {
            topLayout      = layout->bottom;
            topLayout->top = NULL;
        }
        else {
            // otherwise connect top to bottom
            layout->bottom->top = layout->top;
            layout->top->bottom = layout->bottom;
        }
    }
    layout->isUsed = false;
    return 0;
}
 
#endif  // HAVE_SE_TOUCH