ESP LV DECODER

[English]

允许使用 LVGL 中的图像。除此之外,它还允许使用自定义格式(称为分割图像),该格式可以在嵌入式系统上以更优化的方式进行解码。

需要 ESP-IDF >= 5.3 和 LVGL >= 8.3、< 10。

分割图像,参考 SJPG 的实现。

功能

  • 支持标准和自定义分割图像格式,包括 JPG、PNG 和 QOI。

  • 解码标准图像需要与完整未压缩图像大小相当的 RAM,建议用于具有更多 RAM 的设备。

  • 分割图像是基于标准图像格式的自定义格式,专为 LVGL 设计。

  • 文件存储和 C 数组均实现了文件读取。

  • 分割图像分段解码,因此不支持缩放和旋转。

设置图片转换格式

依赖组件 esp_mmap_assets 。 它会在编译过程中自动打包图像并将其转换为所需的格式。

JPG 转换成 SJPG

spiffs_create_partition_assets(
     my_spiffs_partition
     my_folder
     FLASH_IN_PROJECT
     MMAP_FILE_SUPPORT_FORMAT ".jpg"
     MMAP_SUPPORT_SJPG
     MMAP_SPLIT_HEIGHT 16)

PNG 转换成 SPNG

spiffs_create_partition_assets(
     my_spiffs_partition
     my_folder
     FLASH_IN_PROJECT
     MMAP_FILE_SUPPORT_FORMAT ".png"
     MMAP_SUPPORT_SPNG
     MMAP_SPLIT_HEIGHT 16)

PNG、JPG 转换成 QOI

spiffs_create_partition_assets(
     my_spiffs_partition
     my_folder
     FLASH_IN_PROJECT
     MMAP_FILE_SUPPORT_FORMAT ".jpg,.png"
     MMAP_SUPPORT_QOI)

PNG、JPG 转换成 SQOI

spiffs_create_partition_assets(
     my_spiffs_partition
     my_folder
     FLASH_IN_PROJECT
     MMAP_FILE_SUPPORT_FORMAT ".jpg,.png"
     MMAP_SUPPORT_QOI
     MMAP_SUPPORT_SQOI
     MMAP_SPLIT_HEIGHT 16)

PNG 转换成 PJPG

PJPG 将颜色和透明度分别存为 JPEG,属于有损格式。通过 MMAP_SUPPORT_PJPG 转换:

spiffs_create_partition_assets(
     my_spiffs_partition
     my_folder
     FLASH_IN_PROJECT
     MMAP_FILE_SUPPORT_FORMAT ".png"
     MMAP_SUPPORT_PJPG)
  • 硬件 JPEG 不可用或未启用时,在本组件和 esp_new_jpeg 均支持的目标上使用软件解码。

  • 可定义 ESP_LV_ENABLE_HW_JPEG=0 强制软解;PJPG 硬解失败会返回错误,不自动重试软解。

  • 默认输出 RGB565A8,图像内存约为 宽 × 高 × 3 字节,另需工作缓冲区。

  • LVGL v8 需配置 LV_COLOR_DEPTH=16。

  • 转换尺寸补齐至 16 的倍数;任一边小于 128 像素或透明度复杂的图片可能保留为 PNG。

应用示例

注册解码器

在 LVGL 初始化后注册;使用 esp_lvgl_adapter 且启用 CONFIG_ESP_LVGL_ADAPTER_ENABLE_DECODER 时自动注册。

esp_lv_decoder_handle_t decoder_handle = NULL;
esp_lv_decoder_init(&decoder_handle);

文件源需先挂载 LVGL 文件系统,也可使用内存图片描述符。

API 参考

Header File

Functions

esp_err_t esp_lv_decoder_init(esp_lv_decoder_handle_t *ret_handle)

Register the decoder functions in LVGL.

参数

ret_handle – Pointer to the handle where the decoder handle will be stored

返回

  • ESP_OK on success

  • ESP_ERR_* error codes on failure

esp_err_t esp_lv_decoder_deinit(esp_lv_decoder_handle_t handle)

Deinitialize the decoder handle.

参数

handle – The handle to be deinitialized

返回

  • ESP_OK on success

  • ESP_ERR_* error codes on failure

Type Definitions

typedef void *esp_lv_decoder_handle_t

Type of handle for the decoder.