From 99371383921a5606625ce01d6ffe2902a8bc6a5d Mon Sep 17 00:00:00 2001
From: _VIFEXTech <vifextech@foxmail.com>
Date: Mon, 25 Sep 2023 16:28:35 +0800
Subject: [PATCH] feat(libs): add libpng decoder (#4569)

Signed-off-by: pengyiqiang <pengyiqiang@xiaomi.com>
Co-authored-by: pengyiqiang <pengyiqiang@xiaomi.com>
Co-authored-by: Gabor Kiss-Vamosi <kisvegabor@gmail.com>
---
 Kconfig                                     |   3 +
 docs/libs/index.rst                         |   1 +
 docs/libs/libpng.rst                        |  42 +++
 examples/libs/libpng/index.rst              |   6 +
 examples/libs/libpng/lv_example_libpng.h    |  38 +++
 examples/libs/libpng/lv_example_libpng_1.c  |  31 ++
 examples/libs/libpng/lv_example_libpng_1.py |  11 +
 examples/libs/libpng/png_demo.png           | Bin 0 -> 20608 bytes
 examples/libs/lv_example_libs.h             |   1 +
 lv_conf_template.h                          |   3 +
 lvgl.h                                      |   1 +
 src/libs/libpng/lv_libpng.c                 | 304 ++++++++++++++++++++
 src/libs/libpng/lv_libpng.h                 |  48 ++++
 src/lv_conf_internal.h                      |   9 +
 src/lv_init.c                               |   5 +
 tests/ref_imgs/libs/png_2.png               | Bin 0 -> 4600 bytes
 tests/src/lv_test_conf_full.h               |   1 +
 tests/src/test_cases/libs/test_libpng.c     |  54 ++++
 tests/src/test_cases/libs/test_lodepng.c    |   5 +
 19 files changed, 563 insertions(+)
 create mode 100644 docs/libs/libpng.rst
 create mode 100644 examples/libs/libpng/index.rst
 create mode 100644 examples/libs/libpng/lv_example_libpng.h
 create mode 100644 examples/libs/libpng/lv_example_libpng_1.c
 create mode 100755 examples/libs/libpng/lv_example_libpng_1.py
 create mode 100644 examples/libs/libpng/png_demo.png
 create mode 100644 src/libs/libpng/lv_libpng.c
 create mode 100644 src/libs/libpng/lv_libpng.h
 create mode 100644 tests/ref_imgs/libs/png_2.png
 create mode 100644 tests/src/test_cases/libs/test_libpng.c

diff --git a/Kconfig b/Kconfig
index 8705894da..7fd6b5527 100644
--- a/Kconfig
+++ b/Kconfig
@@ -1011,6 +1011,9 @@ menu "LVGL configuration"
 		config LV_USE_LODEPNG
 			bool "PNG decoder library"
 
+		config LV_USE_LIBPNG
+			bool "PNG decoder(libpng) library"
+
 		config LV_USE_BMP
 			bool "BMP decoder library"
 
diff --git a/docs/libs/index.rst b/docs/libs/index.rst
index eea3a9034..b92201e3a 100644
--- a/docs/libs/index.rst
+++ b/docs/libs/index.rst
@@ -11,6 +11,7 @@
     tjpgd
     libjpeg_turbo
     lodepng
+    libpng
     gif
     freetype
     tiny_ttf
diff --git a/docs/libs/libpng.rst b/docs/libs/libpng.rst
new file mode 100644
index 000000000..b8bb0d0ec
--- /dev/null
+++ b/docs/libs/libpng.rst
@@ -0,0 +1,42 @@
+==============
+libpng decoder
+==============
+
+libpng is the official PNG reference library. It supports almost all PNG features, is extensible, and has been extensively tested for over 28 years.
+Detailed introduction: `libpng <http://www.libpng.org/pub/png/libpng.html>`__.
+
+Install
+-------
+
+.. code:: bash
+
+    sudo apt install libpng-dev
+
+Add libpng to your project
+--------------------------
+
+.. code:: cmake
+
+    find_package(PNG REQUIRED)
+    include_directories(${PNG_INCLUDE_DIR})
+    target_link_libraries(${PROJECT_NAME} PRIVATE ${PNG_LIBRARIES})
+
+Usage
+-----
+
+Enable :c:macro:`LV_USE_LIBPNG` in ``lv_conf.h``.
+
+See the examples below.
+It should be noted that each image of this decoder needs to consume ``image width x image height x 4`` bytes of RAM, 
+and it needs to be combined with the ref:`image-caching` feature to ensure that the memory usage is within a reasonable range.
+
+Example
+-------
+
+.. include:: ../examples/libs/libpng/index.rst
+
+API
+---
+
+:ref:`libpng`
+
diff --git a/examples/libs/libpng/index.rst b/examples/libs/libpng/index.rst
new file mode 100644
index 000000000..4604fa7c9
--- /dev/null
+++ b/examples/libs/libpng/index.rst
@@ -0,0 +1,6 @@
+Open a PNG image from file
+--------------------------
+
+.. lv_example:: libs/libpng/lv_example_libpng_1
+  :language: c
+
diff --git a/examples/libs/libpng/lv_example_libpng.h b/examples/libs/libpng/lv_example_libpng.h
new file mode 100644
index 000000000..f41004ca0
--- /dev/null
+++ b/examples/libs/libpng/lv_example_libpng.h
@@ -0,0 +1,38 @@
+/**
+ * @file lv_example_libpng.h
+ *
+ */
+
+#ifndef LV_EXAMPLE_LIBPNG_H
+#define LV_EXAMPLE_LIBPNG_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/*********************
+ *      INCLUDES
+ *********************/
+
+/*********************
+ *      DEFINES
+ *********************/
+
+/**********************
+ *      TYPEDEFS
+ **********************/
+
+/**********************
+ * GLOBAL PROTOTYPES
+ **********************/
+void lv_example_libpng_1(void);
+
+/**********************
+ *      MACROS
+ **********************/
+
+#ifdef __cplusplus
+} /*extern "C"*/
+#endif
+
+#endif /*LV_EXAMPLE_LIBPNG_H*/
diff --git a/examples/libs/libpng/lv_example_libpng_1.c b/examples/libs/libpng/lv_example_libpng_1.c
new file mode 100644
index 000000000..cd1a3214b
--- /dev/null
+++ b/examples/libs/libpng/lv_example_libpng_1.c
@@ -0,0 +1,31 @@
+#include "../../lv_examples.h"
+#if LV_BUILD_EXAMPLES
+
+#if LV_USE_LIBPNG
+
+/**
+ * Open a PNG image from a file
+ */
+void lv_example_libpng_1(void)
+{
+    lv_obj_t * img;
+
+    img = lv_image_create(lv_scr_act());
+    /* Assuming a File system is attached to letter 'A'
+     * E.g. set LV_USE_FS_STDIO 'A' in lv_conf.h */
+    lv_image_set_src(img, "A:lvgl/examples/libs/libpng/png_demo.png");
+    lv_obj_center(img);
+}
+
+#else
+
+void lv_example_libpng_1(void)
+{
+    lv_obj_t * label = lv_label_create(lv_scr_act());
+    lv_label_set_text(label, "LibPNG is not installed");
+    lv_obj_center(label);
+}
+
+#endif
+
+#endif
diff --git a/examples/libs/libpng/lv_example_libpng_1.py b/examples/libs/libpng/lv_example_libpng_1.py
new file mode 100755
index 000000000..8103f2590
--- /dev/null
+++ b/examples/libs/libpng/lv_example_libpng_1.py
@@ -0,0 +1,11 @@
+#!/opt/bin/lv_micropython -i
+import lvgl as lv
+import display_driver
+import fs_driver
+
+fs_drv = lv.fs_drv_t()
+fs_driver.fs_register(fs_drv, 'S')
+
+image = lv.image(lv.scr_act())
+image.set_src("S:png_demo.png")
+image.center()
diff --git a/examples/libs/libpng/png_demo.png b/examples/libs/libpng/png_demo.png
new file mode 100644
index 0000000000000000000000000000000000000000..d8dbbb78eea870323e6849ddf55895ab002ef601
GIT binary patch
literal 20608
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

literal 0
HcmV?d00001

diff --git a/examples/libs/lv_example_libs.h b/examples/libs/lv_example_libs.h
index 2a7b60c11..ae8dcb921 100644
--- a/examples/libs/lv_example_libs.h
+++ b/examples/libs/lv_example_libs.h
@@ -19,6 +19,7 @@ extern "C" {
 #include "freetype/lv_example_freetype.h"
 #include "gif/lv_example_gif.h"
 #include "lodepng/lv_example_lodepng.h"
+#include "libpng/lv_example_libpng.h"
 #include "qrcode/lv_example_qrcode.h"
 #include "rlottie/lv_example_rlottie.h"
 #include "tjpgd/lv_example_tjpgd.h"
diff --git a/lv_conf_template.h b/lv_conf_template.h
index c513f7c76..83aaf2e84 100644
--- a/lv_conf_template.h
+++ b/lv_conf_template.h
@@ -579,6 +579,9 @@
 /*LODEPNG decoder library*/
 #define LV_USE_LODEPNG 0
 
+/*PNG decoder(libpng) library*/
+#define LV_USE_LIBPNG 0
+
 /*BMP decoder library*/
 #define LV_USE_BMP 0
 
diff --git a/lvgl.h b/lvgl.h
index 36321440b..3023b5dab 100644
--- a/lvgl.h
+++ b/lvgl.h
@@ -93,6 +93,7 @@ extern "C" {
 #include "src/libs/bmp/lv_bmp.h"
 #include "src/libs/fsdrv/lv_fsdrv.h"
 #include "src/libs/lodepng/lv_lodepng.h"
+#include "src/libs/libpng/lv_libpng.h"
 #include "src/libs/gif/lv_gif.h"
 #include "src/libs/qrcode/lv_qrcode.h"
 #include "src/libs/tjpgd/lv_tjpgd.h"
diff --git a/src/libs/libpng/lv_libpng.c b/src/libs/libpng/lv_libpng.c
new file mode 100644
index 000000000..2627b505e
--- /dev/null
+++ b/src/libs/libpng/lv_libpng.c
@@ -0,0 +1,304 @@
+/**
+ * @file lv_libpng.c
+ *
+ */
+
+/*********************
+ *      INCLUDES
+ *********************/
+#include "../../../lvgl.h"
+#if LV_USE_LIBPNG
+
+#include "lv_libpng.h"
+#include <png.h>
+
+/*********************
+ *      DEFINES
+ *********************/
+
+/**********************
+ *      TYPEDEFS
+ **********************/
+
+/**********************
+ *  STATIC PROTOTYPES
+ **********************/
+static lv_result_t decoder_info(lv_image_decoder_t * decoder, const void * src, lv_image_header_t * header);
+static lv_result_t decoder_open(lv_image_decoder_t * decoder, lv_image_decoder_dsc_t * dsc);
+static void decoder_close(lv_image_decoder_t * decoder, lv_image_decoder_dsc_t * dsc);
+static const void * decode_png_file(const char * filename);
+static lv_result_t try_cache(lv_image_decoder_dsc_t * dsc);
+
+/**********************
+ *  STATIC VARIABLES
+ **********************/
+
+/**********************
+ *      MACROS
+ **********************/
+
+/**********************
+ *   GLOBAL FUNCTIONS
+ **********************/
+
+/**
+ * Register the PNG decoder functions in LVGL
+ */
+void lv_libpng_init(void)
+{
+    lv_image_decoder_t * dec = lv_image_decoder_create();
+    lv_image_decoder_set_info_cb(dec, decoder_info);
+    lv_image_decoder_set_open_cb(dec, decoder_open);
+    lv_image_decoder_set_close_cb(dec, decoder_close);
+}
+
+void lv_libpng_deinit(void)
+{
+    lv_image_decoder_t * dec = NULL;
+    while((dec = lv_image_decoder_get_next(dec)) != NULL) {
+        if(dec->info_cb == decoder_info) {
+            lv_image_decoder_delete(dec);
+            break;
+        }
+    }
+}
+
+/**********************
+ *   STATIC FUNCTIONS
+ **********************/
+
+/**
+ * Get info about a PNG image
+ * @param src can be file name or pointer to a C array
+ * @param header store the info here
+ * @return LV_RESULT_OK: no error; LV_RESULT_INVALID: can't get the info
+ */
+static lv_result_t decoder_info(lv_image_decoder_t * decoder, const void * src, lv_image_header_t * header)
+{
+    LV_UNUSED(decoder); /*Unused*/
+    lv_image_src_t src_type = lv_image_src_get_type(src);          /*Get the source type*/
+
+    /*If it's a PNG file...*/
+    if(src_type == LV_IMAGE_SRC_FILE) {
+        const char * fn = src;
+
+        lv_fs_file_t f;
+        lv_fs_res_t res = lv_fs_open(&f, fn, LV_FS_MODE_RD);
+        if(res != LV_FS_RES_OK) return LV_RESULT_INVALID;
+
+        /* Read the width and height from the file. They have a constant location:
+         * [16..19]: width
+         * [20..23]: height
+         */
+        uint8_t buf[24];
+        uint32_t rn;
+        lv_fs_read(&f, buf, sizeof(buf), &rn);
+        lv_fs_close(&f);
+
+        if(rn != sizeof(buf)) return LV_RESULT_INVALID;
+
+        const uint8_t magic[] = {0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a};
+        if(memcmp(buf, magic, sizeof(magic)) != 0) return LV_RESULT_INVALID;
+
+        uint32_t * size = (uint32_t *)&buf[16];
+        /*Save the data in the header*/
+        header->always_zero = 0;
+        header->cf = LV_COLOR_FORMAT_ARGB8888;
+        /*The width and height are stored in Big endian format so convert them to little endian*/
+        header->w = (lv_coord_t)((size[0] & 0xff000000) >> 24) + ((size[0] & 0x00ff0000) >> 8);
+        header->h = (lv_coord_t)((size[1] & 0xff000000) >> 24) + ((size[1] & 0x00ff0000) >> 8);
+
+        return LV_RESULT_OK;
+    }
+
+    return LV_RESULT_INVALID;         /*If didn't succeeded earlier then it's an error*/
+}
+
+
+/**
+ * Open a PNG image and return the decided image
+ * @param src can be file name or pointer to a C array
+ * @param style style of the image object (unused now but certain formats might use it)
+ * @return pointer to the decoded image or  `LV_IMAGE_DECODER_OPEN_FAIL` if failed
+ */
+static lv_result_t decoder_open(lv_image_decoder_t * decoder, lv_image_decoder_dsc_t * dsc)
+{
+    LV_UNUSED(decoder); /*Unused*/
+
+    /*Check the cache first*/
+    if(try_cache(dsc) == LV_RESULT_OK) return LV_RESULT_OK;
+
+    /*If it's a PNG file...*/
+    if(dsc->src_type == LV_IMAGE_SRC_FILE) {
+        const char * fn = dsc->src;
+        lv_cache_lock();
+        lv_cache_entry_t * cache = lv_cache_add(dsc->header.w * dsc->header.h * sizeof(uint32_t));
+        if(cache == NULL) {
+            lv_cache_unlock();
+            return LV_RESULT_INVALID;
+        }
+
+        uint32_t t = lv_tick_get();
+        const void * decoded_img = decode_png_file(fn);
+        t = lv_tick_elaps(t);
+        cache->weight = t;
+        cache->data = decoded_img;
+        cache->free_data = 1;
+        if(dsc->src_type == LV_IMAGE_SRC_FILE) {
+            cache->src = lv_strdup(dsc->src);
+            cache->src_type = LV_CACHE_SRC_TYPE_STR;
+            cache->free_src = 1;
+        }
+        else {
+            cache->src_type = LV_CACHE_SRC_TYPE_PTR;
+            cache->src = dsc->src;
+        }
+
+        dsc->img_data = lv_cache_get_data(cache);
+        dsc->user_data = cache;
+
+        lv_cache_unlock();
+        return LV_RESULT_OK;     /*The image is fully decoded. Return with its pointer*/
+    }
+
+    return LV_RESULT_INVALID;    /*If not returned earlier then it failed*/
+}
+
+/**
+ * Free the allocated resources
+ */
+static void decoder_close(lv_image_decoder_t * decoder, lv_image_decoder_dsc_t * dsc)
+{
+    LV_UNUSED(decoder); /*Unused*/
+
+    lv_cache_lock();
+    lv_cache_release(dsc->user_data);
+    lv_cache_unlock();
+}
+
+static lv_result_t try_cache(lv_image_decoder_dsc_t * dsc)
+{
+    lv_cache_lock();
+    if(dsc->src_type == LV_IMAGE_SRC_FILE) {
+        const char * fn = dsc->src;
+
+        lv_cache_entry_t * cache = lv_cache_find(fn, LV_CACHE_SRC_TYPE_STR, 0, 0);
+        if(cache) {
+            dsc->img_data = lv_cache_get_data(cache);
+            dsc->user_data = cache;     /*Save the cache to release it in decoder_close*/
+            lv_cache_unlock();
+            return LV_RESULT_OK;
+        }
+    }
+
+    lv_cache_unlock();
+    return LV_RESULT_INVALID;
+}
+
+static uint8_t * alloc_file(const char * filename, uint32_t * size)
+{
+    uint8_t * data = NULL;
+    lv_fs_file_t f;
+    uint32_t data_size;
+    uint32_t rn;
+    lv_fs_res_t res;
+
+    *size = 0;
+
+    res = lv_fs_open(&f, filename, LV_FS_MODE_RD);
+    if(res != LV_FS_RES_OK) {
+        LV_LOG_WARN("can't open %s", filename);
+        return NULL;
+    }
+
+    res = lv_fs_seek(&f, 0, LV_FS_SEEK_END);
+    if(res != LV_FS_RES_OK) {
+        goto failed;
+    }
+
+    res = lv_fs_tell(&f, &data_size);
+    if(res != LV_FS_RES_OK) {
+        goto failed;
+    }
+
+    res = lv_fs_seek(&f, 0, LV_FS_SEEK_SET);
+    if(res != LV_FS_RES_OK) {
+        goto failed;
+    }
+
+    /*Read file to buffer*/
+    data = lv_malloc(data_size);
+    if(data == NULL) {
+        LV_LOG_WARN("malloc failed for data");
+        goto failed;
+    }
+
+    res = lv_fs_read(&f, data, data_size, &rn);
+
+    if(res == LV_FS_RES_OK && rn == data_size) {
+        *size = rn;
+    }
+    else {
+        LV_LOG_WARN("read file failed");
+        lv_free(data);
+        data = NULL;
+    }
+
+failed:
+    lv_fs_close(&f);
+
+    return data;
+}
+
+static const void * decode_png_file(const char * filename)
+{
+    int ret;
+
+    /*Prepare png_image*/
+    png_image image;
+    lv_memzero(&image, sizeof(image));
+    image.version = PNG_IMAGE_VERSION;
+
+    uint32_t data_size;
+    uint8_t * data = alloc_file(filename, &data_size);
+    if(data == NULL) {
+        LV_LOG_WARN("can't load file: %s", filename);
+        return NULL;
+    }
+
+    /*Ready to read file*/
+    ret = png_image_begin_read_from_memory(&image, data, data_size);
+    if(!ret) {
+        LV_LOG_ERROR("png file: %s read failed: %d", filename, ret);
+        lv_free(data);
+        return NULL;
+    }
+
+    /*Set color format*/
+    image.format = PNG_FORMAT_BGRA;
+
+    /*Alloc image buffer*/
+    size_t image_size = PNG_IMAGE_SIZE(image);
+    void * image_data = lv_draw_buf_malloc(image_size, LV_COLOR_FORMAT_ARGB8888);
+
+    if(image_data) {
+        /*Start decoding*/
+        ret = png_image_finish_read(&image, NULL, image_data, 0, NULL);
+        if(!ret) {
+            LV_LOG_ERROR("png decode failed: %d", ret);
+            lv_draw_buf_free(image_data);
+            image_data = NULL;
+        }
+    }
+    else {
+        LV_LOG_ERROR("png alloc %zu failed", image_size);
+    }
+
+    /*free decoder*/
+    png_image_free(&image);
+    lv_free(data);
+
+    return image_data;
+}
+
+#endif /*LV_USE_LIBPNG*/
diff --git a/src/libs/libpng/lv_libpng.h b/src/libs/libpng/lv_libpng.h
new file mode 100644
index 000000000..12794585d
--- /dev/null
+++ b/src/libs/libpng/lv_libpng.h
@@ -0,0 +1,48 @@
+/**
+ * @file lv_libpng.h
+ *
+ */
+
+#ifndef LV_LIBPNG_H
+#define LV_LIBPNG_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/*********************
+ *      INCLUDES
+ *********************/
+#include "../../lv_conf_internal.h"
+#if LV_USE_LIBPNG
+
+/*********************
+ *      DEFINES
+ *********************/
+
+/**********************
+ *      TYPEDEFS
+ **********************/
+
+/**********************
+ * GLOBAL PROTOTYPES
+ **********************/
+
+/**
+ * Register the PNG decoder functions in LVGL
+ */
+void lv_libpng_init(void);
+
+void lv_libpng_deinit(void);
+
+/**********************
+ *      MACROS
+ **********************/
+
+#endif /*LV_USE_LIBPNG*/
+
+#ifdef __cplusplus
+} /* extern "C" */
+#endif
+
+#endif /*LV_LIBPNG_H*/
diff --git a/src/lv_conf_internal.h b/src/lv_conf_internal.h
index ba6efedd6..fd8b478d5 100644
--- a/src/lv_conf_internal.h
+++ b/src/lv_conf_internal.h
@@ -1943,6 +1943,15 @@
     #endif
 #endif
 
+/*PNG decoder(libpng) library*/
+#ifndef LV_USE_LIBPNG
+    #ifdef CONFIG_LV_USE_LIBPNG
+        #define LV_USE_LIBPNG CONFIG_LV_USE_LIBPNG
+    #else
+        #define LV_USE_LIBPNG 0
+    #endif
+#endif
+
 /*BMP decoder library*/
 #ifndef LV_USE_BMP
     #ifdef CONFIG_LV_USE_BMP
diff --git a/src/lv_init.c b/src/lv_init.c
index 7daa29b3b..1f6de44eb 100644
--- a/src/lv_init.c
+++ b/src/lv_init.c
@@ -19,6 +19,7 @@
 #include "libs/tjpgd/lv_tjpgd.h"
 #include "libs/libjpeg_turbo/lv_libjpeg_turbo.h"
 #include "libs/lodepng/lv_lodepng.h"
+#include "libs/libpng/lv_libpng.h"
 #include "draw/lv_draw.h"
 #include "misc/lv_cache.h"
 #include "misc/lv_cache_builtin.h"
@@ -234,6 +235,10 @@ void lv_init(void)
     lv_lodepng_init();
 #endif
 
+#if LV_USE_LIBPNG
+    lv_libpng_init();
+#endif
+
 #if LV_USE_TJPGD
     lv_tjpgd_init();
 #endif
diff --git a/tests/ref_imgs/libs/png_2.png b/tests/ref_imgs/libs/png_2.png
new file mode 100644
index 0000000000000000000000000000000000000000..6ad03d1897c703576581f71a092d6ec7b8236fff
GIT binary patch
literal 4600
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
H=-0miu{Hel

literal 0
HcmV?d00001

diff --git a/tests/src/lv_test_conf_full.h b/tests/src/lv_test_conf_full.h
index 29485e8d4..eff31a1a3 100644
--- a/tests/src/lv_test_conf_full.h
+++ b/tests/src/lv_test_conf_full.h
@@ -62,6 +62,7 @@
 #define LV_FS_MEMFS_LETTER  'M'
 
 #define LV_USE_LODEPNG      1
+#define LV_USE_LIBPNG       1
 #define LV_USE_BMP          1
 #define LV_USE_TJPGD        1
 #define LV_USE_LIBJPEG_TURBO   1
diff --git a/tests/src/test_cases/libs/test_libpng.c b/tests/src/test_cases/libs/test_libpng.c
new file mode 100644
index 000000000..b64fc2a44
--- /dev/null
+++ b/tests/src/test_cases/libs/test_libpng.c
@@ -0,0 +1,54 @@
+#if LV_BUILD_TEST
+#include "../lvgl.h"
+
+#include "unity/unity.h"
+#include "lv_test_helpers.h"
+
+void setUp(void)
+{
+    /* Function run before every test */
+}
+
+void tearDown(void)
+{
+    /* Function run after every test */
+}
+
+static void create_images(void)
+{
+    lv_obj_clean(lv_scr_act());
+
+    lv_obj_t * img;
+
+    img = lv_img_create(lv_scr_act());
+    lv_img_set_src(img, "A:src/test_assets/test_img_lvgl_logo.png");
+    lv_obj_center(img);
+}
+
+void test_libpng_1(void)
+{
+    /* Temporarily remove lodepng decoder */
+    lv_lodepng_deinit();
+
+    create_images();
+
+    TEST_ASSERT_EQUAL_SCREENSHOT("libs/png_2.png");
+
+
+    uint32_t mem_before = lv_test_get_free_mem();
+    for(uint32_t i = 0; i < 20; i++) {
+        create_images();
+
+        lv_obj_invalidate(lv_scr_act());
+        lv_refr_now(NULL);
+    }
+
+    TEST_ASSERT_EQUAL_SCREENSHOT("libs/png_2.png");
+
+    TEST_ASSERT_EQUAL(mem_before, lv_test_get_free_mem());
+
+    /* Re-add lodepng decoder */
+    lv_lodepng_init();
+}
+
+#endif
diff --git a/tests/src/test_cases/libs/test_lodepng.c b/tests/src/test_cases/libs/test_lodepng.c
index 4fe88a845..d5c391e56 100644
--- a/tests/src/test_cases/libs/test_lodepng.c
+++ b/tests/src/test_cases/libs/test_lodepng.c
@@ -41,6 +41,9 @@ static void create_images(void)
 
 void test_lodepng_1(void)
 {
+    /* Temporarily remove libpng decoder */
+    lv_libpng_deinit();
+
     create_images();
 
     TEST_ASSERT_EQUAL_SCREENSHOT("libs/png_1.png");
@@ -58,6 +61,8 @@ void test_lodepng_1(void)
 
     TEST_ASSERT_EQUAL(mem_before, lv_test_get_free_mem());
 
+    /* Re-add libpng decoder */
+    lv_libpng_init();
 }
 
 #endif