lv_display.h

lv_display_set_default

Set a default display. The new screens will be created on it by default.

void lv_display_set_default(lv_display_t *disp)

lv_display_set_resolution

Sets the resolution of a display. LV_EVENT_RESOLUTION_CHANGED event will be sent. Here the native resolution of the device should be set. If the display will be rotated later with lv_display_set_rotation LVGL will swap the hor. and ver. resolution automatically.

void lv_display_set_resolution(lv_display_t *disp, int32_t hor_res, int32_t ver_res)

lv_display_set_physical_resolution

It's not mandatory to use the whole display for LVGL, however in some cases physical resolution is important. For example the touchpad still sees whole resolution and the values needs to be converted to the active LVGL display area.

void lv_display_set_physical_resolution(lv_display_t *disp, int32_t hor_res, int32_t ver_res)

lv_display_set_offset

If physical resolution is not the same as the normal resolution the offset of the active display area can be set here.

void lv_display_set_offset(lv_display_t *disp, int32_t x, int32_t y)

lv_display_set_rotation

Set the rotation of this display. LVGL will swap the horizontal and vertical resolutions internally.

void lv_display_set_rotation(lv_display_t *disp, lv_display_rotation_t rotation)

lv_display_set_matrix_rotation

Use matrix rotation for the display. This function is depended on LV_DRAW_TRANSFORM_USE_MATRIX

void lv_display_set_matrix_rotation(lv_display_t *disp, bool enable)

lv_display_set_dpi

Set the DPI (dot per inch) of the display. dpi = sqrt(hor_res^2 + ver_res^2) / diagonal"

void lv_display_set_dpi(lv_display_t *disp, int32_t dpi)

lv_display_set_buffers

Set the buffers for a display, similarly to lv_display_set_draw_buffers, but accept the raw buffer pointers. For DIRECT/FULL rending modes, the buffer size must be at least hor_res * ver_res * lv_color_format_get_size(lv_display_get_color_format(disp))

void lv_display_set_buffers(lv_display_t *disp, void *buf1, void *buf2, uint32_t buf_size, lv_display_render_mode_t render_mode)

lv_display_set_buffers_with_stride

Set the frame buffers for a display, similarly to lv_display_set_buffers, but allow for a custom stride as required by a display controller. This allows the frame buffers to have a stride alignment different from the rest of the buffers @param disp pointer to a display @param buf1 first buffer @param buf2 second buffer (can beNULL`)

void lv_display_set_buffers_with_stride(lv_display_t *disp, void *buf1, void *buf2, uint32_t buf_size, uint32_t stride, lv_display_render_mode_t render_mode)

lv_display_set_draw_buffers

Set the buffers for a display, accept a draw buffer pointer. Normally use lv_display_set_buffers is enough for most cases. Use this function when an existing lv_draw_buf_t is available.

void lv_display_set_draw_buffers(lv_display_t *disp, lv_draw_buf_t *buf1, lv_draw_buf_t *buf2)

lv_display_set_3rd_draw_buffer

Set the third draw buffer for a display.

void lv_display_set_3rd_draw_buffer(lv_display_t *disp, lv_draw_buf_t *buf3)

lv_display_set_render_mode

Set display render mode

void lv_display_set_render_mode(lv_display_t *disp, lv_display_render_mode_t render_mode)

lv_display_set_flush_cb

Set the flush callback which will be called to copy the rendered image to the display.

void lv_display_set_flush_cb(lv_display_t *disp, lv_display_flush_cb_t flush_cb)

lv_display_set_flush_wait_cb

Set a callback to be used while LVGL is waiting flushing to be finished. It can do any complex logic to wait, including semaphores, mutexes, polling flags, etc. If not set the disp->flushing flag is used which can be cleared with lv_display_flush_ready()

void lv_display_set_flush_wait_cb(lv_display_t *disp, lv_display_flush_wait_cb_t wait_cb)

lv_display_set_sync_cb

Set the sync callback which will be called to synchronize invalidated areas between frame buffers pre-render.

void lv_display_set_sync_cb(lv_display_t *disp, lv_display_sync_cb_t sync_cb)

lv_display_set_sync_wait_cb

Set a callback to be used while LVGL is waiting sync to be finished. It can do any complex logic to wait, including semaphores, mutexes, polling flags, etc. If not set the disp->syncing flag is used which can be cleared with lv_display_sync_ready()

void lv_display_set_sync_wait_cb(lv_display_t *disp, lv_display_sync_wait_cb_t wait_cb)

lv_display_set_color_format

Set the color format of the display.

void lv_display_set_color_format(lv_display_t *disp, lv_color_format_t color_format)

lv_display_set_tile_cnt

Set the number of tiles for parallel rendering.

void lv_display_set_tile_cnt(lv_display_t *disp, uint32_t tile_cnt)

lv_display_set_antialiasing

Disabling anti-aliasing is not supported since v9. This function will be removed. Enable anti-aliasing for the render engine

void lv_display_set_antialiasing(lv_display_t *disp, bool en)

lv_display_set_theme

Set the theme of a display. If there are no user created widgets yet the screens' theme will be updated

void lv_display_set_theme(lv_display_t *disp, lv_theme_t *th)

lv_display_set_user_data

void lv_display_set_user_data(lv_display_t *disp, void *user_data)

lv_display_set_driver_data

void lv_display_set_driver_data(lv_display_t *disp, void *driver_data)

lv_display_set_external_data

Attaches external user data and destructor callback to a display.

Associates custom user data with an LVGL display and specifies a destructor function that will be automatically invoked when the display is deleted to properly clean up the associated resources.

void lv_display_set_external_data(lv_display_t *disp, void *data, void(*free_cb)(void *data))