Merge branch 'feat/add_jpeg_pixel_reverse_enc' into 'master'

feat(jpeg): Add config for reversing input pixel format in jpeg encoder

Closes IDFGH-17272

See merge request espressif/esp-idf!46075

docs/en/api-reference/peripherals/jpeg.rst

@@ -10,6 +10,8 @@ JPEG is a commonly used method of lossy compression for digital images, particul
 
 JPEG codec on {IDF_TARGET_NAME} is an image codec, which is based on the JPEG baseline standard, for compressing and decompressing images to reduce the bandwidth required to transmit images or the space required to store images, making it possible to process large-resolution images. But please note, at one time, the codec engine can only work as either encoder or decoder.
 
+For more hardware features of JPEG codec, please refer to the `JPEG codec <{IDF_TARGET_TRM_EN_URL}#jpegcodec>`__ section in {IDF_TARGET_NAME} Technical Reference Manual, for more details.
+
 Functional Overview
 -------------------
 
@@ -187,6 +189,7 @@ Below is the example of code that encodes a 1080*1920 picture:
         .image_quality = 80,
         .width = 1920,
         .height = 1080,
+        .pixel_reverse = false, // Whether to reverse the pixel order of the input image, or pixel order detail please refer to technical reference manual
     };
 
     uint8_t *raw_buf_1080p = (uint8_t*)jpeg_alloc_encoder_mem(raw_size_1080p);

docs/zh_CN/api-reference/peripherals/jpeg.rst

@@ -10,6 +10,8 @@ JPEG 常用于数字图像，尤其是数码摄影图像的有损压缩。压缩
 
 {IDF_TARGET_NAME} 的 JPEG 编解码器是一种基于 JPEG 基线标准的图像编解码器，可以压缩和解压缩图像，从而降低传输图像所需的带宽或存储图像所需的空间，可以处理高分辨率的图像。但请注意，编解码器引擎不能同时作为编码器和解码器工作。
 
+关于更多 JPEG 编解码器的硬件特性，请参考 {IDF_TARGET_NAME} 技术参考手册中的 `JPEG 编解码器 <{IDF_TARGET_TRM_EN_URL}#jpegcodec>`__ 章节，了解更多详情。
+
 功能概述
 --------
 
@@ -187,6 +189,7 @@ JPEG 编码器引擎
         .image_quality = 80,
         .width = 1920,
         .height = 1080,
+        .pixel_reverse = false, // 是否反转输入图像的像素顺序，或像素顺序细节请参考技术参考手册
     };
 
     uint8_t *raw_buf_1080p = (uint8_t*)jpeg_alloc_encoder_mem(raw_size_1080p);