54 lines
1.0 KiB
ReStructuredText
54 lines
1.0 KiB
ReStructuredText
.. _lv_imgfont:
|
|
|
|
==========
|
|
Image font
|
|
==========
|
|
|
|
Draw image in **label** or **span** obj with :cpp:type:`lv_imgfont`. This is often used to
|
|
display Unicode emoji icons in text.
|
|
|
|
Supported image formats: determined by enabled LVGL :ref:`image decoders <overview_image_decoder>`.
|
|
|
|
|
|
|
|
.. _lv_imgfont_usage:
|
|
|
|
Usage
|
|
*****
|
|
|
|
Enable :c:macro:`LV_USE_IMGFONT` in ``lv_conf.h``.
|
|
|
|
To create a new *imgfont*:
|
|
|
|
.. code-block:: c
|
|
|
|
static lv_font_t * imgfont;
|
|
...
|
|
imgfont = lv_imgfont_create(height, path_cb, user_data);
|
|
|
|
- ``height`` Font size.
|
|
- ``path_cb`` A function to get the image path of a character.
|
|
Pass ``NULL`` if no image should be shown, but the character itself.
|
|
- ``user_data`` Pointer to user data.
|
|
|
|
To use the *imgfont* in a label, reference it:
|
|
:cpp:expr:`lv_obj_set_style_text_font(label, imgfont, LV_PART_MAIN)`
|
|
|
|
To destroy the *imgfont* that is no longer used, use :cpp:expr:`lv_imgfont_destroy(imgfont)`.
|
|
|
|
|
|
|
|
.. _lv_imgfont_example:
|
|
|
|
Example
|
|
*******
|
|
|
|
.. include:: ../../examples/others/imgfont/index.rst
|
|
|
|
|
|
|
|
.. _lv_imgfont_api:
|
|
|
|
API
|
|
***
|