Files

Gabor Kiss-Vamosi 18f61c5f77 arch add small 3rd party libs to lvgl (#2569 )

* move png, sjpg, bmp, gif, fs_if to extra/libs

* reorganize the examples

* update lv_conf_internal.h

* fix warnings

* add freetype

* remove unused assets

* add the new libs to build tests

* update the docs

2021-10-04 14:34:11 +02:00

1.3 KiB

Raw Blame History

.. include:: /header.rst 
:github_url: |github_link_base|/libs/gif.md

GIF decoder

Allow to use of GIF images in LVGL. Based on https://github.com/lecram/gifdec

When enabled in lv_conf.h with LV_USE_GIF lv_gif_create(parent) can be used to create a gif widget.

lv_gif_set_src(obj, src) works very similarly to lv_img_set_src. As source It also accepts images as variables (lv_img_dsc_t) or files.

Convert GIF files to C array

To convert a GIF file to byte values array use LVGL's online converter. Select "Raw" color format and "C array" Output format.

Use GIF images from file

For example:

lv_gif_set_src(obj, "S:path/to/example.gif");

Note that, a file system driver needs to regsitered to open images from files. Read more about it here or just enable one in lv_conf.h with LV_USE_FS_...

Memory requirements

To decode and display a GIF animation the following amount of RAM is required:

LV_COLOR_DEPTH 8: 3 x image width x image height
LV_COLOR_DEPTH 16: 4 x image width x image height
LV_COLOR_DEPTH 32: 5 x image width x image height

Example


.. include:: ../../../examples/libs/gif/index.rst

API


.. doxygenfile:: lv_gif.h
  :project: lvgl

1.3 KiB Raw Blame History