From ea8be1533a20a1634c9a1cb3a5534cba65329138 Mon Sep 17 00:00:00 2001
From: Cao Sen Miao <caosenmiao@espressif.com>
Date: Wed, 17 Apr 2024 14:37:50 +0800
Subject: [PATCH] docs(jpeg): Add docs for explain pixel order supported in
 jpeg driver

---
 docs/_static/diagrams/jpeg/rgb565.png         | Bin 0 -> 15102 bytes
 .../diagrams/jpeg/rgb565_bigendian.png        | Bin 0 -> 14851 bytes
 docs/_static/diagrams/jpeg/rgb888.png         | Bin 0 -> 18938 bytes
 .../diagrams/jpeg/rgb888_bigendian.png        | Bin 0 -> 19105 bytes
 docs/_static/diagrams/jpeg/yuv420.png         | Bin 0 -> 21824 bytes
 docs/_static/diagrams/jpeg/yuv422.png         | Bin 0 -> 12857 bytes
 docs/_static/diagrams/jpeg/yuv444.png         | Bin 0 -> 12653 bytes
 docs/en/api-reference/peripherals/jpeg.rst    | 109 +++++++++++++++++-
 8 files changed, 103 insertions(+), 6 deletions(-)
 create mode 100644 docs/_static/diagrams/jpeg/rgb565.png
 create mode 100644 docs/_static/diagrams/jpeg/rgb565_bigendian.png
 create mode 100644 docs/_static/diagrams/jpeg/rgb888.png
 create mode 100644 docs/_static/diagrams/jpeg/rgb888_bigendian.png
 create mode 100644 docs/_static/diagrams/jpeg/yuv420.png
 create mode 100644 docs/_static/diagrams/jpeg/yuv422.png
 create mode 100644 docs/_static/diagrams/jpeg/yuv444.png

diff --git a/docs/_static/diagrams/jpeg/rgb565.png b/docs/_static/diagrams/jpeg/rgb565.png
new file mode 100644
index 0000000000000000000000000000000000000000..a76fdcdaa9409241e4dcf8b61dbf98ede7c29da9
GIT binary patch
literal 15102
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
RKeUQinA)0LF!KHJe*h%?56u7o

literal 0
HcmV?d00001

diff --git a/docs/_static/diagrams/jpeg/rgb565_bigendian.png b/docs/_static/diagrams/jpeg/rgb565_bigendian.png
new file mode 100644
index 0000000000000000000000000000000000000000..0d55a55a4ffe4418c855956052070801cad78004
GIT binary patch
literal 14851
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
R{;QME)X38Cn!fXae*v?_-f{o{

literal 0
HcmV?d00001

diff --git a/docs/_static/diagrams/jpeg/rgb888.png b/docs/_static/diagrams/jpeg/rgb888.png
new file mode 100644
index 0000000000000000000000000000000000000000..62f372df5b06824761ebb27bf526e3715033a570
GIT binary patch
literal 18938
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
D`sdKJ

literal 0
HcmV?d00001

diff --git a/docs/_static/diagrams/jpeg/rgb888_bigendian.png b/docs/_static/diagrams/jpeg/rgb888_bigendian.png
new file mode 100644
index 0000000000000000000000000000000000000000..490c95ba887d20f8fade2c6855401f4bd82ca794
GIT binary patch
literal 19105
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
GDgOgz-39&t

literal 0
HcmV?d00001

diff --git a/docs/_static/diagrams/jpeg/yuv420.png b/docs/_static/diagrams/jpeg/yuv420.png
new file mode 100644
index 0000000000000000000000000000000000000000..1dea4a94cf4c279b3c86cd56325f8f0579697a55
GIT binary patch
literal 21824
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

literal 0
HcmV?d00001

diff --git a/docs/_static/diagrams/jpeg/yuv422.png b/docs/_static/diagrams/jpeg/yuv422.png
new file mode 100644
index 0000000000000000000000000000000000000000..a30190ca908119564c260c8117404aff7f190596
GIT binary patch
literal 12857
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
Q1>xGSe?Tuw=fvs%0Iq&xTL1t6

literal 0
HcmV?d00001

diff --git a/docs/_static/diagrams/jpeg/yuv444.png b/docs/_static/diagrams/jpeg/yuv444.png
new file mode 100644
index 0000000000000000000000000000000000000000..e45d274cbaab661b945a1351fcfdecce14ff8973
GIT binary patch
literal 12653
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
R|3AS5*FC61(ms0Xe*i?I_Co*w

literal 0
HcmV?d00001

diff --git a/docs/en/api-reference/peripherals/jpeg.rst b/docs/en/api-reference/peripherals/jpeg.rst
index ad24411a53..23426412b5 100644
--- a/docs/en/api-reference/peripherals/jpeg.rst
+++ b/docs/en/api-reference/peripherals/jpeg.rst
@@ -18,6 +18,7 @@ This document covers the following sections:
 -  `JPEG Decoder Engine <#jpeg-decoder-engine>`__ - covers behavior of JPEG decoder engine. Introduce how to use decoder engine functions to decode an image (from jpg format to raw format).
 -  `JPEG Encoder Engine <#jpeg-encoder-engine>`__ - covers behavior of JPEG encoder engine. Introduce how to use encoder engine functions to encode an image (from raw format to jpg format).
 -  `Performance Overview <#performance-overview>`__ - covers encoder and decoder performance.
+-  `Pixel Storage Layout for Different Color Formats <#pixel-storage-layout-for-different-color-formats>`__ - covers color space order overview required in this JPEG decoder and encoder.
 -  `Thread Safety <#thread-safety>`__ - lists which APIs are guaranteed to be thread safe by the driver.
 -  `Power Management <#power-management>`__ - describes how jpeg driver would be affected by power consumption.
 -  `Kconfig Options <#kconfig-options>`__ - lists the supported Kconfig options that can bring different effects to the driver.
@@ -104,18 +105,28 @@ The format conversions supported by this driver are listed in the table below:
 | Format of the already compressed image |   Format after decompressing      |
 +========================================+===================================+
 |                                        |               RGB565              |
-|             YUV444                     +-----------------------------------+
+|               YUV444                   +-----------------------------------+
 |                                        |               RGB888              |
+|                                        +-----------------------------------+
+|                                        |               YUV444              |
 +----------------------------------------+-----------------------------------+
 |                                        |               RGB565              |
-|             YUV422                     +-----------------------------------+
+|                                        +-----------------------------------+
 |                                        |               RGB888              |
+|               YUV422                   +-----------------------------------+
+|                                        |               YUV444              |
+|                                        +-----------------------------------+
+|                                        |               YUV422              |
 +----------------------------------------+-----------------------------------+
 |                                        |               RGB565              |
-|             YUV420                     +-----------------------------------+
+|                                        +-----------------------------------+
 |                                        |               RGB888              |
+|               YUV420                   +-----------------------------------+
+|                                        |               YUV444              |
+|                                        +-----------------------------------+
+|                                        |               YUV420              |
 +----------------------------------------+-----------------------------------+
-|              GRAY                      |                GRAY               |
+|                GRAY                    |                GRAY               |
 +----------------------------------------+-----------------------------------+
 
 Overall, You can take following code as reference, the code is going to decode a 1080*1920 picture.
@@ -167,11 +178,13 @@ The format conversions supported by this driver are listed in the table below:
 +==========================+======================================+
 |                          |               YUV444                 |
 |                          +--------------------------------------+
-|       RGB565/RGB888      |               YUV422                 |
+|      RGB565/RGB888       |               YUV422                 |
 |                          +--------------------------------------+
 |                          |               YUV420                 |
 +--------------------------+--------------------------------------+
-|        GRAY              |                GRAY                  |
+|          GRAY            |                GRAY                  |
++--------------------------+--------------------------------------+
+|         YUV422           |               YUV422                 |
 +--------------------------+--------------------------------------+
 
 
@@ -236,6 +249,12 @@ JPEG decoder performance
 +--------+-------+--------------------------------------------+----------------------------------------+------------------+
 |  720   | 1280  |                 GRAY                       |               GRAY                     |   161            |
 +--------+-------+--------------------------------------------+----------------------------------------+------------------+
+|  480   | 800   |                YUV444                      |              YUV444                    |   129            |
++--------+-------+--------------------------------------------+----------------------------------------+------------------+
+|  480   | 800   |                YUV422                      |            YUV444/YUV422               |   190            |
++--------+-------+--------------------------------------------+----------------------------------------+------------------+
+|  480   | 800   |                YUV420                      |            YUV444/YUV420               |   253            |
++--------+-------+--------------------------------------------+----------------------------------------+------------------+
 
 JPEG encoder performance
 ~~~~~~~~~~~~~~~~~~~~~~~~
@@ -269,8 +288,86 @@ JPEG encoder performance
 +--------+-------+-----------------------------------------+-------------------------------------------+------------------+
 |  720   | 1280  |                 GRAY                    |             GRAY                          |   163            |
 +--------+-------+-----------------------------------------+-------------------------------------------+------------------+
+|  480   | 800   |                YUV422                   |            YUV422                         |   146            |
++--------+-------+-----------------------------------------+-------------------------------------------+------------------+
 
 
+Pixel Storage Layout for Different Color Formats
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The encoder and decoder described in this guide use the same uncompressed raw image formats (RGB, YUV). Therefore, the encoder and decoder are not discussed separately in this section. The pixel layout of the following formats applies to the input direction of the encoder and the output direction of the decoder (if supported). The specific pixel layout is shown in the following figure:
+
+RGB888
+~~~~~~
+
+In the following picture, each small block means one bit.
+
+.. figure:: ../../../_static/diagrams/jpeg/rgb888.png
+    :align: center
+    :alt: RGB888 pixel order
+
+    RGB888 pixel order
+
+For RGB888, the order can be changed via :cpp:member:`jpeg_decode_cfg_t::rgb_order` sets the pixel to `RGB` order.
+
+.. figure:: ../../../_static/diagrams/jpeg/rgb888_bigendian.png
+    :align: center
+    :alt: RGB888 pixel big endian order
+
+    RGB888 pixel big endian order
+
+RGB565
+~~~~~~
+
+In the following picture, each small block means one bit.
+
+.. figure:: ../../../_static/diagrams/jpeg/rgb565.png
+    :align: center
+    :alt: RGB565 pixel order
+
+    RGB565 pixel order
+
+For RGB565, the order can be changed via :cpp:member:`jpeg_decode_cfg_t::rgb_order` sets the pixel to `RGB` order.
+
+.. figure:: ../../../_static/diagrams/jpeg/rgb565_bigendian.png
+    :align: center
+    :alt: RGB565 pixel big endian order
+
+    RGB565 pixel big endian order
+
+YUV444
+~~~~~~
+
+In the following picture, each small block means one byte.
+
+.. figure:: ../../../_static/diagrams/jpeg/yuv444.png
+    :align: center
+    :alt: YUV444 pixel order
+
+    YUV444 pixel order
+
+YUV422
+~~~~~~
+
+In the following picture, each small block means one byte.
+
+.. figure:: ../../../_static/diagrams/jpeg/yuv422.png
+    :align: center
+    :alt: YUV422 pixel order
+
+    YUV422 pixel order
+
+YUV420
+~~~~~~
+
+In the following picture, each small block means one byte.
+
+.. figure:: ../../../_static/diagrams/jpeg/yuv420.png
+    :align: center
+    :alt: YUV420 pixel order
+
+    YUV420 pixel order
+
 Thread Safety
 ^^^^^^^^^^^^^