244 lines
8.1 KiB
C
244 lines
8.1 KiB
C
/*
|
|
* 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 */
|