lv_draw_label.h

Defines

LV_DRAW_LABEL_NO_TXT_SEL

Typedefs

typedef struct _lv_draw_label_hint_t lv_draw_label_hint_t

Store some info to speed up drawing of very large texts It takes a lot of time to get the first visible character because all the previous characters needs to be checked to calculate the positions. This structure stores an earlier (e.g. at -1000 px) coordinate and the index of that line. Therefore the calculations can start from here.

typedef void (*lv_draw_letter_cb_t)(lv_draw_unit_t *draw_unit, lv_draw_glyph_dsc_t *dsc, lv_draw_fill_dsc_t *fill_dsc, const lv_area_t *fill_area)

Enums

enum lv_draw_letter_bitmap_format_t

Values:

enumerator LV_DRAW_LETTER_BITMAP_FORMAT_A8
enumerator LV_DRAW_LETTER_BITMAP_FORMAT_IMAGE

Functions

void lv_draw_label_iterate_letters(lv_draw_unit_t *draw_unit, const lv_draw_label_dsc_t *dsc, const lv_area_t *coords, lv_draw_letter_cb_t cb)
void lv_draw_label_dsc_init(lv_draw_label_dsc_t *dsc)
void lv_draw_letter_dsc_init(lv_draw_glyph_dsc_t *dsc)
void lv_draw_label(lv_layer_t *layer, const lv_draw_label_dsc_t *dsc, const lv_area_t *coords)

Write a text

Parameters:
  • draw_ctx -- pointer to the current draw context

  • dsc -- pointer to draw descriptor

  • coords -- coordinates of the label

  • txt -- \0 terminated text to write

  • hint -- pointer to a lv_draw_label_hint_t variable. It is managed by the draw to speed up the drawing of very long texts (thousands of lines).

void lv_draw_letter(lv_layer_t *layer, lv_draw_label_dsc_t *dsc, const lv_point_t *point, uint32_t unicode_letter)
struct _lv_draw_label_hint_t
#include <lv_draw_label.h>

Store some info to speed up drawing of very large texts It takes a lot of time to get the first visible character because all the previous characters needs to be checked to calculate the positions. This structure stores an earlier (e.g. at -1000 px) coordinate and the index of that line. Therefore the calculations can start from here.

Public Members

int32_t line_start

Index of the line at y coordinate

int32_t y

Give the y coordinate of the first letter at line start index. Relative to the label's coordinates

int32_t coord_y

The 'y1' coordinate of the label when the hint was saved. Used to invalidate the hint if the label has moved too much.

struct lv_draw_label_dsc_t

Public Members

lv_draw_dsc_base_t base
const char *text
const lv_font_t *font
uint32_t sel_start
uint32_t sel_end
lv_color_t color
lv_color_t sel_color
lv_color_t sel_bg_color
lv_coord_t line_space
lv_coord_t letter_space
lv_coord_t ofs_x
lv_coord_t ofs_y
lv_opa_t opa
lv_base_dir_t bidi_dir
lv_text_align_t align
lv_text_flag_t flag
lv_text_decor_t decor
lv_blend_mode_t blend_mode
uint8_t text_local

1: malloc buffer and copy text there. 0: text is const and it's pointer will be valid during rendering

lv_draw_label_hint_t *hint
struct lv_draw_glyph_dsc_t

Public Members

const uint8_t *bitmap
uint8_t *_bitmap_buf_unaligned
uint8_t *bitmap_buf
uint32_t _bitmap_buf_size
lv_draw_letter_bitmap_format_t format
const lv_area_t *letter_coords
const lv_area_t *bg_coords
lv_color_t color
lv_opa_t opa