chore: migrate project into clean repository

apps-ui/apps/llm/views/lisa_ui_llm_primary.h

@@ -0,0 +1,297 @@
+/**
+ * @file lisa_ui_llm_primary.h
+ * @brief LLM UI主要组件头文件
+ *
+ * 继承自LLM UI基础组件，提供具体的任务栏元素实现，
+ * 包括WiFi图标、状态文本，以及容器中的emoji动画和文本显示。
+ *
+ * @version 1.0.0
+ * @date 2024
+ * @author Lisa UI Team
+ */
+
+#ifndef __LISA_UI_LLM_PRIMARY_H__
+#define __LISA_UI_LLM_PRIMARY_H__
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/*===========================================
+ * 包含文件
+ *==========================================*/
+#include "lisa_ui_llm_base.h"
+#include "lvgl.h"
+#include <stdint.h>
+#include <stdbool.h>
+
+/*===========================================
+ * 宏定义
+ *==========================================*/
+/** 状态文本最大长度 */
+#define LISA_UI_LLM_PRIMARY_MAX_STATUS_LENGTH 32
+
+/** 内容文本最大长度 */
+#define LISA_UI_LLM_PRIMARY_MAX_CONTENT_LENGTH 256
+
+/** 类型检查宏 */
+#define LISA_UI_LLM_PRIMARY_CLASS_CHECK(obj) (lv_obj_has_class(obj, &lisa_ui_llm_primary_class))
+
+/** 根据每帧时长计算总动画时长的辅助宏 */
+#define LISA_UI_LLM_DURATION_BY_FRAME(frame_duration_ms, frame_count) ((frame_duration_ms) * (frame_count))
+
+/**
+ * @brief LLM UI主要组件结构体
+ *
+ * 继承自LLM UI基础组件，添加具体的任务栏元素和容器内容
+ */
+struct lisa_ui_llm_primary {
+    lisa_ui_llm_base_t base_obj; /*!< 基础对象 */
+
+    /* 任务栏元素 */
+#ifndef CONFIG_BOARD_ARCS_MINI
+    lv_obj_t *settings_icon; /*!< 设置图标 */
+#endif
+    lv_obj_t *wifi_icon;     /*!< WiFi图标 */
+    lv_obj_t *full_duplex_icon; /*!< 交互模式图标（全双工） */
+    lv_obj_t *alarm_icon;    /*!< 闹钟图标 */
+    lv_obj_t *battery_icon;  /*!< 电量图标 */
+    lv_obj_t *status_label;  /*!< 状态文本标签 */
+
+    /* 容器内容元素 */
+    lv_obj_t *emoji_container;   /*!< emoji 动画容器 */
+    lv_obj_t *emoji_anim;         /*!< emoji 动画图片 */
+    lv_obj_t *content_container; /*!< 内容文本容器 */
+    lv_obj_t *content_label;     /*!< 内容文本标签 */
+    lv_obj_t *img;
+    lv_obj_t *img_hint;
+};
+
+/** LLM UI主要组件类型定义 */
+typedef struct lisa_ui_llm_primary lisa_ui_llm_primary_t;
+
+/*===========================================
+ * 全局变量声明
+ *==========================================*/
+
+/** LLM UI主要组件类定义 */
+extern const lv_obj_class_t lisa_ui_llm_primary_class;
+
+/*===========================================
+ * 函数声明
+ *==========================================*/
+
+/**
+ * @brief 创建LLM UI主要组件
+ *
+ * @param parent 父对象，如果为NULL则使用当前活动屏幕
+ * @return lv_obj_t* 创建的LLM UI主要组件对象，失败返回NULL
+ *
+ * @note 该函数会自动创建任务栏的所有元素和容器内容
+ *
+ * @code
+ * // 创建LLM UI主要组件
+ * lv_obj_t *llm_ui = lisa_ui_llm_primary_create(lv_scr_act());
+ * if (llm_ui != NULL) {
+ *     // 组件创建成功，包含完整的任务栏和内容区域
+ * }
+ * @endcode
+ */
+lv_obj_t *lisa_ui_llm_primary_create(lv_obj_t *parent);
+
+#ifndef CONFIG_BOARD_ARCS_MINI
+/**
+ * @brief 获取设置图标对象
+ *
+ * @param obj LLM UI主要组件对象
+ * @return lv_obj_t* 设置图标对象，失败返回NULL
+ */
+lv_obj_t *lisa_ui_llm_primary_settings_icon_get(lv_obj_t *obj);
+#endif
+
+/**
+ * @brief 获取WiFi图标对象
+ *
+ * @param obj LLM UI主要组件对象
+ * @return lv_obj_t* WiFi图标对象，失败返回NULL
+ */
+lv_obj_t *lisa_ui_llm_primary_wifi_icon_get(lv_obj_t *obj);
+
+/**
+ * @brief 获取状态文本标签对象
+ *
+ * @param obj LLM UI主要组件对象
+ * @return lv_obj_t* 状态文本标签对象，失败返回NULL
+ */
+lv_obj_t *lisa_ui_llm_primary_status_label_get(lv_obj_t *obj);
+
+/**
+ * @brief 获取电量图标对象
+ *
+ * @param obj LLM UI主要组件对象
+ * @return lv_obj_t* 电量图标对象，失败返回NULL
+ */
+lv_obj_t *lisa_ui_llm_primary_battery_icon_get(lv_obj_t *obj);
+
+/**
+ * @brief 获取emoji动画图片对象
+ *
+ * @param obj LLM UI主要组件对象
+ * @return lv_obj_t* emoji动画图片对象，失败返回NULL
+ */
+lv_obj_t *lisa_ui_llm_primary_emoji_img_get(lv_obj_t *obj);
+
+/**
+ * @brief 获取内容文本标签对象
+ *
+ * @param obj LLM UI主要组件对象
+ * @return lv_obj_t* 内容文本标签对象，失败返回NULL
+ */
+lv_obj_t *lisa_ui_llm_primary_content_label_get(lv_obj_t *obj);
+
+/**
+ * @brief 设置状态文本
+ *
+ * @param obj LLM UI主要组件对象
+ * @param status 状态文本，如果为NULL则清空状态
+ *
+ */
+void lisa_ui_llm_primary_set_status_text(lv_obj_t *obj, const char *status);
+
+/**
+ * @brief 设置内容文本
+ *
+ * @param obj LLM UI主要组件对象
+ * @param content 内容文本，如果为NULL则清空内容
+ *
+ */
+void lisa_ui_llm_primary_set_content_text(lv_obj_t *obj, const char *content);
+
+/**
+ * @brief 设置内容文本(追加)
+ *
+ * @param obj LLM UI主要组件对象
+ * @param content 内容文本，如果为NULL则清空内容
+ *
+ */
+void lisa_ui_llm_primary_add_content_text(lv_obj_t *obj, const char *content);
+
+/**
+ * @brief 设置WiFi图标显示状态
+ *
+ * @param obj LLM UI主要组件对象
+ * @param img_path 图片路径，如果为NULL则不显示WiFi图标
+ */
+void lisa_ui_llm_primary_set_wifi_img(lv_obj_t *obj, const void *img_path);
+
+/**
+ * @brief 设置交互模式图标显示状态
+ *
+ * @param obj LLM UI主要组件对象
+ * @param visible true显示，false隐藏
+ */
+void lisa_ui_llm_primary_set_full_duplex_icon_visible(lv_obj_t *obj, bool visible);
+
+/**
+ * @brief 设置闹钟图标显示状态
+ *
+ * @param obj LLM UI主要组件对象
+ * @param visible true显示，false隐藏
+ */
+void lisa_ui_llm_primary_set_alarm_icon_visible(lv_obj_t *obj, bool visible);
+
+/**
+ * @brief 设置电量图标显示状态
+ *
+ * @param obj LLM UI主要组件对象
+ * @param img_path 图片路径，如果为NULL则隐藏图标
+ */
+void lisa_ui_llm_primary_set_battery_img(lv_obj_t *obj, const void *img_path);
+
+/**
+ * @brief 启动emoji动画
+ *
+ * @param obj LLM UI主要组件对象
+ */
+void lisa_ui_llm_primary_start_emoji_animation(lv_obj_t *obj);
+
+/**
+ * @brief 停止emoji动画
+ *
+ * @param obj LLM UI主要组件对象
+ */
+void lisa_ui_llm_primary_stop_emoji_animation(lv_obj_t *obj);
+
+/**
+ * @brief 设置自定义emoji动画图片
+ *
+ * @param obj LLM UI主要组件对象
+ * @param images 图片数组指针
+ * @param images_count 图片数量
+ * @param duration 动画时长(毫秒)
+ * @param first_frame_delay 第一帧停留时间(毫秒)，0表示无延迟
+ */
+void lisa_ui_llm_primary_set_custom_emoji_animation(lv_obj_t *obj, const void **images, uint32_t images_count,
+                                                    uint32_t duration, uint32_t first_frame_delay);
+
+/**
+ * @brief 设置emoji动画循环参数
+ *
+ * @param obj LLM UI主要组件对象
+ * @param loop_count 循环次数，0表示无限循环
+ */
+void lisa_ui_llm_primary_set_loop_count(lv_obj_t *obj, uint32_t loop_count);
+
+#ifndef CONFIG_BOARD_ARCS_MINI
+/**
+ * @brief 设置设置图标事件回调
+ *
+ * @param obj LLM UI主要组件对象
+ * @param event_cb 事件回调函数
+ * @param user_data 用户数据
+ */
+void lisa_ui_llm_primary_set_settings_icon_event_cb(lv_obj_t *obj, lv_event_cb_t event_cb, void *user_data);
+#endif
+
+/**
+ * @brief 显示拍照图片到表情容器
+ *
+ * @param obj LLM UI主要组件对象
+ * @param rgb565_data RGB565图片数据
+ * @param width 图片宽度
+ * @param height 图片高度
+ */
+void lisa_ui_llm_primary_show_camera_image(lv_obj_t *obj, const uint16_t *rgb565_data, uint32_t width, uint32_t height);
+
+/**
+ * @brief 隐藏拍照图片
+ *
+ * @param obj LLM UI主要组件对象
+ */
+void lisa_ui_llm_primary_hide_camera_image(lv_obj_t *obj);
+lv_obj_t *lisa_ui_llm_primary_emoji_anim_get(lv_obj_t *obj);
+/*===========================================
+ * 内联函数
+ *==========================================*/
+
+/**
+ * @brief 检查对象是否为LLM UI主要组件类型
+ *
+ * @param obj 要检查的对象
+ * @return true 是LLM UI主要组件类型
+ * @return false 不是LLM UI主要组件类型
+ */
+static inline bool lisa_ui_llm_primary_is_valid(lv_obj_t *obj)
+{
+    return (obj != NULL) && LISA_UI_LLM_PRIMARY_CLASS_CHECK(obj);
+}
+void lisa_ui_llm_primary_img_show(lv_obj_t *obj, void *img);
+void lisa_ui_llm_primary_img_hide(lv_obj_t *obj);
+void lisa_ui_llm_primary_img_hint_show(lv_obj_t *obj, const char *text);
+void lisa_ui_llm_primary_img_hint_hide(lv_obj_t *obj);
+
+#ifdef __cplusplus
+} /* extern "C" */
+#endif
+
+#endif /* __LISA_UI_LLM_PRIMARY_H__ */