工具生成API接口文档

/**
 * 获取指定ID资源的路径
 * @param id 资源ID
 * @return 资源路径字符串指针
 */
char * gui_get_res_path(int32_t id)

/**
 * 获取指定ID事件的回调函数
 * @param id 事件ID
 * @return 事件回调函数指针
 */
lv_event_cb_t gui_get_event_cb(int32_t id)

/**
 * 事件回调弱函数
 * @param e LVGL事件对象指针
 */
void res_event_$eventName$(lv_event_t *e);

/**
 * 加载页面并应用指定动画效果
 * @param ui UI上下文指针
 * @param screen 目标页面指针
 * @param anim_type 动画类型
 * @param time 动画持续时间
 * @param delay 动画延迟时间
 * @param is_clean 是否清理旧页面(lv_obj_clear(scr))
 * @param auto_del 是否自动删除
 * @param is_push_satck 是否推入页面栈
 */
void ui_load_scr_anim(lv_ui *ui, gui_scr_t *screen, lv_scr_load_anim_t anim_type, uint32_t time,
                      uint32_t delay, bool is_clean, bool auto_del, bool is_push_satck)

/**
 * 从页面栈中弹出页面并加载，可应用动画效果
 * @param ui UI上下文指针
 * @param anim_type 动画类型
 * @param time 动画持续时间
 * @param delay 动画延迟时间
 * @param is_clean 是否清理旧页面(lv_obj_clear(scr))
 * @param auto_del 是否自动删除
 * @param is_push_satck 是否推入页面栈
 */
void ui_scr_stack_pop_anim(lv_ui *ui, lv_scr_load_anim_t anim_type, uint32_t time, uint32_t delay,
                           bool is_clean, bool auto_del, bool is_push_satck)

/**
 * 获取指定ID的页面
 * @param scr_id 页面ID
 * @return 页面结构体指针
 */
gui_scr_t * ui_get_scr(int32_t scr_id)

/**
 * 获取已初始化的指定ID页面
 * @param scr_id 页面ID
 * @return 已初始化页面结构体指针
 */
gui_scr_t * ui_get_setup_scr(int32_t scr_id)

/**
 * 判断指定页面是否为当前活动页面
 * @param scr_id 页面ID
 * @return 如果是活动页面返回true，否则返回false
 */
bool ui_is_act_scr(int32_t scr_id)

/**
 * 初始化整个UI系统
 * @param ui UI上下文指针
 */
void setup_ui(lv_ui *ui)

/**
 * 页面初始化函数声明
 * @param ui UI上下文指针
 * @return 页面对象指针
 */
lv_obj_t * setup_scr_$pageName$(lv_ui *ui)

/**
 * 页面卸载函数声明
 * @param ui UI上下文指针
 */
void unload_scr_$pageName$(lv_ui *ui)

/**
 * 页面初始化实现，在对应的setup_scr_$pageName$.c文件中定义
 * @param ui UI上下文指针
 * @return 页面对象指针
 */
lv_obj_t * setup_scr_$pageName$(lv_ui *ui)

/**
 * 页面卸载实现，在对应的setup_scr_$pageName$.c文件中定义
 * @param ui UI上下文指针
 */
void unload_scr_$pageName$(lv_ui *ui)

/**
 * 初始化控件默认样式变量(ui_style.h)
 */
void ui_style_init(void)

/**
 * 给控件设置默认样式(ui_style.h)
 * @param obj 控件对象指针
 * @param type 控件类型
 */
void ui_style_set(lv_obj_t * obj, gui_ctrl_type_t type)

/**
 * 初始化页面管理(ui_scr_manager.h)
 */
void ui_scr_manager_init(void)

/**
 * 初始化全局事件(events_init.h)
 * @param ui UI上下文指针
 */
void events_init(lv_ui *ui)

/**
 * 初始化指定页面的事件(events_init.h)
 * @param ui UI上下文指针
 */
void events_init_$pageName$(lv_ui *ui)

/**
 * 刷新指定页面的多国语言文本(i18n_handler.h)
 * @param scr_id 页面ID
 */
void i18n_refresh_texts(int32_t scr_id)

/**
 * 刷新所有已初始化页面的多国语言文本(i18n_handler.h)
 */
void i18n_refresh_all_texts()

/**
 * 页面加载/卸载回调函数(screen_handler.h)
 * @param id 页面ID
 * @param action 页面操作类型
 */
GUI_WEAKREF void gui_scr_action_cb(gui_screen_id_t id, gui_screen_action_t action)

/**
 * 初始化应用程序中使用的所有字体
 */
void init_gui_fonts()

/**
 * 声明图片资源，每个图片C文件都有对应的_$image_name$_(alpha).c文件
 */
LV_IMG_DECLARE(_Menu_14Sleep_alpha111x88)

/**
 * 声明Lottie动画资源，每个Lottie C文件都有对应的$lottie_name$.c文件
 */
#define LV_LOT_DECLARE(array_name) const uint8_t array_name[];
LV_LOT_DECLARE(lottie_daku)

/**
 * 初始化控件组
 */
void gui_group_init()

/**
 * 设置默认控件组
 * @param group 控件组指针
 */
void gui_group_set_default(lv_group_t *group)

/**
 * 添加或移除控件到控件组
 * @param group 控件组指针
 * @param obj 控件对象指针
 * @param is_add true表示添加，false表示移除
 */
void gui_group_add_obj(lv_group_t *group, lv_obj_t *obj, bool is_add)

/**
 * 获取指定原始文本的翻译文本
 * @param msg_id 原始文本
 * @return 翻译后的文本字符串
 */
const char * lv_i18n_get_text(const char * msg_id)

/**
 * 获取指定原始文本的复数形式翻译文本
 * @param msg_id 原始文本
 * @param num 数量
 * @return 根据数量确定的翻译文本
 */
const char * lv_i18n_get_text_plural(const char * msg_id, int num)

/**
 * 获取当前语言设置
 * @return 当前语言代码字符串
 */
const char * lv_i18n_get_current_locale(void)

/**
 * 获取翻译文本和字体的宏定义
 */
#define _(text) lv_i18n_get_text(text)
#define _p(text, num) lv_i18n_get_text_plural(text, num)
#define _font(text) lv_i18n_get_font(text)

/**
 * 初始化模型绑定系统
 */
void gui_msg_init()

/**
 * 初始化UI绑定
 */
void gui_msg_init_ui()

/**
 * 初始化事件绑定
 */
void gui_msg_init_events()

/**
 * 取消订阅所有模型绑定
 */
void gui_msg_unsubscribe()

/**
 * 发送模型消息
 * @param msg_id 消息ID
 * @param value 消息值指针
 * @param len 消息值长度（只有消息类型为数组时传入才有意义）
 * @return 消息发送状态
 */
gui_msg_status_t gui_msg_send(int32_t msg_id, void * value, int32_t len)

/**
 * 获取当前模型发送状态
 * @return 消息发送状态
 */
gui_msg_send_status_t gui_msg_get_send_status()

/**
 * 获取指定ID的模型数据
 * @param msg_id 消息ID
 * @return 模型数据指针
 */
gui_msg_data_t * gui_msg_get(int32_t msg_id)
// 工具生成的默认实现
gui_msg_data_t * gui_msg_get_guider(int32_t msg_id);

/**
 * 修改模型动作
 * @param msg_id 消息ID
 * @param access 访问动作类型
 * @param data 数据指针
 * @param type 数据类型
 */
void gui_msg_action_change(int32_t msg_id, gui_msg_action_t access, gui_msg_data_t * data, gui_msg_data_type_t type)
// 工具生成的默认实现
void gui_msg_action_change_guider(int32_t msg_id, gui_msg_action_t access, gui_msg_data_t * data, gui_msg_data_type_t type);

/**
 * 修改模型订阅状态
 * @param msg_id 消息ID
 * @param sub_type 订阅类型
 */
void gui_msg_subscribe_change(int32_t msg_id, gui_msg_subscribe_t sub_type)
// 工具生成的默认实现
void gui_msg_subscribe_change_guider(int32_t msg_id, gui_msg_subscribe_t sub_type);

/**
 * 获取订阅对象中的subject
 * @param msg_id 消息ID
 * @return subject对象指针
 */
lv_subject_t * gui_msg_get_subject(int32_t msg_id)

/**
 * 获取订阅对象
 * @param msg_id 消息ID
 * @return 订阅对象指针
 */
gui_msg_sub_t * gui_msg_get_sub(int32_t msg_id)

/**
 * 创建订阅对象
 * @param msg_id 消息ID
 * @return 订阅对象指针
 */
gui_msg_sub_t * gui_msg_create_sub(int32_t msg_id)

/**
 * 获取模型数据
 * @return 模型数据指针
 */
gui_msg_data_t * gui_msg_get_data()

/**
 * 获取指定模型的数据类型
 * @param msg_id 消息ID
 * @return 数据类型
 */
gui_msg_data_type_t gui_msg_get_data_type(int32_t msg_id)

/**
 * 获取指定模型数据的数组类型
 * @param msg_id 消息ID
 * @return 数组类型
 */
gui_msg_array_type_t gui_msg_get_data_array_type(int32_t msg_id)

/**
 * 获取模型名称
 * @param msg_id 消息ID
 * @return 模型名称字符串
 */
char * gui_msg_get_name(int32_t msg_id)

/**
 * 判断是否订阅
 * @param subject subject对象指针
 * @param cb 观察者回调函数指针
 * @param obj 控件对象指针
 * @param user_data 用户数据指针
 * @return 如果有观察者返回true，否则返回false
 */
bool gui_msg_has_observer(lv_subject_t * subject, lv_observer_cb_t cb, lv_obj_t * obj, void * user_data)

/**
 * 设置控件的消息订阅
 * @param subscribe_enabled 是否启用订阅
 * @param event_enabled 是否启用事件
 * @param subject subject对象指针
 * @param target_obj 目标控件对象指针
 * @param msg_data 消息数据指针
 * @param observer_cb 观察者回调函数指针
 * @param msg_id 消息ID
 * @param msg_action 消息动作类型
 * @param data_type 数据类型
 * @param event_cb 事件回调函数指针
 */
void gui_msg_setup_component(bool subscribe_enabled, bool event_enabled, lv_subject_t *subject, lv_obj_t *target_obj, gui_msg_data_t *msg_data, lv_observer_cb_t observer_cb, int32_t msg_id, gui_msg_action_t msg_action, gui_msg_data_type_t data_type, lv_event_cb_t event_cb)

// gui_$msgName$_msg.h

//初始化模型绑定
void gui_$msgName$_msg_init(lv_ui *ui);

//初始化UI
void gui_$msgName$_msg_init_ui();

//初始化控件事件，订阅模型消息
void gui_$msgName$_msg_init_events();

//取消订阅所有模型绑定
void gui_$msgName$_msg_unsubscribe();

//发送模型消息
gui_msg_status_t gui_$msgName$_msg_send(int32_t msg_id, void * value, int32_t len);

/**
 * 初始化时间轴动画
 * @param ui UI上下文指针
 */
void gui_timelines_init(lv_ui *ui)

/**
 * 停止所有时间轴动画
 */
void gui_timelines_stop()

/**
 * 删除所有时间轴动画
 */
void gui_timelines_delete()

/**
 * 设置动画变量
 * @param anim 动画对象指针
 * @param obj 控件对象指针
 * @param exec_cb 执行回调函数指针
 * @param data 动画数据
 */
void gui_anim_set_var(lv_anim_t *anim, lv_obj_t *obj, lv_anim_exec_xcb_t exec_cb, gui_anim_data_t data)

/**
 * 启动指定的时间轴动画
 * @param timeline 时间轴对象指针
 */
void gui_timeline_start(gui_timeline_t *timeline)

/**
 * 停止指定的时间轴动画
 * @param timeline 时间轴对象指针
 */
void gui_timeline_stop(gui_timeline_t *timeline)

/**
 * 删除指定的时间轴动画
 * @param timeline 时间轴对象指针
 */
void gui_timeline_delete(gui_timeline_t *timeline)

/**
 * 设置时间轴动画的周期
 * @param timeline 时间轴对象指针
 * @param period 周期时间（毫秒）
 */
void gui_timeline_set_period(gui_timeline_t *timeline, uint32_t period)

/**
 * 设置时间轴动画的重复次数
 * @param timeline 时间轴对象指针
 * @param count 重复次数（-1表示无限循环）
 */
void gui_timeline_set_repeat_count(gui_timeline_t *timeline, int32_t count)

/**
 * 设置控件属性/样式的动画回调函数
 * @param var 动画变量指针
 * @param v 当前动画值
 */
void gui_anim_set_$prop/style$(void * var, int32_t v);

// gui_$timelineName$_timeline.h

//初始化时间轴动画
extern int32_t gui_$timelineName$_timeline_init(lv_ui *ui)