You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
243 lines
8.1 KiB
243 lines
8.1 KiB
/* |
|
* Copyright (c) 2007-2012 Intel Corporation. All Rights Reserved. |
|
* |
|
* Permission is hereby granted, free of charge, to any person obtaining a |
|
* copy of this software and associated documentation files (the |
|
* "Software"), to deal in the Software without restriction, including |
|
* without limitation the rights to use, copy, modify, merge, publish, |
|
* distribute, sub license, and/or sell copies of the Software, and to |
|
* permit persons to whom the Software is furnished to do so, subject to |
|
* the following conditions: |
|
* |
|
* The above copyright notice and this permission notice (including the |
|
* next paragraph) shall be included in all copies or substantial portions |
|
* of the Software. |
|
* |
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS |
|
* OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF |
|
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. |
|
* IN NO EVENT SHALL INTEL AND/OR ITS SUPPLIERS BE LIABLE FOR |
|
* ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, |
|
* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE |
|
* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
|
*/ |
|
|
|
/** |
|
* \file va_dec_vp.h |
|
* \brief VP8 decoding API |
|
* |
|
* This file contains the \ref api_dec_vp8 "VP8 decoding API". |
|
*/ |
|
|
|
#ifndef VA_DEC_VP8_H |
|
#define VA_DEC_VP8_H |
|
|
|
#ifdef __cplusplus |
|
extern "C" { |
|
#endif |
|
|
|
/** |
|
* \defgroup api_dec_vp8 VP8 decoding API |
|
* |
|
* @{ |
|
*/ |
|
|
|
/** |
|
* \brief VPX Bool Coder Context structure |
|
* |
|
* This common structure is defined for potential sharing by other VP formats |
|
* |
|
*/ |
|
typedef struct _VABoolCoderContextVPX |
|
{ |
|
/* partition 0 "range" */ |
|
unsigned char range; |
|
/* partition 0 "value" */ |
|
unsigned char value; |
|
/* |
|
* 'partition 0 number of shifts before an output byte is available' |
|
* it is the number of remaining bits in 'value' for decoding, range [0, 7]. |
|
*/ |
|
|
|
unsigned char count; |
|
} VABoolCoderContextVPX; |
|
|
|
/** |
|
* \brief VP8 Decoding Picture Parameter Buffer Structure |
|
* |
|
* This structure conveys frame level parameters and should be sent once |
|
* per frame. |
|
* |
|
*/ |
|
typedef struct _VAPictureParameterBufferVP8 |
|
{ |
|
/* frame width in pixels */ |
|
unsigned int frame_width; |
|
/* frame height in pixels */ |
|
unsigned int frame_height; |
|
|
|
/* specifies the "last" reference frame */ |
|
VASurfaceID last_ref_frame; |
|
/* specifies the "golden" reference frame */ |
|
VASurfaceID golden_ref_frame; |
|
/* specifies the "alternate" referrence frame */ |
|
VASurfaceID alt_ref_frame; |
|
/* specifies the out-of-loop deblocked frame, not used currently */ |
|
VASurfaceID out_of_loop_frame; |
|
|
|
union { |
|
struct { |
|
/* same as key_frame in bitstream syntax, 0 means a key frame */ |
|
unsigned int key_frame : 1; |
|
/* same as version in bitstream syntax */ |
|
unsigned int version : 3; |
|
/* same as segmentation_enabled in bitstream syntax */ |
|
unsigned int segmentation_enabled : 1; |
|
/* same as update_mb_segmentation_map in bitstream syntax */ |
|
unsigned int update_mb_segmentation_map : 1; |
|
/* same as update_segment_feature_data in bitstream syntax */ |
|
unsigned int update_segment_feature_data : 1; |
|
/* same as filter_type in bitstream syntax */ |
|
unsigned int filter_type : 1; |
|
/* same as sharpness_level in bitstream syntax */ |
|
unsigned int sharpness_level : 3; |
|
/* same as loop_filter_adj_enable in bitstream syntax */ |
|
unsigned int loop_filter_adj_enable : 1; |
|
/* same as mode_ref_lf_delta_update in bitstream syntax */ |
|
unsigned int mode_ref_lf_delta_update : 1; |
|
/* same as sign_bias_golden in bitstream syntax */ |
|
unsigned int sign_bias_golden : 1; |
|
/* same as sign_bias_alternate in bitstream syntax */ |
|
unsigned int sign_bias_alternate : 1; |
|
/* same as mb_no_coeff_skip in bitstream syntax */ |
|
unsigned int mb_no_coeff_skip : 1; |
|
/* flag to indicate that loop filter should be disabled */ |
|
unsigned int loop_filter_disable : 1; |
|
} bits; |
|
unsigned int value; |
|
} pic_fields; |
|
|
|
/* |
|
* probabilities of the segment_id decoding tree and same as |
|
* mb_segment_tree_probs in the spec. |
|
*/ |
|
unsigned char mb_segment_tree_probs[3]; |
|
|
|
/* Post-adjustment loop filter levels for the 4 segments */ |
|
unsigned char loop_filter_level[4]; |
|
/* loop filter deltas for reference frame based MB level adjustment */ |
|
char loop_filter_deltas_ref_frame[4]; |
|
/* loop filter deltas for coding mode based MB level adjustment */ |
|
char loop_filter_deltas_mode[4]; |
|
|
|
/* same as prob_skip_false in bitstream syntax */ |
|
unsigned char prob_skip_false; |
|
/* same as prob_intra in bitstream syntax */ |
|
unsigned char prob_intra; |
|
/* same as prob_last in bitstream syntax */ |
|
unsigned char prob_last; |
|
/* same as prob_gf in bitstream syntax */ |
|
unsigned char prob_gf; |
|
|
|
/* |
|
* list of 4 probabilities of the luma intra prediction mode decoding |
|
* tree and same as y_mode_probs in frame header |
|
*/ |
|
unsigned char y_mode_probs[4]; |
|
/* |
|
* list of 3 probabilities of the chroma intra prediction mode decoding |
|
* tree and same as uv_mode_probs in frame header |
|
*/ |
|
unsigned char uv_mode_probs[3]; |
|
/* |
|
* updated mv decoding probabilities and same as mv_probs in |
|
* frame header |
|
*/ |
|
unsigned char mv_probs[2][19]; |
|
|
|
VABoolCoderContextVPX bool_coder_ctx; |
|
|
|
} VAPictureParameterBufferVP8; |
|
|
|
/** |
|
* \brief VP8 Slice Parameter Buffer Structure |
|
* |
|
* This structure conveys parameters related to data partitions and should be |
|
* sent once per frame. Slice data buffer of VASliceDataBufferType is used |
|
* to send the partition data. |
|
* |
|
*/ |
|
typedef struct _VASliceParameterBufferVP8 |
|
{ |
|
/* |
|
* number of bytes in the slice data buffer for the partitions |
|
*/ |
|
unsigned int slice_data_size; |
|
/* |
|
* offset to the first byte of partition data (control partition) |
|
*/ |
|
unsigned int slice_data_offset; |
|
/* |
|
* see VA_SLICE_DATA_FLAG_XXX definitions |
|
*/ |
|
unsigned int slice_data_flag; |
|
/* |
|
* offset to the first bit of MB from the first byte of partition data(slice_data_offset) |
|
*/ |
|
unsigned int macroblock_offset; |
|
|
|
/* |
|
* Partitions |
|
* (1<<log2_nbr_of_dct_partitions)+1, count both control partition (frame header) and toke partition |
|
*/ |
|
unsigned char num_of_partitions; |
|
/* |
|
* partition_size[0] is remaining bytes of control partition after parsed by application. |
|
* exclude current byte for the remaining bits in bool_coder_ctx. |
|
* exclude the uncompress data chunk since first_part_size 'excluding the uncompressed data chunk' |
|
*/ |
|
unsigned int partition_size[9]; |
|
} VASliceParameterBufferVP8; |
|
|
|
/** |
|
* \brief VP8 Coefficient Probability Data Buffer Structure |
|
* |
|
* Contains the contents of the token probability table, which may be |
|
* incrementally modified in the frame header. There are four dimensions to |
|
* the token probability array. The outermost dimension is indexed by the |
|
* type of plane being decoded; the next dimension is selected by the |
|
* position of the coefficient being decoded; the third dimension, * roughly |
|
* speaking, measures the "local complexity" or extent to which nearby |
|
* coefficients are non-zero; the fourth, and final, dimension of the token |
|
* probability array is indexed by the position in the token tree structure, |
|
* as are all tree probability arrays. This structure is sent once per frame. |
|
* |
|
*/ |
|
typedef struct _VAProbabilityDataBufferVP8 |
|
{ |
|
unsigned char dct_coeff_probs[4][8][3][11]; |
|
} VAProbabilityDataBufferVP8; |
|
|
|
/** |
|
* \brief VP8 Inverse Quantization Matrix Buffer Structure |
|
* |
|
* Contains quantization indices for yac(0),ydc(1),y2dc(2),y2ac(3),uvdc(4), |
|
* uvac(5) for each segment (0-3). When segmentation is disabled, only |
|
* quantization_index[0][] will be used. This structure is sent once per frame. |
|
*/ |
|
typedef struct _VAIQMatrixBufferVP8 |
|
{ |
|
/* |
|
* array first dimensional is segment and 2nd dimensional is Q index |
|
* all Q indexs should be clipped to be range [0, 127] |
|
*/ |
|
unsigned short quantization_index[4][6]; |
|
} VAIQMatrixBufferVP8; |
|
|
|
/**@}*/ |
|
|
|
#ifdef __cplusplus |
|
} |
|
#endif |
|
|
|
#endif /* VA_DEC_VP8_H */
|
|
|