[English]

Tiny TTF font engine(微小的TTF字体引擎)

Usage(用法)

显示原文

Allow using TrueType fonts in LVGL.

Detailed introduction: https://github.com/nothings/stb

When enabled in lv_conf.h with LV_USE_TINY_TTF lv_tiny_ttf_create_data(data, data_size, font_size) can be used to create a TTF font instance at the specified line height. You can then use that font anywhere lv_font_t is accepted.

By default, the TTF or OTF file must be embedded as an array, either in a header, or loaded into RAM in order to function.

However, if LV_TINY_TTF_FILE_SUPPORT is enabled, lv_tiny_ttf_create_file(path, font_size) will also be available, allowing tiny_ttf to stream from a file. The file must remain open the entire time the font is being used.

After a font is created, you can change the font size in pixels by using lv_tiny_ttf_set_size(font, font_size).

By default, a font will cache data for upto 256 glyphs elements to speed up rendering. This maximum can be changed by using lv_tiny_ttf_create_data_ex(data, data_size, font_size, kerning, cache_size) or lv_tiny_ttf_create_file_ex(path, font_size, kerning, cache_size) (when available). The cache size is indicated in number of entries. Kerning is whether to allow if supported, or disable.


允许在 LVGL 中使用 TrueType 字体。

详细介绍:https://github.com/nothings/stb

lv_conf.h 中启用 LV_USE_TINY_TTF 时,lv_tiny_ttf_create_data(data, data_size, font_size) 可用于在指定的行高处创建 TTF 字体实例。然后,您可以在任何地方使用该字体都是可以接受的。

默认情况下,TTF 或 OTF 文件必须作为数组嵌入,或者标头,或加载到 RAM 中才能运行。

但是,如果启用了 LV_TINY_TTF_FILE_SUPPORT ,则 lv_tiny_ttf_create_file(path, font_size) 也将可用, 允许tiny_ttf从文件流式传输。该文件必须保持打开状态使用字体的整个过程。

创建字体后,可以使用 lv_tiny_ttf_set_size(font, font_size) 更改字体大小(以像素为单位)。

默认情况下,字体会缓存最多256个字形元素的数据以加快渲染速度。这个最大值可以通过使用 lv_tiny_ttf_create_data_ex(data, data_size, font_size, kerning, cache_size) 或 :cpp:expr:`lv_tiny_ttf_create_file_ex(path, font_size, kerning, cache_size)`(如果可用)来更改。缓存大小以条目数量表示。Kerning 表示是否启用(如果支持的话)或禁用。

Example

API

stb_rect_pack

stb_truetype_htcw .. Autogenerated

lv_tiny_ttf.h