Charts: clarification about styles

Copy of https://github.com/lvgl/docs/issues/127 (not sure where is the right place to ask this…)

The LVGL docs says:

The Chart’s main part is called LV_CHART_PART_BG and it uses all the typical background properties. The text style properties determine the style of the axis texts and the line properties determine ticks’ style. Padding values add some space on the sides thus it makes series area smaller. Padding also can be used to make space for axis texts and ticks.
The background of the series is called LV_CHART_PART_SERIES_BG and it’s placed on the main background. The division lines, and series data is drawn on this part. Besides the typical background style properties the line style properties are used by the division lines. The padding values tells the space between the this part and the axis texts.

Long question:

for the 3rd element (LV_CHART_PART_SERIES) it’s easy to see what styles can be changed as they are clearly listed. But for above first two (LV_CHART_PART_BG and LV_CHART_PART_SERIES_BG) it’s not straight forward. It is said that they use typical background properties plus something else.

In the Style chapter, 4.4.9 Properties these categories are listed:

  • Mixed properties
  • Padding and margin properties
  • Background properties
  • Border properties
  • Outline properties
  • Shadow properties
  • Pattern properties
  • Value properties
  • Text properties
  • Line properties
  • Image properties
  • Transition properties
  • Scale properties
    And in the end it says:
    The ”typical background” properties are:
    • Background
    • Border
    • Outline
    • Shadow
    • Pattern
    • Value

Which implies that these are not among ”typical background” properties, right?

  • Mixed properties
  • Padding and margin properties
  • Text properties
  • Line properties
  • Image properties
  • Transition properties
  • Scale properties

But then for LV_CHART_PART_BG and LV_CHART_PART_SERIES_BG is mentioned also “text style”, “line properties” and “Padding values” respectively “line style” and “padding values”.
So, do I understand it right that for LV_CHART_PART_BG can be applied:
• Background
• Border
• Outline
• Shadow
• Pattern
• Value
• + Text
• + Line
• + Padding and margin
And for LV_CHART_PART_SERIES_BG can be applied:
• Background
• Border
• Outline
• Shadow
• Pattern
• Value
• + Line
• + Padding and margin

The confusion comes that in some places it tells about extra “style properties” (text style), in others about extra “properties” (line properties) and in other about extra “values” (Padding values).
Kindly can you please confirm if my understanding is correct. Thank you!

I’ve answered in the original issue.