ui_widget_mgr.h

Go to the documentation of this file.

/*******************************************************************************
 * File Name: ui_widget_mgr.h
 *
 * Description: Widget handle table and LVGL widget lifecycle manager.
 *              Maps handle IDs (0-31) to lv_obj_t* pointers.
 *              Creates, modifies, deletes LVGL widgets in GFX task context.
 *
 *******************************************************************************/
 
#ifndef UI_WIDGET_MGR_H
#define UI_WIDGET_MGR_H
 
#include "ipc_ui_protocol.h"
#include "lvgl.h"
#include <stdbool.h>
#include <stdint.h>

void ui_widget_mgr_init(lv_obj_t *parent);

void ui_widget_mgr_set_parent(lv_obj_t *parent);

bool ui_widget_mgr_needs_container(void);

int ui_widget_mgr_create(const ipc_ui_create_t *cfg);

int ui_widget_mgr_create_sprite(const lv_image_dsc_t *dsc, int16_t x, int16_t y);

void ui_widget_mgr_set_sprite_image(int handle, const lv_image_dsc_t *dsc);

void ui_widget_mgr_delete(int handle);

void ui_widget_mgr_clear_all(void);

void ui_widget_mgr_set_text(int handle, const char *text);

void ui_widget_mgr_set_value(int handle, int32_t value);

void ui_widget_mgr_set_position(int handle, int16_t x, int16_t y);

void ui_widget_mgr_set_size(int handle, int16_t w, int16_t h);

void ui_widget_mgr_set_color(int handle, uint32_t color);

void ui_widget_mgr_set_visible(int handle, bool visible);

void ui_widget_mgr_set_all_visible(bool visible);

int32_t ui_widget_mgr_get_value(int handle);

void ui_widget_mgr_set_dotmatrix(int handle, const uint8_t *bitmap, uint8_t len);

void ui_widget_mgr_set_image(int handle, uint16_t offset, const uint8_t *data, uint8_t len);

void ui_widget_mgr_event_push(uint8_t handle, uint8_t event_type, int32_t value);

int ui_widget_mgr_event_drain(ipc_ui_event_t *out, int max_events);

int ui_widget_mgr_count(void);

int ui_widget_mgr_list(ipc_ui_widget_info_t *out, int max_items);

lv_obj_t *ui_widget_mgr_get_parent(void);

void ui_widget_mgr_set_screen(int16_t width, int16_t height);

int ui_widget_mgr_chart_add_series(int handle, uint32_t color);

void ui_widget_mgr_chart_set_next(int handle, uint8_t series_idx, int32_t value);
 
 
/*******************************************************************************
 * Collections and containers (IPC_CMD_UI_ITEM_ADD / _ITEM_CLEAR / _SET_PROP)
 *
 * These three functions MUST exist, and behave the same way for the same widget
 * type, in BOTH ui_widget_mgr.c implementations — claw's and game's. The two
 * Infineon Game kits compile claw's ipc_ui.c against game's ui_widget_mgr.c, so
 * a type served here and not there renders on some boards and returns
 * UI_STATUS_INVALID_TYPE on others, with no build error anywhere.
 *******************************************************************************/

#define UI_ITEM_ADD_OK_NO_CHILD   (-3)

int ui_widget_mgr_item_add(const ipc_ui_item_add_t *it);

void ui_widget_mgr_item_clear(int handle);

void ui_widget_mgr_set_prop(int handle, uint8_t prop_id, int32_t value);

lv_obj_t *ui_widget_mgr_get_object(int handle);
 
#endif /* UI_WIDGET_MGR_H */