LVGL核心部件——弧（arc）控件的介绍

概述

本文介绍LVGL核心部件——弧（arc），它由背景和前景弧组成。前景（指示器）可以进行触摸调整。

LVGL核心部件——弧（arc）控件

一、部件和样式

• ?LV_PART_MAIN?使用典型的背景样式属性绘制背景，使用圆弧样式属性绘制圆弧。 圆弧的大小和位置将遵循?padding?样式属性。

• LV_PART_INDICATOR?使用?arc?样式属性绘制另一个圆弧。 它的填充值是相对于背景弧来解释的。

• LV_PART_KNOB?使用所有背景属性和填充值在指标的末尾绘制一个句柄。 使用零填充，旋钮大小与指示器的宽度相同。 较大的填充使其更大，较小的填充使其更小。

二、用法

值和范围

可以使用?lv_arc_set_value(arc,?new_value)?设置新值。 该值在可以用lv_arc_set_range(arc,?min,?max)修改的范围（最小值和最大值）中解释。 默认范围是 1..100。

指示弧绘制在主零件的弧上。 如果该值设置为最大值，则指示器弧将覆盖整个“背景”弧。 要设置背景弧的开始和结束角度，请使用?lv_arc_set_bg_angles(arc,?start_angle,?end_angle)?函数或?lv_arc_set_bg_start/end_angle(arc,?angle)。

零度位于对象的中间右侧（3 点钟方向），并且度数沿顺时针方向增加。 角度应在 [0;360] 范围内。

旋转

可以使用?lv_arc_set_rotation(arc,?deg)?添加到 0 度位置的偏移量。

模式

弧可以是以下模式之一：

• ?LV_ARC_MODE_NORMAL?指标弧从最小值绘制到当前值。

• LV_ARC_MODE_REVERSE?指标弧从最大值到当前值逆时针绘制。

• LV_ARC_MODE_SYMMETRICAL?指标弧从中间点绘制到当前值。

模式可以通过lv_arc_set_mode (arc,?LV_ARC_MODE_...) 设置，并且仅当角度由lv_arc_set_value()设置或通过手指调整弧度时使用。

变化率

如果弧被按下，当前值将根据设置的变化率以有限的速度设置。 变化率以度/秒为单位定义，可以用lv_arc_set_change_rage(arc,?rate)设置。

手动设置指示器

也可以直接使用?lv_arc_set_angles(arc,?start_angle,?end_angle)?函数或?lv_arc_set_start/end_angle(arc,?start_angle)?设置指标弧的角度。 在这种情况下，设置的“值”和“模式”将被忽略。

换句话说，设置角度和值是独立的。 您应该使用值和角度设置。 将两者混合可能会导致意外行为。

要使圆弧不可调整，请移除旋钮的样式并使对象不可点击：

lv_obj_remove_style(arc, NULL, LV_PART_KNOB);

lv_obj_clear_flag(arc, LV_OBJ_FLAG_CLICKABLE);

Events（事件）

• 按下/拖动圆弧以设置新值时发送“LV_EVENT_VALUE_CHANGED”。

• ?LV_EVENT_DRAW_PART_BEGIN?和?LV_EVENT_DRAW_PART_END?使用以下类型发送：

o???LV_ARC_DRAW_PART_BACKGROUND?背景弧。

§? 部分：LV_PART_MAIN

§? p1：圆弧的中心

§? radius：弧的半径

§? arc_dsc

o???LV_ARC_DRAW_PART_FOREGROUND?前景弧。

§? 部分：LV_PART_INDICATOR

§? p1：圆弧的中心

§? radius：弧的半径

§? arc_dsc

o???LV_ARC_DRAW_PART_KNOB 旋钮

§? 部分：LV_PART_KNOB

§? draw_area：旋钮的面积 -rect_dsc：

按键

·??????? LV_KEY_RIGHT/UP?将值增加一。

·??????? LV_KEY_LEFT/DOWN?将值减一。

Example

Simple Arc

#include "../../lv_examples.h"

#if LV_USE_ARC && LV_BUILD_EXAMPLES

void lv_example_arc_1(void)

{

? /*Create an Arc*/

? lv_obj_t * arc = lv_arc_create(lv_scr_act());

? lv_obj_set_size(arc, 150, 150);

? lv_arc_set_rotation(arc, 135);

? lv_arc_set_bg_angles(arc, 0, 270);

? lv_arc_set_value(arc, 40);

? lv_obj_center(arc);

}

#endif

Loader with Arc?

#include "../../lv_examples.h"

#if LV_USE_ARC && LV_BUILD_EXAMPLES

static void set_angle(void * obj, int32_t v)

{

??? lv_arc_set_value(obj, v);

}

/**

?* Create an arc which acts as a loader.

?*/

void lv_example_arc_2(void)

{

? /*Create an Arc*/

? lv_obj_t * arc = lv_arc_create(lv_scr_act());

? lv_arc_set_rotation(arc, 270);

? lv_arc_set_bg_angles(arc, 0, 360);

? lv_obj_remove_style(arc, NULL, LV_PART_KNOB);?? /*Be sure the knob is not displayed*/

? lv_obj_clear_flag(arc, LV_OBJ_FLAG_CLICKABLE);? /*To not allow adjusting by click*/

? lv_obj_center(arc);

? lv_anim_t a;

? lv_anim_init(&a);

? lv_anim_set_var(&a, arc);

? lv_anim_set_exec_cb(&a, set_angle);

? lv_anim_set_time(&a, 1000);

? lv_anim_set_repeat_count(&a, LV_ANIM_REPEAT_INFINITE);??? /*Just for the demo*/

? lv_anim_set_repeat_delay(&a, 500);

? lv_anim_set_values(&a, 0, 100);

? lv_anim_start(&a);

}

以上是关于LVGL核心部件——弧（arc）的使用介绍。