|
Packit Service |
9402ce |
/*
|
|
Packit Service |
9402ce |
* Copyright (c) 2014 Intel Corporation. All Rights Reserved.
|
|
Packit Service |
9402ce |
*
|
|
Packit Service |
9402ce |
* Permission is hereby granted, free of charge, to any person obtaining a
|
|
Packit Service |
9402ce |
* copy of this software and associated documentation files (the
|
|
Packit Service |
9402ce |
* "Software"), to deal in the Software without restriction, including
|
|
Packit Service |
9402ce |
* without limitation the rights to use, copy, modify, merge, publish,
|
|
Packit Service |
9402ce |
* distribute, sub license, and/or sell copies of the Software, and to
|
|
Packit Service |
9402ce |
* permit persons to whom the Software is furnished to do so, subject to
|
|
Packit Service |
9402ce |
* the following conditions:
|
|
Packit Service |
9402ce |
*
|
|
Packit Service |
9402ce |
* The above copyright notice and this permission notice (including the
|
|
Packit Service |
9402ce |
* next paragraph) shall be included in all copies or substantial portions
|
|
Packit Service |
9402ce |
* of the Software.
|
|
Packit Service |
9402ce |
*
|
|
Packit Service |
9402ce |
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
|
|
Packit Service |
9402ce |
* OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
Packit Service |
9402ce |
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
|
|
Packit Service |
9402ce |
* IN NO EVENT SHALL INTEL AND/OR ITS SUPPLIERS BE LIABLE FOR
|
|
Packit Service |
9402ce |
* ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
|
|
Packit Service |
9402ce |
* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
|
|
Packit Service |
9402ce |
* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
/**
|
|
Packit Service |
9402ce |
* \file va_dec_vp9.h
|
|
Packit Service |
9402ce |
* \brief The VP9 decoding API
|
|
Packit Service |
9402ce |
*
|
|
Packit Service |
9402ce |
* This file contains the \ref api_dec_vp9 "VP9 decoding API".
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
#ifndef VA_DEC_VP9_H
|
|
Packit Service |
9402ce |
#define VA_DEC_VP9_H
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
#ifdef __cplusplus
|
|
Packit Service |
9402ce |
extern "C" {
|
|
Packit Service |
9402ce |
#endif
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
/**
|
|
Packit Service |
9402ce |
* \defgroup api_dec_vp9 VP9 decoding API
|
|
Packit Service |
9402ce |
*
|
|
Packit Service |
9402ce |
* This VP9 decoding API supports 8-bit 420 format only.
|
|
Packit Service |
9402ce |
*
|
|
Packit Service |
9402ce |
* @{
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
/**
|
|
Packit Service |
9402ce |
* \brief VP9 Decoding Picture Parameter Buffer Structure
|
|
Packit Service |
9402ce |
*
|
|
Packit Service |
9402ce |
* This structure conveys picture level parameters.
|
|
Packit Service |
9402ce |
* App should send a surface with this data structure down to VAAPI once
|
|
Packit Service |
9402ce |
* per frame.
|
|
Packit Service |
9402ce |
*
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
typedef struct _VADecPictureParameterBufferVP9
|
|
Packit Service |
9402ce |
{
|
|
Packit Service |
9402ce |
/** \brief picture width
|
|
Packit Service |
9402ce |
* Picture original resolution. The value may not be multiple of 8.
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
uint16_t frame_width;
|
|
Packit Service |
9402ce |
/** \brief picture height
|
|
Packit Service |
9402ce |
* Picture original resolution. The value may not be multiple of 8.
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
uint16_t frame_height;
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
/** \brief Surface indices of reference frames in DPB.
|
|
Packit Service |
9402ce |
*
|
|
Packit Service |
9402ce |
* Each entry of the list specifies the surface index of the picture
|
|
Packit Service |
9402ce |
* that is referred by current picture or will be referred by any future
|
|
Packit Service |
9402ce |
* picture.
|
|
Packit Service |
9402ce |
* Application who calls this API should update this list based on the
|
|
Packit Service |
9402ce |
* refreshing information from VP9 bitstream.
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
VASurfaceID reference_frames[8];
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
union
|
|
Packit Service |
9402ce |
{
|
|
Packit Service |
9402ce |
struct
|
|
Packit Service |
9402ce |
{
|
|
Packit Service |
9402ce |
/** \brief flags for current picture
|
|
Packit Service |
9402ce |
* same syntax and semantic as those in VP9 code
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
uint32_t subsampling_x : 1;
|
|
Packit Service |
9402ce |
uint32_t subsampling_y : 1;
|
|
Packit Service |
9402ce |
uint32_t frame_type : 1;
|
|
Packit Service |
9402ce |
uint32_t show_frame : 1;
|
|
Packit Service |
9402ce |
uint32_t error_resilient_mode : 1;
|
|
Packit Service |
9402ce |
uint32_t intra_only : 1;
|
|
Packit Service |
9402ce |
uint32_t allow_high_precision_mv : 1;
|
|
Packit Service |
9402ce |
uint32_t mcomp_filter_type : 3;
|
|
Packit Service |
9402ce |
uint32_t frame_parallel_decoding_mode : 1;
|
|
Packit Service |
9402ce |
uint32_t reset_frame_context : 2;
|
|
Packit Service |
9402ce |
uint32_t refresh_frame_context : 1;
|
|
Packit Service |
9402ce |
uint32_t frame_context_idx : 2;
|
|
Packit Service |
9402ce |
uint32_t segmentation_enabled : 1;
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
/** \brief corresponds to variable temporal_update in VP9 code.
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
uint32_t segmentation_temporal_update : 1;
|
|
Packit Service |
9402ce |
/** \brief corresponds to variable update_mb_segmentation_map
|
|
Packit Service |
9402ce |
* in VP9 code.
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
uint32_t segmentation_update_map : 1;
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
/** \brief Index of reference_frames[] and points to the
|
|
Packit Service |
9402ce |
* LAST reference frame.
|
|
Packit Service |
9402ce |
* It corresponds to active_ref_idx[0] in VP9 code.
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
uint32_t last_ref_frame : 3;
|
|
Packit Service |
9402ce |
/** \brief Sign Bias of the LAST reference frame.
|
|
Packit Service |
9402ce |
* It corresponds to ref_frame_sign_bias[LAST_FRAME] in VP9 code.
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
uint32_t last_ref_frame_sign_bias : 1;
|
|
Packit Service |
9402ce |
/** \brief Index of reference_frames[] and points to the
|
|
Packit Service |
9402ce |
* GOLDERN reference frame.
|
|
Packit Service |
9402ce |
* It corresponds to active_ref_idx[1] in VP9 code.
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
uint32_t golden_ref_frame : 3;
|
|
Packit Service |
9402ce |
/** \brief Sign Bias of the GOLDERN reference frame.
|
|
Packit Service |
9402ce |
* Corresponds to ref_frame_sign_bias[GOLDERN_FRAME] in VP9 code.
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
uint32_t golden_ref_frame_sign_bias : 1;
|
|
Packit Service |
9402ce |
/** \brief Index of reference_frames[] and points to the
|
|
Packit Service |
9402ce |
* ALTERNATE reference frame.
|
|
Packit Service |
9402ce |
* Corresponds to active_ref_idx[2] in VP9 code.
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
uint32_t alt_ref_frame : 3;
|
|
Packit Service |
9402ce |
/** \brief Sign Bias of the ALTERNATE reference frame.
|
|
Packit Service |
9402ce |
* Corresponds to ref_frame_sign_bias[ALTREF_FRAME] in VP9 code.
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
uint32_t alt_ref_frame_sign_bias : 1;
|
|
Packit Service |
9402ce |
/** \brief Lossless Mode
|
|
Packit Service |
9402ce |
* LosslessFlag = base_qindex == 0 &&
|
|
Packit Service |
9402ce |
* y_dc_delta_q == 0 &&
|
|
Packit Service |
9402ce |
* uv_dc_delta_q == 0 &&
|
|
Packit Service |
9402ce |
* uv_ac_delta_q == 0;
|
|
Packit Service |
9402ce |
* Where base_qindex, y_dc_delta_q, uv_dc_delta_q and uv_ac_delta_q
|
|
Packit Service |
9402ce |
* are all variables in VP9 code.
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
uint32_t lossless_flag : 1;
|
|
Packit Service |
9402ce |
} bits;
|
|
Packit Service |
9402ce |
uint32_t value;
|
|
Packit Service |
9402ce |
} pic_fields;
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
/* following parameters have same syntax with those in VP9 code */
|
|
Packit Service |
9402ce |
uint8_t filter_level;
|
|
Packit Service |
9402ce |
uint8_t sharpness_level;
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
/** \brief number of tile rows specified by (1 << log2_tile_rows).
|
|
Packit Service |
9402ce |
* It corresponds the variable with same name in VP9 code.
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
uint8_t log2_tile_rows;
|
|
Packit Service |
9402ce |
/** \brief number of tile columns specified by (1 << log2_tile_columns).
|
|
Packit Service |
9402ce |
* It corresponds the variable with same name in VP9 code.
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
uint8_t log2_tile_columns;
|
|
Packit Service |
9402ce |
/** \brief Number of bytes taken up by the uncompressed frame header,
|
|
Packit Service |
9402ce |
* which corresponds to byte length of function
|
|
Packit Service |
9402ce |
* read_uncompressed_header() in VP9 code.
|
|
Packit Service |
9402ce |
* Specifically, it is the byte count from bit stream buffer start to
|
|
Packit Service |
9402ce |
* the last byte of uncompressed frame header.
|
|
Packit Service |
9402ce |
* If there are other meta data in the buffer before uncompressed header,
|
|
Packit Service |
9402ce |
* its size should be also included here.
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
uint8_t frame_header_length_in_bytes;
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
/** \brief The byte count of compressed header the bitstream buffer,
|
|
Packit Service |
9402ce |
* which corresponds to syntax first_partition_size in code.
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
uint16_t first_partition_size;
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
/** These values are segment probabilities with same names in VP9
|
|
Packit Service |
9402ce |
* function setup_segmentation(). They should be parsed directly from
|
|
Packit Service |
9402ce |
* bitstream by application.
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
uint8_t mb_segment_tree_probs[7];
|
|
Packit Service |
9402ce |
uint8_t segment_pred_probs[3];
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
/** \brief VP9 Profile definition
|
|
Packit Service |
9402ce |
* value range [0..3].
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
uint8_t profile;
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
/** \brief VP9 bit depth per sample
|
|
Packit Service |
9402ce |
* same for both luma and chroma samples.
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
uint8_t bit_depth;
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
/** \brief Reserved bytes for future use, must be zero */
|
|
Packit Service |
9402ce |
uint32_t va_reserved[VA_PADDING_MEDIUM];
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
} VADecPictureParameterBufferVP9;
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
/**
|
|
Packit Service |
9402ce |
* \brief VP9 Segmentation Parameter Data Structure
|
|
Packit Service |
9402ce |
*
|
|
Packit Service |
9402ce |
* This structure conveys per segment parameters.
|
|
Packit Service |
9402ce |
* 8 of this data structure will be included in VASegmentationParameterBufferVP9
|
|
Packit Service |
9402ce |
* and sent to API in a single buffer.
|
|
Packit Service |
9402ce |
*
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
typedef struct _VASegmentParameterVP9
|
|
Packit Service |
9402ce |
{
|
|
Packit Service |
9402ce |
union
|
|
Packit Service |
9402ce |
{
|
|
Packit Service |
9402ce |
struct
|
|
Packit Service |
9402ce |
{
|
|
Packit Service |
9402ce |
/** \brief Indicates if per segment reference frame indicator
|
|
Packit Service |
9402ce |
* is enabled.
|
|
Packit Service |
9402ce |
* Corresponding to variable feature_enabled when
|
|
Packit Service |
9402ce |
* j == SEG_LVL_REF_FRAME in function setup_segmentation() VP9 code.
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
uint16_t segment_reference_enabled : 1;
|
|
Packit Service |
9402ce |
/** \brief Specifies per segment reference indication.
|
|
Packit Service |
9402ce |
* 0: reserved
|
|
Packit Service |
9402ce |
* 1: Last ref
|
|
Packit Service |
9402ce |
* 2: golden
|
|
Packit Service |
9402ce |
* 3: altref
|
|
Packit Service |
9402ce |
* Value can be derived from variable data when
|
|
Packit Service |
9402ce |
* j == SEG_LVL_REF_FRAME in function setup_segmentation() VP9 code.
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
uint16_t segment_reference : 2;
|
|
Packit Service |
9402ce |
/** \brief Indicates if per segment skip feature is enabled.
|
|
Packit Service |
9402ce |
* Corresponding to variable feature_enabled when
|
|
Packit Service |
9402ce |
* j == SEG_LVL_SKIP in function setup_segmentation() VP9 code.
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
uint16_t segment_reference_skipped : 1;
|
|
Packit Service |
9402ce |
} fields;
|
|
Packit Service |
9402ce |
uint16_t value;
|
|
Packit Service |
9402ce |
} segment_flags;
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
/** \brief Specifies the filter level information per segment.
|
|
Packit Service |
9402ce |
* The value corresponds to variable lfi->lvl[seg][ref][mode] in VP9 code,
|
|
Packit Service |
9402ce |
* where m is [ref], and n is [mode] in FilterLevel[m][n].
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
uint8_t filter_level[4][2];
|
|
Packit Service |
9402ce |
/** \brief Specifies per segment Luma AC quantization scale.
|
|
Packit Service |
9402ce |
* Corresponding to y_dequant[qindex][1] in vp9_mb_init_quantizer()
|
|
Packit Service |
9402ce |
* function of VP9 code.
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
int16_t luma_ac_quant_scale;
|
|
Packit Service |
9402ce |
/** \brief Specifies per segment Luma DC quantization scale.
|
|
Packit Service |
9402ce |
* Corresponding to y_dequant[qindex][0] in vp9_mb_init_quantizer()
|
|
Packit Service |
9402ce |
* function of VP9 code.
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
int16_t luma_dc_quant_scale;
|
|
Packit Service |
9402ce |
/** \brief Specifies per segment Chroma AC quantization scale.
|
|
Packit Service |
9402ce |
* Corresponding to uv_dequant[qindex][1] in vp9_mb_init_quantizer()
|
|
Packit Service |
9402ce |
* function of VP9 code.
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
int16_t chroma_ac_quant_scale;
|
|
Packit Service |
9402ce |
/** \brief Specifies per segment Chroma DC quantization scale.
|
|
Packit Service |
9402ce |
* Corresponding to uv_dequant[qindex][0] in vp9_mb_init_quantizer()
|
|
Packit Service |
9402ce |
* function of VP9 code.
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
int16_t chroma_dc_quant_scale;
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
/** \brief Reserved bytes for future use, must be zero */
|
|
Packit Service |
9402ce |
uint32_t va_reserved[VA_PADDING_LOW];
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
} VASegmentParameterVP9;
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
/**
|
|
Packit Service |
9402ce |
* \brief VP9 Slice Parameter Buffer Structure
|
|
Packit Service |
9402ce |
*
|
|
Packit Service |
9402ce |
* This structure conveys parameters related to segmentation data and should be
|
|
Packit Service |
9402ce |
* sent once per frame.
|
|
Packit Service |
9402ce |
*
|
|
Packit Service |
9402ce |
* When segmentation is disabled, only SegParam[0] has valid values,
|
|
Packit Service |
9402ce |
* all other entries should be populated with 0.
|
|
Packit Service |
9402ce |
* Otherwise, all eight entries should be valid.
|
|
Packit Service |
9402ce |
*
|
|
Packit Service |
9402ce |
* Slice data buffer of VASliceDataBufferType is used
|
|
Packit Service |
9402ce |
* to send the bitstream which should include whole or part of partition 0
|
|
Packit Service |
9402ce |
* (at least compressed header) to the end of frame.
|
|
Packit Service |
9402ce |
*
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
typedef struct _VASliceParameterBufferVP9
|
|
Packit Service |
9402ce |
{
|
|
Packit Service |
9402ce |
/** \brief The byte count of current frame in the bitstream buffer,
|
|
Packit Service |
9402ce |
* starting from first byte of the buffer.
|
|
Packit Service |
9402ce |
* It uses the name slice_data_size to be consitent with other codec,
|
|
Packit Service |
9402ce |
* but actually means frame_data_size.
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
uint32_t slice_data_size;
|
|
Packit Service |
9402ce |
/**
|
|
Packit Service |
9402ce |
* offset to the first byte of partition data (control partition)
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
uint32_t slice_data_offset;
|
|
Packit Service |
9402ce |
/**
|
|
Packit Service |
9402ce |
* see VA_SLICE_DATA_FLAG_XXX definitions
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
uint32_t slice_data_flag;
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
/**
|
|
Packit Service |
9402ce |
* \brief per segment information
|
|
Packit Service |
9402ce |
*/
|
|
Packit Service |
9402ce |
VASegmentParameterVP9 seg_param[8];
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
/** \brief Reserved bytes for future use, must be zero */
|
|
Packit Service |
9402ce |
uint32_t va_reserved[VA_PADDING_LOW];
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
} VASliceParameterBufferVP9;
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
/**@}*/
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
#ifdef __cplusplus
|
|
Packit Service |
9402ce |
}
|
|
Packit Service |
9402ce |
#endif
|
|
Packit Service |
9402ce |
|
|
Packit Service |
9402ce |
#endif /* VA_DEC_VP9_H */
|