LVGL 图表

图表(lv_chart)图表是可视化数据点的基本对象。它们支持折线图（将点与线连接和/或在其上绘制点）和柱形图。

图表还支持分隔线，2 y轴，刻度线和刻度线文本。

零件和样式

图表的主要部分称为 LV_CHART_PART_BG ，它使用所有典型的背景属性。文本样式属性确定轴文本的样式，而线属性确定刻度线的样式。填充值在侧面增加了一些空间，因此使序列区域更小。填充也可用于为轴文本和刻度线留出空间。

该系列的背景称为 LV_CHART_PART_SERIES_BG ，它位于主要背景上。在此部分上绘制了分隔线和系列数据。除典型的背景样式属性外，分割线还使用线型属性。填充值指示此零件与轴文本之间的间隔。

LV_CHART_PART_SERIES 可以引用该系列的样式。对于列类型，使用以下属性：

• 半径：数据点的半径
• padding_inner：相同x坐标的列之间的间隔

如果是线型图，则使用以下属性：

• 线属性来描述线
• 点的大小半径
• bg_opa：线条下方区域的整体不透明度
• bg_main_stop：的％bg_opa在顶部以创建一个alpha褪色（0：在顶部透明，255：bg_opa在顶部）
• bg_grad_stop：底部bg_opa的百分比以创建alpha渐变（0：底部透明，255：bg_opa顶部）
• bg_drag_dir：应该 LV_GRAD_DIR_VER 允许通过bg_main_stop和bg_grad_stop进行Alpha淡入

LV_CHART_PART_CURSOR 引用游标。可以添加任意数量的光标，并且可以通过与行相关的样式属性来设置其外观。创建游标时设置游标的颜色，并用该值覆盖 line_color 样式。

用法

数据系列

您可以通过 lv_chart_add_series(chart, color) 向图表添加任意数量的系列。它为包含所选颜色的 lv_chart_u series_t 结构分配数据，如果不使用外部数组，如果分配了外部数组，则与该系列关联的任何内部点都将被释放，而序列指向外部数组。

系列类型

存在以下数据显示类型：

• LV_CHART_TYPE_NONE – 不显示任何数据。它可以用来隐藏系列。
• LV_CHART_TYPE_LINE – 在两点之间画线。
• LV_CHART_TYPE_COLUMN – 绘制列。

可以使用 lv_chart_set_type(chart, LV_CHART_TYPE_...) 指定显示类型。可以对类型进行“或”运算（例如 LV_CHART_TYPE_LINE ）。

修改数据

有几个选项可以设置系列数据：

1. 在数组中手动设置值，例如 ser1->points[3] = 7 ，然后使用 lv_chart_refresh(chart) 刷新图表。
2. 使用 lv_chart_set_point_id(chart, ser, value, id) ，其中id是您要更新的点的索引。
3. 使用 lv_chart_set_next(chart, ser, value) 。
4. 使用 lv_chart_init_points(chart, ser, value) 将所有点初始化为给定值。
5. 使用 lv_chart_set_points(chart, ser, value_array) 设置数组中的所有点。

使用 LV_CHART_POINT_DEF 作为值可使库跳过该点，列或线段的绘制。

覆盖系列的默认起点

如果希望绘图从默认点（序列的点[0]）之外的其他点开始，则可以使用 lv_chart_set_x_start_point(chart, ser, id) 函数设置替代索引，其中id是要开始的新索引位置从。

设置外部数据源

可以使用以下函数从外部数据源更新图表系列： lv_chart_set_ext_array(chart, ser, array, point_cnt ) ，其中array是lv_coord_t与point_cnt元素的外部数组。注意：更新外部数据源后，应调用 lv_chart_refresh(chart) 来更新图表。

获取当前图表信息

有四个功能可获取有关图表的信息：

• lv_chart_get_type(chart) 返回当前图表类型。
• lv_chart_get_point_count(chart) 返回当前图表点数。
• lv_chart_get_x_start_point(ser) 返回指定系列的当前绘图索引。
• lv_chart_get_point_id(chart, ser, id) 返回指定系列的特定索引处的数据值。

更新模式

lv_chart_set_next 可以以两种方式运行，具体取决于更新模式：

• LV_CHART_UPDATE_MODE_SHIFT – 将旧数据向左移动，然后向右添加新数据。
• LV_CHART_UPDATE_MODE_CIRCULAR – 循环添加新数据（如ECG图）。

可以使用 lv_chart_set_update_mode(chart, LV_CHART_UPDATE_MODE_...) 更改更新模式。

浮标个数

可以通过 lv_chart_set_point_count(chart, point_num) 修改系列中的点数。默认值为10。注意：当将外部缓冲区分配给序列时，这也会影响处理的点数。

垂直范围

可以使用 lv_chart_set_range(chart, y_min, y_max) 在y方向上指定最小值和最大值。点的值将按比例缩放。默认范围是：0..100。

分割线

水平和垂直分隔线的数量可以通过 lv_chart_set_div_line_count(chart, hdiv_num, vdiv_ 进行修改。默认设置为3条水平分割线和5条垂直分割线。

刻度线和标签

刻度和标签可以添加到轴上。

lv_chart_set_x_tick_text(chart, list_of_values, num_tick_marks, LV_CHART_AXIS_...) 设置x轴上的刻度和文本。 list_of_values 是一个字符串，带有 '\n' 终止文本（期望最后一个），其中包含用于刻度的文本。 list_of_values 是一个字符串，带有 '\n' 终止文本（期望最后一个），其中包含用于刻度的文本。例如。 const char * list_of_values = "first\nsec\nthird" 。 list_of_values 可以为 NULL 。 如果设置了 list_of_values ，则 num_tick_marks 告诉两个标签之间的刻度数。如果 list_of_values 为 NULL ，则它指定滴答声的总数。

主刻度线绘制在放置文本的位置，次刻度线绘制在其他位置。 lv_chart_set_x_tick_length(chart, major_tick_len, minor_tick_len) 设置x轴上刻度线的长度。

y轴也存在相同的功能： lv_chart_set_y_tick_text 和 lv_chart_set_y_tick_length 。

光标

可以使用 lv_chart_cursor_t * c1 = lv_chart_add_cursor(chart, color, dir); 添加光标。 dir LV_CHART_CURSOR_NONE/RIGHT/UP/LEFT/DOWN 的可能值或它们的OR-ed值，用于指示应在哪个方向上绘制光标。

lv_chart_set_cursor_point(chart, cursor, &point) 设置光标的位置。 point 是指向 lv_poin_t 变量的指针。例如。lv_point_t point = {10, 20}; 。该点相对于图表的序列区域。

lv_coord_t p_index = lv_chart_get_nearest_index_from_coord(chart, x) 告诉哪个点索引最接近X坐标（相对于序列区域）。例如，当单击图表时，它可用于将光标捕捉到一个点。

lv_chart_get_x_from_index(chart, series, id) 和 lv_chart_get_y_from_index(chart, series, id) 告诉给定点的X和Y坐标。将光标放置到给定点很有用。

可以使用 lv_chart_get_series_area(chart, &area) 检索当前系列区域，其中 area 是指向 lv_area_t 变量的指针，用于存储结果。该区域具有绝对坐标。

事件

仅通用事件是按对象类型发送的。

了解有关 事件 的更多信息。

按键

对象类型不处理任何键。

进一步了解 按键 。

范例

折线图

折线图

上述效果的示例代码：

#include "../../../lv_examples.h"
#if LV_USE_CHART

void lv_ex_chart_1(void)
{
        /*Create a chart*/
        lv_obj_t * chart;
        chart = lv_chart_create(lv_scr_act(), NULL);
        lv_obj_set_size(chart, 200, 150);
        lv_obj_align(chart, NULL, LV_ALIGN_CENTER, 0, 0);
        lv_chart_set_type(chart, LV_CHART_TYPE_LINE);   /*Show lines and points too*/

        /*Add two data series*/
        lv_chart_series_t * ser1 = lv_chart_add_series(chart, LV_COLOR_RED);
        lv_chart_series_t * ser2 = lv_chart_add_series(chart, LV_COLOR_GREEN);

        /*Set the next points on 'ser1'*/
        lv_chart_set_next(chart, ser1, 10);
        lv_chart_set_next(chart, ser1, 10);
        lv_chart_set_next(chart, ser1, 10);
        lv_chart_set_next(chart, ser1, 10);
        lv_chart_set_next(chart, ser1, 10);
        lv_chart_set_next(chart, ser1, 10);
        lv_chart_set_next(chart, ser1, 10);
        lv_chart_set_next(chart, ser1, 30);
        lv_chart_set_next(chart, ser1, 70);
        lv_chart_set_next(chart, ser1, 90);

        /*Directly set points on 'ser2'*/
        ser2->points[0] = 90;
        ser2->points[1] = 70;
        ser2->points[2] = 65;
        ser2->points[3] = 65;
        ser2->points[4] = 65;
        ser2->points[5] = 65;
        ser2->points[6] = 65;
        ser2->points[7] = 65;
        ser2->points[8] = 65;
        ser2->points[9] = 65;

        lv_chart_refresh(chart); /*Required after direct set*/
}

#endif

折线图添加褪色区域效果

折线图添加褪色区域效果

上述效果的示例代码：

#include "../../../lv_examples.h"
#if LV_USE_CHART

/**
 * Add a faded area effect to the line chart
 */
void lv_ex_chart_2(void)
{
        /*Create a chart*/
        lv_obj_t * chart;
        chart = lv_chart_create(lv_scr_act(), NULL);
        lv_obj_set_size(chart, 200, 150);
        lv_obj_align(chart, NULL, LV_ALIGN_CENTER, 0, 0);
        lv_chart_set_type(chart, LV_CHART_TYPE_LINE);   /*Show lines and points too*/

        /*Add a faded are effect*/
        lv_obj_set_style_local_bg_opa(chart, LV_CHART_PART_SERIES, LV_STATE_DEFAULT, LV_OPA_50); /*Max. opa.*/
        lv_obj_set_style_local_bg_grad_dir(chart, LV_CHART_PART_SERIES, LV_STATE_DEFAULT, LV_GRAD_DIR_VER);
        lv_obj_set_style_local_bg_main_stop(chart, LV_CHART_PART_SERIES, LV_STATE_DEFAULT, 255);    /*Max opa on the top*/
        lv_obj_set_style_local_bg_grad_stop(chart, LV_CHART_PART_SERIES, LV_STATE_DEFAULT, 0);      /*Transparent on the bottom*/


        /*Add two data series*/
        lv_chart_series_t * ser1 = lv_chart_add_series(chart, LV_COLOR_RED);
        lv_chart_series_t * ser2 = lv_chart_add_series(chart, LV_COLOR_GREEN);

        /*Set the next points on 'ser1'*/
        lv_chart_set_next(chart, ser1, 31);
        lv_chart_set_next(chart, ser1, 66);
        lv_chart_set_next(chart, ser1, 10);
        lv_chart_set_next(chart, ser1, 89);
        lv_chart_set_next(chart, ser1, 63);
        lv_chart_set_next(chart, ser1, 56);
        lv_chart_set_next(chart, ser1, 32);
        lv_chart_set_next(chart, ser1, 35);
        lv_chart_set_next(chart, ser1, 57);
        lv_chart_set_next(chart, ser1, 85);

        /*Directly set points on 'ser2'*/
        ser2->points[0] = 92;
        ser2->points[1] = 71;
        ser2->points[2] = 61;
        ser2->points[3] = 15;
        ser2->points[4] = 21;
        ser2->points[5] = 35;
        ser2->points[6] = 35;
        ser2->points[7] = 58;
        ser2->points[8] = 31;
        ser2->points[9] = 53;

        lv_chart_refresh(chart); /*Required after direct set*/
}

#endif

相关API

Typedefs

typedef uint8_t lv_chart_type_t
typedef uint8_t lv_chart_update_mode_t
typedef uint8_t lv_chart_axis_t
typedef uint8_t lv_cursor_direction_t
typedef uint8_t lv_chart_axis_options_t

enums

enum [anonymous]
图表类型
值：
enumerator LV_CHART_TYPE_NONE
不要画系列
enumerator LV_CHART_TYPE_LINE
用线连接点
enumerator LV_CHART_TYPE_COLUMN
绘制列


enum [anonymous]
图表更新模式 lv_chart_set_next
值：
enumerator LV_CHART_UPDATE_MODE_SHIFT
向左移动旧数据，向右添加新数据
enumerator LV_CHART_UPDATE_MODE_CIRCULAR
循环添加新数据


enum [anonymous]
值：
enumerator LV_CHART_AXIS_PRIMARY_Y
enumerator LV_CHART_AXIS_SECONDARY_Y
enumerator _LV_CHART_AXIS_LAST


enum [anonymous]
值：
enumerator LV_CHART_CURSOR_NONE
enumerator LV_CHART_CURSOR_RIGHT
enumerator LV_CHART_CURSOR_UP
enumerator LV_CHART_CURSOR_LEFT
enumerator LV_CHART_CURSOR_DOWN


enum [anonymous]
轴数据
值：
enumerator LV_CHART_AXIS_SKIP_LAST_TICK
不要画最后的刻度
enumerator LV_CHART_AXIS_DRAW_LAST_TICK
画最后一个刻度
enumerator LV_CHART_AXIS_INVERSE_LABELS_ORDER
以倒序绘制刻度标签


enum [anonymous]
值：
enumerator LV_CHART_PART_BG
enumerator LV_CHART_PART_SERIES_BG
enumerator LV_CHART_PART_SERIES
enumerator LV_CHART_PART_CURSOR

函数

LV_EXPORT_CONST_INT( LV_CHART_POINT_DEF )
LV_EXPORT_CONST_INT( LV_CHART_TICK_LENGTH_AUTO )
lv_obj_t * lv_chart_create(lv_obj_t * par，constlv_obj_t *copy)
功能：创建图表背景对象
返回：
指向创建的图表背景的指针
形参：
par：指向对象的指针，它将是新图表背景的父对象
copy：指向图表背景对象的指针，如果不为NULL，则将从其复制新对象


lv_chart_series_t * lv_chart_add_series(lv_obj_t *chart，lv_color_t color)
功能：分配数据系列并将其添加到图表
返回：
指向已分配数据系列的指针
形参：
chart：指向图表对象的指针
color：数据系列的颜色


void lv_chart_clear_series(lv_obj_t *chart，lv_chart_series_t *series)
功能：明确系列的要点
形参：
chart：指向图表对象的指针
series：指向要清除的图表系列的指针


void lv_chart_set_div_line_count(lv_obj_t *chart，uint8_t hdiv，uint8_t vdiv )
功能：设置水平和垂直分割线的数量
形参：
chart：指向图形背景对象的指针
hdiv：水平分割线数
vdiv：垂直分割线数


void lv_chart_set_y_range(lv_obj_t *chart，lv_chart_axis_t axis，lv_coord_t ymin，lv_coord_t ymax )
功能：在轴上设置最小和最大y值
形参：
chart：指向图形背景对象的指针
axis：LV_CHART_AXIS_PRIMARY_Y或LV_CHART_AXIS_SECONDARY_Y
ymin：y最小值
ymax：y最大值


void lv_chart_set_type(lv_obj_t *chart，lv_chart_type_t type)
功能：设置图表的新类型
形参：
chart：指向图表对象的指针
type：图表的新类型(来自“ lv_chart_type_t”enum )


void lv_chart_set_point_count(lv_obj_t *chart，uint16_t point_cnt )
功能：设置图表上数据线上的点数
形参：
chart：指向图表对象的指针r
point_cnt：数据线上的新点数


void lv_chart_init_points(lv_obj_t *chart，lv_chart_series_t * ser，lv_coord_t y )
功能：用一个值初始化所有数据点
形参：
chart：指向图表对象的指针
ser：指向“图表”上的数据系列的指针
y：所有点的新值


void lv_chart_set_points(lv_obj_t *chart，lv_chart_series_t * ser，lv_coord_t y_array [] )
功能：设置数组中的点的值
形参：
chart：指向图表对象的指针
ser：指向“图表”上的数据系列的指针
y_array：'lv_coord_t'点的数组(带有'points count'元素)


void lv_chart_set_next(lv_obj_t *chart，lv_chart_series_t * ser，lv_coord_t y )
功能：向右移动所有数据并在数据线上设置最右边的数据
形参：
chart：指向图表对象的指针
ser：指向“图表”上的数据系列的指针
y：最正确数据的新价值


void lv_chart_set_update_mode(lv_obj_t *chart，lv_chart_update_mode_t update_mode )
功能：设置图表对象的更新模式。
形参：
chart：指向图表对象的指针
update：模式


void lv_chart_set_x_tick_length(lv_obj_t *chart，uint8_t major_tick_len，uint8_t minor_tick_len )
功能：设置x轴上刻度线的长度
形参：
chart：指向图表的指针
major_tick_len：主要刻度的长度或LV_CHART_TICK_LENGTH_AUTO自动设置(添加标签的位置)
minor_tick_len：次刻度的长度，LV_CHART_TICK_LENGTH_AUTO可自动设置(不添加标签)


void lv_chart_set_y_tick_length(lv_obj_t *chart，uint8_t major_tick_len，uint8_t minor_tick_len )
功能：设置y轴上刻度线的长度
形参：
chart：指向图表的指针
major_tick_len：主要刻度的长度或LV_CHART_TICK_LENGTH_AUTO自动设置(添加标签的位置)
minor_tick_len：次刻度的长度，LV_CHART_TICK_LENGTH_AUTO可自动设置(不添加标签)


void lv_chart_set_secondary_y_tick_length(lv_obj_t *chart，uint8_t major_tick_len，uint8_t minor_tick_len )
功能：设置次要y轴上刻度线的长度
形参：
chart：指向图表的指针
major_tick_len：主要刻度的长度或LV_CHART_TICK_LENGTH_AUTO自动设置(添加标签的位置)
minor_tick_len：次刻度的长度，LV_CHART_TICK_LENGTH_AUTO可自动设置(不添加标签)


void lv_chart_set_x_tick_texts(lv_obj_t *chart，constchar * list_of_values，uint8_t num_tick_marks，lv_chart_axis_options_t options )
功能：设置图表的X轴刻度计数和标签

形参：
chart：指向图表对象的指针
list_of_values：字符串值列表，以终止，除了最后一个
num_tick_marks：如果list_of_values为NULL：每个轴的总刻度数，否则两个值标签之间的刻度数
options：额外的选择


void lv_chart_set_secondary_y_tick_texts(lv_obj_t *chart，constchar * list_of_values，uint8_t num_tick_marks，lv_chart_axis_options_t options )
功能：设置次要y轴刻度计数和图表标签
形参：
chart：指向图表对象的指针
list_of_values：字符串值列表，以终止，除了最后一个
num_tick_marks：如果list_of_values为NULL：每个轴的总刻度数，否则两个值标签之间的刻度数
options：额外的选择


void lv_chart_set_y_tick_texts(lv_obj_t *chart，constchar * list_of_values，uint8_t num_tick_marks，lv_chart_axis_options_t options )
功能：设置图表的Y轴刻度计数和标签
形参：
chart：指向图表对象的指针
list_of_values：字符串值列表，以终止，除了最后一个
num_tick_marks：如果list_of_values为NULL：每个轴的总刻度数，否则两个值标签之间的刻度数
options：额外的选择


void lv_chart_set_x_start_point(lv_obj_t *chart，lv_chart_series_t * ser，uint16_t id )
功能：设置数据数组中x轴起点的索引
形参：
chart：指向图表对象的指针
ser：指向“图表”上的数据系列的指针
id：数据数组中x点的索引


void lv_chart_set_ext_array(lv_obj_t *chart，lv_chart_series_t * ser，lv_coord_t array[]，uint16_t point_cnt )
功能：设置要用于图表的外部数据点阵列注意：用户有责任确保point_cnt与外部阵列大小匹配。
形参：
chart：指向图表对象的指针
ser：指向“图表”上的数据系列的指针
array：图表的外部点数组


void lv_chart_set_point_id(lv_obj_t *chart，lv_chart_series_t * ser，lv_coord_t value，uint16_t id )
功能：直接基于索引在图表系列中设置单个点值
形参：
chart：指向图表对象的指针
ser：指向“图表”上的数据系列的指针
value：分配给数组点的值
id：数组中x点的索引


void lv_chart_set_series_axis(lv_obj_t *chart，lv_chart_series_t * ser，lv_chart_axis_t axis)
功能：设置系列的Y轴
形参：
chart：指向图表对象的指针
ser：指向系列的指针
axis：LV_CHART_AXIS_PRIMARY_Y或LV_CHART_AXIS_SECONDARY_Y


lv_chart_type_t lv_chart_get_type(constlv_obj_t *chart)
获取图表类型
返回：
图表类型(来自“ lv_chart_t”enum )
形参：
chart：指向图表对象的指针


uint16_t lv_chart_get_point_count(constlv_obj_t *chart)
功能：获取图表上每条数据线的数据点编号
返回：
每条数据线上的点号
形参：
chart：指向图表对象的指针


uint16_t lv_chart_get_x_start_point(lv_chart_series_t * ser )
功能：获取数据数组中x轴起点的当前索引
返回：
数据数组中当前x起点的索引
形参：
ser：指向“图表”上的数据系列的指针


lv_coord_t lv_chart_get_point_id(lv_obj_t *chart，lv_chart_series_t * ser，uint16_t id )
功能：直接基于索引获取图表系列中的单个点值
返回：
索引ID处数组点的值
形参：
chart：指向图表对象的指针
ser：指向“图表”上的数据系列的指针
id：数组中x点的索引


lv_chart_axis_t lv_chart_get_series_axis(lv_obj_t *chart，lv_chart_series_t * ser )
功能：获取系列的Y轴
返回：
LV_CHART_AXIS_PRIMARY_Y 要么 LV_CHART_AXIS_SECONDARY_Y
形参：
chart：指向图表对象的指针
ser：指向系列的指针


void lv_chart_refresh(lv_obj_t *chart)
功能：如果其数据线已更改，则刷新图表
形参：
chart：指向图表对象的指针