Drawing Pipeline

LVGL has a flexible and extendable drawing pipeline. You can hook it to do some rendering with a GPU or even completely replace the built-in software renderer.

Overview

Draw task

When lv_draw_rect, lv_draw_label or similar functions are called LVGL creates a so called draw task.

Draw unit

The draw tasks are collected in a list and periodically dispatched to draw units. A draw unit can a CPU core, a GPU, just a new rendering library for certain or all draw tasks, or basically anything that can draw somehow.

Draw task evaluation

Different draw units might render slight different output for example for an image transformation or a gradient. If such a draw task were assigned to a different draw units, the screen might jitter a little bit. To resolve it each draw unit has an evaluate_cb which is called when a draw task is created. Based on the type and parameters of the draw task each draw unit can decide if it want to assign the draw task to itself. This way a certain type of draw task (e.g. rounded rectangle with horizontal gradient) will be always assigned to the same draw unit. It avoid the above mentioned issue of slight difference between draw units.

Dispatching

While collecting draw tasks LVGL frequently tries to dispatch the collected draw tasks to the draw units. This handles via the dispatch_cb of the draw units.

If a draw unit is busy with another draw task, it just returns. However, it is available it can take a draw task.

lv_draw_get_next_available_task(layer, previous_task, draw_unit_id) is a useful helper function which returns an available draw task. "Available draw task" means that, all the draw tasks which should be drawn under a draw task are ready and it is assigned to the given draw unit.

Layers

A layer is a buffer with a given area on which rendering happens. Each display has a "main" layer, but during rendering additional layers might be created internally to handle for example arbitrary widget transformations.

Hierarchy of modules

All these together looks like this

  • list of draw units

  • display(s)

    • layer(s): Each display has its own list of layers

      • draw tasks: Each layer has its own list of draw tasks

References

As a reference take a look at lv_draw_sw.c

API

lv_draw_sw_blend_to_al88.h

lv_api_map_v9_0.h

lv_draw_line.h

lv_utils.h

lv_draw_label.h

lv_draw_sw_blend_to_argb8888.h

lv_draw_sw_blend.h

lv_draw.h

lv_draw_vglite.h

lv_draw_buf.h

lv_draw_vg_lite.h

lv_draw_sw_mask.h

lv_draw_sw_arm2d.h

lv_draw_sdl.h

lv_draw_sw.h

lv_draw_triangle.h

lv_draw_dma2d.h

lv_draw_sw_blend_to_l8.h

lv_svg_render.h

lv_draw_sw_blend_to_rgb888.h

lv_draw_dave2d_utils.h

lv_types.h

lv_draw_arc.h

lv_draw_dave2d.h

lv_draw_mask.h

lv_draw_image.h

lv_draw_rect.h

lv_draw_sw_blend_to_i1.h

lv_draw_sw_utils.h

lv_draw_pxp.h

lv_draw_nema_gfx.h

lv_draw_sw_blend_to_rgb565.h

lv_draw_vector.h

lv_draw_opengles.h

lv_vg_lite_path.h