lv_font_manager.h

Functions

lv_font_manager_t *lv_font_manager_create(uint32_t recycle_cache_size)

Create main font manager.

Parameters:

recycle_cache_size – number of fonts that were recently deleted from the cache.

Returns:

pointer to main font manager.

bool lv_font_manager_delete(lv_font_manager_t *manager)

Delete main font manager.

Parameters:

manager – pointer to main font manager.

Returns:

return true if the deletion was successful.

bool lv_font_manager_add_src(lv_font_manager_t *manager, const char *name, const void *src, const lv_font_class_t *class_p)

Add font resource.

Parameters:
  • manager – pointer to main font manager.

  • name – font name.

  • src – font source. Need to strictly correspond to the font class.

  • class_p – font class. eg. lv_freetype_font_class, lv_builtin_font_class.

Returns:

return true if the add was successful.

bool lv_font_manager_add_src_static(lv_font_manager_t *manager, const char *name, const void *src, const lv_font_class_t *class_p)

Add font resource with static memory.

Parameters:
  • manager – pointer to main font manager.

  • name – font name. It cannot be a local variable.

  • src – font source. Need to strictly correspond to the font class. And it cannot be a local variable.

  • class_p – font class. E.g. lv_freetype_font_class, lv_builtin_font_class.

Returns:

return true if the add was successful.

bool lv_font_manager_remove_src(lv_font_manager_t *manager, const char *name)

Remove font resource.

Parameters:
  • manager – pointer to main font manager.

  • name – font name.

Returns:

return true if the remove was successful.

lv_font_t *lv_font_manager_create_font(lv_font_manager_t *manager, const char *font_family, uint32_t render_mode, uint32_t size, uint32_t style, lv_font_kerning_t kerning)

Create font.

Parameters:
  • manager – pointer to main font manager.

  • font_family – font family name. Matches the font resource name, using commas to separate different names. E.g. "my_font_1,my_font_2".

  • render_mode – font render mode. see lv_freetype_font_render_mode_t.

  • size – font size in pixel.

  • style – font style. see lv_freetype_font_style_t.

  • kerning – kerning mode. see lv_font_kerning_t.

Returns:

point to the created font.

void lv_font_manager_delete_font(lv_font_manager_t *manager, lv_font_t *font)

Delete font.

Parameters:
  • manager – pointer to main font manager.

  • font – point to the font.

Returns:

return true if the deletion was successful.