App:Library:LVGL:docs:Overview:Images

https://docs.lvgl.io/8.2/overview/image.html

Images

英文	自動翻訳
An image can be a file or a variable which stores the bitmap itself and some metadata.	画像は、ビットマップそのものといくつかのメタデータを格納するファイルまたは変数にすることができます。

戻る : Previous

Store images

英文	自動翻訳
You can store images in two places as a variable in internal memory (RAM or ROM) as a file	画像は、次の2つの場所に保存することができます。 内部メモリー（RAMまたはROM）の変数として ファイルとして

戻る : Previous

Variables

英文

自動翻訳

Images stored internally in a variable are composed mainly of an lv_img_dsc_t structure with the following fields: header cf Color format. See below w width in pixels (<= 2048) h height in pixels (<= 2048) always zero 3 bits which need to be always zero reserved reserved for future use data pointer to an array where the image itself is stored data_size length of data in bytes These are usually stored within a project as C files. They are linked into the resulting executable like any other constant data.

変数に格納される画像は、主に以下のフィールドを持つ lv_img_dsc_t 構造体から構成される。 ヘッダ cf カラーフォーマット。下記参照 w 幅 (ピクセル) (<= 2048) h 高さ (ピクセル) (<= 2048) always zero 　常にゼロであることが必要な3ビット reserved 　将来使用するために予約されている 画像そのものが格納される配列へのdata ポインタ． data_size 　data 単位で表されるデータの長さ。 これらは通常、Cファイルとしてプロジェクト内に保存されます。他の定数データと同じように実行ファイルにリンクされます。

戻る : Previous

Files

英文

自動翻訳

To deal with files you need to add a storage Drive to LVGL. In short, a Drive is a collection of functions (open, read, close, etc.) registered in LVGL to make file operations. You can add an interface to a standard file system (FAT32 on SD card) or you create your simple file system to read data from an SPI Flash memory. In every case, a Drive is just an abstraction to read and/or write data to memory. See the File system section to learn more. Images stored as files are not linked into the resulting executable, and must be read into RAM before being drawn. As a result, they are not as resource-friendly as images linked at compile time. However, they are easier to replace without needing to rebuild the main program.

ファイルを扱うには、LVGLにストレージDriveを追加する必要があります。つまり、DriveとはLVGLに登録されたファイル操作を行うための関数（open, read, closeなど）の集合体です。 標準的なファイルシステム（SDカードのFAT32）へのインタフェースを追加したり、SPIフラッシュメモリからデータを読み込むための簡単なファイルシステムを作成することができます。 いずれの場合も、ドライブはメモリにデータを読み書きするための抽象化されたものに過ぎません。 詳しくは、ファイルシステムのセクションを参照してください。 ファイルとして保存された画像は、結果の実行ファイルにリンクされず、描画する前にRAMに読み込まれる必要があります。 そのため、コンパイル時にリンクされた画像ほどリソースに優しくはありません。 しかし、メインプログラムを再構築することなく、簡単に交換することができます。

戻る : Previous

Color formats

英文

自動翻訳

Various built-in color formats are supported: LV_IMG_CF_TRUE_COLOR Simply stores the RGB colors (in whatever color depth LVGL is configured for). LV_IMG_CF_TRUE_COLOR_ALPHA Like LV_IMG_CF_TRUE_COLOR but it also adds an alpha (transparency) byte for every pixel. LV_IMG_CF_TRUE_COLOR_CHROMA_KEYED Like LV_IMG_CF_TRUE_COLOR but if a pixel has the LV_COLOR_TRANSP color (set in lv_conf.h) it will be transparent. LV_IMG_CF_INDEXED_1/2/4/8BIT Uses a palette with 2, 4, 16 or 256 colors and stores each pixel in 1, 2, 4 or 8 bits. LV_IMG_CF_ALPHA_1/2/4/8BIT Only stores the Alpha value with 1, 2, 4 or 8 bits. The pixels take the color of style.img_recolor and the set opacity. The source image has to be an alpha channel. This is ideal for bitmaps similar to fonts where the whole image is one color that can be altered. The bytes of LV_IMG_CF_TRUE_COLOR images are stored in the following order. For 32-bit color depth: Byte 0: Blue Byte 1: Green Byte 2: Red Byte 3: Alpha For 16-bit color depth: Byte 0: Green 3 lower bit, Blue 5 bit Byte 1: Red 5 bit, Green 3 higher bit Byte 2: Alpha byte (only with LV_IMG_CF_TRUE_COLOR_ALPHA) For 8-bit color depth: Byte 0: Red 3 bit, Green 3 bit, Blue 2 bit Byte 2: Alpha byte (only with LV_IMG_CF_TRUE_COLOR_ALPHA) You can store images in a Raw format to indicate that it's not encoded with one of the built-in color formats and an external Image decoder needs to be used to decode the image. LV_IMG_CF_RAW Indicates a basic raw image (e.g. a PNG or JPG image). LV_IMG_CF_RAW_ALPHA Indicates that an image has alpha and an alpha byte is added for every pixel. LV_IMG_CF_RAW_CHROMA_KEYED Indicates that an image is chroma-keyed as described in LV_IMG_CF_TRUE_COLOR_CHROMA_KEYED above.

Various built-in color formats are supported: LV_IMG_CF_TRUE_COLOR 単純にRGBの色を保存します（LVGLが設定されている色深度であれば、何でも構いません）。 LV_IMG_CF_TRUE_COLOR_ALPHA ： LV_IMG_CF_TRUE_COLOR に似ていますが、アルファも追加されます。 LV_IMG_CF_TRUE_COLOR_CHROMA_KEYED ：LV_IMG_CF_TRUE_COLOR に似ていますが、ピクセルが LV_COLOR_TRANSP カラー（ lv_conf.h で設定）であれば透明となります。 LV_IMG_CF_INDEXED_1/2/4/8BIT 2, 4, 16, 256色のパレットを使用し、各ピクセルを1, 2, 4, 8ビットで格納します。 LV_IMG_CF_ALPHA_1/2/4/8BIT 1, 2, 4, 8ビットのアルファ値のみが格納されます。ピクセルはstyle.img_recolorの色と設定された不透明度をとります。ソース画像はアルファチャンネルである必要があります。これは、画像全体が1色で変更可能なフォントのようなビットマップに最適です。 LV_IMG_CF_TRUE_COLOR 画像のバイトは、以下の順序で格納される。 32ビット色深度の場合。 Byte 0: 青 Byte 1: グリーン Byte 2: 赤 Byte 3: 透過度（アルファ） 16ビット色深度の場合。 Byte 0: 緑3下ビット、青5ビット Byte 1: 赤5ビット、緑3上位ビット Byte 2: 透過度:アルファバイト（LV_IMG_CF_TRUE_COLOR_ALPHAのみ） 8ビット色深度の場合。 Byte 0: 赤3ビット、緑3ビット、青2ビット Byte 2: 透過度:アルファバイト（LV_IMG_CF_TRUE_COLOR_ALPHAのみ） 画像をRaw形式で保存して、組み込みのカラー形式の1つでエンコードされていないこと、および画像をデコードするために外部の画像デコーダーを使用する必要があることを示すことができます。 LV_IMG_CF_RAW 基本的なraw画像（PNGまたはJPG画像など）を示します。 LV_IMG_CF_RAW_ALPHA 画像にアルファがあり、ピクセルごとにアルファバイトが追加されていることを示します。 LV_IMG_CF_RAW_CHROMA_KEYED 上記のLV_IMG_CF_TRUE_COLOR_CHROMA_KEYED 前述のLV_IMG_CF_TRUE_COLOR_CHROMA_KEYEDで説明されているように、画像がクロマキーで制御されていることを示します。

戻る : Previous

Add and use images

英文	自動翻訳
You can add images to LVGL in two ways: using the online converter manually create images	LVGLにイメージを追加するには、次の2つの方法があります。 オンラインコンバータの使用 イメージを手動で作成する

戻る : Previous

Online converter

英文

自動翻訳

The online Image converter is available here: https://lvgl.io/tools/imageconverter Adding an image to LVGL via the online converter is easy. You need to select a BMP, PNG or JPG image first. Give the image a name that will be used within LVGL. Select the Color format. Select the type of image you want. Choosing a binary will generate a .bin file that must be stored separately and read using the file support. Choosing a variable will generate a standard C file that can be linked into your project. Hit the Convert button. Once the conversion is finished, your browser will automatically download the resulting file. In the generated C arrays (variables), bitmaps for all the color depths (1, 8, 16 or 32) are included in the C file, but only the color depth that matches LV_COLOR_DEPTH in lv_conf.h will actually be linked into the resulting executable. In the case of binary files, you need to specify the color format you want: RGB332 for 8-bit color depth RGB565 for 16-bit color depth RGB565 Swap for 16-bit color depth (two bytes are swapped) RGB888 for 32-bit color depth

オンラインのイメージコンバータは次のURLで入手できます。https://lvgl.io/tools/imageconverter オンラインコンバータを介してLVGLにイメージを簡単に追加できます。 まず、BMP、PNG、JPGのいずれかの画像を選択する必要があります。 画像にはLVGL内で使用される名前をつけてください。 カラー形式を選択します。 画像の種類を選択します。バイナリを選択すると.binファイルが生成され、別途保存し、ファイルサポートを使用して読み込む必要があります。変数を選択すると、プロジェクトにリンクできる標準的なCファイルが生成されます。 Convertボタンを押します。変換が完了すると、ブラウザが自動的に変換後のファイルをダウンロードします。 生成されたCの配列（変数）には、すべての色深度（1、8、16、32）のビットマップが含まれますが、lv_conf.hのLV_COLOR_DEPTHに一致する色深度だけが実際に結果の実行ファイルにリンクされることになります。 バイナリファイルの場合は、希望する色形式を指定する必要があります。 RGB332 for 8-bit 色深度用 RGB565 for 16-bit 色深度用 RGB565 Swap for 16-bit 色深度用 (two bytes are swapped) RGB888 for 32-bit 色深度用

戻る : Previous

Manually create an image

英文

自動翻訳

If you are generating an image at run-time, you can craft an image variable to display it using LVGL. For example: uint8_t my_img_data[] = {0x00, 0x01, 0x02, ...}; static lv_img_dsc_t my_img_dsc = { .header.always_zero = 0, .header.w = 80, .header.h = 60, .data_size = 80 * 60 * LV_COLOR_DEPTH / 8, .header.cf = LV_IMG_CF_TRUE_COLOR, /*Set the color format*/ .data = my_img_data, }; If the color format is LV_IMG_CF_TRUE_COLOR_ALPHA you can set data_size like 80 * 60 * LV_IMG_PX_SIZE_ALPHA_BYTE. Another (possibly simpler) option to create and display an image at run-time is to use the Canvas object.

実行時に画像を生成している場合、画像変数を細工してLVGLで表示することができます。例えば uint8_t my_img_data[] = {0x00, 0x01, 0x02, ...}; static lv_img_dsc_t my_img_dsc = { .header.always_zero = 0, .header.w = 80, .header.h = 60, .data_size = 80 * 60 * LV_COLOR_DEPTH / 8, .header.cf = LV_IMG_CF_TRUE_COLOR, /*Set the color format*/ .data = my_img_data, }; カ ラーフォーマットが LV_IMG_CF_TRUE_COLOR_ALPHA の場合、 data_size を 80 * 60 * LV_IMG_PX_SIZE_ALPHA_BYTEのように設定することが可能です。 ランタイムに画像を作成し表示するもう一つの（おそらくより単純な）オプションは、Canvasオブジェクトを使用することです。

戻る : Previous

Use images

英文	自動翻訳
The simplest way to use an image in LVGL is to display it with an lv_img object: lv_obj_t * icon = lv_img_create(lv_scr_act(), NULL); /*From variable*/ lv_img_set_src(icon, &my_icon_dsc); /*From file*/ lv_img_set_src(icon, "S:my_icon.bin"); If the image was converted with the online converter, you should use LV_IMG_DECLARE(my_icon_dsc) to declare the image in the file where you want to use it.	LVGLで画像を使用する最も簡単な方法は、lv_imgオブジェクトで表示することです。 lv_obj_t * icon = lv_img_create(lv_scr_act(), NULL); /*From variable*/ lv_img_set_src(icon, &my_icon_dsc); /*From file*/ lv_img_set_src(icon, "S:my_icon.bin"); オンラインコンバータで変換した画像の場合は、LV_IMG_DECLARE(my_icon_dsc)で画像を使用するファイルの中で宣言しておく必要があります。

戻る : Previous

Image decoder

英文

自動翻訳

As you can see in the Color formats section, LVGL supports several built-in image formats. In many cases, these will be all you need. LVGL doesn't directly support, however, generic image formats like PNG or JPG. To handle non-built-in image formats, you need to use external libraries and attach them to LVGL via the Image decoder interface. An image decoder consists of 4 callbacks: info get some basic info about the image (width, height and color format). open open an image: either store a decoded image or set it to NULL to indicate the image can be read line-by-line. read if open didn't fully open an image this function should give some decoded data (max 1 line) from a given position. close close an opened image, free the allocated resources. You can add any number of image decoders. When an image needs to be drawn, the library will try all the registered image decoders until it finds one which can open the image, i.e. one which knows that format. The LV_IMG_CF_TRUE_COLOR_..., LV_IMG_INDEXED_... and LV_IMG_ALPHA_... formats (essentially, all non-RAW formats) are understood by the built-in decoder. Custom image formats The easiest way to create a custom image is to use the online image converter and select Raw, Raw with alpha or Raw with chroma-keyed format. It will just take every byte of the binary file you uploaded and write it as an image "bitmap". You then need to attach an image decoder that will parse that bitmap and generate the real, renderable bitmap. header.cf will be LV_IMG_CF_RAW, LV_IMG_CF_RAW_ALPHA or LV_IMG_CF_RAW_CHROMA_KEYED accordingly. You should choose the correct format according to your needs: a fully opaque image, using an alpha channel or using a chroma key. After decoding, the raw formats are considered True color by the library. In other words, the image decoder must decode the Raw images to True color according to the format described in the Color formats section. If you want to create a custom image, you should use LV_IMG_CF_USER_ENCODED_0..7 color formats. However, the library can draw images only in True color format (or Raw but ultimately it will be in True color format). The LV_IMG_CF_USER_ENCODED_... formats are not known by the library and therefore they should be decoded to one of the known formats from the Color formats section. It's possible to decode an image to a non-true color format first (for example: LV_IMG_INDEXED_4BITS) and then call the built-in decoder functions to convert it to True color. With User encoded formats, the color format in the open function (dsc->header.cf) should be changed according to the new format.

カラーフォーマットのセクションにあるように、LVGLはいくつかのビルトインイメージフォーマットをサポートしています。多くの場合、これらが必要なすべてでしょう。しかし、LVGLは、PNGやJPGのような一般的な画像形式を直接はサポートしていません。 内蔵されていない画像形式を扱うには、外部ライブラリを使用し、Image decoder interfaceを介してLVGLにアタッチする必要があります。 画像デコーダは4つのコールバックで構成される。 は、画像に関する基本的な情報（幅、高さ、カラーフォーマット）を取得します。 open 画像を開く: デコードされた画像を格納するか，あるいは画像を一行ごとに読めることを示すために NULL を設定する． open が画像を完全に開いていない場合、この関数は与えられた位置からいくつかのデコードされたデータ（最大1行）を与えるはずです。 close 開いた画像を閉じ、割り当てられたリソースを解放する。 イメージデコーダはいくつでも追加できます。画像を描画する必要があるとき、ライブラリは画像を開くことができるもの、つまりそのフォーマットを知っているものが見つかるまで、登録されたすべての画像デコーダを試します。 The LV_IMG_CF_TRUE_COLOR_..., LV_IMG_INDEXED_... と LV_IMG_ALPHA_... 形式（基本的に、すべての非RAW 形式）は、内蔵デコーダで理解されます。 Custom image formats カスタム画像を作成する最も簡単な方法は、オンラインの画像変換ソフトを使い、Raw、Raw with alpha、Raw with chroma-keyed のいずれかの形式を選択することです。 アップロードしたバイナリファイルの各バイトを取り込んで、画像「ビットマップ」として書き込むだけです。 そして、そのビットマップを解析し、実際のレンダリング可能なビットマップを生成する画像デコーダを添付する必要があります。 header.cf は LV_IMG_CF_RAW, LV_IMG_CF_RAW_ALPHA またはLV_IMG_CF_RAW_CHROMA_KEYED になります。 完全に不透明な画像，アルファチャンネルを使用したもの，クロマキーを使用したものなど，必要に応じて適切な形式を選択する必要があります． デコード後、RawフォーマットはライブラリによってTrueカラーとみなされる。つまり、画像デコーダはRaw画像をカラーフォーマットの項で説明したフォーマットに従ってTrueカラーにデコードする必要がある。 カスタム画像を作成する場合は、LV_IMG_CF_USER_ENCODED_0..7 のカラー形式を使用する必要があります。 ただし、ライブラリはTrueカラー形式（またはRawだが最終的にはTrueカラー形式になる）のみで画像を描画することができる。 LV_IMG_CF_USER_ENCODED_... のフォーマットはライブラリで知られていないため、カラーフォーマットセクションの既知のフォーマットのいずれかにデコードする必要があります。 画像をまずトゥルーカラーでないフォーマット(例えばLV_IMG_INDEXED_4BITS) にデコードしてから、内蔵のデコーダ関数を呼び出してトゥルーカラーに変換することは可能です。 User エンコードされたフォーマットでは、open 関数 (dsc->header.cf) のカラーフォーマットは新しいフォーマットに従って変更される必要があります。

戻る : Previous

Register an image decoder

英文

自動翻訳

Here's an example of getting LVGL to work with PNG images. First, you need to create a new image decoder and set some functions to open/close the PNG files. It should look like this: /*Create a new decoder and register functions */ lv_img_decoder_t * dec = lv_img_decoder_create(); lv_img_decoder_set_info_cb(dec, decoder_info); lv_img_decoder_set_open_cb(dec, decoder_open); lv_img_decoder_set_close_cb(dec, decoder_close); /** * Get info about a PNG image * @param decoder pointer to the decoder where this function belongs * @param src can be file name or pointer to a C array * @param header store the info here * @return LV_RES_OK: no error; LV_RES_INV: can't get the info */ static lv_res_t decoder_info(lv_img_decoder_t * decoder, const void * src, lv_img_header_t * header) { /*Check whether the type `src` is known by the decoder*/ if(is_png(src) == false) return LV_RES_INV; /* Read the PNG header and find `width` and `height` */ ... header->cf = LV_IMG_CF_RAW_ALPHA; header->w = width; header->h = height; } /** * Open a PNG image and return the decided image * @param decoder pointer to the decoder where this function belongs * @param dsc pointer to a descriptor which describes this decoding session * @return LV_RES_OK: no error; LV_RES_INV: can't get the info */ static lv_res_t decoder_open(lv_img_decoder_t * decoder, lv_img_decoder_dsc_t * dsc) { /*Check whether the type `src` is known by the decoder*/ if(is_png(src) == false) return LV_RES_INV; /*Decode and store the image. If `dsc->img_data` is `NULL`, the `read_line` function will be called to get the image data line-by-line*/ dsc->img_data = my_png_decoder(src); /*Change the color format if required. For PNG usually 'Raw' is fine*/ dsc->header.cf = LV_IMG_CF_... /*Call a built in decoder function if required. It's not required if`my_png_decoder` opened the image in true color format.*/ lv_res_t res = lv_img_decoder_built_in_open(decoder, dsc); return res; } /** * Decode `len` pixels starting from the given `x`, `y` coordinates and store them in `buf`. * Required only if the "open" function can't open the whole decoded pixel array. (dsc->img_data == NULL) * @param decoder pointer to the decoder the function associated with * @param dsc pointer to decoder descriptor * @param x start x coordinate * @param y start y coordinate * @param len number of pixels to decode * @param buf a buffer to store the decoded pixels * @return LV_RES_OK: ok; LV_RES_INV: failed */ lv_res_t decoder_built_in_read_line(lv_img_decoder_t * decoder, lv_img_decoder_dsc_t * dsc, lv_coord_t x, lv_coord_t y, lv_coord_t len, uint8_t * buf) { /*With PNG it's usually not required*/ /*Copy `len` pixels from `x` and `y` coordinates in True color format to `buf` */ } /** * Free the allocated resources * @param decoder pointer to the decoder where this function belongs * @param dsc pointer to a descriptor which describes this decoding session */ static void decoder_close(lv_img_decoder_t * decoder, lv_img_decoder_dsc_t * dsc) { /*Free all allocated data*/ /*Call the built-in close function if the built-in open/read_line was used*/ lv_img_decoder_built_in_close(decoder, dsc); } So in summary: In decoder_info, you should collect some basic information about the image and store it in header. In decoder_open, you should try to open the image source pointed by dsc->src. Its type is already in dsc->src_type == LV_IMG_SRC_FILE/VARIABLE. If this format/type is not supported by the decoder, return LV_RES_INV. However, if you can open the image, a pointer to the decoded True color image should be set in dsc->img_data. If the format is known, but you don't want to decode the entire image (e.g. no memory for it), set dsc->img_data = NULL and use read_line to get the pixel data. In decoder_close you should free all allocated resources. decoder_read is optional. Decoding the whole image requires extra memory and some computational overhead. However, it can decode one line of the image without decoding the whole image, you can save memory and time. To indicate that the line read function should be used, set dsc->img_data = NULL in the open function.

ここでは、LVGLをPNG画像で動作させる例を示します。 まず、新しい画像デコーダを作り、PNGファイルを開いたり閉じたりするためのいくつかの関数を設定する必要があります。以下のような感じでいいと思います。 /*Create a new decoder and register functions */ lv_img_decoder_t * dec = lv_img_decoder_create(); lv_img_decoder_set_info_cb(dec, decoder_info); lv_img_decoder_set_open_cb(dec, decoder_open); lv_img_decoder_set_close_cb(dec, decoder_close); /** * Get info about a PNG image * @param decoder pointer to the decoder where this function belongs * @param src can be file name or pointer to a C array * @param header store the info here * @return LV_RES_OK: no error; LV_RES_INV: can't get the info */ static lv_res_t decoder_info(lv_img_decoder_t * decoder, const void * src, lv_img_header_t * header) { /*Check whether the type `src` is known by the decoder*/ if(is_png(src) == false) return LV_RES_INV; /* Read the PNG header and find `width` and `height` */ ... header->cf = LV_IMG_CF_RAW_ALPHA; header->w = width; header->h = height; } /** * Open a PNG image and return the decided image * @param decoder pointer to the decoder where this function belongs * @param dsc pointer to a descriptor which describes this decoding session * @return LV_RES_OK: no error; LV_RES_INV: can't get the info */ static lv_res_t decoder_open(lv_img_decoder_t * decoder, lv_img_decoder_dsc_t * dsc) { /*Check whether the type `src` is known by the decoder*/ if(is_png(src) == false) return LV_RES_INV; /*Decode and store the image. If `dsc->img_data` is `NULL`, the `read_line` function will be called to get the image data line-by-line*/ dsc->img_data = my_png_decoder(src); /*Change the color format if required. For PNG usually 'Raw' is fine*/ dsc->header.cf = LV_IMG_CF_... /*Call a built in decoder function if required. It's not required if`my_png_decoder` opened the image in true color format.*/ lv_res_t res = lv_img_decoder_built_in_open(decoder, dsc); return res; } /** * Decode `len` pixels starting from the given `x`, `y` coordinates and store them in `buf`. * Required only if the "open" function can't open the whole decoded pixel array. (dsc->img_data == NULL) * @param decoder pointer to the decoder the function associated with * @param dsc pointer to decoder descriptor * @param x start x coordinate * @param y start y coordinate * @param len number of pixels to decode * @param buf a buffer to store the decoded pixels * @return LV_RES_OK: ok; LV_RES_INV: failed */ lv_res_t decoder_built_in_read_line(lv_img_decoder_t * decoder, lv_img_decoder_dsc_t * dsc, lv_coord_t x, lv_coord_t y, lv_coord_t len, uint8_t * buf) { /*With PNG it's usually not required*/ /*Copy `len` pixels from `x` and `y` coordinates in True color format to `buf` */ } /** * Free the allocated resources * @param decoder pointer to the decoder where this function belongs * @param dsc pointer to a descriptor which describes this decoding session */ static void decoder_close(lv_img_decoder_t * decoder, lv_img_decoder_dsc_t * dsc) { /*Free all allocated data*/ /*Call the built-in close function if the built-in open/read_line was used*/ lv_img_decoder_built_in_close(decoder, dsc); } 以上をまとめると。 decoder_infoでは、画像に関する基本的な情報を収集し、headerに格納する必要があります。. decoder_open では、dsc->src が指すイメージソースを開こうとします。そのタイプはすでに dsc->src_type == LV_IMG_SRC_FILE/VARIABLEになっています。このフォーマット/タイプがデコーダによってサポートされていない場合、LV_RES_INVを返します。ただし、画像を開くことができれば、dsc->img_data にデコードされたトゥルーカラー画像へのポインタを設定する必要がある。フォーマットはわかっているが、画像全体をデコードしたくない場合（メモリがないなど）、dsc->img_data = NULLに設定し、read_lineでピクセルデータを取得する。 In decoder_closeでは、割り当てられたすべてのリソースを解放する必要があります。 decoder_read はオプションです。画像全体をデコードするには、余分なメモリと多少の計算オーバーヘッドが必要である。しかし、画像全体をデコードすることなく、画像の1行をデコードすることができれば、メモリと時間を節約することができる。ラインリード関数を使用することを示すには、open 関数内でdsc->img_data = NULLを設定します。

戻る : Previous

Manually use an image decoder

英文

自動翻訳

LVGL will use registered image decoders automatically if you try and draw a raw image (i.e. using the lv_img object) but you can use them manually too. Create an lv_img_decoder_dsc_t variable to describe the decoding session and call lv_img_decoder_open(). The color parameter is used only with LV_IMG_CF_ALPHA_1/2/4/8BIT images to tell color of the image. frame_id can be used if the image to open is an animation. lv_res_t res; lv_img_decoder_dsc_t dsc; res = lv_img_decoder_open(&dsc, &my_img_dsc, color, frame_id); if(res == LV_RES_OK) { /*Do something with `dsc->img_data`*/ lv_img_decoder_close(&dsc); }

LVGLは、生画像を描画しようとする場合（すなわち、lv_img オブジェクトを使 う場合）、自動的に登録された画像デコーダを使用しますが、手動で使用する こともできます。デコードセッションを記述するために lv_img_decoder_dsc_t変数を作成し、 lv_img_decoder_open() を呼びます。 color パラメータは LV_IMG_CF_ALPHA_1/2/4/8BIT 画像でのみ使用され、画像の色を知ることができます。frame_idは、開くイメージがアニメーションの場合に使用できます。 lv_res_t res; lv_img_decoder_dsc_t dsc; res = lv_img_decoder_open(&dsc, &my_img_dsc, color, frame_id); if(res == LV_RES_OK) { /*Do something with `dsc->img_data`*/ lv_img_decoder_close(&dsc); }

戻る : Previous

Image caching

英文

自動翻訳

Sometimes it takes a lot of time to open an image. Continuously decoding a PNG image or loading images from a slow external memory would be inefficient and detrimental to the user experience. Therefore, LVGL caches a given number of images. Caching means some images will be left open, hence LVGL can quickly access them from dsc->img_data instead of needing to decode them again. Of course, caching images is resource intensive as it uses more RAM to store the decoded image. LVGL tries to optimize the process as much as possible (see below), but you will still need to evaluate if this would be beneficial for your platform or not. Image caching may not be worth it if you have a deeply embedded target which decodes small images from a relatively fast storage medium.

画像を開くのに時間がかかることがある。 PNG画像をデコードし続けたり、遅い外部メモリから画像を読み込むことは、非効率でユーザーエクスペリエンスを損ないます。 そこで、LVGLでは、所定の枚数の画像をキャッシュします。 キャッシュすることは、いくつかの画像を開いたままにしておくことを意味し、したがってLVGLは、それらを再びデコードする必要がなく、dsc->img_dataから素早くアクセスすることができます。 もちろん、画像をキャッシュすることは、デコードされた画像を保存するために多くのRAMを使用するため、リソースを消費します。 LVGLは可能な限り処理を最適化しようとしますが（下記参照）、これがあなたのプラットフォームにとって有益かどうか、評価する必要があります。 画像キャッシュは、比較的高速な記憶媒体から小さな画像をデコードする深く埋め込まれたターゲットを持っている場合、価値がない可能性があります。

戻る : Previous

Cache size

英文	自動翻訳
The number of cache entries can be defined with LV_IMG_CACHE_DEF_SIZE in lv_conf.h. The default value is 1 so only the most recently used image will be left open. The size of the cache can be changed at run-time with lv_img_cache_set_size(entry_num).	キャッシュのエントリ数は lv_conf.h の LV_IMG_CACHE_DEF_SIZE で定義できます。デフォルト値は 1 で、最近使用した画像だけがオープンされたままになります。 キャッシュのサイズは、ランタイムに lv_img_cache_set_size(entry_num) で変更することができます。

戻る : Previous

Value of images

英文

自動翻訳

When you use more images than cache entries, LVGL can't cache all the images. Instead, the library will close one of the cached images to free space. To decide which image to close, LVGL uses a measurement it previously made of how long it took to open the image. Cache entries that hold slower-to-open images are considered more valuable and are kept in the cache as long as possible. If you want or need to override LVGL's measurement, you can manually set the time to open value in the decoder open function in dsc->time_to_open = time_ms to give a higher or lower value. (Leave it unchanged to let LVGL control it.) Every cache entry has a "life" value. Every time an image is opened through the cache, the life value of all entries is decreased to make them older. When a cached image is used, its life value is increased by the time to open value to make it more alive. If there is no more space in the cache, the entry with the lowest life value will be closed.

キャッシュエントリより多くの画像を使用する場合、LVGLはすべての画像をキャッ シュすることができません。その代わりに、ライブラリはキャッシュされたイメージの1つを閉じて、スペースを空けることになります。 どの画像を閉じるかを決定するために、LVGLは画像を開くのにどれくらい時間がかかったかを以前に行った測定値を使用します。 開くのに時間のかかる画像を保持するキャッシュエントリは、より価値があるとみなされ、できるだけ長くキャッシュに保持されます。 LVGLの測定値を上書きしたい場合は、デコーダのopen関数のtime to openの値をdsc->time_to_open = time_msで手動で設定し、より大きい値または小さい値を与えることができる。(LVGLに制御させるために変更しないままにしておきます)。 すべてのキャッシュエントリは "ライフ "値を持っています。キャッシュを通して画像が開かれるたびに、すべてのエントリの寿命の値が減少し、古いものになります。キャッシュされた画像が使用されると、その寿命の値はオープンまでの時間の値によって増加し、より生き生きとしたものになります。 キャッシュに空き容量がない場合、ライフ値が最も低いエントリーが閉じられます。

戻る : Previous

Memory usage

英文	自動翻訳
Note that a cached image might continuously consume memory. For example, if three PNG images are cached, they will consume memory while they are open. Therefore, it's the user's responsibility to be sure there is enough RAM to cache even the largest images at the same time.	キャッシュされた画像は、継続的にメモリを消費する可能性があることに注意してください。例えば、3つのPNG画像がキャッシュされた場合、それらが開いている間、メモリを消費します。 したがって、最大の画像を同時にキャッシュするのに十分なRAMがあることを確認するのは、ユーザーの責任です。

戻る : Previous

Clean the cache

英文

自動翻訳

Let's say you have loaded a PNG image into a lv_img_dsc_t my_png variable and use it in an lv_img object. If the image is already cached and you then change the underlying PNG file, you need to notify LVGL to cache the image again. Otherwise, there is no easy way of detecting that the underlying file changed and LVGL will still draw the old image from cache. To do this, use lv_img_cache_invalidate_src(&my_png). If NULL is passed as a parameter, the whole cache will be cleaned.

例えば、PNG画像をlv_img_dsc_t my_png変数にロードし、それをlv_imgオブジェクトで使用したとします。 もし、画像がすでにキャッシュされており、その後、基礎となるPNGファイルを変更した場合、LVGLに画像を再度キャッシュするように通知する必要があります。 さもなければ、基礎となるファイルが変更されたことを検出する簡単な方法がなく、LVGLはキャッシュから古い画像を描画します。 これを行うには、lv_img_cache_invalidate_src(&my_png)を使用します。 パラメータとしてNULL が渡された場合、キャッシュ全体がクリーンアップされます。

戻る : Previous

API

Image buffer

英文	自動翻訳
Typedefs typedef uint8_t lv_img_cf_t Enums enum [anonymous] Values: enumerator LV_IMG_CF_UNKNOWN enumerator LV_IMG_CF_RAW Contains the file as it is. Needs custom decoder function enumerator LV_IMG_CF_RAW_ALPHA Contains the file as it is. The image has alpha. Needs custom decoder function enumerator LV_IMG_CF_RAW_CHROMA_KEYED Contains the file as it is. The image is chroma keyed. Needs custom decoder function enumerator LV_IMG_CF_TRUE_COLOR Color format and depth should match with LV_COLOR settings enumerator LV_IMG_CF_TRUE_COLOR_ALPHA Same as LV_IMG_CF_TRUE_COLOR but every pixel has an alpha byte enumerator LV_IMG_CF_TRUE_COLOR_CHROMA_KEYED Same as LV_IMG_CF_TRUE_COLOR but LV_COLOR_TRANSP pixels will be transparent enumerator LV_IMG_CF_INDEXED_1BIT Can have 2 different colors in a palette (always chroma keyed) enumerator LV_IMG_CF_INDEXED_2BIT Can have 4 different colors in a palette (always chroma keyed) enumerator LV_IMG_CF_INDEXED_4BIT Can have 16 different colors in a palette (always chroma keyed) enumerator LV_IMG_CF_INDEXED_8BIT Can have 256 different colors in a palette (always chroma keyed) enumerator LV_IMG_CF_ALPHA_1BIT Can have one color and it can be drawn or not enumerator LV_IMG_CF_ALPHA_2BIT Can have one color but 4 different alpha value enumerator LV_IMG_CF_ALPHA_4BIT Can have one color but 16 different alpha value enumerator LV_IMG_CF_ALPHA_8BIT Can have one color but 256 different alpha value enumerator LV_IMG_CF_RESERVED_15 Reserved for further use. enumerator LV_IMG_CF_RESERVED_16 Reserved for further use. enumerator LV_IMG_CF_RESERVED_17 Reserved for further use. enumerator LV_IMG_CF_RESERVED_18 Reserved for further use. enumerator LV_IMG_CF_RESERVED_19 Reserved for further use. enumerator LV_IMG_CF_RESERVED_20 Reserved for further use. enumerator LV_IMG_CF_RESERVED_21 Reserved for further use. enumerator LV_IMG_CF_RESERVED_22 Reserved for further use. enumerator LV_IMG_CF_RESERVED_23 Reserved for further use. enumerator LV_IMG_CF_USER_ENCODED_0 User holder encoding format. enumerator LV_IMG_CF_USER_ENCODED_1 User holder encoding format. enumerator LV_IMG_CF_USER_ENCODED_2 User holder encoding format. enumerator LV_IMG_CF_USER_ENCODED_3 User holder encoding format. enumerator LV_IMG_CF_USER_ENCODED_4 User holder encoding format. enumerator LV_IMG_CF_USER_ENCODED_5 User holder encoding format. enumerator LV_IMG_CF_USER_ENCODED_6 User holder encoding format. enumerator LV_IMG_CF_USER_ENCODED_7 User holder encoding format.	Typedefs typedef uint8_t lv_img_cf_t Enums enum [anonymous] Values: enumerator LV_IMG_CF_UNKNOWN enumerator LV_IMG_CF_RAW ファイルをそのまま収録しています。カスタムデコーダ機能が必要 enumerator LV_IMG_CF_RAW_ALPHA ファイルをそのまま収録しています。画像はアルファを含む。カスタムデコーダ機能が必要 enumerator LV_IMG_CF_RAW_CHROMA_KEYED ファイルをそのまま収録しています。画像はクロマキー処理されています。カスタムデコーダ機能が必要 enumerator LV_IMG_CF_TRUE_COLOR カラーフォーマットと深度はLV_COLORの設定と一致する必要があります。 enumerator LV_IMG_CF_TRUE_COLOR_ALPHA LV_IMG_CF_TRUE_COLOR と同じですが、各ピクセルにアルファバイトが含まれます。 enumerator LV_IMG_CF_TRUE_COLOR_CHROMA_KEYED LV_IMG_CF_TRUE_COLOR と同じですが、LV_COLOR_TRANSP の画素は透明になります。 enumerator LV_IMG_CF_INDEXED_1BIT パレット内に2種類の色を持つことができる（常にクロマキー処理される） enumerator LV_IMG_CF_INDEXED_2BIT パレット内に4色の色を持つことができる（常にクロマキー処理される） enumerator LV_IMG_CF_INDEXED_4BIT パレット内に16色の色を持つことができる（常にクロマキー処理される） enumerator LV_IMG_CF_INDEXED_8BIT 256色のパレットを持つことができる（常にクロマキー処理される） enumerator LV_IMG_CF_ALPHA_1BIT 1色で、描画の有無も可能 enumerator LV_IMG_CF_ALPHA_2BIT 1つの色で4つの異なるアルファ値を持つことができる enumerator LV_IMG_CF_ALPHA_4BIT 1つの色で16種類のアルファ値を持つことができる enumerator LV_IMG_CF_ALPHA_8BIT 1つの色で256通りのアルファ値を持つことができる enumerator LV_IMG_CF_RESERVED_15 今後使用するために予約した。 enumerator LV_IMG_CF_RESERVED_16 今後使用するために予約した。 enumerator LV_IMG_CF_RESERVED_17 今後使用するために予約した。 enumerator LV_IMG_CF_RESERVED_18 今後使用するために予約した。 enumerator LV_IMG_CF_RESERVED_19 今後使用するために予約した。 enumerator LV_IMG_CF_RESERVED_20 今後使用するために予約した。 enumerator LV_IMG_CF_RESERVED_21 今後使用するために予約した。 enumerator LV_IMG_CF_RESERVED_22 今後使用するために予約した。 enumerator LV_IMG_CF_RESERVED_23 Reserved for further use. enumerator LV_IMG_CF_USER_ENCODED_0 ユーザーホルダーのエンコード形式。 enumerator LV_IMG_CF_USER_ENCODED_1 ユーザーホルダーのエンコード形式。 enumerator LV_IMG_CF_USER_ENCODED_2 ユーザーホルダーのエンコード形式。 enumerator LV_IMG_CF_USER_ENCODED_3 ユーザーホルダーのエンコード形式。 enumerator LV_IMG_CF_USER_ENCODED_4 ユーザーホルダーのエンコード形式。 enumerator LV_IMG_CF_USER_ENCODED_5 ユーザーホルダーのエンコード形式。 enumerator LV_IMG_CF_USER_ENCODED_6 ユーザーホルダーのエンコード形式。 enumerator LV_IMG_CF_USER_ENCODED_7 ユーザーホルダーのエンコード形式。
Functions lv_img_dsc_t *lv_img_buf_alloc(lv_coord_t w, lv_coord_t h, lv_img_cf_t cf) Allocate an image buffer in RAM Parameters w -- width of image h -- height of image cf -- a color format (LV_IMG_CF_...) Returns an allocated image, or NULL on failure lv_color_t lv_img_buf_get_px_color(lv_img_dsc_t *dsc, lv_coord_t x, lv_coord_t y, lv_color_t color) Get the color of an image's pixel Parameters dsc -- an image descriptor x -- x coordinate of the point to get y -- x coordinate of the point to get color -- the color of the image. In case of LV_IMG_CF_ALPHA_1/2/4/8 this color is used. Not used in other cases. safe -- true: check out of bounds Returns color of the point lv_opa_t lv_img_buf_get_px_alpha(lv_img_dsc_t *dsc, lv_coord_t x, lv_coord_t y) Get the alpha value of an image's pixel Parameters dsc -- pointer to an image descriptor x -- x coordinate of the point to set y -- x coordinate of the point to set safe -- true: check out of bounds Returns alpha value of the point void lv_img_buf_set_px_color(lv_img_dsc_t *dsc, lv_coord_t x, lv_coord_t y, lv_color_t c) Set the color of a pixel of an image. The alpha channel won't be affected. Parameters dsc -- pointer to an image descriptor x -- x coordinate of the point to set y -- x coordinate of the point to set c -- color of the point safe -- true: check out of bounds void lv_img_buf_set_px_alpha(lv_img_dsc_t *dsc, lv_coord_t x, lv_coord_t y, lv_opa_t opa) Set the alpha value of a pixel of an image. The color won't be affected Parameters dsc -- pointer to an image descriptor x -- x coordinate of the point to set y -- x coordinate of the point to set opa -- the desired opacity safe -- true: check out of bounds void lv_img_buf_set_palette(lv_img_dsc_t *dsc, uint8_t id, lv_color_t c) Set the palette color of an indexed image. Valid only for LV_IMG_CF_INDEXED1/2/4/8 Parameters dsc -- pointer to an image descriptor id -- the palette color to set: for LV_IMG_CF_INDEXED1: 0..1 for LV_IMG_CF_INDEXED2: 0..3 for LV_IMG_CF_INDEXED4: 0..15 for LV_IMG_CF_INDEXED8: 0..255 c -- the color to set void lv_img_buf_free(lv_img_dsc_t *dsc) Free an allocated image buffer Parameters dsc -- image buffer to free uint32_t lv_img_buf_get_img_size(lv_coord_t w, lv_coord_t h, lv_img_cf_t cf) Get the memory consumption of a raw bitmap, given color format and dimensions. Parameters w -- width h -- height cf -- color format Returns size in bytes void _lv_img_buf_transform_init(lv_img_transform_dsc_t *dsc) Initialize a descriptor to rotate an image Parameters dsc -- pointer to an lv_img_transform_dsc_t variable whose cfg field is initialized bool _lv_img_buf_transform_anti_alias(lv_img_transform_dsc_t *dsc) Continue transformation by taking the neighbors into account Parameters dsc -- pointer to the transformation descriptor bool _lv_img_buf_transform(lv_img_transform_dsc_t *dsc, lv_coord_t x, lv_coord_t y) Get which color and opa would come to a pixel if it were rotated Note the result is written back to dsc->res_color and dsc->res_opa Parameters dsc -- a descriptor initialized by lv_img_buf_rotate_init x -- the coordinate which color and opa should be get y -- the coordinate which color and opa should be get Returns true: there is valid pixel on these x/y coordinates; false: the rotated pixel was out of the image void _lv_img_buf_get_transformed_area(lv_area_t *res, lv_coord_t w, lv_coord_t h, int16_t angle, uint16_t zoom, const lv_point_t *pivot) Get the area of a rectangle if its rotated and scaled Parameters res -- store the coordinates here w -- width of the rectangle to transform h -- height of the rectangle to transform angle -- angle of rotation zoom -- zoom, (256 no zoom) pivot -- x,y pivot coordinates of rotation struct lv_img_header_t #include <lv_img_buf.h> The first 8 bit is very important to distinguish the different source types. For more info see lv_img_get_src_type() in lv_img.c On big endian systems the order is reversed so cf and always_zero must be at the end of the struct. Public Members uint32_t h uint32_t w uint32_t reserved uint32_t always_zero uint32_t cf struct lv_img_header_t #include <lv_img_buf.h> The first 8 bit is very important to distinguish the different source types. For more info see lv_img_get_src_type() in lv_img.c On big endian systems the order is reversed so cf and always_zero must be at the end of the struct. Public Members uint32_t h uint32_t w uint32_t reserved uint32_t always_zero uint32_t cf struct lv_img_dsc_t #include <lv_img_buf.h> Image header it is compatible with the result from image converter utility Public Members lv_img_header_t header A header describing the basics of the image uint32_t data_size Size of the image in bytes const uint8_t *data Pointer to the data of the image struct lv_img_transform_dsc_t Public Members const void *src lv_coord_t src_w lv_coord_t src_h lv_coord_t pivot_x lv_coord_t pivot_y int16_t angle uint16_t zoom lv_color_t color lv_img_cf_t cf bool antialias struct lv_img_transform_dsc_t::[anonymous] cfg lv_opa_t opa struct lv_img_transform_dsc_t::[anonymous] res lv_img_dsc_t img_dsc int32_t pivot_x_256 int32_t pivot_y_256 int32_t sinma int32_t cosma uint8_t chroma_keyed uint8_t has_alpha uint8_t native_color uint32_t zoom_inv lv_coord_t xs lv_coord_t ys lv_coord_t xs_int lv_coord_t ys_int uint32_t pxi uint8_t px_size struct lv_img_transform_dsc_t::[anonymous] tmp	Functions lv_img_dsc_t *lv_img_buf_alloc(lv_coord_t w, lv_coord_t h, lv_img_cf_t cf) RAMに画像バッファを確保する Parameters w -- 画像の横幅 h -- 像の高さ cf -- カラーフォーマット(LV_IMG_CF_...) Returns 割り当てられたイメージ，あるいは失敗時に NULL を返します． lv_color_t lv_img_buf_get_px_color(lv_img_dsc_t *dsc, lv_coord_t x, lv_coord_t y, lv_color_t color) 画像の画素の色を取得する Parameters dsc -- 画像記述子 x -- 取得する点のx座標。 y -- 取得する点のy座標。 color -- イメージの色。LV_IMG_CF_ALPHA_1/2/4/8 の場合、この色が使用されます。それ以外の場合は使用しません。 safe -- true:範囲外をチェックアウト Returns 点の色 lv_opa_t lv_img_buf_get_px_alpha(lv_img_dsc_t *dsc, lv_coord_t x, lv_coord_t y) Get the alpha value of an image's pixel Parameters dsc -- イメージ記述子へのポインタ x --設定する点のx座標 y -- 設定する点のy座標 safe -- true:範囲外をチェックアウト Returns ポイントのアルファ値 void lv_img_buf_set_px_color(lv_img_dsc_t *dsc, lv_coord_t x, lv_coord_t y, lv_color_t c) 画像のピクセルの色を設定します。アルファチャンネルは影響を受けません。 Parameters dsc -- イメージ記述子へのポインタ x -- 設定する点のx座標 y -- 設定する点のy座標 c -- 点の色 safe -- true:範囲外をチェックアウト void lv_img_buf_set_px_alpha(lv_img_dsc_t *dsc, lv_coord_t x, lv_coord_t y, lv_opa_t opa) イメージのピクセルのアルファ値を設定します。色には影響しません Parameters dsc -- イメージ記述子へのポインタ x -- 設定する点のx座標 y -- 設定する点のy座標 opa -- 所望の不透明度 safe --true:範囲外をチェックアウト void lv_img_buf_set_palette(lv_img_dsc_t *dsc, uint8_t id, lv_color_t c) インデックス付きイメージのパレットカラーを設定します。 LV_IMG_CF_INDEXED1/2/4/8のみ有効 Parameters dsc -- イメージ記述子へのポインタ id --設定するパレットの色: for LV_IMG_CF_INDEXED1: 0..1 for LV_IMG_CF_INDEXED2: 0..3 for LV_IMG_CF_INDEXED4: 0..15 for LV_IMG_CF_INDEXED8: 0..255 c -- 設定する色 void lv_img_buf_free(lv_img_dsc_t *dsc) 割り当てられたイメージバッファを解放する Parameters dsc -- 解放するイメージバッファ uint32_t lv_img_buf_get_img_size(lv_coord_t w, lv_coord_t h, lv_img_cf_t cf) 指定されたカラー形式とサイズで、生のビットマップのメモリ消費量を取得します。 Parameters w -- 幅 h -- 高さ cf -- カラーフォーマット Returns バイト単位のサイズ void _lv_img_buf_transform_init(lv_img_transform_dsc_t *dsc) イメージを回転させるための記述子の初期化 Parameters dsc -- cfg フィールドが初期化されたlv_img_transform_dsc_t変数へのポインタ bool _lv_img_buf_transform_anti_alias(lv_img_transform_dsc_t *dsc) 近傍を考慮して変換を継続する Parameters dsc -- 変換記述子へのポインタ bool _lv_img_buf_transform(lv_img_transform_dsc_t *dsc, lv_coord_t x, lv_coord_t y) 回転された場合にピクセルになる色とopaを取得する結果はdsc->res_color とdsc->res_opaに書き戻されることに注意してください。 Parameters dsc -- lv_img_buf_rotate_initによって初期化される記述子 x -- 色とopaを取得するx座標 y -- 色とopaを取得するy座標 Returns true:これらのx/y座標に有効なピクセルがあります。 false:回転されたピクセルがイメージの外にあります。 void _lv_img_buf_get_transformed_area(lv_area_t *res, lv_coord_t w, lv_coord_t h, int16_t angle, uint16_t zoom, const lv_point_t *pivot) 矩形の面積を取得する (回転およびスケールされた場合) Parameters res -- 座標をここに保存するには w -- width of the rectangle to transform h -- 変換する長方形の高さ angle -- 回転角 zoom -- ズーム, (256 no zoom) pivot -- 回転のx、yピボット座標 struct lv_img_header_t #include <lv_img_buf.h> 最初の8ビットは、異なるソースタイプを区別するために非常に重要です。 詳細については、lv_img.cの lv_img_get_src_type() in lv_img.c を参照してください。 ビッグエンディアンシステムでは、順序が逆になるため、cfとalways_0は構造体の末尾にある必要があります。 Public Members uint32_t h uint32_t w uint32_t reserved uint32_t always_zero uint32_t cf struct lv_img_header_t #include <lv_img_buf.h> 最初の8ビットは、異なるソースタイプを区別するために非常に重要です。 詳細については、lv_img.cのlv_img_get_src_type() を参照してください。 ビッグエンディアンシステムでは、順序が逆になるため、cfとalways_0は構造体の末尾にある必要があります。 Public Members uint32_t h uint32_t w uint32_t reserved uint32_t always_zero uint32_t cf struct lv_img_dsc_t #include <lv_img_buf.h> イメージヘッダ。イメージ変換ユーティリティの結果と互換性があります。 Public Members lv_img_header_t header イメージの基本を説明するヘッダー uint32_t data_size イメージのサイズ (バイト単位) const uint8_t *data 画像のデータへのポインタ struct lv_img_transform_dsc_t Public Members const void *src lv_coord_t src_w lv_coord_t src_h lv_coord_t pivot_x lv_coord_t pivot_y int16_t angle uint16_t zoom lv_color_t color lv_img_cf_t cf bool antialias struct lv_img_transform_dsc_t::[anonymous] cfg lv_opa_t opa struct lv_img_transform_dsc_t::[anonymous] res lv_img_dsc_t img_dsc int32_t pivot_x_256 int32_t pivot_y_256 int32_t sinma int32_t cosma uint8_t chroma_keyed uint8_t has_alpha uint8_t native_color uint32_t zoom_inv lv_coord_t xs lv_coord_t ys lv_coord_t xs_int lv_coord_t ys_int uint32_t pxi uint8_t px_size struct lv_img_transform_dsc_t::[anonymous] tmp

戻る : Previous