Home | History | Annotate | Download | only in va 
      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 */
    177