Embedded/lvgl
1
0
Fork 0
mirror of https://github.com/lvgl/lvgl.git synced 2025-01-14 06:42:58 +08:00
Code Issues Projects Releases Wiki Activity
lvgl/docs/widgets/core/arc.md
Gabor Kiss-Vamosi 88c485949f feat(event, widgets) improve the paramter of LV_EVENT_DRAW_PART_BEGIN/END 
Add lv_<widget>_draw_part_type_t to widgets to precisly describe the hooked drawings.
Also add class_p element to lv_obj_draw_part_dsc_t to show what widgets lv_<widget>_draw_part_type_t needs to be used.

Related to: https://forum.lvgl.io/t/how-to-add-minor-division-lines-to-a-chart/5366/
2021-07-07 16:19:06 +02:00

4.0 KiB
Raw Blame History 

.. include:: /header.rst 
:github_url: |github_link_base|/widgets/arc.md

Arc (lv_arc)

Overview

The Arc consists of a background and a foreground arc. The foregrond (indicator) can be touch-adjusted.

Parts and Styles

  • LV_PART_MAIN Draws a background using the typical background style properties and an arc using the arc style properties. The arc's size and position will respect the padding style properties.
  • LV_PART_INDICATOR Draws an other arc using the arc style properties. Its padding values are interpreted relative to the background arc.
  • LV_PART_KNOB Draws a handle on the end of the indicator using all background properties and padding values. With zero padding the knob size is the same as the indicator's width. Larger padding makes it larger, smaller padding makes it smaller.

Usage

Value and range

A new value can be set using lv_arc_set_value(arc, new_value). The value is interpreted in a range (minimum and maximum values) which can be modified with lv_arc_set_range(arc, min, max). The default range is 1..100.

The indicator arc is drawn on the main part's arc. This if the value is set to maximum the indicator arc will cover the entire "background" arc. To set the start and end angle of the background arc use the lv_arc_set_bg_angles(arc, start_angle, end_angle) functions or lv_arc_set_bg_start/end_angle(arc, angle).

Zero degrees is at the middle right (3 o'clock) of the object and the degrees are increasing in clockwise direction. The angles should be in the [0;360] range.

Rotation

An offset to the 0 degree position can added with lv_arc_set_rotation(arc, deg).

Mode

The arc can be one of the following modes:

  • LV_ARC_MODE_NORMAL The indicator arc is drawn from the minimimum value to the current.
  • LV_ARC_MODE_REVERSE The indicator arc is drawn counter-clockwise from the maximum value to the current.
  • LV_ARC_MODE_SYMMETRICAL The indicator arc is drawn from the middle point to the current value.

The mode can be set by lv_arc_set_mode(arc, LV_ARC_MODE_...) and used only if the the angle is set by lv_arc_set_value() or the arc is adjusted by finger.

Change rate

If the arc is pressed the current value will set with a limited speed according to the set change rate. The change rate is defined in degree/second unit and can be set with lv_arc_set_change_rage(arc, rate)

Setting the indicator manually

It also possible to set the angles of the indicator arc directly with lv_arc_set_angles(arc, start_angle, end_angle) function or lv_arc_set_start/end_angle(arc, start_angle). In this case the set "value" and "mode" is ignored.

In other words, settings angles and values are independent. You should use either value and angle settings. Mixing the two might result in unintended behavior.

To make the arc non-adjustabe remove the style of the knob and make the object non-clickable:

lv_obj_remove_style(arc, NULL, LV_PART_KNOB);
lv_obj_clear_flag(arc, LV_OBJ_FLAG_CLICKABLE);

Events

  • LV_EVENT_VALUE_CHANGED sent when the arc is pressed/dragged to set a new value.
  • LV_EVENT_DRAW_PART_BEGIN and LV_EVENT_DRAW_PART_END are sent with the following types:
    • LV_ARC_DRAW_PART_BACKGROUND The background arc.
      • part: LV_PART_MAIN
      • p1: center of the arc
      • radius: radius of the arc
      • arc_dsc
    • LV_ARC_DRAW_PART_FOREGROUND The foreground arc.
      • part: LV_PART_INDICATOR
      • p1: center of the arc
      • radius: radius of the arc
      • arc_dsc
    • LV_ARC_DRAW_PART_KNOB The knob
      • part: LV_PART_KNOB
      • draw_area: the arae of the knob
      • rect_dsc:

See the events of the Base object too.

Learn more about Events.

Keys

  • LV_KEY_RIGHT/UP Increases the value by one.
  • LV_KEY_LEFT/DOWN Decreases the value by one.

Learn more about Keys.

Example


.. include:: ../../../examples/widgets/arc/index.rst

API


.. doxygenfile:: lv_arc.h
  :project: lvgl