「App:Library:LVGL:docs:3rd party libraries:BMP decoder」の版間の差分
提供: robot-jp wiki
ナビゲーションに移動検索に移動 (ページの作成:「https://docs.lvgl.io/8.2/libs/bmp.html __NOTOC__ {| class="wikitable" !英文 !自動翻訳 |- | | |} ---- :App:Library:LVGL:docs:3rd party libraries|戻る : P…」) |
|||
8行目: | 8行目: | ||
| | | | ||
|} | |} | ||
+ | |||
+ | = 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 <code>lv_conf.h</code> by <code>LV_USE_BMP</code> 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 <code>lv_conf.h</code> with <code>LV_USE_FS_...</code> | ||
+ | |||
+ | == Limitations == | ||
+ | |||
+ | * Only BMP files are supported and BMP images as C array (<code>lv_img_dsc_t</code>) 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 <code>LV_COLOR_DEPTH</code>. Use GIMP to save the image in the required format. Both RGB888 and ARGB888 works with <code>LV_COLOR_DEPTH 32</code> | ||
+ | * Palette is not supported. | ||
+ | * Because not the whole image is read in can not be zoomed or rotated. | ||
+ | |||
+ | == Example == | ||
+ | |||
+ | === Open a BMP image from file === | ||
+ | [[ファイル:LVGL docs others gridnav 03.png|サムネイル]] | ||
+ | |||
+ | |||
+ | https://docs.lvgl.io/8.2/libs/bmp.html#open-a-bmp-image-from-file | ||
+ | |||
+ | ---- | ||
+ | |||
+ | == API == | ||
+ | Functions | ||
+ | |||
+ | ; <span id="_CPPv311lv_bmp_initv"></span><span id="_CPPv211lv_bmp_initv"></span><span id="lv_bmp_init__void"></span><span id="lv__bmp_8h_1a840775046f734a65dfeaca9d4a606154" class="target"></span>void lv_bmp_init(void) | ||
+ | |||
2022年6月28日 (火) 13:01時点における版
https://docs.lvgl.io/8.2/libs/bmp.html
英文 | 自動翻訳 |
---|---|
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 withLV_COLOR_DEPTH 32
- Palette is not supported.
- Because not the whole image is read in can not be zoomed or rotated.
Example
Open a BMP image from file
https://docs.lvgl.io/8.2/libs/bmp.html#open-a-bmp-image-from-file
API
Functions
- void lv_bmp_init(void)