huxi
886 lines
27 KiB
C
886 lines
27 KiB
C
/* Copyright(C) 2010- , JIELI TECHNOLOGY, Inc.
|
||
* All right reserved.
|
||
*/
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @file ui.h
|
||
*
|
||
* @brief 杰理UI框架头文件
|
||
*
|
||
* @author JIELI TECHNOLOGY ZHUHAI
|
||
*
|
||
* @version V1.0.0
|
||
*
|
||
* @date 2024-06-04
|
||
*
|
||
* 注意：杰理UI框架在控件刷新时会触发on_change事件回调，
|
||
* 因此在on_change事件的回调中禁止调用含有redraw刷新的接口，
|
||
* 否则会进入递归引发不可预测的问题
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
|
||
#ifndef UI_CORE_H
|
||
#define UI_CORE_H
|
||
|
||
#include "ui_animation_utils.h"
|
||
#include "ui_animation_math.h"
|
||
#include "ui_animation.h"
|
||
|
||
#include "window.h"
|
||
#include "ui_button.h"
|
||
#include "ui_grid.h"
|
||
#include "ui_time.h"
|
||
#include "ui_camera.h"
|
||
#include "ui_pic.h"
|
||
#include "ui_text.h"
|
||
#include "ui_battery.h"
|
||
#include "ui_browser.h"
|
||
#include "ui_slider.h"
|
||
#include "ui_slider_vert.h"
|
||
#include "ui_number.h"
|
||
#include "ui_watch.h"
|
||
#include "ui_progress.h"
|
||
#include "ui_progress_multi.h"
|
||
#include "ui_rotate.h"
|
||
#include "ui_page_manager.h"
|
||
#include "ui_compass.h"
|
||
#include "ui_draw/ui_figure.h"
|
||
#include "ui_multi_page_manager.h"
|
||
#include "ui_draw/ui_obj.h"
|
||
|
||
#include <stdarg.h>
|
||
|
||
extern const int UI_DATA_STORE_IN_NORFLASH;
|
||
|
||
|
||
|
||
struct uimsg_handl {
|
||
const char *msg;
|
||
int (*handler)(const char *type, u32 args);
|
||
};
|
||
|
||
enum {
|
||
HIDE_WITH_REDRAW,
|
||
HIDE_WITHOUT_REDRAW,
|
||
};
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_framework_init ui框架初始化
|
||
*
|
||
* @param lcd配置句柄，在board.c文件配置
|
||
*
|
||
* @return 0
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_framework_init(void *);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_set_style_file 设置ui风格
|
||
*
|
||
* @param style ui风格资源句柄
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_set_style_file(struct ui_style *style);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_style_file_version_compare UI风格版本检查
|
||
*
|
||
* @param version 目标版本号
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_style_file_version_compare(int version);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_redraw UI控件刷新
|
||
*
|
||
* @param id 待刷新的UI控件ID(注意：凡刷新的动作，不允许在ONCHANGE事件中调用)
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_redraw(int id);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_show 设置UI控件为显示
|
||
*
|
||
* @param id UI控件ID
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_show(int id);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_hide 设置UI控件为隐藏
|
||
*
|
||
* @param id UI控件ID
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_hide(int id);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_set_call 设置页面回调
|
||
* (一般在ONCHANGE_INIT事件中使用，页面第一次显示完后会触发回调，回调中可调用redraw，可用
|
||
* 于图标等内容第一次显示时更新图标。回调被调用后，指针会被清空；即回调注册后只会被调用一
|
||
* 次)
|
||
*
|
||
* @param func 回调函数指针
|
||
* @param param 传给回调函数的参数
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_set_call(int (*func)(int), int param);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_event_onkey UI控件按键事件回调
|
||
*
|
||
* @param e 按键事件句柄
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_event_onkey(struct element_key_event *e);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_event_ontouch UI控件触摸事件回调
|
||
*
|
||
* @param e 触摸事件句柄
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_event_ontouch(struct element_touch_event *e);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_card_ontouch UI卡片触摸事件回调（已放到lcd_ui_api.c文件）
|
||
*
|
||
* @param e 触摸事件句柄
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_card_ontouch(struct element_touch_event *e);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_core_get_root
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
struct element *ui_core_get_root();
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_get_highlight_child_by_id 获取高亮的子控件
|
||
*
|
||
* @param id 控件ID
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
struct element *ui_get_highlight_child_by_id(int id);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_invert_element_by_id
|
||
*
|
||
* @param id
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_invert_element_by_id(int id);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_no_highlight_element 取消控件高亮（不带redraw）
|
||
*
|
||
* @param elm 控件句柄
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_no_highlight_element(struct element *elm);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_no_highlight_element_by_id 取消控件高亮（带redraw）
|
||
*
|
||
* @param id 控件ID
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_no_highlight_element_by_id(int id);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_highlight_element 设置控件高亮（不带redraw）
|
||
*
|
||
* @param elm 控件句柄
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_highlight_element(struct element *elm);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_highlight_element_by_id 设置控件高亮（带redraw）
|
||
*
|
||
* @param id 控件ID
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_highlight_element_by_id(int id);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_get_current_window_id 获取当前显示的window ID
|
||
*
|
||
* @return 当前显示的window ID
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_get_current_window_id();
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_page_switch 手动切换页面
|
||
*
|
||
* @param curr_win 当前页面ID
|
||
* @param next_win 下一个页面ID
|
||
* @param xoffset 移动步距
|
||
* @param mode 特效模式（暂时只有模式0）
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_page_switch(int curr_win, int next_win, int xoffset, int mode);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_register_msg_handler 注册指定控件的消息回调句柄
|
||
*
|
||
* @param id 控件ID
|
||
* @param handl 回调句柄
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_register_msg_handler(int id, const struct uimsg_handl *handl);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_message_handler
|
||
*
|
||
* @param id
|
||
* @param msg
|
||
* @param va_list
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_message_handler(int id, const char *msg, va_list);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief str_substr_iter
|
||
*
|
||
* @param str
|
||
* @param delim
|
||
* @param iter
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
const char *str_substr_iter(const char *str, char delim, int *iter);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_get_child_by_id
|
||
*
|
||
* @param id
|
||
* @param event_handler_cb
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_get_child_by_id(int id, int (*event_handler_cb)(void *, int, int));
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_set_default_handler
|
||
*
|
||
* @param ontouch
|
||
* @param onkey
|
||
* @param onchange
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_set_default_handler(struct element *elm, int (*ontouch)(void *, struct element_touch_event *),
|
||
int (*onkey)(void *, struct element_key_event *),
|
||
int (*onchange)(void *, enum element_change_event, void *));
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_ontouch_lock 触摸消息锁定发送给控件之外的区域
|
||
*
|
||
* @param elm 目标控件的元素
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
void ui_ontouch_lock(void *elm);
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_ontouch_unlock 释放控件之外的区域锁定
|
||
*
|
||
* @param elm 目标控件的元素
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
void ui_ontouch_unlock(void *elm);
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_lock_layer 锁定控件的父图层，先不推向imb显示
|
||
*
|
||
* @param id 控件ID
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_lock_layer(int id);
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_unlock_layer 释放控件的父图层，可以推向imb显示
|
||
*
|
||
* @param id 控件ID
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_unlock_layer(int id);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_get_disp_status_by_id 获取指定控件的显示状态(默认隐藏标志)
|
||
*
|
||
* @param id 待获取状态的控件ID
|
||
*
|
||
* @return false 显示，true 隐藏
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_get_disp_status_by_id(int id);
|
||
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief create_control_by_id 动态创建控件(将B工程的指定控件显示到A工程的指定容器中)
|
||
*
|
||
* @param tabfile 待创建控件的tab文件路径
|
||
* @param page_id 带创建控件所在PAGE ID
|
||
* @param id 待创建控件的ID
|
||
* @param parent_id 容器控件的ID
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int create_control_by_id(char *tabfile, int page_id, int id, int parent_id);
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief delete_control_by_id 删除动态创建的控件(一般与create_control_by_id成对使用)
|
||
*
|
||
* @param id 要删除的动态创建的控件ID
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int delete_control_by_id(int id);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_remove_backcolor 删除控件的背景颜色
|
||
*
|
||
* @param elm 待删除颜色的控件句柄
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
void ui_remove_backcolor(struct element *elm);
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_remove_backimage 删除控件的背景图
|
||
*
|
||
* @param elm 待删除背景图的控件句柄
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
void ui_remove_backimage(struct element *elm);
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_remove_border 删除控件的边框
|
||
*
|
||
* @param elm 待删除边框的控件句柄
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
void ui_remove_border(struct element *elm);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_fill_rect ui填充矩形
|
||
*
|
||
* @param dc UI框架句柄
|
||
* @param left 矩形left坐标
|
||
* @param top 矩形top坐标
|
||
* @param width 矩形宽度
|
||
* @param height 矩形高度
|
||
* @param acolor 填充颜色（带透明度）
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_fill_rect(struct draw_context *dc, int left, int top, int width, int height, u32 acolor);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_draw_image 自定义绘图方式显示图片
|
||
*
|
||
* @param dc 待显示的上下文句柄
|
||
* @param page 待显示图片所在页面
|
||
* @param id 待显示图片所在控件ID
|
||
* @param x 待显示图片将显示的X坐标
|
||
* @param y 待显示图片将显示的Y坐标
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_draw_image(struct draw_context *dc, int page, int id, int x, int y);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_draw_image_large 大图片截取显示
|
||
*
|
||
* @param dc 显示上下文
|
||
* @param page 页面号
|
||
* @param id 图片索引
|
||
* @param x 显示的X坐标(相对屏幕)
|
||
* @param y 显示的Y坐标(相对屏幕)
|
||
* @param width 显示宽度
|
||
* @param height 显示高度
|
||
* @param image_x 图片的X坐标(相对图片)
|
||
* @param image_y 图片的Y坐标(相对图片)
|
||
*
|
||
* @return -1 失败，0 正常
|
||
* @note 大图片显示具有尺寸限制，请留意工具或者代码提示信息
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_draw_image_large(struct draw_context *dc, int page, int id, int x, int y, int width, int height, int image_x, int image_y);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_draw_ascii 自定义合成ascii字符串显示
|
||
*
|
||
* @param dc 显示上下文
|
||
* @param str 字符串指针
|
||
* @param strlen 字符串长度
|
||
* @param x 字符串X坐标
|
||
* @param y 字符串Y坐标
|
||
* @param color 字符串显示颜色
|
||
*
|
||
* @return 0 正常，-1 失败
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_draw_ascii(struct draw_context *dc, char *str, int strlen, int x, int y, int color);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_draw_text 自定义显示字符串
|
||
*
|
||
* @param dc 显示上下文
|
||
* @param encode 编码格式
|
||
* @param endian 大小端
|
||
* @param str 字符串指针
|
||
* @param strlen 字符串长度
|
||
* @param x 显示X坐标
|
||
* @param y 显示Y坐标
|
||
* @param color 显示颜色
|
||
*
|
||
* @return 0 正常，-1 失败
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_draw_text(struct draw_context *dc, int encode, int endian, char *str, int strlen, int x, int y, int color);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_draw_strpic 显示多国语言excel表文本
|
||
*
|
||
* @param dc 显示上下文
|
||
* @param id 文本控件ID
|
||
* @param x 显示X坐标
|
||
* @param y 显示Y坐标
|
||
* @param color 文本颜色
|
||
*
|
||
* @return 0 正常，-1 失败
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_draw_strpic(struct draw_context *dc, int id, int x, int y, int color);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_draw_line 绘制直线
|
||
*
|
||
* @param _dc 显示上下文
|
||
* @param x0 直线起点X坐标
|
||
* @param y0 直线起点Y坐标
|
||
* @param x1 直线终点X坐标
|
||
* @param y1 直线终点Y坐标
|
||
* @param color 直线颜色
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
void ui_draw_line(void *_dc, int x0, int y0, int x1, int y1, int color);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_draw_line_by_angle 绘制指定角度的直线
|
||
*
|
||
* @param _dc 显示上下文
|
||
* @param x 直线起点X坐标
|
||
* @param y 直线起点Y坐标
|
||
* @param length 直线长度
|
||
* @param angle 直线角度
|
||
* @param color 直线颜色
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
void ui_draw_line_by_angle(void *_dc, int x, int y, int length, int angle, int color);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_draw_rect 绘制矩形填充
|
||
*
|
||
* @param _dc 显示上下文
|
||
* @param x 矩形左上角X坐标
|
||
* @param y 矩形左上角Y坐标
|
||
* @param width 矩形宽度
|
||
* @param height 矩形高度
|
||
* @param color 填充颜色
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
void ui_draw_rect(void *_dc, int x, int y, int width, int height, int color);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_draw_image_invert 绘制镜像图片（图片倒影）
|
||
*
|
||
* @param dc 绘图句柄
|
||
* @param page 页面
|
||
* @param id 资源id
|
||
* @param x left
|
||
* @param y top
|
||
* @param x_en 使能水平翻转：0不翻转 1向右翻转 2向左翻转
|
||
* @param y_en 使能垂直翻转：0不翻转 1向下翻转 2向上翻转
|
||
* @param x_dist 翻转后距离原图最近边界距离
|
||
* @param y_dist 翻转后距离原图最近边界距离
|
||
* @param alpha 反转后图片透明度
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_draw_image_invert(struct draw_context *dc, int page, int id, int x, int y, int x_en, int y_en, int x_dist, int y_dist, int alpha);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_draw_ring 绘制圆
|
||
*
|
||
* @param _dc 显示上下文
|
||
* @param x 圆心X坐标
|
||
* @param y 圆心Y坐标
|
||
* @param radius_big 圆形外径
|
||
* @param radius_small 圆形内径
|
||
* @param angle_begin 起始角度
|
||
* @param angle_end 结束角度
|
||
* @param color 颜色
|
||
* @param percent 绘制百分比
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
void ui_draw_ring(void *_dc, int x, int y, int radius_big, int radius_small, int angle_begin, int angle_end, int color, int percent);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_draw_bar 绘制水平进度条
|
||
*
|
||
* @param _dc 显示上下文句柄
|
||
* @param x 绘制的X坐标(左上角)
|
||
* @param y 绘制的Y坐标(右上角)
|
||
* @param width 绘制宽度
|
||
* @param height 绘制高度
|
||
* @param color 高亮颜色
|
||
* @param percent 高亮百分比
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
void ui_draw_bar(void *_dc, int x, int y, int width, int height, int color, int percent, int wait_sync);
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_draw_alpha_bar 透明度圆环
|
||
*
|
||
* @param _dc
|
||
* @param x
|
||
* @param y
|
||
* @param width
|
||
* @param height
|
||
* @param color
|
||
* @param percent (0-100)
|
||
* @param alpha (0-255)
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
void ui_draw_alpha_bar(void *_dc, int x, int y, int width, int height, int color, int percent, int alpha);
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_draw_slidebar 绘制进度条
|
||
*
|
||
* @param dc 绘图句柄
|
||
* @param fg_color 前景色
|
||
* @param bg_color 背景色
|
||
* @param percent 百分比
|
||
* @param x left
|
||
* @param y top
|
||
* @param width
|
||
* @param height
|
||
* @param style 水平靠左/水平靠右/垂直靠上/垂直靠下
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_draw_slidebar(struct draw_context *dc, u32 fg_color, u32 bg_color, int percent, int x, int y, int width, int height, SLIDEBAR_STYLE style);
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_draw_airrect 绘制带圆角的矩形（填充）
|
||
*
|
||
* @param dc 绘图句柄
|
||
* @param x left
|
||
* @param y top
|
||
* @param width
|
||
* @param height
|
||
* @param color 填充颜色
|
||
* @param radius 圆角半径
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
void ui_draw_airrect(void *_dc, int x, int y, int width, int height, int color, int radius);
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_draw_airrect_border 绘制带圆角的矩形（边框）
|
||
*
|
||
* @param dc 绘图句柄
|
||
* @param x left
|
||
* @param y top
|
||
* @param width
|
||
* @param height
|
||
* @param color 填充颜色
|
||
* @param radius 圆角半径
|
||
* @param border_width 边框宽度
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
void ui_draw_airrect_border(void *_dc, int x, int y, int width, int height, int color, int radius, int border_width);
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_draw_poly_line 绘制折线（已知多个端点，将相邻端点连接起来）
|
||
*
|
||
* @param dc 绘图句柄
|
||
* @param x left
|
||
* @param y top
|
||
* @param width
|
||
* @param height
|
||
* @param points 端点
|
||
* @param points_num 端点数量
|
||
* @param line_width 线宽
|
||
* @param color 颜色
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
void ui_draw_poly_line(void *_dc, int x, int y, int width, int height, ui_point_t *points, int points_num, int line_width, u32 color);
|
||
|
||
/* 弃用 */
|
||
int ui_draw_set_pixel(struct draw_context *dc, int x, int y, int pixel);
|
||
u32 ui_draw_get_pixel(struct draw_context *dc, int x, int y);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_draw_get_mixed_pixel 颜色混合(ARGB565)
|
||
*
|
||
* @param backcolor 背景色
|
||
* @param forecolor 前景色
|
||
* @param alpha 透明度
|
||
*
|
||
* @return u16 混合后的颜色值
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
u16 ui_draw_get_mixed_pixel(u16 backcolor, u16 forecolor, u8 alpha);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_custom_draw_clear 清空自定义绘图
|
||
*
|
||
* @param dc 显示上下文
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
void ui_custom_draw_clear(struct draw_context *dc);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief load_control_info_by_id 通过控件ID加载控件资源信息
|
||
*
|
||
* @param tabfile 控件所在tab文件路径
|
||
* @param page_id 控件所在页面ID
|
||
* @param id 控件ID
|
||
*
|
||
* @return NULL 失败，control_pos * 控件在UI资源中的信息
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
void *load_control_info_by_id(char *tabfile, u32 page_id, u32 id);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_control_new 创建新控件
|
||
*
|
||
* @param _pos 控件资源信息
|
||
* @param parent 父控件句柄
|
||
*
|
||
* @return 新创建的控件句柄
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
void *ui_control_new(void *_pos, void *parent);
|
||
|
||
|
||
/* 弃用 */
|
||
int ui_draw_begin(struct draw_context *dc);
|
||
int ui_draw_end(struct draw_context *dc);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_draw
|
||
*
|
||
* @param dc
|
||
* @param buf
|
||
* @param x
|
||
* @param y
|
||
* @param width
|
||
* @param height
|
||
* @param cb
|
||
* @param priv
|
||
* @param priv_len
|
||
* @param id
|
||
*
|
||
* @return
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_draw(struct draw_context *dc, u8 *buf, int x, int y, int width, int height, void *cb, void *priv, int priv_len, int id);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_page_set_param 卡片界面左右滑动参数设置
|
||
*
|
||
* @param threshold 阈值(继续滑动或回弹)
|
||
* @param step 步距(自动滑动或回弹时每次步进量)
|
||
* @param delay 自动滑动时间间隔(delay * 10 ms)
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
void ui_page_set_param(int threshold, int step, int delay);
|
||
|
||
|
||
/* ------------------------------------------------------------------------------------*/
|
||
/**
|
||
* @brief ui_hide_set 设置控件隐藏动作是否刷新
|
||
*
|
||
* @param id 控件ID
|
||
* @param redraw 刷新标志
|
||
*
|
||
* @return 0 正常，-22 控件不存在
|
||
*/
|
||
/* ------------------------------------------------------------------------------------*/
|
||
int ui_hide_set(int id, int redraw);
|
||
|
||
|
||
int ui_draw(struct draw_context *dc, u8 *buf, int x, int y, int width, int height, void *cb, void *priv, int priv_len, int id);
|
||
|
||
|
||
|
||
#endif
|
||
|
||
|
||
|