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