va.h

Go to the documentation of this file.

/*
 * Copyright (c) 2007-2009 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.
 */
/*
 * Video Acceleration (VA) API Specification
 *
 * Rev. 0.30
 * <jonathan.bian@intel.com>
 *
 * Revision History:
 * rev 0.10 (12/10/2006 Jonathan Bian) - Initial draft
 * rev 0.11 (12/15/2006 Jonathan Bian) - Fixed some errors
 * rev 0.12 (02/05/2007 Jonathan Bian) - Added VC-1 data structures for slice level decode
 * rev 0.13 (02/28/2007 Jonathan Bian) - Added GetDisplay()
 * rev 0.14 (04/13/2007 Jonathan Bian) - Fixed MPEG-2 PictureParameter structure, cleaned up a few funcs.
 * rev 0.15 (04/20/2007 Jonathan Bian) - Overhauled buffer management
 * rev 0.16 (05/02/2007 Jonathan Bian) - Added error codes and fixed some issues with configuration
 * rev 0.17 (05/07/2007 Jonathan Bian) - Added H.264/AVC data structures for slice level decode.
 * rev 0.18 (05/14/2007 Jonathan Bian) - Added data structures for MPEG-4 slice level decode 
 *                                       and MPEG-2 motion compensation.
 * rev 0.19 (08/06/2007 Jonathan Bian) - Removed extra type for bitplane data.
 * rev 0.20 (08/08/2007 Jonathan Bian) - Added missing fields to VC-1 PictureParameter structure.
 * rev 0.21 (08/20/2007 Jonathan Bian) - Added image and subpicture support.
 * rev 0.22 (08/27/2007 Jonathan Bian) - Added support for chroma-keying and global alpha.
 * rev 0.23 (09/11/2007 Jonathan Bian) - Fixed some issues with images and subpictures.
 * rev 0.24 (09/18/2007 Jonathan Bian) - Added display attributes.
 * rev 0.25 (10/18/2007 Jonathan Bian) - Changed to use IDs only for some types.
 * rev 0.26 (11/07/2007 Waldo Bastian) - Change vaCreateBuffer semantics
 * rev 0.27 (11/19/2007 Matt Sottek)   - Added DeriveImage
 * rev 0.28 (12/06/2007 Jonathan Bian) - Added new versions of PutImage and AssociateSubpicture 
 *                                       to enable scaling
 * rev 0.29 (02/07/2008 Jonathan Bian) - VC1 parameter fixes,
 *                                       added VA_STATUS_ERROR_RESOLUTION_NOT_SUPPORTED
 * rev 0.30 (03/01/2009 Jonathan Bian) - Added encoding support for H.264 BP and MPEG-4 SP and fixes
 *                                       for ISO C conformance.
 * rev 0.31 (09/02/2009 Gwenole Beauchesne) - VC-1/H264 fields change for VDPAU and XvBA backend
 *                                       Application needs to relink with the new library.
 *
 * rev 0.31.1 (03/29/2009)              - Data structure for JPEG encode
 * rev 0.31.2 (01/13/2011 Anthony Pabon)- Added a flag to indicate Subpicture coordinates are screen
 *                                        screen relative rather than source video relative.
 * rev 0.32.0 (01/13/2011 Xiang Haihao) - Add profile into VAPictureParameterBufferVC1
 *                                        update VAAPI to 0.32.0
 *
 * Acknowledgements:
 *  Some concepts borrowed from XvMC and XvImage.
 *  Waldo Bastian (Intel), Matt Sottek (Intel),  Austin Yuan (Intel), and Gwenole Beauchesne (SDS)
 *  contributed to various aspects of the API.
 */

#ifndef _VA_H_
#define _VA_H_

#include <stddef.h>
#include <stdint.h>
#include <va/va_version.h>

#ifdef __cplusplus
extern "C" {
#endif

typedef void* VADisplay;        /* window system dependent */

typedef int VAStatus;   
#define VA_STATUS_SUCCESS                       0x00000000
#define VA_STATUS_ERROR_OPERATION_FAILED        0x00000001
#define VA_STATUS_ERROR_ALLOCATION_FAILED       0x00000002
#define VA_STATUS_ERROR_INVALID_DISPLAY         0x00000003
#define VA_STATUS_ERROR_INVALID_CONFIG          0x00000004
#define VA_STATUS_ERROR_INVALID_CONTEXT         0x00000005
#define VA_STATUS_ERROR_INVALID_SURFACE         0x00000006
#define VA_STATUS_ERROR_INVALID_BUFFER          0x00000007
#define VA_STATUS_ERROR_INVALID_IMAGE           0x00000008
#define VA_STATUS_ERROR_INVALID_SUBPICTURE      0x00000009
#define VA_STATUS_ERROR_ATTR_NOT_SUPPORTED      0x0000000a
#define VA_STATUS_ERROR_MAX_NUM_EXCEEDED        0x0000000b
#define VA_STATUS_ERROR_UNSUPPORTED_PROFILE     0x0000000c
#define VA_STATUS_ERROR_UNSUPPORTED_ENTRYPOINT  0x0000000d
#define VA_STATUS_ERROR_UNSUPPORTED_RT_FORMAT   0x0000000e
#define VA_STATUS_ERROR_UNSUPPORTED_BUFFERTYPE  0x0000000f
#define VA_STATUS_ERROR_SURFACE_BUSY            0x00000010
#define VA_STATUS_ERROR_FLAG_NOT_SUPPORTED      0x00000011
#define VA_STATUS_ERROR_INVALID_PARAMETER       0x00000012
#define VA_STATUS_ERROR_RESOLUTION_NOT_SUPPORTED 0x00000013
#define VA_STATUS_ERROR_UNIMPLEMENTED           0x00000014
#define VA_STATUS_ERROR_SURFACE_IN_DISPLAYING   0x00000015
#define VA_STATUS_ERROR_INVALID_IMAGE_FORMAT    0x00000016
#define VA_STATUS_ERROR_DECODING_ERROR          0x00000017
#define VA_STATUS_ERROR_ENCODING_ERROR          0x00000018

#define VA_STATUS_ERROR_INVALID_VALUE           0x00000019

#define VA_STATUS_ERROR_UNSUPPORTED_FILTER      0x00000020

#define VA_STATUS_ERROR_INVALID_FILTER_CHAIN    0x00000021

#define VA_STATUS_ERROR_HW_BUSY                 0x00000022

#define VA_STATUS_ERROR_UNSUPPORTED_MEMORY_TYPE 0x00000024
#define VA_STATUS_ERROR_UNKNOWN                 0xFFFFFFFF

#define VA_FRAME_PICTURE        0x00000000 
#define VA_TOP_FIELD            0x00000001
#define VA_BOTTOM_FIELD         0x00000002

#define VA_ENABLE_BLEND         0x00000004 /* video area blend with the constant color */ 
    
#define VA_CLEAR_DRAWABLE       0x00000008

#define VA_SRC_BT601            0x00000010
#define VA_SRC_BT709            0x00000020
#define VA_SRC_SMPTE_240        0x00000040

#define VA_FILTER_SCALING_DEFAULT       0x00000000
#define VA_FILTER_SCALING_FAST          0x00000100
#define VA_FILTER_SCALING_HQ            0x00000200
#define VA_FILTER_SCALING_NL_ANAMORPHIC 0x00000300
#define VA_FILTER_SCALING_MASK          0x00000f00

const char *vaErrorStr(VAStatus error_status);

typedef void* VANativeDisplay;  /* window system dependent */

int vaDisplayIsValid(VADisplay dpy);
    
VAStatus vaInitialize (
    VADisplay dpy,
    int *major_version,  /* out */
    int *minor_version   /* out */
);

VAStatus vaTerminate (
    VADisplay dpy
);

const char *vaQueryVendorString (
    VADisplay dpy
);

typedef int (*VAPrivFunc)();

VAPrivFunc vaGetLibFunc (
    VADisplay dpy,
    const char *func
);

typedef enum
{
    VAProfileNone                       = -1,
    VAProfileMPEG2Simple                = 0,
    VAProfileMPEG2Main                  = 1,
    VAProfileMPEG4Simple                = 2,
    VAProfileMPEG4AdvancedSimple        = 3,
    VAProfileMPEG4Main                  = 4,
    VAProfileH264Baseline               = 5,
    VAProfileH264Main                   = 6,
    VAProfileH264High                   = 7,
    VAProfileVC1Simple                  = 8,
    VAProfileVC1Main                    = 9,
    VAProfileVC1Advanced                = 10,
    VAProfileH263Baseline               = 11,
    VAProfileJPEGBaseline               = 12,
    VAProfileH264ConstrainedBaseline    = 13,
    VAProfileVP8Version0_3              = 14,
    VAProfileH264MultiviewHigh          = 15,
    VAProfileH264StereoHigh             = 16,
    VAProfileHEVCMain                   = 17,
    VAProfileHEVCMain10                 = 18
} VAProfile;

typedef enum
{
    VAEntrypointVLD             = 1,
    VAEntrypointIZZ             = 2,
    VAEntrypointIDCT            = 3,
    VAEntrypointMoComp          = 4,
    VAEntrypointDeblocking      = 5,
    VAEntrypointEncSlice        = 6,    /* slice level encode */
    VAEntrypointEncPicture      = 7,    /* pictuer encode, JPEG, etc */
    VAEntrypointVideoProc       = 10,   
} VAEntrypoint;

typedef enum
{
    VAConfigAttribRTFormat              = 0,
    VAConfigAttribSpatialResidual       = 1,
    VAConfigAttribSpatialClipping       = 2,
    VAConfigAttribIntraResidual         = 3,
    VAConfigAttribEncryption            = 4,
    VAConfigAttribRateControl           = 5,

    VAConfigAttribEncPackedHeaders      = 10,
    VAConfigAttribEncInterlaced         = 11,
    VAConfigAttribEncMaxRefFrames       = 13,
    VAConfigAttribEncMaxSlices          = 14,
    VAConfigAttribEncSliceStructure     = 15,
    VAConfigAttribEncMacroblockInfo     = 16,
    VAConfigAttribEncJPEG             = 20,
    VAConfigAttribEncQualityRange     = 21,
    VAConfigAttribTypeMax
} VAConfigAttribType;

typedef struct _VAConfigAttrib {
    VAConfigAttribType type;
    unsigned int value; /* OR'd flags (bits) for this attribute */
} VAConfigAttrib;

#define VA_RT_FORMAT_YUV420     0x00000001      
#define VA_RT_FORMAT_YUV422     0x00000002
#define VA_RT_FORMAT_YUV444     0x00000004
#define VA_RT_FORMAT_YUV411     0x00000008
#define VA_RT_FORMAT_YUV400     0x00000010
#define VA_RT_FORMAT_RGB16      0x00010000
#define VA_RT_FORMAT_RGB32      0x00020000
/* RGBP covers RGBP and BGRP fourcc */ 
#define VA_RT_FORMAT_RGBP       0x00100000
#define VA_RT_FORMAT_PROTECTED  0x80000000

#define VA_RC_NONE                      0x00000001

#define VA_RC_CBR                       0x00000002

#define VA_RC_VBR                       0x00000004

#define VA_RC_VCM                       0x00000008

#define VA_RC_CQP                       0x00000010

#define VA_RC_VBR_CONSTRAINED           0x00000020

#define VA_ENC_PACKED_HEADER_NONE       0x00000000

#define VA_ENC_PACKED_HEADER_SEQUENCE   0x00000001

#define VA_ENC_PACKED_HEADER_PICTURE    0x00000002

#define VA_ENC_PACKED_HEADER_SLICE      0x00000004

#define VA_ENC_PACKED_HEADER_MISC       0x00000008

#define VA_ENC_PACKED_HEADER_RAW_DATA   0x00000010

#define VA_ENC_INTERLACED_NONE          0x00000000

#define VA_ENC_INTERLACED_FRAME         0x00000001

#define VA_ENC_INTERLACED_FIELD         0x00000002

#define VA_ENC_INTERLACED_MBAFF         0x00000004

#define VA_ENC_INTERLACED_PAFF          0x00000008

#define VA_ENC_SLICE_STRUCTURE_ARBITRARY_ROWS           0x00000000

#define VA_ENC_SLICE_STRUCTURE_POWER_OF_TWO_ROWS        0x00000001

#define VA_ENC_SLICE_STRUCTURE_ARBITRARY_MACROBLOCKS    0x00000002

typedef union _VAConfigAttribValEncJPEG {
    struct {
        unsigned int arithmatic_coding_mode : 1;
        unsigned int progressive_dct_mode : 1;
        unsigned int non_interleaved_mode : 1;
        unsigned int differential_mode : 1;
        unsigned int max_num_components : 3;
        unsigned int max_num_scans : 4;
        unsigned int max_num_huffman_tables : 3;
        unsigned int max_num_quantization_tables : 3;
    } bits;
    unsigned int value;
} VAConfigAttribValEncJPEG;

#define VA_ATTRIB_NOT_SUPPORTED 0x80000000

int vaMaxNumProfiles (
    VADisplay dpy
);

int vaMaxNumEntrypoints (
    VADisplay dpy
);

int vaMaxNumConfigAttributes (
    VADisplay dpy
);

VAStatus vaQueryConfigProfiles (
    VADisplay dpy,
    VAProfile *profile_list,    /* out */
    int *num_profiles           /* out */
);

VAStatus vaQueryConfigEntrypoints (
    VADisplay dpy,
    VAProfile profile,
    VAEntrypoint *entrypoint_list,      /* out */
    int *num_entrypoints                /* out */
);

VAStatus vaGetConfigAttributes (
    VADisplay dpy,
    VAProfile profile,
    VAEntrypoint entrypoint,
    VAConfigAttrib *attrib_list, /* in/out */
    int num_attribs
);

typedef unsigned int VAGenericID;

typedef VAGenericID VAConfigID;

VAStatus vaCreateConfig (
    VADisplay dpy,
    VAProfile profile, 
    VAEntrypoint entrypoint, 
    VAConfigAttrib *attrib_list,
    int num_attribs,
    VAConfigID *config_id /* out */
);

VAStatus vaDestroyConfig (
    VADisplay dpy,
    VAConfigID config_id
);

VAStatus vaQueryConfigAttributes (
    VADisplay dpy,
    VAConfigID config_id, 
    VAProfile *profile,         /* out */
    VAEntrypoint *entrypoint,   /* out */
    VAConfigAttrib *attrib_list,/* out */
    int *num_attribs            /* out */
);


typedef VAGenericID VAContextID;

typedef VAGenericID VASurfaceID;

#define VA_INVALID_ID           0xffffffff
#define VA_INVALID_SURFACE      VA_INVALID_ID

typedef enum  {
    VAGenericValueTypeInteger = 1,      
    VAGenericValueTypeFloat,            
    VAGenericValueTypePointer,          
    VAGenericValueTypeFunc              
} VAGenericValueType;

typedef void (*VAGenericFunc)(void);

typedef struct _VAGenericValue {
    VAGenericValueType  type;
    union {
        int             i;
        float           f;
        void           *p;
        VAGenericFunc   fn;
    }                   value;
} VAGenericValue;

#define VA_SURFACE_ATTRIB_NOT_SUPPORTED 0x00000000

#define VA_SURFACE_ATTRIB_GETTABLE      0x00000001

#define VA_SURFACE_ATTRIB_SETTABLE      0x00000002

typedef enum {
    VASurfaceAttribNone = 0,
    VASurfaceAttribPixelFormat,
    VASurfaceAttribMinWidth,
    VASurfaceAttribMaxWidth,
    VASurfaceAttribMinHeight,
    VASurfaceAttribMaxHeight,
    VASurfaceAttribMemoryType,
    VASurfaceAttribExternalBufferDescriptor,
    VASurfaceAttribUsageHint,
    VASurfaceAttribCount
} VASurfaceAttribType;

typedef struct _VASurfaceAttrib {
    VASurfaceAttribType type;
    unsigned int        flags;
    VAGenericValue      value;
} VASurfaceAttrib;

#define VA_SURFACE_ATTRIB_MEM_TYPE_VA                   0x00000001

#define VA_SURFACE_ATTRIB_MEM_TYPE_V4L2                 0x00000002

#define VA_SURFACE_ATTRIB_MEM_TYPE_USER_PTR             0x00000004

typedef struct _VASurfaceAttribExternalBuffers {
    unsigned int pixel_format;
    unsigned int width;
    unsigned int height;
    unsigned int data_size;
    unsigned int num_planes;
    unsigned int pitches[4];
    unsigned int offsets[4];
    unsigned long *buffers;
    unsigned int num_buffers;
    unsigned int flags;
    void *private_data;
} VASurfaceAttribExternalBuffers;

#define VA_SURFACE_EXTBUF_DESC_ENABLE_TILING    0x00000001

#define VA_SURFACE_EXTBUF_DESC_CACHED           0x00000002

#define VA_SURFACE_EXTBUF_DESC_UNCACHED         0x00000004

#define VA_SURFACE_EXTBUF_DESC_WC               0x00000008

#define VA_SURFACE_EXTBUF_DESC_PROTECTED        0x80000000

#define VA_SURFACE_ATTRIB_USAGE_HINT_GENERIC    0x00000000

#define VA_SURFACE_ATTRIB_USAGE_HINT_DECODER    0x00000001

#define VA_SURFACE_ATTRIB_USAGE_HINT_ENCODER    0x00000002

#define VA_SURFACE_ATTRIB_USAGE_HINT_VPP_READ   0x00000004

#define VA_SURFACE_ATTRIB_USAGE_HINT_VPP_WRITE  0x00000008

#define VA_SURFACE_ATTRIB_USAGE_HINT_DISPLAY    0x00000010

VAStatus
vaQuerySurfaceAttributes(
    VADisplay           dpy,
    VAConfigID          config,
    VASurfaceAttrib    *attrib_list,
    unsigned int       *num_attribs
);

VAStatus
vaCreateSurfaces(
    VADisplay           dpy,
    unsigned int        format,
    unsigned int        width,
    unsigned int        height,
    VASurfaceID        *surfaces,
    unsigned int        num_surfaces,
    VASurfaceAttrib    *attrib_list,
    unsigned int        num_attribs
);
    
VAStatus vaDestroySurfaces (
    VADisplay dpy,
    VASurfaceID *surfaces,
    int num_surfaces
);

#define VA_PROGRESSIVE 0x1

VAStatus vaCreateContext (
    VADisplay dpy,
    VAConfigID config_id,
    int picture_width,
    int picture_height,
    int flag,
    VASurfaceID *render_targets,
    int num_render_targets,
    VAContextID *context                /* out */
);

VAStatus vaDestroyContext (
    VADisplay dpy,
    VAContextID context
);

typedef VAGenericID VABufferID;

typedef enum
{
    VAPictureParameterBufferType        = 0,
    VAIQMatrixBufferType                = 1,
    VABitPlaneBufferType                = 2,
    VASliceGroupMapBufferType           = 3,
    VASliceParameterBufferType          = 4,
    VASliceDataBufferType               = 5,
    VAMacroblockParameterBufferType     = 6,
    VAResidualDataBufferType            = 7,
    VADeblockingParameterBufferType     = 8,
    VAImageBufferType                   = 9,
    VAProtectedSliceDataBufferType      = 10,
    VAQMatrixBufferType                 = 11,
    VAHuffmanTableBufferType            = 12,
    VAProbabilityBufferType             = 13,

/* Following are encode buffer types */
    VAEncCodedBufferType                = 21,
    VAEncSequenceParameterBufferType    = 22,
    VAEncPictureParameterBufferType     = 23,
    VAEncSliceParameterBufferType       = 24,
    VAEncPackedHeaderParameterBufferType = 25,
    VAEncPackedHeaderDataBufferType     = 26,
    VAEncMiscParameterBufferType        = 27,
    VAEncMacroblockParameterBufferType  = 28,
    VAEncMacroblockMapBufferType        = 29,
/* Following are video processing buffer types */
    VAProcPipelineParameterBufferType   = 41,
    VAProcFilterParameterBufferType     = 42,
    VABufferTypeMax
} VABufferType;

typedef enum
{
    VAEncMiscParameterTypeFrameRate     = 0,
    VAEncMiscParameterTypeRateControl   = 1,
    VAEncMiscParameterTypeMaxSliceSize  = 2,
    VAEncMiscParameterTypeAIR           = 3,
    VAEncMiscParameterTypeMaxFrameSize  = 4,
    VAEncMiscParameterTypeHRD           = 5,
    VAEncMiscParameterTypeQualityLevel  = 6,
} VAEncMiscParameterType;

typedef enum {
    VAEncPackedHeaderSequence   = 1,
    VAEncPackedHeaderPicture    = 2,
    VAEncPackedHeaderSlice      = 3,
    VAEncPackedHeaderRawData    = 4,
    VAEncPackedHeaderMiscMask   = 0x80000000,
} VAEncPackedHeaderType;

typedef struct _VAEncPackedHeaderParameterBuffer {
    unsigned int                type;
    unsigned int                bit_length;
    unsigned char               has_emulation_bytes;
} VAEncPackedHeaderParameterBuffer;

typedef struct _VAEncMiscParameterBuffer
{
    VAEncMiscParameterType type;
    unsigned int data[0];
} VAEncMiscParameterBuffer;


typedef struct _VAEncMiscParameterRateControl
{
    /* this is the maximum bit-rate to be constrained by the rate control implementation */
    unsigned int bits_per_second;
    /* this is the bit-rate the rate control is targeting, as a percentage of the maximum
     * bit-rate for example if target_percentage is 95 then the rate control will target
     * a bit-rate that is 95% of the maximum bit-rate
     */
    unsigned int target_percentage;
    /* windows size in milliseconds. For example if this is set to 500,
     * then the rate control will guarantee the target bit-rate over a 500 ms window
     */
    unsigned int window_size;
    /* initial QP at I frames */
    unsigned int initial_qp;
    unsigned int min_qp;
    unsigned int basic_unit_size;
    union
    {
        struct
        {
            unsigned int reset : 1;
            unsigned int disable_frame_skip : 1; /* Disable frame skip in rate control mode */
            unsigned int disable_bit_stuffing : 1; /* Disable bit stuffing in rate control mode */
        } bits;
        unsigned int value;
    } rc_flags;
} VAEncMiscParameterRateControl;

typedef struct _VAEncMiscParameterFrameRate
{
    unsigned int framerate;
} VAEncMiscParameterFrameRate;

typedef struct _VAEncMiscParameterMaxSliceSize
{
    unsigned int max_slice_size;
} VAEncMiscParameterMaxSliceSize;

typedef struct _VAEncMiscParameterAIR
{
    unsigned int air_num_mbs;
    unsigned int air_threshold;
    unsigned int air_auto; /* if set to 1 then hardware auto-tune the AIR threshold */
} VAEncMiscParameterAIR;

typedef struct _VAEncMiscParameterHRD
{
    unsigned int initial_buffer_fullness;       /* in bits */
    unsigned int buffer_size;                   /* in bits */
} VAEncMiscParameterHRD;

typedef struct _VAEncMiscParameterBufferMaxFrameSize {
    VAEncMiscParameterType      type;
    unsigned int                max_frame_size;
} VAEncMiscParameterBufferMaxFrameSize;

typedef struct _VAEncMiscParameterBufferQualityLevel {
    unsigned int                quality_level;
} VAEncMiscParameterBufferQualityLevel;

/* 
 * There will be cases where the bitstream buffer will not have enough room to hold
 * the data for the entire slice, and the following flags will be used in the slice
 * parameter to signal to the server for the possible cases.
 * If a slice parameter buffer and slice data buffer pair is sent to the server with 
 * the slice data partially in the slice data buffer (BEGIN and MIDDLE cases below), 
 * then a slice parameter and data buffer needs to be sent again to complete this slice. 
 */
#define VA_SLICE_DATA_FLAG_ALL          0x00    /* whole slice is in the buffer */
#define VA_SLICE_DATA_FLAG_BEGIN        0x01    /* The beginning of the slice is in the buffer but the end if not */
#define VA_SLICE_DATA_FLAG_MIDDLE       0x02    /* Neither beginning nor end of the slice is in the buffer */
#define VA_SLICE_DATA_FLAG_END          0x04    /* end of the slice is in the buffer */

/* Codec-independent Slice Parameter Buffer base */
typedef struct _VASliceParameterBufferBase
{
    unsigned int slice_data_size;       /* number of bytes in the slice data buffer for this slice */
    unsigned int slice_data_offset;     /* the offset to the first byte of slice data */
    unsigned int slice_data_flag;       /* see VA_SLICE_DATA_FLAG_XXX definitions */
} VASliceParameterBufferBase;

#include <va/va_dec_jpeg.h>

/****************************
 * MPEG-2 data structures
 ****************************/
 
/* MPEG-2 Picture Parameter Buffer */
/* 
 * For each frame or field, and before any slice data, a single
 * picture parameter buffer must be send.
 */
typedef struct _VAPictureParameterBufferMPEG2
{
    unsigned short horizontal_size;
    unsigned short vertical_size;
    VASurfaceID forward_reference_picture;
    VASurfaceID backward_reference_picture;
    /* meanings of the following fields are the same as in the standard */
    int picture_coding_type;
    int f_code; /* pack all four fcode into this */
    union {
        struct {
            unsigned int intra_dc_precision             : 2; 
            unsigned int picture_structure              : 2; 
            unsigned int top_field_first                : 1; 
            unsigned int frame_pred_frame_dct           : 1; 
            unsigned int concealment_motion_vectors     : 1;
            unsigned int q_scale_type                   : 1;
            unsigned int intra_vlc_format               : 1;
            unsigned int alternate_scan                 : 1;
            unsigned int repeat_first_field             : 1;
            unsigned int progressive_frame              : 1;
            unsigned int is_first_field                 : 1; /* indicate whether the current field
                                                              * is the first field for field picture
                                                              */
        } bits;
        unsigned int value;
    } picture_coding_extension;
} VAPictureParameterBufferMPEG2;

typedef struct _VAIQMatrixBufferMPEG2
{
    int load_intra_quantiser_matrix;
    int load_non_intra_quantiser_matrix;
    int load_chroma_intra_quantiser_matrix;
    int load_chroma_non_intra_quantiser_matrix;
    unsigned char intra_quantiser_matrix[64];
    unsigned char non_intra_quantiser_matrix[64];
    unsigned char chroma_intra_quantiser_matrix[64];
    unsigned char chroma_non_intra_quantiser_matrix[64];
} VAIQMatrixBufferMPEG2;

typedef struct _VASliceParameterBufferMPEG2
{
    unsigned int slice_data_size;/* number of bytes in the slice data buffer for this slice */
    unsigned int slice_data_offset;/* the offset to the first byte of slice data */
    unsigned int slice_data_flag; /* see VA_SLICE_DATA_FLAG_XXX defintions */
    unsigned int macroblock_offset;/* the offset to the first bit of MB from the first byte of slice data */
    unsigned int slice_horizontal_position;
    unsigned int slice_vertical_position;
    int quantiser_scale_code;
    int intra_slice_flag;
} VASliceParameterBufferMPEG2;

typedef struct _VAMacroblockParameterBufferMPEG2
{
    unsigned short macroblock_address;
    /* 
     * macroblock_address (in raster scan order)
     * top-left: 0
     * bottom-right: picture-height-in-mb*picture-width-in-mb - 1
     */
    unsigned char macroblock_type;  /* see definition below */
    union {
        struct {
            unsigned int frame_motion_type              : 2; 
            unsigned int field_motion_type              : 2; 
            unsigned int dct_type                       : 1; 
        } bits;
        unsigned int value;
    } macroblock_modes;
    unsigned char motion_vertical_field_select; 
    /* 
     * motion_vertical_field_select:
     * see section 6.3.17.2 in the spec
     * only the lower 4 bits are used
     * bit 0: first vector forward
     * bit 1: first vector backward
     * bit 2: second vector forward
     * bit 3: second vector backward
     */
    short PMV[2][2][2]; /* see Table 7-7 in the spec */
    unsigned short coded_block_pattern;
    /* 
     * The bitplanes for coded_block_pattern are described 
     * in Figure 6.10-12 in the spec
     */
     
    /* Number of skipped macroblocks after this macroblock */
    unsigned short num_skipped_macroblocks;
} VAMacroblockParameterBufferMPEG2;

/* 
 * OR'd flags for macroblock_type (section 6.3.17.1 in the spec)
 */
#define VA_MB_TYPE_MOTION_FORWARD       0x02
#define VA_MB_TYPE_MOTION_BACKWARD      0x04
#define VA_MB_TYPE_MOTION_PATTERN       0x08
#define VA_MB_TYPE_MOTION_INTRA         0x10

/****************************
 * MPEG-4 Part 2 data structures
 ****************************/
 
/* MPEG-4 Picture Parameter Buffer */
/* 
 * For each frame or field, and before any slice data, a single
 * picture parameter buffer must be send.
 */
typedef struct _VAPictureParameterBufferMPEG4
{
    unsigned short vop_width;
    unsigned short vop_height;
    VASurfaceID forward_reference_picture;
    VASurfaceID backward_reference_picture;
    union {
        struct {
            unsigned int short_video_header             : 1; 
            unsigned int chroma_format                  : 2; 
            unsigned int interlaced                     : 1; 
            unsigned int obmc_disable                   : 1; 
            unsigned int sprite_enable                  : 2; 
            unsigned int sprite_warping_accuracy        : 2; 
            unsigned int quant_type                     : 1; 
            unsigned int quarter_sample                 : 1; 
            unsigned int data_partitioned               : 1; 
            unsigned int reversible_vlc                 : 1; 
            unsigned int resync_marker_disable          : 1; 
        } bits;
        unsigned int value;
    } vol_fields;
    unsigned char no_of_sprite_warping_points;
    short sprite_trajectory_du[3];
    short sprite_trajectory_dv[3];
    unsigned char quant_precision;
    union {
        struct {
            unsigned int vop_coding_type                : 2; 
            unsigned int backward_reference_vop_coding_type     : 2; 
            unsigned int vop_rounding_type              : 1; 
            unsigned int intra_dc_vlc_thr               : 3; 
            unsigned int top_field_first                : 1; 
            unsigned int alternate_vertical_scan_flag   : 1; 
        } bits;
        unsigned int value;
    } vop_fields;
    unsigned char vop_fcode_forward;
    unsigned char vop_fcode_backward;
    unsigned short vop_time_increment_resolution;
    /* short header related */
    unsigned char num_gobs_in_vop;
    unsigned char num_macroblocks_in_gob;
    /* for direct mode prediction */
    short TRB;
    short TRD;
} VAPictureParameterBufferMPEG4;

typedef struct _VAIQMatrixBufferMPEG4
{
    int load_intra_quant_mat;
    int load_non_intra_quant_mat;
    unsigned char intra_quant_mat[64];
    unsigned char non_intra_quant_mat[64];
} VAIQMatrixBufferMPEG4;

typedef struct _VASliceParameterBufferMPEG4
{
    unsigned int slice_data_size;/* number of bytes in the slice data buffer for this slice */
    unsigned int slice_data_offset;/* the offset to the first byte of slice data */
    unsigned int slice_data_flag; /* see VA_SLICE_DATA_FLAG_XXX defintions */
    unsigned int macroblock_offset;/* the offset to the first bit of MB from the first byte of slice data */
    unsigned int macroblock_number;
    int quant_scale;
} VASliceParameterBufferMPEG4;

typedef enum   /* see 7.1.1.32 */
{
    VAMvMode1Mv                        = 0,
    VAMvMode1MvHalfPel                 = 1,
    VAMvMode1MvHalfPelBilinear         = 2,
    VAMvModeMixedMv                    = 3,
    VAMvModeIntensityCompensation      = 4 
} VAMvModeVC1;

/* 
 * For each picture, and before any slice data, a picture parameter
 * buffer must be send. Multiple picture parameter buffers may be
 * sent for a single picture. In that case picture parameters will
 * apply to all slice data that follow it until a new picture
 * parameter buffer is sent.
 *
 * Notes:
 *   pic_quantizer_type should be set to the applicable quantizer
 *   type as defined by QUANTIZER (J.1.19) and either
 *   PQUANTIZER (7.1.1.8) or PQINDEX (7.1.1.6)
 */
typedef struct _VAPictureParameterBufferVC1
{
    VASurfaceID forward_reference_picture;
    VASurfaceID backward_reference_picture;
    /* if out-of-loop post-processing is done on the render
       target, then we need to keep the in-loop decoded 
       picture as a reference picture */
    VASurfaceID inloop_decoded_picture;

    /* sequence layer for AP or meta data for SP and MP */
    union {
        struct {
            unsigned int pulldown       : 1; /* SEQUENCE_LAYER::PULLDOWN */
            unsigned int interlace      : 1; /* SEQUENCE_LAYER::INTERLACE */
            unsigned int tfcntrflag     : 1; /* SEQUENCE_LAYER::TFCNTRFLAG */
            unsigned int finterpflag    : 1; /* SEQUENCE_LAYER::FINTERPFLAG */
            unsigned int psf            : 1; /* SEQUENCE_LAYER::PSF */
            unsigned int multires       : 1; /* METADATA::MULTIRES */
            unsigned int overlap        : 1; /* METADATA::OVERLAP */
            unsigned int syncmarker     : 1; /* METADATA::SYNCMARKER */
            unsigned int rangered       : 1; /* METADATA::RANGERED */
            unsigned int max_b_frames   : 3; /* METADATA::MAXBFRAMES */
            unsigned int profile        : 2; /* SEQUENCE_LAYER::PROFILE or The MSB of METADATA::PROFILE */
        } bits;
        unsigned int value;
    } sequence_fields;

    unsigned short coded_width;         /* ENTRY_POINT_LAYER::CODED_WIDTH */
    unsigned short coded_height;        /* ENTRY_POINT_LAYER::CODED_HEIGHT */
    union {
        struct {
            unsigned int broken_link    : 1; /* ENTRY_POINT_LAYER::BROKEN_LINK */
            unsigned int closed_entry   : 1; /* ENTRY_POINT_LAYER::CLOSED_ENTRY */
            unsigned int panscan_flag   : 1; /* ENTRY_POINT_LAYER::PANSCAN_FLAG */
            unsigned int loopfilter     : 1; /* ENTRY_POINT_LAYER::LOOPFILTER */
        } bits;
        unsigned int value;
    } entrypoint_fields;
    unsigned char conditional_overlap_flag; /* ENTRY_POINT_LAYER::CONDOVER */
    unsigned char fast_uvmc_flag;       /* ENTRY_POINT_LAYER::FASTUVMC */
    union {
        struct {
            unsigned int luma_flag      : 1; /* ENTRY_POINT_LAYER::RANGE_MAPY_FLAG */
            unsigned int luma           : 3; /* ENTRY_POINT_LAYER::RANGE_MAPY */
            unsigned int chroma_flag    : 1; /* ENTRY_POINT_LAYER::RANGE_MAPUV_FLAG */
            unsigned int chroma         : 3; /* ENTRY_POINT_LAYER::RANGE_MAPUV */
        } bits;
        unsigned int value;
    } range_mapping_fields;

    unsigned char b_picture_fraction;   /* PICTURE_LAYER::BFRACTION */
    unsigned char cbp_table;            /* PICTURE_LAYER::CBPTAB/ICBPTAB */
    unsigned char mb_mode_table;        /* PICTURE_LAYER::MBMODETAB */
    unsigned char range_reduction_frame;/* PICTURE_LAYER::RANGEREDFRM */
    unsigned char rounding_control;     /* PICTURE_LAYER::RNDCTRL */
    unsigned char post_processing;      /* PICTURE_LAYER::POSTPROC */
    unsigned char picture_resolution_index;     /* PICTURE_LAYER::RESPIC */
    unsigned char luma_scale;           /* PICTURE_LAYER::LUMSCALE */
    unsigned char luma_shift;           /* PICTURE_LAYER::LUMSHIFT */
    union {
        struct {
            unsigned int picture_type           : 3; /* PICTURE_LAYER::PTYPE */
            unsigned int frame_coding_mode      : 3; /* PICTURE_LAYER::FCM */
            unsigned int top_field_first        : 1; /* PICTURE_LAYER::TFF */
            unsigned int is_first_field         : 1; /* set to 1 if it is the first field */
            unsigned int intensity_compensation : 1; /* PICTURE_LAYER::INTCOMP */
        } bits;
        unsigned int value;
    } picture_fields;
    union {
        struct {
            unsigned int mv_type_mb     : 1;    /* PICTURE::MVTYPEMB */
            unsigned int direct_mb      : 1;    /* PICTURE::DIRECTMB */
            unsigned int skip_mb        : 1;    /* PICTURE::SKIPMB */
            unsigned int field_tx       : 1;    /* PICTURE::FIELDTX */
            unsigned int forward_mb     : 1;    /* PICTURE::FORWARDMB */
            unsigned int ac_pred        : 1;    /* PICTURE::ACPRED */
            unsigned int overflags      : 1;    /* PICTURE::OVERFLAGS */
        } flags;
        unsigned int value;
    } raw_coding;
    union {
        struct {
            unsigned int bp_mv_type_mb   : 1;    /* PICTURE::MVTYPEMB */
            unsigned int bp_direct_mb    : 1;    /* PICTURE::DIRECTMB */
            unsigned int bp_skip_mb      : 1;    /* PICTURE::SKIPMB */  
            unsigned int bp_field_tx     : 1;    /* PICTURE::FIELDTX */ 
            unsigned int bp_forward_mb   : 1;    /* PICTURE::FORWARDMB */
            unsigned int bp_ac_pred      : 1;    /* PICTURE::ACPRED */   
            unsigned int bp_overflags    : 1;    /* PICTURE::OVERFLAGS */
        } flags;
        unsigned int value;
    } bitplane_present; /* signal what bitplane is being passed via the bitplane buffer */
    union {
        struct {
            unsigned int reference_distance_flag : 1;/* PICTURE_LAYER::REFDIST_FLAG */
            unsigned int reference_distance     : 5;/* PICTURE_LAYER::REFDIST */
            unsigned int num_reference_pictures: 1;/* PICTURE_LAYER::NUMREF */
            unsigned int reference_field_pic_indicator  : 1;/* PICTURE_LAYER::REFFIELD */
        } bits;
        unsigned int value;
    } reference_fields;
    union {
        struct {
            unsigned int mv_mode                : 3; /* PICTURE_LAYER::MVMODE */
            unsigned int mv_mode2               : 3; /* PICTURE_LAYER::MVMODE2 */
            unsigned int mv_table               : 3; /* PICTURE_LAYER::MVTAB/IMVTAB */
            unsigned int two_mv_block_pattern_table: 2; /* PICTURE_LAYER::2MVBPTAB */
            unsigned int four_mv_switch         : 1; /* PICTURE_LAYER::4MVSWITCH */
            unsigned int four_mv_block_pattern_table : 2; /* PICTURE_LAYER::4MVBPTAB */
            unsigned int extended_mv_flag       : 1; /* ENTRY_POINT_LAYER::EXTENDED_MV */
            unsigned int extended_mv_range      : 2; /* PICTURE_LAYER::MVRANGE */
            unsigned int extended_dmv_flag      : 1; /* ENTRY_POINT_LAYER::EXTENDED_DMV */
            unsigned int extended_dmv_range     : 2; /* PICTURE_LAYER::DMVRANGE */
        } bits;
        unsigned int value;
    } mv_fields;
    union {
        struct {
            unsigned int dquant : 2;    /* ENTRY_POINT_LAYER::DQUANT */
            unsigned int quantizer     : 2;     /* ENTRY_POINT_LAYER::QUANTIZER */
            unsigned int half_qp        : 1;    /* PICTURE_LAYER::HALFQP */
            unsigned int pic_quantizer_scale : 5;/* PICTURE_LAYER::PQUANT */
            unsigned int pic_quantizer_type : 1;/* PICTURE_LAYER::PQUANTIZER */
            unsigned int dq_frame       : 1;    /* VOPDQUANT::DQUANTFRM */
            unsigned int dq_profile     : 2;    /* VOPDQUANT::DQPROFILE */
            unsigned int dq_sb_edge     : 2;    /* VOPDQUANT::DQSBEDGE */
            unsigned int dq_db_edge     : 2;    /* VOPDQUANT::DQDBEDGE */
            unsigned int dq_binary_level : 1;   /* VOPDQUANT::DQBILEVEL */
            unsigned int alt_pic_quantizer : 5;/* VOPDQUANT::ALTPQUANT */
        } bits;
        unsigned int value;
    } pic_quantizer_fields;
    union {
        struct {
            unsigned int variable_sized_transform_flag  : 1;/* ENTRY_POINT_LAYER::VSTRANSFORM */
            unsigned int mb_level_transform_type_flag   : 1;/* PICTURE_LAYER::TTMBF */
            unsigned int frame_level_transform_type     : 2;/* PICTURE_LAYER::TTFRM */
            unsigned int transform_ac_codingset_idx1    : 2;/* PICTURE_LAYER::TRANSACFRM */
            unsigned int transform_ac_codingset_idx2    : 2;/* PICTURE_LAYER::TRANSACFRM2 */
            unsigned int intra_transform_dc_table       : 1;/* PICTURE_LAYER::TRANSDCTAB */
        } bits;
        unsigned int value;
    } transform_fields;
} VAPictureParameterBufferVC1;

/* VC-1 Slice Parameter Buffer */
typedef struct _VASliceParameterBufferVC1
{
    unsigned int slice_data_size;/* number of bytes in the slice data buffer for this slice */
    unsigned int slice_data_offset;/* the offset to the first byte of slice data */
    unsigned int slice_data_flag; /* see VA_SLICE_DATA_FLAG_XXX defintions */
    unsigned int macroblock_offset;/* the offset to the first bit of MB from the first byte of slice data */
    unsigned int slice_vertical_position;
} VASliceParameterBufferVC1;

/* VC-1 Slice Data Buffer */
/* 
This is simplely a buffer containing raw bit-stream bytes 
*/

/****************************
 * H.264/AVC data structures
 ****************************/

typedef struct _VAPictureH264
{
    VASurfaceID picture_id;
    unsigned int frame_idx;
    unsigned int flags;
    signed int TopFieldOrderCnt;
    signed int BottomFieldOrderCnt;
} VAPictureH264;
/* flags in VAPictureH264 could be OR of the following */
#define VA_PICTURE_H264_INVALID                 0x00000001
#define VA_PICTURE_H264_TOP_FIELD               0x00000002
#define VA_PICTURE_H264_BOTTOM_FIELD            0x00000004
#define VA_PICTURE_H264_SHORT_TERM_REFERENCE    0x00000008
#define VA_PICTURE_H264_LONG_TERM_REFERENCE     0x00000010

/* 
 * For each picture, and before any slice data, a single
 * picture parameter buffer must be send.
 */
typedef struct _VAPictureParameterBufferH264
{
    VAPictureH264 CurrPic;
    VAPictureH264 ReferenceFrames[16];  /* in DPB */
    unsigned short picture_width_in_mbs_minus1;
    unsigned short picture_height_in_mbs_minus1;
    unsigned char bit_depth_luma_minus8;
    unsigned char bit_depth_chroma_minus8;
    unsigned char num_ref_frames;
    union {
        struct {
            unsigned int chroma_format_idc                      : 2; 
            unsigned int residual_colour_transform_flag         : 1; 
            unsigned int gaps_in_frame_num_value_allowed_flag   : 1; 
            unsigned int frame_mbs_only_flag                    : 1; 
            unsigned int mb_adaptive_frame_field_flag           : 1; 
            unsigned int direct_8x8_inference_flag              : 1; 
            unsigned int MinLumaBiPredSize8x8                   : 1; /* see A.3.3.2 */
            unsigned int log2_max_frame_num_minus4              : 4;
            unsigned int pic_order_cnt_type                     : 2;
            unsigned int log2_max_pic_order_cnt_lsb_minus4      : 4;
            unsigned int delta_pic_order_always_zero_flag       : 1;
        } bits;
        unsigned int value;
    } seq_fields;
    unsigned char num_slice_groups_minus1;
    unsigned char slice_group_map_type;
    unsigned short slice_group_change_rate_minus1;
    signed char pic_init_qp_minus26;
    signed char pic_init_qs_minus26;
    signed char chroma_qp_index_offset;
    signed char second_chroma_qp_index_offset;
    union {
        struct {
            unsigned int entropy_coding_mode_flag       : 1;
            unsigned int weighted_pred_flag             : 1;
            unsigned int weighted_bipred_idc            : 2;
            unsigned int transform_8x8_mode_flag        : 1;
            unsigned int field_pic_flag                 : 1;
            unsigned int constrained_intra_pred_flag    : 1;
            unsigned int pic_order_present_flag                 : 1;
            unsigned int deblocking_filter_control_present_flag : 1;
            unsigned int redundant_pic_cnt_present_flag         : 1;
            unsigned int reference_pic_flag                     : 1; /* nal_ref_idc != 0 */
        } bits;
        unsigned int value;
    } pic_fields;
    unsigned short frame_num;
} VAPictureParameterBufferH264;

typedef struct _VAIQMatrixBufferH264
{
    unsigned char ScalingList4x4[6][16];
    unsigned char ScalingList8x8[2][64];
} VAIQMatrixBufferH264;

typedef struct _VASliceParameterBufferH264
{
    unsigned int slice_data_size;/* number of bytes in the slice data buffer for this slice */
    unsigned int slice_data_offset;
    unsigned int slice_data_flag; /* see VA_SLICE_DATA_FLAG_XXX defintions */
    unsigned short slice_data_bit_offset;
    unsigned short first_mb_in_slice;
    unsigned char slice_type;
    unsigned char direct_spatial_mv_pred_flag;
    unsigned char num_ref_idx_l0_active_minus1;
    unsigned char num_ref_idx_l1_active_minus1;
    unsigned char cabac_init_idc;
    char slice_qp_delta;
    unsigned char disable_deblocking_filter_idc;
    char slice_alpha_c0_offset_div2;
    char slice_beta_offset_div2;
    VAPictureH264 RefPicList0[32];      /* See 8.2.4.2 */
    VAPictureH264 RefPicList1[32];      /* See 8.2.4.2 */
    unsigned char luma_log2_weight_denom;
    unsigned char chroma_log2_weight_denom;
    unsigned char luma_weight_l0_flag;
    short luma_weight_l0[32];
    short luma_offset_l0[32];
    unsigned char chroma_weight_l0_flag;
    short chroma_weight_l0[32][2];
    short chroma_offset_l0[32][2];
    unsigned char luma_weight_l1_flag;
    short luma_weight_l1[32];
    short luma_offset_l1[32];
    unsigned char chroma_weight_l1_flag;
    short chroma_weight_l1[32][2];
    short chroma_offset_l1[32][2];
} VASliceParameterBufferH264;

/****************************
 * Common encode data structures 
 ****************************/
typedef enum
{
    VAEncPictureTypeIntra               = 0,
    VAEncPictureTypePredictive          = 1,
    VAEncPictureTypeBidirectional       = 2,
} VAEncPictureType;

/* Encode Slice Parameter Buffer */
typedef struct _VAEncSliceParameterBuffer
{
    unsigned int start_row_number;      /* starting MB row number for this slice */
    unsigned int slice_height;  /* slice height measured in MB */
    union {
        struct {
            unsigned int is_intra       : 1;
            unsigned int disable_deblocking_filter_idc : 2;
            unsigned int uses_long_term_ref             :1;
            unsigned int is_long_term_ref               :1;
        } bits;
        unsigned int value;
    } slice_flags;
} VAEncSliceParameterBuffer;


/****************************
 * H.263 specific encode data structures
 ****************************/

typedef struct _VAEncSequenceParameterBufferH263
{
    unsigned int intra_period;
    unsigned int bits_per_second;
    unsigned int frame_rate;
    unsigned int initial_qp;
    unsigned int min_qp;
} VAEncSequenceParameterBufferH263;

typedef struct _VAEncPictureParameterBufferH263
{
    VASurfaceID reference_picture;
    VASurfaceID reconstructed_picture;
    VABufferID coded_buf;
    unsigned short picture_width;
    unsigned short picture_height;
    VAEncPictureType picture_type;
} VAEncPictureParameterBufferH263;

/****************************
 * MPEG-4 specific encode data structures
 ****************************/

typedef struct _VAEncSequenceParameterBufferMPEG4
{
    unsigned char profile_and_level_indication;
    unsigned int intra_period;
    unsigned int video_object_layer_width;
    unsigned int video_object_layer_height;
    unsigned int vop_time_increment_resolution;
    unsigned int fixed_vop_rate;
    unsigned int fixed_vop_time_increment;
    unsigned int bits_per_second;
    unsigned int frame_rate;
    unsigned int initial_qp;
    unsigned int min_qp;
} VAEncSequenceParameterBufferMPEG4;

typedef struct _VAEncPictureParameterBufferMPEG4
{
    VASurfaceID reference_picture;
    VASurfaceID reconstructed_picture;
    VABufferID coded_buf;
    unsigned short picture_width;
    unsigned short picture_height;
    unsigned int modulo_time_base; /* number of 1s */
    unsigned int vop_time_increment;
    VAEncPictureType picture_type;
} VAEncPictureParameterBufferMPEG4;



VAStatus vaCreateBuffer (
    VADisplay dpy,
    VAContextID context,
    VABufferType type,  /* in */
    unsigned int size,  /* in */
    unsigned int num_elements, /* in */
    void *data,         /* in */
    VABufferID *buf_id  /* out */
);

VAStatus vaBufferSetNumElements (
    VADisplay dpy,
    VABufferID buf_id,  /* in */
    unsigned int num_elements /* in */
);


/* 
 * FICTURE_AVE_QP(bit7-0): The average Qp value used during this frame
 * LARGE_SLICE(bit8):At least one slice in the current frame was large
 *              enough for the encoder to attempt to limit its size.
 * SLICE_OVERFLOW(bit9): At least one slice in the current frame has
 *              exceeded the maximum slice size specified.
 * BITRATE_OVERFLOW(bit10): The peak bitrate was exceeded for this frame.
 * BITRATE_HIGH(bit11): The frame size got within the safety margin of the maximum size (VCM only)
 * AIR_MB_OVER_THRESHOLD: the number of MBs adapted to Intra MB
 */
#define VA_CODED_BUF_STATUS_PICTURE_AVE_QP_MASK         0xff
#define VA_CODED_BUF_STATUS_LARGE_SLICE_MASK            0x100
#define VA_CODED_BUF_STATUS_SLICE_OVERFLOW_MASK         0x200
#define VA_CODED_BUF_STATUS_BITRATE_OVERFLOW            0x400
#define VA_CODED_BUF_STATUS_BITRATE_HIGH                0x800

#define VA_CODED_BUF_STATUS_FRAME_SIZE_OVERFLOW         0x1000
#define VA_CODED_BUF_STATUS_AIR_MB_OVER_THRESHOLD       0xff0000

#define VA_CODED_BUF_STATUS_SINGLE_NALU                 0x10000000      

typedef  struct _VACodedBufferSegment  {
    unsigned int        size;
    unsigned int        bit_offset;
    unsigned int        status;
    unsigned int        reserved;
    void               *buf;
    void               *next;
} VACodedBufferSegment;
     
VAStatus vaMapBuffer (
    VADisplay dpy,
    VABufferID buf_id,  /* in */
    void **pbuf         /* out */
);

VAStatus vaUnmapBuffer (
    VADisplay dpy,
    VABufferID buf_id   /* in */
);

VAStatus vaDestroyBuffer (
    VADisplay dpy,
    VABufferID buffer_id
);

typedef struct {
    uintptr_t           handle;
    uint32_t            type;
    uint32_t            mem_type;
    size_t              mem_size;
} VABufferInfo;

VAStatus
vaAcquireBufferHandle(VADisplay dpy, VABufferID buf_id, VABufferInfo *buf_info);

VAStatus
vaReleaseBufferHandle(VADisplay dpy, VABufferID buf_id);

/*
Render (Decode) Pictures

A picture represents either a frame or a field.

The Begin/Render/End sequence sends the decode buffers to the server
*/

VAStatus vaBeginPicture (
    VADisplay dpy,
    VAContextID context,
    VASurfaceID render_target
);

VAStatus vaRenderPicture (
    VADisplay dpy,
    VAContextID context,
    VABufferID *buffers,
    int num_buffers
);

VAStatus vaEndPicture (
    VADisplay dpy,
    VAContextID context
);

/*

Synchronization 

*/

VAStatus vaSyncSurface (
    VADisplay dpy,
    VASurfaceID render_target
);

typedef enum
{
    VASurfaceRendering  = 1, /* Rendering in progress */ 
    VASurfaceDisplaying = 2, /* Displaying in progress (not safe to render into it) */ 
                             /* this status is useful if surface is used as the source */
                             /* of an overlay */
    VASurfaceReady      = 4, /* not being rendered or displayed */
    VASurfaceSkipped    = 8  /* Indicate a skipped frame during encode */
} VASurfaceStatus;

VAStatus vaQuerySurfaceStatus (
    VADisplay dpy,
    VASurfaceID render_target,
    VASurfaceStatus *status     /* out */
);

typedef enum
{
    VADecodeSliceMissing            = 0,
    VADecodeMBError                 = 1,
} VADecodeErrorType;

typedef struct _VASurfaceDecodeMBErrors
{
    int status; /* 1 if hardware has returned detailed info below, -1 means this record is invalid */
    unsigned int start_mb; /* start mb address with errors */
    unsigned int end_mb;  /* end mb address with errors */
    VADecodeErrorType decode_error_type;
} VASurfaceDecodeMBErrors;

VAStatus vaQuerySurfaceError(
    VADisplay dpy,
    VASurfaceID surface,
    VAStatus error_status,
    void **error_info
);

#define VA_FOURCC(ch0, ch1, ch2, ch3) \
    ((unsigned long)(unsigned char) (ch0) | ((unsigned long)(unsigned char) (ch1) << 8) | \
    ((unsigned long)(unsigned char) (ch2) << 16) | ((unsigned long)(unsigned char) (ch3) << 24 ))

/* 
 * Pre-defined fourcc codes
 */
#define VA_FOURCC_NV12          0x3231564E
#define VA_FOURCC_AI44          0x34344149
#define VA_FOURCC_RGBA          0x41424752
#define VA_FOURCC_RGBX          0x58424752
#define VA_FOURCC_BGRA          0x41524742
#define VA_FOURCC_BGRX          0x58524742
#define VA_FOURCC_ARGB          0x42475241
#define VA_FOURCC_XRGB          0x42475258
#define VA_FOURCC_ABGR          0x52474241
#define VA_FOURCC_XBGR          0x52474258
#define VA_FOURCC_UYVY          0x59565955
#define VA_FOURCC_YUY2          0x32595559
#define VA_FOURCC_AYUV          0x56555941
#define VA_FOURCC_NV11          0x3131564e
#define VA_FOURCC_YV12          0x32315659
#define VA_FOURCC_P208          0x38303250
#define VA_FOURCC_IYUV          0x56555949
#define VA_FOURCC_YV24          0x34325659
#define VA_FOURCC_YV32          0x32335659
#define VA_FOURCC_Y800          0x30303859
#define VA_FOURCC_IMC3          0x33434D49
#define VA_FOURCC_411P          0x50313134
#define VA_FOURCC_422H          0x48323234
#define VA_FOURCC_422V          0x56323234
#define VA_FOURCC_444P          0x50343434
#define VA_FOURCC_RGBP          0x50424752
#define VA_FOURCC_BGRP          0x50524742
#define VA_FOURCC_411R          0x52313134 /* rotated 411P */

/* byte order */
#define VA_LSB_FIRST            1
#define VA_MSB_FIRST            2

typedef struct _VAImageFormat
{
    unsigned int        fourcc;
    unsigned int        byte_order; /* VA_LSB_FIRST, VA_MSB_FIRST */
    unsigned int        bits_per_pixel;
    /* for RGB formats */
    unsigned int        depth; /* significant bits per pixel */
    unsigned int        red_mask;
    unsigned int        green_mask;
    unsigned int        blue_mask;
    unsigned int        alpha_mask;
} VAImageFormat;

typedef VAGenericID VAImageID;

typedef struct _VAImage
{
    VAImageID           image_id; /* uniquely identify this image */
    VAImageFormat       format;
    VABufferID          buf;    /* image data buffer */
    /*
     * Image data will be stored in a buffer of type VAImageBufferType to facilitate
     * data store on the server side for optimal performance. The buffer will be 
     * created by the CreateImage function, and proper storage allocated based on the image
     * size and format. This buffer is managed by the library implementation, and 
     * accessed by the client through the buffer Map/Unmap functions.
     */
    unsigned short      width; 
    unsigned short      height;
    unsigned int        data_size;
    unsigned int        num_planes;     /* can not be greater than 3 */
    /* 
     * An array indicating the scanline pitch in bytes for each plane.
     * Each plane may have a different pitch. Maximum 3 planes for planar formats
     */
    unsigned int        pitches[3];
    /* 
     * An array indicating the byte offset from the beginning of the image data 
     * to the start of each plane.
     */
    unsigned int        offsets[3];

    /* The following fields are only needed for paletted formats */
    int num_palette_entries;   /* set to zero for non-palette images */
    /* 
     * Each component is one byte and entry_bytes indicates the number of components in 
     * each entry (eg. 3 for YUV palette entries). set to zero for non-palette images   
     */
    int entry_bytes; 
    /*
     * An array of ascii characters describing the order of the components within the bytes.
     * Only entry_bytes characters of the string are used.
     */
    char component_order[4];
} VAImage;

int vaMaxNumImageFormats (
    VADisplay dpy
);

VAStatus vaQueryImageFormats (
    VADisplay dpy,
    VAImageFormat *format_list, /* out */
    int *num_formats            /* out */
);

VAStatus vaCreateImage (
    VADisplay dpy,
    VAImageFormat *format,
    int width,
    int height,
    VAImage *image      /* out */
);

VAStatus vaDestroyImage (
    VADisplay dpy,
    VAImageID image
);

VAStatus vaSetImagePalette (
    VADisplay dpy,
    VAImageID image,
    /* 
     * pointer to an array holding the palette data.  The size of the array is 
     * num_palette_entries * entry_bytes in size.  The order of the components 
     * in the palette is described by the component_order in VAImage struct    
     */
    unsigned char *palette 
);

VAStatus vaGetImage (
    VADisplay dpy,
    VASurfaceID surface,
    int x,      /* coordinates of the upper left source pixel */
    int y,
    unsigned int width, /* width and height of the region */
    unsigned int height,
    VAImageID image
);

VAStatus vaPutImage (
    VADisplay dpy,
    VASurfaceID surface,
    VAImageID image,
    int src_x,
    int src_y,
    unsigned int src_width,
    unsigned int src_height,
    int dest_x,
    int dest_y,
    unsigned int dest_width,
    unsigned int dest_height
);

VAStatus vaDeriveImage (
    VADisplay dpy,
    VASurfaceID surface,
    VAImage *image      /* out */
);

typedef VAGenericID VASubpictureID;

int vaMaxNumSubpictureFormats (
    VADisplay dpy
);

#define VA_SUBPICTURE_CHROMA_KEYING                     0x0001
#define VA_SUBPICTURE_GLOBAL_ALPHA                      0x0002
#define VA_SUBPICTURE_DESTINATION_IS_SCREEN_COORD       0x0004

VAStatus vaQuerySubpictureFormats (
    VADisplay dpy,
    VAImageFormat *format_list, /* out */
    unsigned int *flags,        /* out */
    unsigned int *num_formats   /* out */
);

VAStatus vaCreateSubpicture (
    VADisplay dpy,
    VAImageID image,
    VASubpictureID *subpicture  /* out */
);

VAStatus vaDestroySubpicture (
    VADisplay dpy,
    VASubpictureID subpicture
);

VAStatus vaSetSubpictureImage (
    VADisplay dpy,
    VASubpictureID subpicture,
    VAImageID image
);

VAStatus vaSetSubpictureChromakey (
    VADisplay dpy,
    VASubpictureID subpicture,
    unsigned int chromakey_min,
    unsigned int chromakey_max,
    unsigned int chromakey_mask
);

VAStatus vaSetSubpictureGlobalAlpha (
    VADisplay dpy,
    VASubpictureID subpicture,
    float global_alpha 
);

VAStatus vaAssociateSubpicture (
    VADisplay dpy,
    VASubpictureID subpicture,
    VASurfaceID *target_surfaces,
    int num_surfaces,
    short src_x, /* upper left offset in subpicture */
    short src_y,
    unsigned short src_width,
    unsigned short src_height,
    short dest_x, /* upper left offset in surface */
    short dest_y,
    unsigned short dest_width,
    unsigned short dest_height,
    /*
     * whether to enable chroma-keying, global-alpha, or screen relative mode
     * see VA_SUBPICTURE_XXX values
     */
    unsigned int flags
);

VAStatus vaDeassociateSubpicture (
    VADisplay dpy,
    VASubpictureID subpicture,
    VASurfaceID *target_surfaces,
    int num_surfaces
);

typedef struct _VARectangle
{
    short x;
    short y;
    unsigned short width;
    unsigned short height;
} VARectangle;

/* PowerVR IEP Lite attributes */
typedef enum
{
    VADISPLAYATTRIB_BLE_OFF              = 0x00,
    VADISPLAYATTRIB_BLE_LOW,
    VADISPLAYATTRIB_BLE_MEDIUM,
    VADISPLAYATTRIB_BLE_HIGH,
    VADISPLAYATTRIB_BLE_NONE,
} VADisplayAttribBLEMode;

#define VA_ROTATION_NONE        0x00000000
#define VA_ROTATION_90          0x00000001
#define VA_ROTATION_180         0x00000002
#define VA_ROTATION_270         0x00000003

#define VA_OOL_DEBLOCKING_FALSE 0x00000000
#define VA_OOL_DEBLOCKING_TRUE  0x00000001

#define VA_RENDER_MODE_UNDEFINED           0
#define VA_RENDER_MODE_LOCAL_OVERLAY       1
#define VA_RENDER_MODE_LOCAL_GPU           2
#define VA_RENDER_MODE_EXTERNAL_OVERLAY    4
#define VA_RENDER_MODE_EXTERNAL_GPU        8

#define VA_RENDER_DEVICE_UNDEFINED  0
#define VA_RENDER_DEVICE_LOCAL      1
#define VA_RENDER_DEVICE_EXTERNAL   2

typedef enum
{
    VADisplayAttribBrightness           = 0,
    VADisplayAttribContrast             = 1,
    VADisplayAttribHue                  = 2,
    VADisplayAttribSaturation           = 3,
    /* client can specifiy a background color for the target window
     * the new feature of video conference,
     * the uncovered area of the surface is filled by this color
     * also it will blend with the decoded video color
     */
    VADisplayAttribBackgroundColor      = 4,
    /*
     * this is a gettable only attribute. For some implementations that use the
     * hardware overlay, after PutSurface is called, the surface can not be    
     * re-used until after the subsequent PutSurface call. If this is the case 
     * then the value for this attribute will be set to 1 so that the client   
     * will not attempt to re-use the surface right after returning from a call
     * to PutSurface.
     *
     * Don't use it, use flag VASurfaceDisplaying of vaQuerySurfaceStatus since
     * driver may use overlay or GPU alternatively
     */
    VADisplayAttribDirectSurface       = 5,
    VADisplayAttribRotation            = 6,     
    VADisplayAttribOutofLoopDeblock    = 7,

    /* PowerVR IEP Lite specific attributes */
    VADisplayAttribBLEBlackMode        = 8,
    VADisplayAttribBLEWhiteMode        = 9,
    VADisplayAttribBlueStretch         = 10,
    VADisplayAttribSkinColorCorrection = 11,
    /*
     * For type VADisplayAttribCSCMatrix, "value" field is a pointer to the color
     * conversion matrix. Each element in the matrix is float-point
     */
    VADisplayAttribCSCMatrix           = 12,
    /* specify the constant color used to blend with video surface
     * Cd = Cv*Cc*Ac + Cb *(1 - Ac) C means the constant RGB
     *      d: the final color to overwrite into the frame buffer 
     *      v: decoded video after color conversion, 
     *      c: video color specified by VADisplayAttribBlendColor
     *      b: background color of the drawable
     */
    VADisplayAttribBlendColor          = 13,
    /*
     * Indicate driver to skip painting color key or not.
     * only applicable if the render is overlay
     */
    VADisplayAttribOverlayAutoPaintColorKey   = 14,
    /*
     * customized overlay color key, the format is RGB888
     * [23:16] = Red, [15:08] = Green, [07:00] = Blue.
     */
    VADisplayAttribOverlayColorKey      = 15,
    /*
     * The hint for the implementation of vaPutSurface
     * normally, the driver could use an overlay or GPU to render the surface on the screen
     * this flag provides APP the flexibity to switch the render dynamically
     */
    VADisplayAttribRenderMode           = 16,
    /*
     * specify if vaPutSurface needs to render into specified monitors
     * one example is that one external monitor (e.g. HDMI) is enabled, 
     * but the window manager is not aware of it, and there is no associated drawable
     */
    VADisplayAttribRenderDevice        = 17,
    /*
     * specify vaPutSurface render area if there is no drawable on the monitor
     */
    VADisplayAttribRenderRect          = 18,
} VADisplayAttribType;

/* flags for VADisplayAttribute */
#define VA_DISPLAY_ATTRIB_NOT_SUPPORTED 0x0000
#define VA_DISPLAY_ATTRIB_GETTABLE      0x0001
#define VA_DISPLAY_ATTRIB_SETTABLE      0x0002

typedef struct _VADisplayAttribute
{
    VADisplayAttribType type;
    int min_value;
    int max_value;
    int value;  /* used by the set/get attribute functions */
/* flags can be VA_DISPLAY_ATTRIB_GETTABLE or VA_DISPLAY_ATTRIB_SETTABLE or OR'd together */
    unsigned int flags;
} VADisplayAttribute;

int vaMaxNumDisplayAttributes (
    VADisplay dpy
);

VAStatus vaQueryDisplayAttributes (
    VADisplay dpy,
    VADisplayAttribute *attr_list,      /* out */
    int *num_attributes                 /* out */
);

VAStatus vaGetDisplayAttributes (
    VADisplay dpy,
    VADisplayAttribute *attr_list,      /* in/out */
    int num_attributes
);

VAStatus vaSetDisplayAttributes (
    VADisplay dpy,
    VADisplayAttribute *attr_list,
    int num_attributes
);

/****************************
 * HEVC data structures
 ****************************/
typedef struct _VAPictureHEVC
{
    VASurfaceID             picture_id;
    int32_t                 pic_order_cnt;
    /* described below */
    uint32_t                flags;
} VAPictureHEVC;

/* flags in VAPictureHEVC could be OR of the following */
#define VA_PICTURE_HEVC_INVALID                 0x00000001

#define VA_PICTURE_HEVC_FIELD_PIC               0x00000002

#define VA_PICTURE_HEVC_BOTTOM_FIELD            0x00000004

#define VA_PICTURE_HEVC_LONG_TERM_REFERENCE     0x00000008

#define VA_PICTURE_HEVC_RPS_ST_CURR_BEFORE      0x00000010

#define VA_PICTURE_HEVC_RPS_ST_CURR_AFTER       0x00000020

#define VA_PICTURE_HEVC_RPS_LT_CURR             0x00000040

#ifdef __cplusplus
}
#endif

#endif /* _VA_H_ */