aboutsummaryrefslogtreecommitdiff
path: root/docs/libs/libjpeg_turbo.rst
blob: aa04de7a5cd01f8bcbdf7f702cf8bee13e2eb8ad (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
.. _libjpeg:

=====================
libjpeg-turbo decoder
=====================

**libjpeg-turbo** is a JPEG image codec that uses SIMD instructions to accelerate baseline JPEG compression and decompression on x86, 
x86-64, Arm, PowerPC, and MIPS systems, as well as progressive JPEG compression on x86, x86-64, and Arm systems.

Detailed introduction: https://libjpeg-turbo.org

Library source: https://github.com/libjpeg-turbo/libjpeg-turbo

.. _libjpeg_install:

Install
-------

.. code:: bash

    sudo apt install libjpeg-turbo8-dev

Add libjpeg-turbo to your project
---------------------------------

.. code:: cmake

    find_package(JPEG REQUIRED)
    include_directories(${JPEG_INCLUDE_DIR})
    target_link_libraries(${PROJECT_NAME} PRIVATE ${JPEG_LIBRARIES})

.. _libjpeg_usage:

Usage
-----

Enable :c:macro:`LV_USE_LIBJPEG_TURBO` 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 3`` 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.

.. _libjpeg_example:

Example
-------

.. include:: ../examples/libs/libjpeg_turbo/index.rst

.. _libjpeg_api:

API
---

:ref:`libjpeg_turbo`