github-code/lvgl
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix(tiny_ttf): fix font metrics confusion (#4714)

Browse Source
This commit is contained in:
Niklas Fiekas
2023-10-27 11:54:02 +02:00
committed by GitHub
parent 605379ab3c
commit ef1885f670
4 changed files with 35 additions and 43 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
docs/libs/tiny_ttf.rst
View File

@@ -9,7 +9,7 @@ Allow using TrueType fonts LVGL. Based on
https://github.com/nothings/stb
When enabled in ``lv_conf.h`` with :c:macro:`LV_USE_TINY_TTF`
:c:expr:`lv_tiny_ttf_create_data(data, data_size, line_height)` can be used to
:c:expr:`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 :c:struct:`lv_font_t` is accepted.
@@ -17,17 +17,17 @@ 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 :c:macro:`LV_TINY_TTF_FILE_SUPPORT` is enabled,
:c:expr:`lv_tiny_ttf_create_file(path, line_height)` will also be available,
:c:expr:`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 size by using
:c:expr:`lv_tiny_ttf_set_size(font, line_height)`.
After a font is created, you can change the font size in pixels by using
:c:expr:`lv_tiny_ttf_set_size(font, font_size)`.
By default, a font will use up to 4KB of cache to speed up rendering
glyphs. This maximum can be changed by using
:c:expr:`lv_tiny_ttf_create_data_ex(data, data_size, line_height, cache_size)`
or :c:expr:`lv_tiny_ttf_create_file_ex(path, line_height, cache_size)` (when
:c:expr:`lv_tiny_ttf_create_data_ex(data, data_size, font_size, cache_size)`
or :c:expr:`lv_tiny_ttf_create_file_ex(path, font_size, cache_size)` (when
available). The cache size is indicated in bytes.
Example
@@ -35,11 +35,9 @@ Example
.. include:: ../examples/libs/tiny_ttf/index.rst
API
---
:ref:`stb_rect_pack`
:ref:`stb_truetype_htcw`