diff options
author | Wang, Ce <ce.wang@intel.com> | 2014-04-02 05:40:01 +0000 |
---|---|---|
committer | Xiang, Haihao <haihao.xiang@intel.com> | 2014-04-04 09:29:21 +0800 |
commit | 960352aaf1e11891a533ce2c98b16edde24d6851 (patch) | |
tree | 5291b2941e2ae7fdd1009f3b7a98c06c05148b6f | |
parent | 66ca988d5d71e5de15081a4563d8f4899bd2206e (diff) | |
download | libva-960352aaf1e11891a533ce2c98b16edde24d6851.tar.gz |
VP9 decode API
Signed-off-by: Wang, Ce <ce.wang@intel.com>
Signed-off-by: Jonathan Bian <jonathan.bian@intel.com>
-rwxr-xr-x | va/Android.mk | 1 | ||||
-rw-r--r-- | va/Makefile.am | 1 | ||||
-rw-r--r-- | va/va.h | 3 | ||||
-rw-r--r-- | va/va_dec_vp9.h | 308 |
4 files changed, 312 insertions, 1 deletions
diff --git a/va/Android.mk b/va/Android.mk index 80e81e7..b0b1d50 100755 --- a/va/Android.mk +++ b/va/Android.mk @@ -65,6 +65,7 @@ LOCAL_COPY_HEADERS := \ va_dec_hevc.h \ va_dec_jpeg.h \ va_dec_vp8.h \ + va_dec_vp9.h \ va_enc.h \ va_enc_h264.h \ va_enc_jpeg.h \ diff --git a/va/Makefile.am b/va/Makefile.am index d0a8ec2..13ea35a 100644 --- a/va/Makefile.am +++ b/va/Makefile.am @@ -48,6 +48,7 @@ libva_source_h = \ va_dec_hevc.h \ va_dec_jpeg.h \ va_dec_vp8.h \ + va_dec_vp9.h \ va_drmcommon.h \ va_enc.h \ va_enc_h264.h \ @@ -331,7 +331,8 @@ typedef enum VAProfileH264MultiviewHigh = 15, VAProfileH264StereoHigh = 16, VAProfileHEVCMain = 17, - VAProfileHEVCMain10 = 18 + VAProfileHEVCMain10 = 18, + VAProfileVP9Version0 = 19 } VAProfile; /** diff --git a/va/va_dec_vp9.h b/va/va_dec_vp9.h new file mode 100644 index 0000000..c1dbb20 --- /dev/null +++ b/va/va_dec_vp9.h @@ -0,0 +1,308 @@ +/* + * Copyright (c) 2014 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_vp9.h + * \brief The VP9 decoding API + * + * This file contains the \ref api_dec_vp9 "VP9 decoding API". + */ + +#ifndef VA_DEC_VP9_H +#define VA_DEC_VP9_H + +#include <stdint.h> + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * \defgroup api_dec_vp9 VP9 decoding API + * + * This VP9 decoding API supports 8-bit 420 format only. + * + * @{ + */ + + + + +/** + * \brief VP9 Decoding Picture Parameter Buffer Structure + * + * This structure conveys picture level parameters. + * App should send a surface with this data structure down to VAAPI once + * per frame. + * + */ +typedef struct _VADecPictureParameterBufferVP9 +{ + /**@{*/ + + /** \brief picture width + * The value must be multiple of 8. + */ + uint16_t frame_width; + /** \brief picture height + * The value must be multiple of 8. + */ + uint16_t frame_height; + + /** \brief Surface index of decoded current picture + */ + VASurfaceID curr_pic; + /** \brief Surface indices of reference frames in DPB. + * + * Each entry of the list specifies the surface index of the picture + * that is referred by current picture or will be referred by any future + * picture. + * Application who calls this API should update this list based on the + * refreshing information from VP9 bitstream. + */ + VASurfaceID reference_frames[8]; + + union + { + struct + { + /** \brief flags for current picture + * same syntax and semantic as those in VP9 code + */ + uint32_t subsampling_x : 1; + uint32_t subsampling_y : 1; + uint32_t frame_type : 1; + uint32_t show_frame : 1; + uint32_t error_resilient_mode : 1; + uint32_t intra_only : 1; + uint32_t allow_high_precision_mv : 1; + uint32_t mcomp_filter_type : 3; + uint32_t frame_parallel_decoding_mode : 1; + uint32_t reset_frame_context : 2; + uint32_t refresh_frame_context : 1; + uint32_t frame_context_idx : 2; + uint32_t segmentation_enabled : 1; + + /** \brief corresponds to variable temporal_update in VP9 code. + */ + uint32_t segmentation_temporal_update : 1; + /** \brief corresponds to variable update_mb_segmentation_map + * in VP9 code. + */ + uint32_t segmentation_update_map : 1; + + /** \brief Index of reference_frames[] and points to the + * LAST reference frame. + * It corresponds to active_ref_idx[0] in VP9 code. + */ + uint32_t last_ref_frame : 3; + /** \brief Sign Bias of the LAST reference frame. + * It corresponds to ref_frame_sign_bias[LAST_FRAME] in VP9 code. + */ + uint32_t last_ref_frame_sign_bias : 1; + /** \brief Index of reference_frames[] and points to the + * GOLDERN reference frame. + * It corresponds to active_ref_idx[1] in VP9 code. + */ + uint32_t golden_ref_frame : 3; + /** \brief Sign Bias of the GOLDERN reference frame. + * Corresponds to ref_frame_sign_bias[GOLDERN_FRAME] in VP9 code. + */ + uint32_t golden_ref_frame_sign_bias : 1; + /** \brief Index of reference_frames[] and points to the + * ALTERNATE reference frame. + * Corresponds to active_ref_idx[2] in VP9 code. + */ + uint32_t alt_ref_frame : 3; + /** \brief Sign Bias of the ALTERNATE reference frame. + * Corresponds to ref_frame_sign_bias[ALTREF_FRAME] in VP9 code. + */ + uint32_t alt_ref_frame_sign_bias : 1; + /** \brief Lossless Mode + * LosslessFlag = base_qindex == 0 && + * y_dc_delta_q == 0 && + * uv_dc_delta_q == 0 && + * uv_ac_delta_q == 0; + * Where base_qindex, y_dc_delta_q, uv_dc_delta_q and uv_ac_delta_q + * are all variables in VP9 code. + */ + uint32_t lossless_flag : 1; + } bits; + uint32_t value; + } pic_fields; + + /* following parameters have same syntax with those in VP9 code */ + uint8_t filter_level; + uint8_t sharpness_level; + + /** \brief number of tile rows specified by (1 << log2_tile_rows). + * It corresponds the variable with same name in VP9 code. + */ + uint8_t log2_tile_rows; + /** \brief number of tile columns specified by (1 << log2_tile_columns). + * It corresponds the variable with same name in VP9 code. + */ + uint8_t log2_tile_columns; + /** \brief Number of bytes taken up by the uncompressed frame header, + * which corresponds to byte length of function + * read_uncompressed_header() in VP9 code. + * Specifically, it is the byte count from bit stream buffer start to + * the last byte of uncompressed frame header. + */ + uint8_t frame_header_length_in_bytes; + + /** \brief The byte count of compressed header the bitstream buffer, + * which corresponds to syntax first_partition_size in code. + */ + uint16_t first_partition_size; + + /** \brief The byte count of current frame in the bitstream buffer, + * starting from first byte of the buffer. + */ + uint32_t frame_data_size; + + /** These values are segment probabilities with same names in VP9 + * function setup_segmentation(). They should be parsed directly from + * bitstream by application. + */ + uint8_t mb_segment_tree_probs[7]; + uint8_t segment_pred_probs[3]; + + /** \brief VP9 version number + * value can be 0 or 1. + */ + uint8_t version; + /**@}*/ + +} VADecPictureParameterBufferVP9; + + + +/** + * \brief VP9 Segmentation Parameter Data Structure + * + * This structure conveys per segment parameters. + * 8 of this data structure will be included in VASegmentationParameterBufferVP9 + * and sent to API in a single buffer. + * + */ +typedef struct _VASegmentParameterVP9 +{ + /**@{*/ + + union + { + struct + { + /** \brief Indicates if per segment reference frame indicator + * is enabled. + * Corresponding to variable feature_enabled when + * j == SEG_LVL_REF_FRAME in function setup_segmentation() VP9 code. + */ + uint16_t segment_reference_enabled : 1; + /** \brief Specifies per segment reference indication. + * 0: reserved + * 1: Last ref + * 2: golden + * 3: altref + * Value can be derived from variable data when + * j == SEG_LVL_REF_FRAME in function setup_segmentation() VP9 code. + */ + uint16_t segment_reference : 2; + /** \brief Indicates if per segment skip feature is enabled. + * Corresponding to variable feature_enabled when + * j == SEG_LVL_SKIP in function setup_segmentation() VP9 code. + */ + uint16_t segment_reference_skipped : 1; + } fields; + uint16_t value; + } segment_flags; + + /** \brief Specifies the filter level information per segment. + * The value corresponds to variable lfi->lvl[seg][ref][mode] in VP9 code, + * where m is [ref], and n is [mode] in FilterLevel[m][n]. + */ + uint8_t filter_level[4][2]; + /** \brief Specifies per segment Luma AC quantization scale. + * Corresponding to y_dequant[qindex][1] in vp9_mb_init_quantizer() + * function of VP9 code. + */ + int16_t luma_ac_quant_scale; + /** \brief Specifies per segment Luma DC quantization scale. + * Corresponding to y_dequant[qindex][0] in vp9_mb_init_quantizer() + * function of VP9 code. + */ + int16_t luma_dc_quant_scale; + /** \brief Specifies per segment Chroma AC quantization scale. + * Corresponding to uv_dequant[qindex][1] in vp9_mb_init_quantizer() + * function of VP9 code. + */ + int16_t chroma_ac_quant_scale; + /** \brief Specifies per segment Chroma DC quantization scale. + * Corresponding to uv_dequant[qindex][0] in vp9_mb_init_quantizer() + * function of VP9 code. + */ + int16_t chroma_dc_quant_scale; + + /**@}*/ + +} VASegmentParameterVP9; + + + +/** + * \brief VP9 Slice Parameter Buffer Structure + * + * This structure conveys parameters related to segmentation data and should be + * sent once per frame. + * + * When segmentation is disabled, only SegParam[0] has valid values, + * all other entries should be populated with 0. + * Otherwise, all eight entries should be valid. + * + * Slice data buffer of VASliceDataBufferType is used + * to send the bitstream which should include whole or part of partition 0 + * (at least compressed header) to the end of frame. + * + */ +typedef struct _VASliceParameterBufferVP9 +{ + /**@{*/ + /** + * \brief per segment information + */ + VASegmentParameterVP9 seg_param[8]; + + /**@}*/ + +} VASliceParameterBufferVP9; + + +/**@}*/ + +#ifdef __cplusplus +} +#endif + +#endif /* VA_DEC_VP9_H */ |