mirror of
https://github.com/lvgl/lvgl.git
synced 2025-01-28 07:03:00 +08:00
0458acd998
Co-authored-by: Kevin Schlosser <kdschlosser@users.noreply.github.com> Co-authored-by: Liam <30486941+liamHowatt@users.noreply.github.com>
53 lines
1.1 KiB
ReStructuredText
53 lines
1.1 KiB
ReStructuredText
.. _libpng:
|
|
|
|
==============
|
|
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: http://www.libpng.org/pub/png/libpng.html
|
|
|
|
Install
|
|
-------
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo apt install libpng-dev
|
|
|
|
Add libpng to your project
|
|
--------------------------
|
|
|
|
.. code-block:: cmake
|
|
|
|
find_package(PNG REQUIRED)
|
|
include_directories(${PNG_INCLUDE_DIR})
|
|
target_link_libraries(${PROJECT_NAME} PRIVATE ${PNG_LIBRARIES})
|
|
|
|
.. _libpng_usage:
|
|
|
|
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 ``width x height x 4`` bytes of RAM,
|
|
and it needs to be combined with the :ref:`overview_image_caching` feature to ensure that the memory usage is within a reasonable range.
|
|
The decoded image is stored in RGBA pixel format.
|
|
|
|
.. _libpng_example:
|
|
|
|
Example
|
|
-------
|
|
|
|
.. include:: ../examples/libs/libpng/index.rst
|
|
|
|
.. _libpng_api:
|
|
|
|
API
|
|
---
|
|
|
|
:ref:`libpng`
|
|
|