OLD | NEW |
(Empty) | |
| 1 /* |
| 2 * Copyright (c) 2007-2012 Intel Corporation. All Rights Reserved. |
| 3 * |
| 4 * Permission is hereby granted, free of charge, to any person obtaining a |
| 5 * copy of this software and associated documentation files (the |
| 6 * "Software"), to deal in the Software without restriction, including |
| 7 * without limitation the rights to use, copy, modify, merge, publish, |
| 8 * distribute, sub license, and/or sell copies of the Software, and to |
| 9 * permit persons to whom the Software is furnished to do so, subject to |
| 10 * the following conditions: |
| 11 * |
| 12 * The above copyright notice and this permission notice (including the |
| 13 * next paragraph) shall be included in all copies or substantial portions |
| 14 * of the Software. |
| 15 * |
| 16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS |
| 17 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF |
| 18 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. |
| 19 * IN NO EVENT SHALL INTEL AND/OR ITS SUPPLIERS BE LIABLE FOR |
| 20 * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, |
| 21 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE |
| 22 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
| 23 */ |
| 24 |
| 25 /** |
| 26 * \file va_dec_jpeg.h |
| 27 * \brief The JPEG decoding API |
| 28 * |
| 29 * This file contains the \ref api_dec_jpeg "JPEG decoding API". |
| 30 */ |
| 31 |
| 32 #ifndef VA_DEC_JPEG_H |
| 33 #define VA_DEC_JPEG_H |
| 34 |
| 35 #ifdef __cplusplus |
| 36 extern "C" { |
| 37 #endif |
| 38 |
| 39 #include <va/va.h> |
| 40 |
| 41 /** |
| 42 * \defgroup api_dec_jpeg JPEG decoding API |
| 43 * |
| 44 * This JPEG decoding API supports Baseline profile only. |
| 45 * |
| 46 * @{ |
| 47 */ |
| 48 |
| 49 /** |
| 50 * \brief Picture parameter for JPEG decoding. |
| 51 * |
| 52 * This structure holds information from the frame header, along with |
| 53 * definitions from additional segments. |
| 54 */ |
| 55 typedef struct _VAPictureParameterBufferJPEGBaseline { |
| 56 /** \brief Picture width in pixels. */ |
| 57 unsigned short picture_width; |
| 58 /** \brief Picture height in pixels. */ |
| 59 unsigned short picture_height; |
| 60 |
| 61 struct { |
| 62 /** \brief Component identifier (Ci). */ |
| 63 unsigned char component_id; |
| 64 /** \brief Horizontal sampling factor (Hi). */ |
| 65 unsigned char h_sampling_factor; |
| 66 /** \brief Vertical sampling factor (Vi). */ |
| 67 unsigned char v_sampling_factor; |
| 68 /* \brief Quantization table selector (Tqi). */ |
| 69 unsigned char quantiser_table_selector; |
| 70 } components[255]; |
| 71 /** \brief Number of components in frame (Nf). */ |
| 72 unsigned char num_components; |
| 73 } VAPictureParameterBufferJPEGBaseline; |
| 74 |
| 75 /** |
| 76 * \brief Quantization table for JPEG decoding. |
| 77 * |
| 78 * This structure holds the complete quantization tables. This is an |
| 79 * aggregation of all quantization table (DQT) segments maintained by |
| 80 * the application. i.e. up to 4 quantization tables are stored in |
| 81 * there for baseline profile. |
| 82 * |
| 83 * The #load_quantization_table array can be used as a hint to notify |
| 84 * the VA driver implementation about which table(s) actually changed |
| 85 * since the last submission of this buffer. |
| 86 */ |
| 87 typedef struct _VAIQMatrixBufferJPEGBaseline { |
| 88 /** \brief Specifies which #quantiser_table is valid. */ |
| 89 unsigned char load_quantiser_table[4]; |
| 90 /** \brief Quanziation tables indexed by table identifier (Tqi). */ |
| 91 unsigned char quantiser_table[4][64]; |
| 92 } VAIQMatrixBufferJPEGBaseline; |
| 93 |
| 94 /** |
| 95 * \brief Huffman table for JPEG decoding. |
| 96 * |
| 97 * This structure holds the complete Huffman tables. This is an |
| 98 * aggregation of all Huffman table (DHT) segments maintained by the |
| 99 * application. i.e. up to 2 Huffman tables are stored in there for |
| 100 * baseline profile. |
| 101 * |
| 102 * The #load_huffman_table array can be used as a hint to notify the |
| 103 * VA driver implementation about which table(s) actually changed |
| 104 * since the last submission of this buffer. |
| 105 */ |
| 106 typedef struct _VAHuffmanTableBufferJPEGBaseline { |
| 107 /** \brief Specifies which #huffman_table is valid. */ |
| 108 unsigned char load_huffman_table[2]; |
| 109 /** \brief Huffman tables indexed by table identifier (Th). */ |
| 110 struct { |
| 111 /** @name DC table (up to 12 categories) */ |
| 112 /**@{*/ |
| 113 /** \brief Number of Huffman codes of length i + 1 (Li). */ |
| 114 unsigned char num_dc_codes[16]; |
| 115 /** \brief Value associated with each Huffman code (Vij). */ |
| 116 unsigned char dc_values[12]; |
| 117 /**@}*/ |
| 118 /** @name AC table (2 special codes + up to 16 * 10 codes) */ |
| 119 /**@{*/ |
| 120 /** \brief Number of Huffman codes of length i + 1 (Li). */ |
| 121 unsigned char num_ac_codes[16]; |
| 122 /** \brief Value associated with each Huffman code (Vij). */ |
| 123 unsigned char ac_values[162]; |
| 124 /** \brief Padding to 4-byte boundaries. Must be set to zero. */ |
| 125 unsigned char pad[2]; |
| 126 /**@}*/ |
| 127 } huffman_table[2]; |
| 128 } VAHuffmanTableBufferJPEGBaseline; |
| 129 |
| 130 /** |
| 131 * \brief Slice parameter for JPEG decoding. |
| 132 * |
| 133 * This structure holds information from the scan header, along with |
| 134 * definitions from additional segments. The associated slice data |
| 135 * buffer holds all entropy coded segments (ECS) in the scan. |
| 136 */ |
| 137 typedef struct _VASliceParameterBufferJPEGBaseline { |
| 138 /** @name Codec-independent Slice Parameter Buffer base. */ |
| 139 /**@{*/ |
| 140 /** \brief Number of bytes in the slice data buffer for this slice. */ |
| 141 unsigned int slice_data_size; |
| 142 /** \brief The offset to the first byte of the first MCU. */ |
| 143 unsigned int slice_data_offset; |
| 144 /** \brief Slice data buffer flags. See \c VA_SLICE_DATA_FLAG_xxx. */ |
| 145 unsigned int slice_data_flag; |
| 146 /**@}*/ |
| 147 |
| 148 /** \brief Scan horizontal position. */ |
| 149 unsigned int slice_horizontal_position; |
| 150 /** \brief Scan vertical position. */ |
| 151 unsigned int slice_vertical_position; |
| 152 |
| 153 struct { |
| 154 /** \brief Scan component selector (Csj). */ |
| 155 unsigned char component_selector; |
| 156 /** \brief DC entropy coding table selector (Tdj). */ |
| 157 unsigned char dc_table_selector; |
| 158 /** \brief AC entropy coding table selector (Taj). */ |
| 159 unsigned char ac_table_selector; |
| 160 } components[4]; |
| 161 /** \brief Number of components in scan (Ns). */ |
| 162 unsigned char num_components; |
| 163 |
| 164 /** \brief Restart interval definition (Ri). */ |
| 165 unsigned short restart_interval; |
| 166 /** \brief Number of MCUs in a scan. */ |
| 167 unsigned int num_mcus; |
| 168 } VASliceParameterBufferJPEGBaseline; |
| 169 |
| 170 /**@}*/ |
| 171 |
| 172 #ifdef __cplusplus |
| 173 } |
| 174 #endif |
| 175 |
| 176 #endif /* VA_DEC_JPEG_H */ |
OLD | NEW |