277 lines
8.2 KiB
C
277 lines
8.2 KiB
C
/**
|
||
* @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 emoji 动画类型枚举
|
||
*/
|
||
typedef enum {
|
||
LISA_UI_EMOJI_UNKNOW = 0,
|
||
LISA_UI_EMOJI_LOVE,
|
||
LISA_UI_EMOJI_SAD,
|
||
LISA_UI_EMOJI_LAUGH,
|
||
LISA_UI_EMOJI_SQUINT,
|
||
LISA_UI_EMOJI_ANGRY,
|
||
LISA_UI_EMOJI_EYE,
|
||
LISA_UI_EMOJI_BLINK,
|
||
LISA_UI_EMOJI_HUG,
|
||
LISA_UI_EMOJI_PUZZLED,
|
||
LISA_UI_EMOJI_WAKEUP,
|
||
LISA_UI_EMOJI_SLEEPY,
|
||
LISA_UI_EMOJI_WAIT,
|
||
LISA_UI_EMOJI_BATTERY,
|
||
LISA_UI_EMOJI_CHARGING,
|
||
LISA_UI_EMOJI_START_BATTERY_CHANGE,
|
||
LISA_UI_EMOJI_HAPPY,
|
||
LISA_UI_EMOJI_CUTE,
|
||
LISA_UI_EMOJI_MAX,
|
||
} lisa_ui_emoji_type_e;
|
||
|
||
/**
|
||
* @brief LLM UI主要组件结构体
|
||
*
|
||
* 继承自LLM UI基础组件，添加具体的任务栏元素和容器内容
|
||
*/
|
||
struct lisa_ui_llm_primary {
|
||
lisa_ui_llm_base_t base_obj; /*!< 基础对象 */
|
||
|
||
/* 任务栏元素 */
|
||
lv_obj_t *wifi_icon; /*!< WiFi图标 */
|
||
lv_obj_t *status_label; /*!< 状态文本标签 */
|
||
lv_obj_t *battery_icon; /*!< 电量图标 */
|
||
|
||
/* 容器内容元素 */
|
||
lv_obj_t *emoji_container; /*!< emoji 动画容器 */
|
||
lv_obj_t *emoji_img; /*!< emoji 动画图片 */
|
||
lv_obj_t *content_container; /*!< 内容文本容器 */
|
||
lv_obj_t *content_label; /*!< 内容文本标签 */
|
||
|
||
/* 动画相关 */
|
||
const void **emoji_images; /*!< emoji 图片数组 */
|
||
uint32_t emoji_images_count; /*!< emoji 图片数量 */
|
||
uint32_t current_emoji_frame; /*!< 当前动画帧 */
|
||
uint32_t first_frame_delay; /*!< 第一帧延迟时间(毫秒) */
|
||
uint32_t frame_duration; /*!< 每帧时长(毫秒) */
|
||
lv_timer_t *emoji_timer; /*!< emoji动画定时器 */
|
||
bool is_first_frame_delayed; /*!< 是否正在第一帧延迟中 */
|
||
|
||
/* 循环播放控制 */
|
||
uint32_t loop_count; /*!< 当前循环次数 */
|
||
uint32_t target_loops; /*!< 目标循环次数，0表示无限循环 */
|
||
bool loop_mode_enabled; /*!< 是否启用循环模式 */
|
||
};
|
||
|
||
/** 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);
|
||
|
||
/**
|
||
* @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 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);
|
||
|
||
/*===========================================
|
||
* 内联函数
|
||
*==========================================*/
|
||
|
||
/**
|
||
* @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);
|
||
}
|
||
|
||
#ifdef __cplusplus
|
||
} /* extern "C" */
|
||
#endif
|
||
|
||
#endif /* __LISA_UI_LLM_PRIMARY_H__ */
|