Menu Cellular

The menu cellular widget displays a set of icons in a honeycomb shape menu.

Usage

Config Offset

Function is gui_menu_cellular_offset(). Users are able to adjust horizontal and vertical offset for better display.

Example

GUI_APP_ENTRY(APP_MENU)
{
    /**
     * @link https://docs.realmcu.com/Honeygui/latest/widgets/gui_menu_cellular.html#example
    */
    gui_win_t *win = gui_win_create(GUI_APP_ROOT_SCREEN, APP_MENU_WIN_NAME, 0, 0, 0, 0);
    /* app swap animation configration of the next app*/
    uint32_t *array[] =
    {
        I4500009_BIN,
        I4500011_BIN,
        I4500015_BIN,
        I4500020_BIN,
        I4500028_BIN,
        I4500034_BIN,
        I4500035_BIN,
        I4500037_BIN,
        I4500040_BIN,
        I4500042_BIN,
        I4500047_BIN,
        I4500049_BIN,
        I4500052_BIN,
        I4500064_BIN,
        I4500009_BIN,
        I4500011_BIN,
        I4500015_BIN,
        I4500020_BIN,
        I4500028_BIN,
        I4500034_BIN,
        I4500035_BIN,
        I4500037_BIN,
        I4500040_BIN,
        I4500042_BIN,
        I4500047_BIN,
        I4500049_BIN,
        I4500052_BIN,
        I4500064_BIN,
        I4500009_BIN,
        I4500011_BIN,
        I4500015_BIN,
        I4500020_BIN,
        I4500028_BIN,
        I4500034_BIN,
        I4500035_BIN,
        I4500037_BIN,
        I4500040_BIN,
        I4500042_BIN,
        I4500047_BIN,
        I4500049_BIN,
        I4500052_BIN,
        I4500064_BIN,
        I4500009_BIN,
        I4500011_BIN,
        I4500015_BIN,
        I4500020_BIN,

    };

    gui_menu_cellular_t *cell = gui_menu_cellular_create(win, 100, array,
                                                         sizeof(array) / sizeof(uint32_t *));
    gui_menu_cellular_offset((void *)cell, -36, -216);
    {
        struct gui_menu_cellular_gesture_parameter gesture_parameter_array[] =
        {
            {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1},
            {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1},
            {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1},
            {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1},
            {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1},
            {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1},
            {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1},
            {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1},
            {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1}, {app_menu_cb, (void *)1},
            {app_menu_cb, (void *)1},
        };
        gui_menu_cellular_on_click(cell, gesture_parameter_array,
                                   sizeof(gesture_parameter_array) / sizeof(gesture_parameter_array[0]));

    }
    //status_bar(win, (void *)cell);
    gui_return_create(win, gui_app_return_array,
                      sizeof(gui_app_return_array) / sizeof(uint32_t *), win_cb, (void *)cell);
}

API

Functions

gui_menu_cellular_t *gui_menu_cellular_create(void *parent, int icon_size, uint32_t *icon_array[], int array_size)

Create a honeycomb effect widget.

Parameters:

parent – The father widget nested in.
icon_size – Icon’s width(px).
icon_array – Icons set’s file address array.
array_size – The array’s size.

Returns:

gui_menu_cellular_t*

void gui_menu_cellular_offset(gui_obj_t *menu_cellular, int offset_x, int offset_y)

Config offset.

Parameters:

menu_cellular – The menu_cellular pointer.
offset_x – Offset_x.
offset_y – Offset_y.

void gui_menu_cellular_on_click(gui_menu_cellular_t *menu_cellular, struct gui_menu_cellular_gesture_parameter *para_array, int array_length)

Listen to click events on the cellular menu.

It processes the click event based on the given gesture parameters.

Parameters:

menu_cellular – Pointer to the cellular menu structure.
para_array – Array of gesture parameters corresponding to the click event.
array_length – Length of the gesture parameters array.

gui_menu_cellular_t *gui_menu_cellular_create_ftl(void *parent, int icon_size, uint32_t *icon_array[], int array_size)

Create a honeycomb effect widget (ftl address mode).

Parameters:

parent – The father widget nested in.
icon_size – Icon’s width(px).
icon_array – Icons set’s file address array (ftl address mode).
array_size – The array’s size.

Returns:

gui_menu_cellular_t*

struct gui_menu_cellular_t

Menu_cellular structure.

Public Members

gui_win_t base: base structure

void *overwrite

int x

int y

int16_t speed[2]

int16_t left

int16_t right

int16_t top

int16_t bottom

int16_t left_offset

int16_t right_offset

int16_t top_offset

int16_t bottom_offset

int16_t touch_y

bool render

struct gui_menu_cellular_gesture_parameter

Public Members

gui_event_cb_t callback_function

void *parameter

Menu Cellular

Usage

Create Menu Cellular Widget

Config Offset

Example

API