esp-idf/components/esp_driver_jpeg/private/jpeg_param.h

143 wiersze
6.1 KiB
C

/*
* SPDX-FileCopyrightText: 2024 Espressif Systems (Shanghai) CO LTD
*
* SPDX-License-Identifier: Apache-2.0
*/
#pragma once
#include <stdint.h>
#include "driver/jpeg_types.h"
#include "../jpeg_private.h"
#ifdef __cplusplus
extern "C" {
#endif
/**
* @brief Zigzag scan pattern array.
*
* This array represents a zigzag scan pattern for reordering the coefficients
* in a block of data. It is commonly used in JPEG compression and decompression
* algorithms to optimize encoding and decoding processes.
*
* The array consists of 64 elements, where each element represents the position
* of a coefficient in the zigzag pattern. The coefficients are traversed in the
* order specified by this array to achieve efficient compression and decompression.
*
* @note The values in this array are zero-indexed.
*/
extern const uint8_t zigzag_arr[64];
/**
* @brief DMA2D best hb value table for JPEG decompression.
*
* This two-dimensional array represents a Huffman decoding table for JPEG
* decompression. It is used to decode the Huffman-coded symbols in the compressed
* data stream during the decoding process.
*/
extern const uint32_t dec_hb_tbl[JPEG_DOWN_SAMPLING_NUM][JPEG_DEC_BEST_HB_MAX];
/**
* @brief DMA2D best hb value table for JPEG compression.
*
* This two-dimensional array represents a Huffman encoding table for JPEG
* compression. It is used to decode the Huffman-coded symbols in the compressed
* data stream during the encoding process.
*/
extern const uint32_t enc_hb_tbl[JPEG_ENC_BEST_HB_MAX][JPEG_DOWN_SAMPLING_NUM];
/**
* @brief Setup the standard Huffman tables (JPEG standard sections K.3.3)
* For table K.3 (for luminance DC coefficients), the 16 bytes which specify the list of code lengths for the table are
* X'00 01 05 01 01 01 01 01 01 00 00 00 00 00 00 00'
*/
extern const uint8_t luminance_dc_coefficients[JPEG_HUFFMAN_BITS_LEN_TABLE_LEN];
/**
* @brief Setup the standard Huffman tables (JPEG standard sections K.3.3)
* For table K.3 (for luminance DC coefficients), the set of values following this list is
* X'00 01 02 03 04 05 06 07 08 09 0A 0B'
*/
extern const uint8_t luminance_dc_values[JPEG_HUFFMAN_DC_VALUE_TABLE_LEN];
/**
* @brief Setup the standard Huffman tables (JPEG standard sections K.3.3)
* For table K.5 (for luminance AC coefficients), the 16 bytes which specify the list of code lengths for the table are
* X'00 02 01 03 03 02 04 03 05 05 04 04 00 00 01 7D'
*/
extern const uint8_t luminance_ac_coefficients[JPEG_HUFFMAN_BITS_LEN_TABLE_LEN];
/**
* @brief Setup the standard Huffman tables (JPEG standard sections K.3.3)
* For table K.5 (for luminance AC values)
*/
extern const uint8_t luminance_ac_values[JPEG_HUFFMAN_AC_VALUE_TABLE_LEN];
/**
* @brief Setup the standard Huffman tables (JPEG standard sections K.3.3)
* For table K.4 (for chrominance DC coefficients), the 16 bytes which specify the list of code lengths for the table are
* X'00 03 01 01 01 01 01 01 01 01 01 00 00 00 00 00'
*/
extern const uint8_t chrominance_dc_coefficients[JPEG_HUFFMAN_BITS_LEN_TABLE_LEN];
/**
* @brief Setup the standard Huffman tables (JPEG standard sections K.3.3)
* For table K.4 (for luminance DC coefficients), the set of values following this list is
* X'00 01 02 03 04 05 06 07 08 09 0A 0B'
*/
extern const uint8_t chrominance_dc_values[JPEG_HUFFMAN_DC_VALUE_TABLE_LEN];
/**
* @brief Setup the standard Huffman tables (JPEG standard sections K.3.3)
* For table K.5 (for luminance AC coefficients), the 16 bytes which specify the list of code lengths for the table are
* X'00 02 01 02 04 04 03 04 07 05 04 04 00 01 02 77'
*/
extern const uint8_t chrominance_ac_coefficients[JPEG_HUFFMAN_BITS_LEN_TABLE_LEN];
/**
* @brief Setup the standard Huffman tables (JPEG standard sections K.3.3)
* For table K.5 (for chrominance AC values)
*/
extern const uint8_t chrominance_ac_values[JPEG_HUFFMAN_AC_VALUE_TABLE_LEN];
/**
* @brief This array stores the luminance quantization values for each block in an image.(JPEG standard sections K.1)
* The luminance_quantization_table array is of type uint32_t and has a size of 64 elements.
*
* These values are part of the quantization table used in the JPEG image compression standard.
* They are employed during the process of quantizing the discrete cosine transform (DCT) coefficients
* of an image's luminance component, allowing for lossy compression.
*
* The quantization process involves dividing the DCT coefficients by these values to reduce the precision of the data,
* which results in higher compression ratios but also introduces some loss of image quality.
*
* Each value in the array corresponds to a specific position in the 8x8 luminance quantization matrix used in JPEG compression.
*
* These specific values are critical for achieving a balance between compression efficiency and visual quality
* in JPEG image compression, and they have become a fundamental component of the standard.
*/
extern const uint32_t luminance_quantization_table[JPEG_QUANTIZATION_TABLE_LEN];
/**
* @brief This array stores the chrominance quantization values for each block in an image.(JPEG standard sections K.2)
* The chrominance_quantization_table array is of type uint32_t and has a size of 64 elements.
*
* These values are part of the quantization table used in the JPEG image compression standard.
* They are employed during the process of quantizing the discrete cosine transform (DCT) coefficients
* of an image's chrominance component, allowing for lossy compression.
*
* The quantization process involves dividing the DCT coefficients by these values to reduce the precision of the data,
* which results in higher compression ratios but also introduces some loss of image quality.
*
* Each value in the array corresponds to a specific position in the 8x8 chrominance quantization matrix used in JPEG compression.
*
* These specific values are critical for achieving a balance between compression efficiency and visual quality
* in JPEG image compression, and they have become a fundamental component of the standard.
*/
extern const uint32_t chrominance_quantization_table[JPEG_QUANTIZATION_TABLE_LEN];
#ifdef __cplusplus
}
#endif