OSDN Git Service

Add VP8 decoding API
authorJonathan Bian <jonathan.bian@intel.com>
Thu, 26 Apr 2012 17:21:49 +0000 (10:21 -0700)
committerXiang, Haihao <haihao.xiang@intel.com>
Thu, 13 Feb 2014 07:00:45 +0000 (15:00 +0800)
Added new profile, buffer types and data structures for VP8 decoding

Signed-off-by: Jonathan Bian <jonathan.bian@intel.com>
[Fixed conflicts and remove unused profiles]
Signed-off-by: Xiang, Haihao <haihao.xiang@intel.com>
va/Makefile.am
va/va.h
va/va_dec_vp8.h [new file with mode: 0644]

index e08ccea..20e2f97 100644 (file)
@@ -43,6 +43,7 @@ libva_source_h = \
        va_backend_vpp.h        \
        va_compat.h             \
        va_dec_jpeg.h           \
+       va_dec_vp8.h            \
        va_drmcommon.h          \
        va_enc_h264.h           \
        va_enc_mpeg2.h          \
diff --git a/va/va.h b/va/va.h
index d9e4c7e..8057912 100644 (file)
--- a/va/va.h
+++ b/va/va.h
@@ -286,7 +286,8 @@ typedef enum
     VAProfileVC1Advanced               = 10,
     VAProfileH263Baseline              = 11,
     VAProfileJPEGBaseline               = 12,
-    VAProfileH264ConstrainedBaseline = 13
+    VAProfileH264ConstrainedBaseline    = 13,
+    VAProfileVP8Version0_3              = 14
 } VAProfile;
 
 /* 
@@ -873,6 +874,7 @@ typedef enum
     VAProtectedSliceDataBufferType     = 10,
     VAQMatrixBufferType                 = 11,
     VAHuffmanTableBufferType            = 12,
+    VAProbabilityBufferType             = 13,
 
 /* Following are encode buffer types */
     VAEncCodedBufferType               = 21,
diff --git a/va/va_dec_vp8.h b/va/va_dec_vp8.h
new file mode 100644 (file)
index 0000000..db74f4d
--- /dev/null
@@ -0,0 +1,209 @@
+/*
+ * 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 short range;
+    /* partition 0 "value" */
+    unsigned int value;
+    /* partition 0 number of shifts before an output byte is available */
+    unsigned short 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 */
+            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; 
+           /* see section 11.1 for mb_skip_coeff */
+            unsigned int mb_skip_coeff                 : 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;
+
+    /* Partitions */
+    unsigned char num_of_partitions;
+    unsigned int partition_size[9];
+
+    /*
+     * offset to the first bit of MB from the first byte of slice data buffer
+     */
+    unsigned int macroblock_offset;
+
+} VAPictureParameterBufferVP8;
+
+/**
+ * \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
+     */
+    unsigned short quantization_index[4][6];
+} VAIQMatrixBufferVP8;
+
+/**@}*/
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* VA_DEC_VP8_H */