nakamochi
/
ndg
Archived
2
0
Fork 0
Code Issues Pull Requests Projects Releases 14 Activity
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
This repo is archived. You can view files and clone it, but cannot push or open issues/pull-requests.
master
add-custom-font
v0.0.1
0.2.0-1-gff883042-dev
v0.1.0
v0.1.1
v0.2.0
v0.3.0
v0.3.1
v0.4.0
v0.5.0
v0.5.1
v0.6.0
v0.7.0
v0.8.0
v0.8.1
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'bc87a57de2'
${ noResults }
ndg/lib/lvgl/docs/libs/bmp.md

1.5 KiB
Raw Blame History

BMP decoder

This extension allows the use of BMP images in LVGL. This implementation uses bmp-decoder library. The pixels are read on demand (not the whole image is loaded) so using BMP images requires very little RAM.

If enabled in lv_conf.h by LV_USE_BMP LVGL will register a new image decoder automatically so BMP files can be directly used as image sources. For example:

lv_img_set_src(my_img, "S:path/to/picture.bmp");

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

Limitations

  • Only BMP files are supported and BMP images as C array (lv_img_dsc_t) are not. It's because there is no practical differences between how the BMP files and LVGL's image format stores the image data.
  • BMP files can be loaded only from file. If you want to store them in flash it's better to convert them to C array with LVGL's image converter.
  • The BMP files color format needs to match with LV_COLOR_DEPTH. Use GIMP to save the image in the required format. Both RGB888 and ARGB888 works with LV_COLOR_DEPTH 32
  • Palette is not supported.
  • Because not the whole image is read in can not be zoomed or rotated.

Example


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

API


.. doxygenfile:: lv_bmp.h
  :project: lvgl