Menu Internal Helpers

Functions
static ERR_te	menu_selectable_run (MENU_HANDLE_ts *menu_handle)
	Renders a MENU_TYPE_SELECTABLE menu to the display.
static ERR_te	menu_dataview_run (MENU_HANDLE_ts *menu_handle)
	Renders a MENU_TYPE_DATA_VIEW menu to the display.

Detailed Description

Function Documentation

menu_selectable_run()

ERR_te menu_selectable_run ( MENU_HANDLE_ts * menu_handle )

static

Renders a MENU_TYPE_SELECTABLE menu to the display.

Clamps the selection index to valid bounds, updates the visible window and highlight line based on scroll direction, draws each visible option string, inverts the highlight line to show selection, and draws the title.

The display supports 7 option lines (lines 1–7) plus a title line (line 8). When the option count exceeds 7, a sliding window tracks which options are currently visible.

Parameters

[in,out]

menu_handle

Pointer to the menu handle to render.

Returns

• ERR_OK always

Definition at line 445 of file menu.c.

                                                               {
    // Clamp selected item if possible boundaries exceeded
    if(menu_handle->selected_option < 0) {
        menu_handle->selected_option = 0;
    }
    else if(menu_handle->selected_option >= menu_handle->options_count) {
        menu_handle->selected_option = menu_handle->options_count - 1;
    }
 
    // Items in options list is greater than 7, thus shifting of the currently showed items is needed
    if(menu_handle->options_count > 7) {
        // If selected item is outside (positive direction) of the currently showed items list shift
        // the window by one in positive direction
        if(menu_handle->selected_option > menu_handle->last_visible_option) {
            menu_handle->first_visible_option++;
            menu_handle->last_visible_option++;
        }
        // Opposite direction
        else if (menu_handle->selected_option < menu_handle->first_visible_option) {
            menu_handle->first_visible_option--;
            menu_handle->last_visible_option--;
        }
 
        // If selection reached last visible item, shift selection in positive direction
        if(menu_handle->selected_option == menu_handle->last_visible_option) {
            menu_handle->line_to_highlight = 7;
        }
        // If selection reached first item, shift selection in negative direction
        else if(menu_handle->selected_option == menu_handle->first_visible_option) {
            menu_handle->line_to_highlight = 1;
        }
        // If selection is in-between, change selection
        else {
            // In positive direction
            if(menu_handle->selected_option > menu_handle->prev_selected_option) {
                menu_handle->line_to_highlight = menu_handle->selected_option + 1;
            }
            // In negative direction
            else if(menu_handle->selected_option < menu_handle->prev_selected_option) {
                menu_handle->line_to_highlight = 7 - (menu_handle->last_visible_option - menu_handle->selected_option);
            }
        }
        menu_handle->prev_selected_option = menu_handle->selected_option;
    }
    // Shifting of the currently showed items is not needed
    else {
        // Select first item in the list
        if(menu_handle->selected_option == menu_handle->first_visible_option) {
            menu_handle->line_to_highlight = 1;
        }
        // Select next item in the list (positive direction)
        else if(menu_handle->selected_option > menu_handle->prev_selected_option) {
            menu_handle->line_to_highlight = menu_handle->selected_option + 1;
        }
        // Select next item in the list (negative direction)
        else if(menu_handle->selected_option < menu_handle->prev_selected_option) {
            menu_handle->line_to_highlight = menu_handle->options_count - (menu_handle->last_visible_option - menu_handle->selected_option);
        }
        else if(menu_handle->selected_option == menu_handle->last_visible_option) {
            menu_handle->line_to_highlight = menu_handle->selected_option + 1;
        }
        menu_handle->prev_selected_option = menu_handle->selected_option;
    }
 
    // Draw item list on the screen
    uint8_t line_counter = 0;
    for(uint8_t i = menu_handle->first_visible_option; i <= menu_handle->last_visible_option; i++) {
        line_counter++;
        ssd1309_draw_text(menu_handle->options[i],
            get_str_len(menu_handle->options[i]), line_counter, false);
    }
 
    // Simulate selection by inverting the value of pixels
    ssd1309_invert_line(menu_handle->line_to_highlight, false);
 
    ssd1309_draw_text(menu_handle->title, 16, 8, false);
 
    return ERR_OK;
}

Here is the call graph for this function:

Here is the caller graph for this function:

menu_dataview_run()

ERR_te menu_dataview_run ( MENU_HANDLE_ts * menu_handle )

static

Renders a MENU_TYPE_DATA_VIEW menu to the display.

Behaves like menu_selectable_run for window and highlight tracking, but renders alternating rows: even-indexed rows display the static option label, odd-indexed rows display the live value returned by MENU_CFG_ts::get_value_fn for the corresponding option index.

Parameters

[in,out]

menu_handle

Pointer to the menu handle to render.

Returns

• ERR_OK on success
• ERR_DATA_ACQUISITION_FAILURE if MENU_CFG_ts::get_value_fn returns an error

Definition at line 540 of file menu.c.

                                                             {
    ERR_te err;
 
    // Clamp selected item if possible boundaries exceeded
    if(menu_handle->selected_option < 0) {
        menu_handle->selected_option = 0;
    }
    else if(menu_handle->selected_option >= menu_handle->options_count) {
        menu_handle->selected_option = menu_handle->options_count - 1;
    }
 
    // Items in options list is greater than 7, thus shifting of the currently showed items is needed
    if(menu_handle->options_count > 7) {
        // If selected item is outside (positive direction) of the currently showed items list shift
        // the window by one in positive direction
        if(menu_handle->selected_option > menu_handle->last_visible_option) {
            menu_handle->first_visible_option++;
            menu_handle->last_visible_option++;
        }
        // Opposite direction
        else if (menu_handle->selected_option < menu_handle->first_visible_option) {
            menu_handle->first_visible_option--;
            menu_handle->last_visible_option--;
        }
 
        // If selection reached last visible item, shift selection in positive direction
        if(menu_handle->selected_option == menu_handle->last_visible_option) {
            menu_handle->line_to_highlight = 7;
        }
        // If selection reached first item, shift selection in negative direction
        else if(menu_handle->selected_option == menu_handle->first_visible_option) {
            menu_handle->line_to_highlight = 1;
        }
        // If selection is in-between, change selection
        else {
            // In positive direction
            if(menu_handle->selected_option > menu_handle->prev_selected_option) {
                menu_handle->line_to_highlight = menu_handle->selected_option + 1;
            }
            // In negative direction
            else if(menu_handle->selected_option < menu_handle->prev_selected_option) {
                menu_handle->line_to_highlight = 7 - (menu_handle->last_visible_option - menu_handle->selected_option);
            }
        }
        menu_handle->prev_selected_option = menu_handle->selected_option;
    }
    // Shifting of the currently showed items is not needed
    else {
        // Select first item in the list
        if(menu_handle->selected_option == menu_handle->first_visible_option) {
            menu_handle->line_to_highlight = 1;
        }
        // Select next item in the list (positive direction)
        else if(menu_handle->selected_option > menu_handle->prev_selected_option) {
            menu_handle->line_to_highlight = menu_handle->selected_option + 1;
        }
        // Select next item in the list (negative direction)
        else if(menu_handle->selected_option < menu_handle->prev_selected_option) {
            menu_handle->line_to_highlight = menu_handle->options_count - (menu_handle->last_visible_option - menu_handle->selected_option);
        }
        else if(menu_handle->selected_option == menu_handle->last_visible_option) {
            menu_handle->line_to_highlight = menu_handle->selected_option + 1;
        }
        menu_handle->prev_selected_option = menu_handle->selected_option;
    }
 
    // Draw item list on the screen
    uint8_t line_counter = 0;
    uint8_t real_counter = 0;
 
    if(menu_handle->first_visible_option > 0)
        real_counter = menu_handle->first_visible_option / 2;
 
    for(uint8_t i = menu_handle->first_visible_option; i <= menu_handle->last_visible_option; i++) {
        line_counter++;
        // Counter is at option label row
        if(i % 2 == 0) {
            ssd1309_draw_text(menu_handle->options[real_counter],
                get_str_len(menu_handle->options[real_counter]), line_counter, false);
        }
        // Counter is at live value row
        else {
            char *value;
 
            err = menu_handle->get_value_fn(real_counter, &value);
            if(err != ERR_OK) {
                return ERR_DATA_ACQUISITION_FAILURE;
            }
 
            ssd1309_draw_text(value,
                get_str_len(value),
                line_counter, false);
 
            real_counter++;
        }
    }
 
    // Simulate selection by inverting the value of pixels
    ssd1309_invert_line(menu_handle->line_to_highlight, false);
 
    ssd1309_draw_text(menu_handle->title, 16, 8, false);
 
    return ERR_OK;
}

Here is the call graph for this function:

Here is the caller graph for this function: