「App:Library:LVGL:docs:3rd party libraries:BMP decoder」の版間の差分

提供: robot-jp wiki
ナビゲーションに移動検索に移動
9行目: 9行目:
 
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.
 
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:
+
If enabled in <code style="color: #bb0000;">lv_conf.h</code> by <code style="color: #bb0000;">LV_USE_BMP</code> LVGL will register a new image decoder automatically so BMP files can be directly used as image sources. For example:
 +
<syntaxhighlight lang="C++" style="border:1px dashed gray;">
 
  lv_img_set_src(my_img, "S:path/to/picture.bmp");
 
  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>
+
</syntaxhighlight>
 +
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 style="color: #bb0000;">lv_conf.h</code> with <code style="color: #bb0000;">LV_USE_FS_...</code>
 
|この拡張機能により、LVGLでBMPイメージを使用できます。この実装では、bmp-decoderライブラリを使用します。ピクセルはオンデマンドで読み取られるため(画像全体が読み込まれるわけではありません)、BMP画像を使用するために必要なRAMはごくわずかです。
 
|この拡張機能により、LVGLでBMPイメージを使用できます。この実装では、bmp-decoderライブラリを使用します。ピクセルはオンデマンドで読み取られるため(画像全体が読み込まれるわけではありません)、BMP画像を使用するために必要なRAMはごくわずかです。
  
LVGLで有効に<code>lv_conf.h</code>する<code>LV_USE_BMP</code>と、新しい画像デコーダーが自動的に登録されるため、BMPファイルを画像ソースとして直接使用できます。例えば:
+
LVGLで有効に<code style="color: #bb0000;">lv_conf.h</code>する<code style="color: #bb0000;">LV_USE_BMP</code>と、新しい画像デコーダーが自動的に登録されるため、BMPファイルを画像ソースとして直接使用できます。例えば:
 +
<syntaxhighlight lang="C++" style="border:1px dashed gray;">
 
  lv_img_set_src(my_img、 "S:path / to / picture.bmp");
 
  lv_img_set_src(my_img、 "S:path / to / picture.bmp");
ファイルからイメージを開くには、ファイルシステムドライバを登録する必要があることに注意してください。詳細についてはこちらをご覧になるか、で有効に<code>lv_conf.h</code>してください<code>LV_USE_FS_...</code>
+
</syntaxhighlight>
 +
ファイルからイメージを開くには、ファイルシステムドライバを登録する必要があることに注意してください。詳細についてはこちらをご覧になるか、で有効に<code style="color: #bb0000;">lv_conf.h</code>してください<code style="color: #bb0000;">LV_USE_FS_...</code>
 
|}
 
|}
  
27行目: 31行目:
 
|
 
|
  
* 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.
+
* Only BMP files are supported and BMP images as C array (<code style="color: #bb0000;">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.
 
* 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>
+
* The BMP files color format needs to match with <code style="color: #bb0000;">LV_COLOR_DEPTH</code>. Use GIMP to save the image in the required format. Both RGB888 and ARGB888 works with <code style="color: #bb0000;">LV_COLOR_DEPTH 32</code>
 
* Palette is not supported.
 
* Palette is not supported.
 
* Because not the whole image is read in can not be zoomed or rotated.
 
* Because not the whole image is read in can not be zoomed or rotated.
 
|
 
|
* BMPファイルのみがサポートされており、C配列(<code>lv_img_dsc_t</code>)としてのBMPイメージはサポートされていません。これは、BMPファイルとLVGLの画像形式が画像データを保存する方法に実際的な違いがないためです。
+
* BMPファイルのみがサポートされており、C配列(<code style="color: #bb0000;">lv_img_dsc_t</code>)としてのBMPイメージはサポートされていません。これは、BMPファイルとLVGLの画像形式が画像データを保存する方法に実際的な違いがないためです。
 
* BMPファイルはファイルからのみロードできます。それらをフラッシュに保存したい場合は、LVGLの画像コンバーターを使用してC配列に変換することをお勧めします。
 
* BMPファイルはファイルからのみロードできます。それらをフラッシュに保存したい場合は、LVGLの画像コンバーターを使用してC配列に変換することをお勧めします。
* BMPファイルの色形式は。と一致する必要があります<code>LV_COLOR_DEPTH</code>。GIMPを使用して、必要な形式で画像を保存します。RGB888とARGB888の両方が<code>LV_COLOR_DEPTH 32</code>
+
* BMPファイルの色形式は。と一致する必要があります<code style="color: #bb0000;">LV_COLOR_DEPTH</code>。GIMPを使用して、必要な形式で画像を保存します。RGB888とARGB888の両方が<code style="color: #bb0000;">LV_COLOR_DEPTH 32</code>
 
* パレットはサポートされていません。
 
* パレットはサポートされていません。
 
* 画像全体が読み込まれないため、ズームや回転はできません。
 
* 画像全体が読み込まれないため、ズームや回転はできません。

2022年6月29日 (水) 15:15時点における版

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_...

この拡張機能により、LVGLでBMPイメージを使用できます。この実装では、bmp-decoderライブラリを使用します。ピクセルはオンデマンドで読み取られるため(画像全体が読み込まれるわけではありません)、BMP画像を使用するために必要なRAMはごくわずかです。

LVGLで有効にlv_conf.hするLV_USE_BMPと、新しい画像デコーダーが自動的に登録されるため、BMPファイルを画像ソースとして直接使用できます。例えば:

 lv_img_set_srcmy_img "S:path / to / picture.bmp";

ファイルからイメージを開くには、ファイルシステムドライバを登録する必要があることに注意してください。詳細についてはこちらをご覧になるか、で有効にlv_conf.hしてください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.
  • BMPファイルのみがサポートされており、C配列(lv_img_dsc_t)としてのBMPイメージはサポートされていません。これは、BMPファイルとLVGLの画像形式が画像データを保存する方法に実際的な違いがないためです。
  • BMPファイルはファイルからのみロードできます。それらをフラッシュに保存したい場合は、LVGLの画像コンバーターを使用してC配列に変換することをお勧めします。
  • BMPファイルの色形式は。と一致する必要がありますLV_COLOR_DEPTH。GIMPを使用して、必要な形式で画像を保存します。RGB888とARGB888の両方がLV_COLOR_DEPTH 32
  • パレットはサポートされていません。
  • 画像全体が読み込まれないため、ズームや回転はできません。


Example

英文 自動翻訳

Open a BMP image from file

LVGL docs others gridnav 03.png


API

英文 自動翻訳

Functions

void lv_bmp_init(void)



戻る : Previous