15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Copyright (c) 2007-2009 Intel Corporation. All Rights Reserved. 35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Permission is hereby granted, free of charge, to any person obtaining a 55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * copy of this software and associated documentation files (the 65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * "Software"), to deal in the Software without restriction, including 75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * without limitation the rights to use, copy, modify, merge, publish, 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * distribute, sub license, and/or sell copies of the Software, and to 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * permit persons to whom the Software is furnished to do so, subject to 105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * the following conditions: 115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The above copyright notice and this permission notice (including the 135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * next paragraph) shall be included in all copies or substantial portions 145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * of the Software. 155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. 195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * IN NO EVENT SHALL INTEL AND/OR ITS SUPPLIERS BE LIABLE FOR 205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, 215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Video Acceleration (VA) API Specification 265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Rev. 0.30 285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * <jonathan.bian@intel.com> 295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Revision History: 315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * rev 0.10 (12/10/2006 Jonathan Bian) - Initial draft 325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * rev 0.11 (12/15/2006 Jonathan Bian) - Fixed some errors 335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * rev 0.12 (02/05/2007 Jonathan Bian) - Added VC-1 data structures for slice level decode 345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * rev 0.13 (02/28/2007 Jonathan Bian) - Added GetDisplay() 355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * rev 0.14 (04/13/2007 Jonathan Bian) - Fixed MPEG-2 PictureParameter structure, cleaned up a few funcs. 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * rev 0.15 (04/20/2007 Jonathan Bian) - Overhauled buffer management 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * rev 0.16 (05/02/2007 Jonathan Bian) - Added error codes and fixed some issues with configuration 385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * rev 0.17 (05/07/2007 Jonathan Bian) - Added H.264/AVC data structures for slice level decode. 395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * rev 0.18 (05/14/2007 Jonathan Bian) - Added data structures for MPEG-4 slice level decode 405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * and MPEG-2 motion compensation. 415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * rev 0.19 (08/06/2007 Jonathan Bian) - Removed extra type for bitplane data. 425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * rev 0.20 (08/08/2007 Jonathan Bian) - Added missing fields to VC-1 PictureParameter structure. 435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * rev 0.21 (08/20/2007 Jonathan Bian) - Added image and subpicture support. 445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * rev 0.22 (08/27/2007 Jonathan Bian) - Added support for chroma-keying and global alpha. 455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * rev 0.23 (09/11/2007 Jonathan Bian) - Fixed some issues with images and subpictures. 465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * rev 0.24 (09/18/2007 Jonathan Bian) - Added display attributes. 475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * rev 0.25 (10/18/2007 Jonathan Bian) - Changed to use IDs only for some types. 485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * rev 0.26 (11/07/2007 Waldo Bastian) - Change vaCreateBuffer semantics 495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * rev 0.27 (11/19/2007 Matt Sottek) - Added DeriveImage 505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * rev 0.28 (12/06/2007 Jonathan Bian) - Added new versions of PutImage and AssociateSubpicture 515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * to enable scaling 525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * rev 0.29 (02/07/2008 Jonathan Bian) - VC1 parameter fixes, 535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * added VA_STATUS_ERROR_RESOLUTION_NOT_SUPPORTED 545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * rev 0.30 (03/01/2009 Jonathan Bian) - Added encoding support for H.264 BP and MPEG-4 SP and fixes 555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * for ISO C conformance. 565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * rev 0.31 (09/02/2009 Gwenole Beauchesne) - VC-1/H264 fields change for VDPAU and XvBA backend 575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Application needs to relink with the new library. 585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * rev 0.31.1 (03/29/2009) - Data structure for JPEG encode 605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * rev 0.31.2 (01/13/2011 Anthony Pabon)- Added a flag to indicate Subpicture coordinates are screen 615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * screen relative rather than source video relative. 625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * rev 0.32.0 (01/13/2011 Xiang Haihao) - Add profile into VAPictureParameterBufferVC1 635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * update VAAPI to 0.32.0 645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Acknowledgements: 665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Some concepts borrowed from XvMC and XvImage. 675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Waldo Bastian (Intel), Matt Sottek (Intel), Austin Yuan (Intel), and Gwenole Beauchesne (SDS) 685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * contributed to various aspects of the API. 695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 71f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** 72f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * \file va.h 73f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * \brief The Core API 74f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 75f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * This file contains the \ref api_core "Core API". 76f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) */ 77f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifndef _VA_H_ 795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define _VA_H_ 805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 81116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch#include <stdint.h> 825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <va/va_version.h> 835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifdef __cplusplus 855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)extern "C" { 865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif 875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 88f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** 89f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * \mainpage Video Acceleration (VA) API 90f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 91f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * \section intro Introduction 92f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 93f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * The main motivation for VA-API (Video Acceleration API) is to 94f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * enable hardware accelerated video decode and encode at various 95f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * entry-points (VLD, IDCT, Motion Compensation etc.) for the 96f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * prevailing coding standards today (MPEG-2, MPEG-4 ASP/H.263, MPEG-4 97f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * AVC/H.264, VC-1/VMW3, and JPEG). 98f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 99f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * VA-API is split into several modules: 100f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * - \ref api_core 101f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * - \ref api_enc_h264 102f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * - \ref api_vpp 103f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) */ 104f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 105f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** 106f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * \defgroup api_core Core API 107f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 108f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * @{ 109f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) */ 110f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 111116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 1125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)Overview 1135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)The VA API is intended to provide an interface between a video decode/encode/display 1155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)application (client) and a hardware accelerator (server), to off-load 1165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)video decode/encode/display operations from the host to the hardware accelerator at various 1175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)entry-points. 1185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)The basic operation steps are: 1205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)- Negotiate a mutually acceptable configuration with the server to lock 1225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) down profile, entrypoints, and other attributes that will not change on 1235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) a frame-by-frame basis. 1245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)- Create a decode context which represents a "virtualized" hardware decode 1255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) device 1265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)- Get and fill decode buffers with picture level, slice level and macroblock 1275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) level data (depending on entrypoints) 1285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)- Pass the decode buffers to the server to decode the current frame 1295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)Initialization & Configuration Management 1315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)- Find out supported profiles 1335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)- Find out entrypoints for a given profile 1345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)- Find out configuration attributes for a given profile/entrypoint pair 1355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)- Create a configuration for use by the decoder 1365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)*/ 1385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef void* VADisplay; /* window system dependent */ 1405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 141116680a4aac90f2aa7413d9095a592090648e557Ben Murdochtypedef int VAStatus; /** Return status type from functions */ 142116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** Values for the return status */ 1435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_SUCCESS 0x00000000 1445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_OPERATION_FAILED 0x00000001 1455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_ALLOCATION_FAILED 0x00000002 1465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_INVALID_DISPLAY 0x00000003 1475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_INVALID_CONFIG 0x00000004 1485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_INVALID_CONTEXT 0x00000005 1495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_INVALID_SURFACE 0x00000006 1505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_INVALID_BUFFER 0x00000007 1515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_INVALID_IMAGE 0x00000008 1525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_INVALID_SUBPICTURE 0x00000009 1535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_ATTR_NOT_SUPPORTED 0x0000000a 1545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_MAX_NUM_EXCEEDED 0x0000000b 1555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_UNSUPPORTED_PROFILE 0x0000000c 1565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_UNSUPPORTED_ENTRYPOINT 0x0000000d 1575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_UNSUPPORTED_RT_FORMAT 0x0000000e 1585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_UNSUPPORTED_BUFFERTYPE 0x0000000f 1595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_SURFACE_BUSY 0x00000010 1605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_FLAG_NOT_SUPPORTED 0x00000011 1615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_INVALID_PARAMETER 0x00000012 1625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_RESOLUTION_NOT_SUPPORTED 0x00000013 1635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_UNIMPLEMENTED 0x00000014 1645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_SURFACE_IN_DISPLAYING 0x00000015 1655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_INVALID_IMAGE_FORMAT 0x00000016 1665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_DECODING_ERROR 0x00000017 1675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_ENCODING_ERROR 0x00000018 168f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** 169f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * \brief An invalid/unsupported value was supplied. 170f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 171f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * This is a catch-all error code for invalid or unsupported values. 172f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * e.g. value exceeding the valid range, invalid type in the context 173f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * of generic attribute values. 174f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) */ 175f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_STATUS_ERROR_INVALID_VALUE 0x00000019 176f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief An unsupported filter was supplied. */ 177f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_STATUS_ERROR_UNSUPPORTED_FILTER 0x00000020 178f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief An invalid filter chain was supplied. */ 179f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_STATUS_ERROR_INVALID_FILTER_CHAIN 0x00000021 180f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Indicate HW busy (e.g. run multiple encoding simultaneously). */ 181f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_STATUS_ERROR_HW_BUSY 0x00000022 1825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_UNKNOWN 0xFFFFFFFF 1835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 184116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** De-interlacing flags for vaPutSurface() */ 1855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FRAME_PICTURE 0x00000000 1865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_TOP_FIELD 0x00000001 1875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_BOTTOM_FIELD 0x00000002 1885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 189116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 1905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Enabled the positioning/cropping/blending feature: 1915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 1, specify the video playback position in the isurface 1925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 2, specify the cropping info for video playback 1935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 3, encoded video will blend with background color 1945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 1955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_ENABLE_BLEND 0x00000004 /* video area blend with the constant color */ 1965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 197116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 1985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Clears the drawable with background color. 1995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * for hardware overlay based implementation this flag 2005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * can be used to turn off the overlay 2015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 2025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_CLEAR_DRAWABLE 0x00000008 2035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 204116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** Color space conversion flags for vaPutSurface() */ 2055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_SRC_BT601 0x00000010 2065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_SRC_BT709 0x00000020 2075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_SRC_SMPTE_240 0x00000040 2085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 209116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** Scaling flags for vaPutSurface() */ 2105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FILTER_SCALING_DEFAULT 0x00000000 2115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FILTER_SCALING_FAST 0x00000100 2125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FILTER_SCALING_HQ 0x00000200 2135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FILTER_SCALING_NL_ANAMORPHIC 0x00000300 2145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FILTER_SCALING_MASK 0x00000f00 2155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 216116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 2175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Returns a short english description of error_status 2185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 2195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const char *vaErrorStr(VAStatus error_status); 2205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 221116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 2225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Initialization: 2235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * A display must be obtained by calling vaGetDisplay() before calling 2245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaInitialize() and other functions. This connects the API to the 2255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * native window system. 2265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * For X Windows, native_dpy would be from XOpenDisplay() 2275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 2285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef void* VANativeDisplay; /* window system dependent */ 2295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)int vaDisplayIsValid(VADisplay dpy); 2315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 232116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 2335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Initialize the library 2345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 2355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaInitialize ( 2365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 2375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int *major_version, /* out */ 2385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int *minor_version /* out */ 2395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 2405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 241116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 2425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * After this call, all library internal resources will be cleaned up 2435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 2445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaTerminate ( 2455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy 2465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 2475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 248116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 2495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaQueryVendorString returns a pointer to a zero-terminated string 2505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * describing some aspects of the VA implemenation on a specific 2515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * hardware accelerator. The format of the returned string is vendor 2525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * specific and at the discretion of the implementer. 2535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * e.g. for the Intel GMA500 implementation, an example would be: 2545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * "Intel GMA500 - 2.0.0.32L.0005" 2555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 2565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const char *vaQueryVendorString ( 2575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy 2585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 2595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef int (*VAPrivFunc)(); 2615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 262116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 2635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Return a function pointer given a function name in the library. 2645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * This allows private interfaces into the library 2655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 2665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAPrivFunc vaGetLibFunc ( 2675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 2685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const char *func 2695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 2705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 271116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** Currently defined profiles */ 2725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef enum 2735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 274f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Profile ID used for video processing. */ 275f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAProfileNone = -1, 2765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfileMPEG2Simple = 0, 2775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfileMPEG2Main = 1, 2785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfileMPEG4Simple = 2, 2795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfileMPEG4AdvancedSimple = 3, 2805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfileMPEG4Main = 4, 2815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfileH264Baseline = 5, 2825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfileH264Main = 6, 2835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfileH264High = 7, 2845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfileVC1Simple = 8, 2855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfileVC1Main = 9, 2865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfileVC1Advanced = 10, 2875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfileH263Baseline = 11, 2885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfileJPEGBaseline = 12, 289116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch VAProfileH264ConstrainedBaseline = 13, 290116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch VAProfileVP8Version0_3 = 14 2915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAProfile; 2925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 293116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 2945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Currently defined entrypoints 2955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 2965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef enum 2975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 2985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEntrypointVLD = 1, 2995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEntrypointIZZ = 2, 3005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEntrypointIDCT = 3, 3015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEntrypointMoComp = 4, 3025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEntrypointDeblocking = 5, 3035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEntrypointEncSlice = 6, /* slice level encode */ 304f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAEntrypointEncPicture = 7, /* pictuer encode, JPEG, etc */ 305f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAEntrypointVideoProc = 10, /**< Video pre/post-processing. */ 3065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEntrypoint; 3075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 308116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** Currently defined configuration attribute types */ 3095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef enum 3105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 3115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAConfigAttribRTFormat = 0, 3125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAConfigAttribSpatialResidual = 1, 3135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAConfigAttribSpatialClipping = 2, 3145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAConfigAttribIntraResidual = 3, 3155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAConfigAttribEncryption = 4, 316f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAConfigAttribRateControl = 5, 317f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 318f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** @name Attributes for encoding */ 319f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /**@{*/ 320f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** 321f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * \brief Packed headers mode. Read/write. 322f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 323f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * This attribute determines what packed headers the driver supports, 324f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * through vaGetConfigAttributes(); and what packed headers the user 325f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * will be providing to the driver, through vaCreateConfig(), if the 326f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * driver supports those. 327f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 328f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * See \c VA_ENC_PACKED_HEADER_xxx for the list of packed headers. 329f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) */ 330f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAConfigAttribEncPackedHeaders = 10, 331f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** 332f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * \brief Interlaced mode. Read/write. 333f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 334f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * This attribute determines what kind of interlaced encoding mode 335f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * the driver supports. 336f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 337f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * See \c VA_ENC_INTERLACED_xxx for the list of interlaced modes. 338f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) */ 339f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAConfigAttribEncInterlaced = 11, 340f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** 341f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * \brief Maximum number of reference frames. Read-only. 342f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 343f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * This attribute determines the maximum number of reference 344f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * frames supported for encoding. 345f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 346f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * Note: for H.264 encoding, the value represents the maximum number 347f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * of reference frames for both the reference picture list 0 (bottom 348f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 16 bits) and the reference picture list 1 (top 16 bits). 349f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) */ 350f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAConfigAttribEncMaxRefFrames = 13, 351f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** 352f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * \brief Maximum number of slices per frame. Read-only. 353f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 354f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * This attribute determines the maximum number of slices the 355f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * driver can support to encode a single frame. 356f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) */ 357f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAConfigAttribEncMaxSlices = 14, 358f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** 359f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * \brief Slice structure. Read-only. 360f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 361f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * This attribute determines slice structures supported by the 362f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * driver for encoding. This attribute is a hint to the user so 363f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * that he can choose a suitable surface size and how to arrange 364f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * the encoding process of multiple slices per frame. 365f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 366f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * More specifically, for H.264 encoding, this attribute 367f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * determines the range of accepted values to 368f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * VAEncSliceParameterBufferH264::macroblock_address and 369f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * VAEncSliceParameterBufferH264::num_macroblocks. 370f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 371f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * See \c VA_ENC_SLICE_STRUCTURE_xxx for the supported slice 372f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * structure types. 373f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) */ 374f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAConfigAttribEncSliceStructure = 15, 375f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** 376f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * \brief Macroblock information. Read-only. 377f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 378f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * This attribute determines whether the driver supports extra 379f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * encoding information per-macroblock. e.g. QP. 380f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 381f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * More specifically, for H.264 encoding, if the driver returns a non-zero 382f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * value for this attribute, this means the application can create 383f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * additional #VAEncMacroblockParameterBufferH264 buffers referenced 384f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * through VAEncSliceParameterBufferH264::macroblock_info. 385f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) */ 386f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAConfigAttribEncMacroblockInfo = 16, 387f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /**@}*/ 388f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAConfigAttribTypeMax 3895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAConfigAttribType; 3905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 391116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 3925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Configuration attributes 3935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * If there is more than one value for an attribute, a default 3945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * value will be assigned to the attribute if the client does not 3955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * specify the attribute when creating a configuration 3965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 3975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAConfigAttrib { 3985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAConfigAttribType type; 3995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; /* OR'd flags (bits) for this attribute */ 4005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAConfigAttrib; 4015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 402116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** attribute value for VAConfigAttribRTFormat */ 4035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RT_FORMAT_YUV420 0x00000001 4045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RT_FORMAT_YUV422 0x00000002 4055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RT_FORMAT_YUV444 0x00000004 406f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_RT_FORMAT_YUV411 0x00000008 407f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_RT_FORMAT_YUV400 0x00000010 408f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_RT_FORMAT_RGB16 0x00010000 409f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_RT_FORMAT_RGB32 0x00020000 410f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/* RGBP covers RGBP and BGRP fourcc */ 411f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_RT_FORMAT_RGBP 0x00100000 4125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RT_FORMAT_PROTECTED 0x80000000 4135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 414f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** @name Attribute values for VAConfigAttribRateControl */ 415f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/**@{*/ 416f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Driver does not support any form of rate control. */ 417f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_RC_NONE 0x00000001 418f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Constant bitrate. */ 419f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_RC_CBR 0x00000002 420f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Variable bitrate. */ 421f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_RC_VBR 0x00000004 422f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Video conference mode. */ 423f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_RC_VCM 0x00000008 424f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Constant QP. */ 425f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_RC_CQP 0x00000010 426f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Variable bitrate with peak rate higher than average bitrate. */ 427f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_RC_VBR_CONSTRAINED 0x00000020 428f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/**@}*/ 429f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 430f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** @name Attribute values for VAConfigAttribEncPackedHeaders */ 431f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/**@{*/ 432f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Driver does not support any packed headers mode. */ 433f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_ENC_PACKED_HEADER_NONE 0x00000000 434f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Driver supports packed sequence headers. e.g. SPS for H.264. */ 435f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_ENC_PACKED_HEADER_SEQUENCE 0x00000001 436f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Driver supports packed picture headers. e.g. PPS for H.264. */ 437f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_ENC_PACKED_HEADER_PICTURE 0x00000002 438f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Driver supports packed slice headers. e.g. \c slice_header() for H.264. */ 439f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_ENC_PACKED_HEADER_SLICE 0x00000004 440f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Driver supports misc packed headers. e.g. SEI for H.264. */ 441f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_ENC_PACKED_HEADER_MISC 0x00000008 442f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Driver supports raw packed header, see VAEncPackedHeaderRawData */ 443116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch#define VA_ENC_PACKED_HEADER_RAW_DATA 0x00000010 444f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/**@}*/ 445f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 446f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** @name Attribute values for VAConfigAttribEncInterlaced */ 447f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/**@{*/ 448f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Driver does not support interlaced coding. */ 449f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_ENC_INTERLACED_NONE 0x00000000 450f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Driver supports interlaced frame coding. */ 451f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_ENC_INTERLACED_FRAME 0x00000001 452f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Driver supports interlaced field coding. */ 453f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_ENC_INTERLACED_FIELD 0x00000002 454f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Driver supports macroblock adaptive frame field coding. */ 455f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_ENC_INTERLACED_MBAFF 0x00000004 456f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Driver supports picture adaptive frame field coding. */ 457f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_ENC_INTERLACED_PAFF 0x00000008 458f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/**@}*/ 459f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 460f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** @name Attribute values for VAConfigAttribEncSliceStructure */ 461f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/**@{*/ 462f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Driver supports an arbitrary number of rows per slice. */ 463f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_ENC_SLICE_STRUCTURE_ARBITRARY_ROWS 0x00000000 464f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Driver supports a power-of-two number of rows per slice. */ 465f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_ENC_SLICE_STRUCTURE_POWER_OF_TWO_ROWS 0x00000001 466f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Driver supports an arbitrary number of rows per slice. */ 467f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_ENC_SLICE_STRUCTURE_ARBITRARY_MACROBLOCKS 0x00000002 468f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/**@}*/ 4695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 470116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 4715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * if an attribute is not applicable for a given 4725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * profile/entrypoint pair, then set the value to the following 4735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 4745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_ATTRIB_NOT_SUPPORTED 0x80000000 4755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 476116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** Get maximum number of profiles supported by the implementation */ 4775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)int vaMaxNumProfiles ( 4785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy 4795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 4805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 481116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** Get maximum number of entrypoints supported by the implementation */ 4825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)int vaMaxNumEntrypoints ( 4835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy 4845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 4855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 486116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** Get maximum number of attributs supported by the implementation */ 4875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)int vaMaxNumConfigAttributes ( 4885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy 4895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 4905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 491116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 4925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Query supported profiles 4935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The caller must provide a "profile_list" array that can hold at 4945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * least vaMaxNumProfile() entries. The actual number of profiles 4955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * returned in "profile_list" is returned in "num_profile". 4965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 4975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaQueryConfigProfiles ( 4985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 4995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfile *profile_list, /* out */ 5005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int *num_profiles /* out */ 5015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 5025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 503116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 5045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Query supported entrypoints for a given profile 5055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The caller must provide an "entrypoint_list" array that can hold at 5065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * least vaMaxNumEntrypoints() entries. The actual number of entrypoints 5075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * returned in "entrypoint_list" is returned in "num_entrypoints". 5085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 5095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaQueryConfigEntrypoints ( 5105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 5115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfile profile, 5125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEntrypoint *entrypoint_list, /* out */ 5135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int *num_entrypoints /* out */ 5145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 5155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 516116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 5175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Get attributes for a given profile/entrypoint pair 5185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The caller must provide an "attrib_list" with all attributes to be 5195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * retrieved. Upon return, the attributes in "attrib_list" have been 5205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * updated with their value. Unknown attributes or attributes that are 5215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * not supported for the given profile/entrypoint pair will have their 5225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * value set to VA_ATTRIB_NOT_SUPPORTED 5235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 5245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaGetConfigAttributes ( 5255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 5265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfile profile, 5275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEntrypoint entrypoint, 5285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAConfigAttrib *attrib_list, /* in/out */ 5295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int num_attribs 5305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 5315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 532116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** Generic ID type, can be re-typed for specific implementation */ 5335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef unsigned int VAGenericID; 5345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef VAGenericID VAConfigID; 5365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 537116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 5385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Create a configuration for the decode pipeline 5395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * it passes in the attribute list that specifies the attributes it cares 5405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * about, with the rest taking default values. 5415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 5425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaCreateConfig ( 5435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 5445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfile profile, 5455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEntrypoint entrypoint, 5465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAConfigAttrib *attrib_list, 5475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int num_attribs, 5485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAConfigID *config_id /* out */ 5495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 5505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 551116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 5525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Free resources associdated with a given config 5535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 5545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaDestroyConfig ( 5555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 5565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAConfigID config_id 5575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 5585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 559116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 5605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Query all attributes for a given configuration 5615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The profile of the configuration is returned in "profile" 5625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The entrypoint of the configuration is returned in "entrypoint" 5635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The caller must provide an "attrib_list" array that can hold at least 5645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaMaxNumConfigAttributes() entries. The actual number of attributes 5655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * returned in "attrib_list" is returned in "num_attribs" 5665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 5675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaQueryConfigAttributes ( 5685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 5695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAConfigID config_id, 5705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfile *profile, /* out */ 5715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEntrypoint *entrypoint, /* out */ 5725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAConfigAttrib *attrib_list,/* out */ 5735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int *num_attribs /* out */ 5745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 5755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 577116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 5785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Contexts and Surfaces 5795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 5805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Context represents a "virtual" video decode pipeline. Surfaces are render 5815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * targets for a given context. The data in the surfaces are not accessible 5825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * to the client and the internal data format of the surface is implementatin 5835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * specific. 5845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 5855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Surfaces will be bound to a context when the context is created. Once 5865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * a surface is bound to a given context, it can not be used to create 5875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * another context. The association is removed when the context is destroyed 5885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 5895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Both contexts and surfaces are identified by unique IDs and its 5905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * implementation specific internals are kept opaque to the clients 5915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 5925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef VAGenericID VAContextID; 5945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef VAGenericID VASurfaceID; 5965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_INVALID_ID 0xffffffff 5985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_INVALID_SURFACE VA_INVALID_ID 5995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 600f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Generic value types. */ 601f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)typedef enum { 602f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAGenericValueTypeInteger = 1, /**< 32-bit signed integer. */ 603f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAGenericValueTypeFloat, /**< 32-bit floating-point value. */ 604f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAGenericValueTypePointer, /**< Generic pointer type */ 605f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAGenericValueTypeFunc /**< Pointer to function */ 606f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)} VAGenericValueType; 607f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 608f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Generic function type. */ 609f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)typedef void (*VAGenericFunc)(void); 610f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 611f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Generic value. */ 612f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)typedef struct _VAGenericValue { 613f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Value type. See #VAGenericValueType. */ 614f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAGenericValueType type; 615f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Value holder. */ 616f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) union { 617f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief 32-bit signed integer. */ 618f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) int i; 619f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief 32-bit float. */ 620f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) float f; 621f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Generic pointer. */ 622f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) void *p; 623f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Pointer to function. */ 624f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAGenericFunc fn; 625f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) } value; 626f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)} VAGenericValue; 627f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 628f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** @name Surface attribute flags */ 629f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/**@{*/ 630f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Surface attribute is not supported. */ 631f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_SURFACE_ATTRIB_NOT_SUPPORTED 0x00000000 632f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Surface attribute can be got through vaQuerySurfaceAttributes(). */ 633f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_SURFACE_ATTRIB_GETTABLE 0x00000001 634f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Surface attribute can be set through vaCreateSurfaces(). */ 635f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_SURFACE_ATTRIB_SETTABLE 0x00000002 636f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/**@}*/ 637f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 638f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Surface attribute types. */ 639f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)typedef enum { 640f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VASurfaceAttribNone = 0, 641f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** 642f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * \brief Pixel format (fourcc). 643f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 644f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * The value is meaningful as input to vaQuerySurfaceAttributes(). 645f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * If zero, the driver returns the optimal pixel format for the 646f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * specified config. Otherwise, if non-zero, the value represents 647f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * a pixel format (FOURCC) that is kept as is on output, if the 648f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * driver supports it. Otherwise, the driver sets the value to 649f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * zero and drops the \c VA_SURFACE_ATTRIB_SETTABLE flag. 650f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) */ 651f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VASurfaceAttribPixelFormat, 652f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Minimal width in pixels (int, read-only). */ 653f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VASurfaceAttribMinWidth, 654f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Maximal width in pixels (int, read-only). */ 655f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VASurfaceAttribMaxWidth, 656f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Minimal height in pixels (int, read-only). */ 657f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VASurfaceAttribMinHeight, 658f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Maximal height in pixels (int, read-only). */ 659f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VASurfaceAttribMaxHeight, 660f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Surface memory type expressed in bit fields (int, read/write). */ 661f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VASurfaceAttribMemoryType, 662f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief External buffer descriptor (pointer, write). */ 663f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VASurfaceAttribExternalBufferDescriptor, 664f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Number of surface attributes. */ 665f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VASurfaceAttribCount 666f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)} VASurfaceAttribType; 667f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 668f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Surface attribute. */ 669f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)typedef struct _VASurfaceAttrib { 670f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Type. */ 671f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VASurfaceAttribType type; 672f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Flags. See "Surface attribute flags". */ 673f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int flags; 674f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Value. See "Surface attribute types" for the expected types. */ 675f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAGenericValue value; 676f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)} VASurfaceAttrib; 677f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 678f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** 679f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * @name VASurfaceAttribMemoryType values in bit fields. 680f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * Bit 0:7 are reserved for generic types, Bit 31:28 are reserved for 681f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * Linux DRM, Bit 23:20 are reserved for Android. DRM and Android specific 682f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * types are defined in DRM and Android header files. 683f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) */ 684f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/**@{*/ 685f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief VA memory type (default) is supported. */ 686f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_SURFACE_ATTRIB_MEM_TYPE_VA 0x00000001 687f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief V4L2 buffer memory type is supported. */ 688f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_SURFACE_ATTRIB_MEM_TYPE_V4L2 0x00000002 689f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief User pointer memory type is supported. */ 690f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_SURFACE_ATTRIB_MEM_TYPE_USER_PTR 0x00000004 691f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/**@}*/ 692f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 693f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** 694f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * \brief VASurfaceAttribExternalBuffers structure for 695f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * the VASurfaceAttribExternalBufferDescriptor attribute. 696f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) */ 697f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)typedef struct _VASurfaceAttribExternalBuffers { 698f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief pixel format in fourcc. */ 699f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int pixel_format; 700f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief width in pixels. */ 701f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int width; 702f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief height in pixels. */ 703f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int height; 704f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief total size of the buffer in bytes. */ 705f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int data_size; 706f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief number of planes for planar layout */ 707f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int num_planes; 708f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief pitch for each plane in bytes */ 709f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int pitches[4]; 710f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief offset for each plane in bytes */ 711f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int offsets[4]; 712f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief buffer handles or user pointers */ 713f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned long *buffers; 714f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief number of elements in the "buffers" array */ 715f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int num_buffers; 716f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief flags. See "Surface external buffer descriptor flags". */ 717f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int flags; 718f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief reserved for passing private data */ 719f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) void *private_data; 720f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)} VASurfaceAttribExternalBuffers; 721f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 722f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** @name VASurfaceAttribExternalBuffers flags */ 723f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/**@{*/ 724f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Enable memory tiling */ 725f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_SURFACE_EXTBUF_DESC_ENABLE_TILING 0x00000001 726f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Memory is cacheable */ 727f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_SURFACE_EXTBUF_DESC_CACHED 0x00000002 728f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Memory is non-cacheable */ 729f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_SURFACE_EXTBUF_DESC_UNCACHED 0x00000004 730f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Memory is write-combined */ 731f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_SURFACE_EXTBUF_DESC_WC 0x00000008 732f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Memory is protected */ 733f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_SURFACE_EXTBUF_DESC_PROTECTED 0x80000000 734f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 735f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/**@}*/ 736f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 737f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** 738f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * \brief Queries surface attributes for the supplied config. 739f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 740f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * Unlike vaGetSurfaceAttributes(), this function queries for all 741f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * supported attributes for the supplied VA @config. In particular, if 742f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * the underlying hardware supports the creation of VA surfaces in 743f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * various formats, then this function will enumerate all pixel 744f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * formats that are supported. 745f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 746f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * The \c attrib_list array is allocated by the user and \c 747f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * num_attribs shall be initialized to the number of allocated 748f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * elements in that array. Upon successful return, the actual number 749f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * of attributes will be overwritten into \c num_attribs. Otherwise, 750f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * \c VA_STATUS_ERROR_MAX_NUM_EXCEEDED is returned and \c num_attribs 751f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * is adjusted to the number of elements that would be returned if 752f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * enough space was available. 753f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 754f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * Note: it is perfectly valid to pass NULL to the \c attrib_list 755f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * argument when vaQuerySurfaceAttributes() is used to determine the 756f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * actual number of elements that need to be allocated. 757f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 758f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * @param[in] dpy the VA display 759f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * @param[in] config the config identifying a codec or a video 760f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * processing pipeline 761f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * @param[out] attrib_list the output array of #VASurfaceAttrib elements 762f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * @param[in,out] num_attribs the number of elements allocated on 763f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * input, the number of elements actually filled in output 764f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) */ 765f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)VAStatus 766f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)vaQuerySurfaceAttributes( 767f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VADisplay dpy, 768f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAConfigID config, 769f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VASurfaceAttrib *attrib_list, 770f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int *num_attribs 7715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 7725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 773f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** 774f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * \brief Creates an array of surfaces 775f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 776f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * Creates an array of surfaces. The optional list of attributes shall 777f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * be constructed and validated through vaGetSurfaceAttributes() or 778f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * constructed based based on what the underlying hardware could 779f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * expose through vaQuerySurfaceAttributes(). 780f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 781f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * @param[in] dpy the VA display 782f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * @param[in] format the desired surface format. See \c VA_RT_FORMAT_* 783f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * @param[in] width the surface width 784f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * @param[in] height the surface height 785f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * @param[out] surfaces the array of newly created surfaces 786f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * @param[in] num_surfaces the number of surfaces to create 787f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * @param[in] attrib_list the list of (optional) attributes, or \c NULL 788f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * @param[in] num_attribs the number of attributes supplied in 789f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * \c attrib_list, or zero 790f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) */ 791f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)VAStatus 792f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)vaCreateSurfaces( 793f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VADisplay dpy, 794f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int format, 795f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int width, 796f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int height, 797f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VASurfaceID *surfaces, 798f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int num_surfaces, 799f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VASurfaceAttrib *attrib_list, 800f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int num_attribs 801f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)); 8025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 803116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 8045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaDestroySurfaces - Destroy resources associated with surfaces. 8055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Surfaces can only be destroyed after the context associated has been 8065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * destroyed. 8075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * dpy: display 8085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * surfaces: array of surfaces to destroy 8095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * num_surfaces: number of surfaces in the array to be destroyed. 8105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 8115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaDestroySurfaces ( 8125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 8135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID *surfaces, 8145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int num_surfaces 8155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 8165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_PROGRESSIVE 0x1 818116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 8195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaCreateContext - Create a context 8205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * dpy: display 8215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * config_id: configuration for the context 8225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * picture_width: coded picture width 8235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * picture_height: coded picture height 8245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * flag: any combination of the following: 8255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * VA_PROGRESSIVE (only progressive frame pictures in the sequence when set) 8265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * render_targets: render targets (surfaces) tied to the context 8275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * num_render_targets: number of render targets in the above array 8285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * context: created context id upon return 8295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 8305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaCreateContext ( 8315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 8325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAConfigID config_id, 8335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int picture_width, 8345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int picture_height, 8355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int flag, 8365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID *render_targets, 8375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int num_render_targets, 8385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAContextID *context /* out */ 8395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 8405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 841116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 8425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaDestroyContext - Destroy a context 8435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * dpy: display 8445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * context: context to be destroyed 8455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 8465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaDestroyContext ( 8475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 8485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAContextID context 8495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 8505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 851116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 8525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Buffers 8535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Buffers are used to pass various types of data from the 8545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * client to the server. The server maintains a data store 8555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * for each buffer created, and the client idenfies a buffer 8565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * through a unique buffer id assigned by the server. 8575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 8585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef VAGenericID VABufferID; 8605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef enum 8625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 8635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAPictureParameterBufferType = 0, 8645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAIQMatrixBufferType = 1, 8655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VABitPlaneBufferType = 2, 8665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASliceGroupMapBufferType = 3, 8675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASliceParameterBufferType = 4, 8685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASliceDataBufferType = 5, 8695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAMacroblockParameterBufferType = 6, 8705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAResidualDataBufferType = 7, 8715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADeblockingParameterBufferType = 8, 8725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImageBufferType = 9, 8735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProtectedSliceDataBufferType = 10, 8745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAQMatrixBufferType = 11, 8755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAHuffmanTableBufferType = 12, 876116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch VAProbabilityBufferType = 13, 8775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* Following are encode buffer types */ 8795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncCodedBufferType = 21, 8805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncSequenceParameterBufferType = 22, 8815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncPictureParameterBufferType = 23, 8825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncSliceParameterBufferType = 24, 883f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAEncPackedHeaderParameterBufferType = 25, 884f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAEncPackedHeaderDataBufferType = 26, 8855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncMiscParameterBufferType = 27, 886f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAEncMacroblockParameterBufferType = 28, 887f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/* Following are video processing buffer types */ 888f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** 889f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * \brief Video processing pipeline parameter buffer. 890f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 891f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * This buffer describes the video processing pipeline. See 892f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * #VAProcPipelineParameterBuffer for details. 893f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) */ 894f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAProcPipelineParameterBufferType = 41, 895f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** 896f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * \brief Video filter parameter buffer. 897f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 898f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * This buffer describes the video filter parameters. All buffers 899f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * inherit from #VAProcFilterParameterBufferBase, thus including 900f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * a unique filter buffer type. 901f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 902f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * The default buffer used by most filters is #VAProcFilterParameterBuffer. 903f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * Filters requiring advanced parameters include, but are not limited to, 904f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * deinterlacing (#VAProcFilterParameterBufferDeinterlacing), 905f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * color balance (#VAProcFilterParameterBufferColorBalance), etc. 906f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) */ 907f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAProcFilterParameterBufferType = 42, 908f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VABufferTypeMax 9095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VABufferType; 9105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 9115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef enum 9125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 9135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncMiscParameterTypeFrameRate = 0, 9145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncMiscParameterTypeRateControl = 1, 9155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncMiscParameterTypeMaxSliceSize = 2, 9165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncMiscParameterTypeAIR = 3, 917f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Buffer type used to express a maximum frame size (in bits). */ 918f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAEncMiscParameterTypeMaxFrameSize = 4, 919f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Buffer type used for HRD parameters. */ 920f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAEncMiscParameterTypeHRD = 5, 9215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncMiscParameterType; 9225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 923f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Packed header type. */ 924f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)typedef enum { 925f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Packed sequence header. */ 926f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAEncPackedHeaderSequence = 1, 927f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Packed picture header. */ 928f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAEncPackedHeaderPicture = 2, 929f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Packed slice header. */ 930f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAEncPackedHeaderSlice = 3, 931f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** 932f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * \brief Packed raw header. 933f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 934f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * Packed raw data header can be used by the client to insert a header 935f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * into the bitstream data buffer at the point it is passed, the driver 936f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * will handle the raw packed header based on "has_emulation_bytes" field 937f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * in the packed header parameter structure. 938f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) */ 939f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAEncPackedHeaderRawData = 4, 940f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Misc packed header. See codec-specific definitions. */ 941f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAEncPackedHeaderMiscMask = 0x80000000, 942f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)} VAEncPackedHeaderType; 943f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 944f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Packed header parameter. */ 945f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)typedef struct _VAEncPackedHeaderParameterBuffer { 946f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** Type of the packed header buffer. See #VAEncPackedHeaderType. */ 947f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int type; 948f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Size of the #VAEncPackedHeaderDataBuffer in bits. */ 949f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int bit_length; 950f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Flag: buffer contains start code emulation prevention bytes? */ 951f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned char has_emulation_bytes; 952f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)} VAEncPackedHeaderParameterBuffer; 953f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 954116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 9555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * For application, e.g. set a new bitrate 9565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * VABufferID buf_id; 9575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * VAEncMiscParameterBuffer *misc_param; 9585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * VAEncMiscParameterRateControl *misc_rate_ctrl; 9595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 9605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaCreateBuffer(dpy, context, VAEncMiscParameterBufferType, 9615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * sizeof(VAEncMiscParameterBuffer) + sizeof(VAEncMiscParameterRateControl), 9625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 1, NULL, &buf_id); 9635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 9645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaMapBuffer(dpy,buf_id,(void **)&misc_param); 9655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * misc_param->type = VAEncMiscParameterTypeRateControl; 9665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * misc_rate_ctrl= (VAEncMiscParameterRateControl *)misc_param->data; 9675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * misc_rate_ctrl->bits_per_second = 6400000; 9685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaUnmapBuffer(dpy, buf_id); 9695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaRenderPicture(dpy, context, &buf_id, 1); 9705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 9715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAEncMiscParameterBuffer 9725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 9735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncMiscParameterType type; 9745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int data[0]; 9755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncMiscParameterBuffer; 9765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 977f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 978f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** \brief Rate control parameters */ 9795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAEncMiscParameterRateControl 9805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 981f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /* this is the maximum bit-rate to be constrained by the rate control implementation */ 982f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int bits_per_second; 983f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /* this is the bit-rate the rate control is targeting, as a percentage of the maximum 984f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * bit-rate for example if target_percentage is 95 then the rate control will target 985f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * a bit-rate that is 95% of the maximum bit-rate 986f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) */ 987f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int target_percentage; 988f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /* windows size in milliseconds. For example if this is set to 500, 989f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * then the rate control will guarantee the target bit-rate over a 500 ms window 990f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) */ 991f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int window_size; 992f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /* initial QP at I frames */ 993f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int initial_qp; 994f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int min_qp; 995f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int basic_unit_size; 996f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) union 997f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) { 998f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) struct 999f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) { 1000f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int reset : 1; 1001f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int disable_frame_skip : 1; /* Disable frame skip in rate control mode */ 1002f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int disable_bit_stuffing : 1; /* Disable bit stuffing in rate control mode */ 1003f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) } bits; 1004f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int value; 1005f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) } rc_flags; 10065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncMiscParameterRateControl; 10075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAEncMiscParameterFrameRate 10095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 10105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int framerate; 10115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncMiscParameterFrameRate; 10125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1013116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 10145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Allow a maximum slice size to be specified (in bits). 10155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The encoder will attempt to make sure that individual slices do not exceed this size 10165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Or to signal applicate if the slice size exceed this size, see "status" of VACodedBufferSegment 10175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 10185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAEncMiscParameterMaxSliceSize 10195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 10205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int max_slice_size; 10215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncMiscParameterMaxSliceSize; 10225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAEncMiscParameterAIR 10245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 10255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int air_num_mbs; 10265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int air_threshold; 10275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int air_auto; /* if set to 1 then hardware auto-tune the AIR threshold */ 10285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncMiscParameterAIR; 10295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1030f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)typedef struct _VAEncMiscParameterHRD 1031f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles){ 1032f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int initial_buffer_fullness; /* in bits */ 1033f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int buffer_size; /* in bits */ 1034f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)} VAEncMiscParameterHRD; 1035f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 1036f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** 1037f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * \brief Defines a maximum frame size (in bits). 1038f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 1039f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * This misc parameter buffer defines the maximum size of a frame (in 1040f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * bits). The encoder will try to make sure that each frame does not 1041f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * exceed this size. Otherwise, if the frame size exceeds this size, 1042f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * the \c status flag of #VACodedBufferSegment will contain 1043f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * #VA_CODED_BUF_STATUS_FRAME_SIZE_OVERFLOW. 1044f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) */ 1045f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)typedef struct _VAEncMiscParameterBufferMaxFrameSize { 1046f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Type. Shall be set to #VAEncMiscParameterTypeMaxFrameSize. */ 1047f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) VAEncMiscParameterType type; 1048f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Maximum size of a frame (in bits). */ 1049f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int max_frame_size; 1050f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)} VAEncMiscParameterBufferMaxFrameSize; 10515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1052116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 10535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * There will be cases where the bitstream buffer will not have enough room to hold 10545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * the data for the entire slice, and the following flags will be used in the slice 10555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * parameter to signal to the server for the possible cases. 10565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * If a slice parameter buffer and slice data buffer pair is sent to the server with 10575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * the slice data partially in the slice data buffer (BEGIN and MIDDLE cases below), 10585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * then a slice parameter and data buffer needs to be sent again to complete this slice. 10595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 10605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_SLICE_DATA_FLAG_ALL 0x00 /* whole slice is in the buffer */ 10615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_SLICE_DATA_FLAG_BEGIN 0x01 /* The beginning of the slice is in the buffer but the end if not */ 10625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_SLICE_DATA_FLAG_MIDDLE 0x02 /* Neither beginning nor end of the slice is in the buffer */ 10635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_SLICE_DATA_FLAG_END 0x04 /* end of the slice is in the buffer */ 10645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* Codec-independent Slice Parameter Buffer base */ 10665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VASliceParameterBufferBase 10675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 10685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_size; /* number of bytes in the slice data buffer for this slice */ 10695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_offset; /* the offset to the first byte of slice data */ 10705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_flag; /* see VA_SLICE_DATA_FLAG_XXX definitions */ 10715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VASliceParameterBufferBase; 10725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/**************************** 10755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * JEPG data structure 10765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ***************************/ 10775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAQMatrixBufferJPEG 10785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 10795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int load_lum_quantiser_matrix; 10805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int load_chroma_quantiser_matrix; 10815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char lum_quantiser_matrix[64]; 10825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char chroma_quantiser_matrix[64]; 10835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAQMatrixBufferJPEG; 10845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAEncPictureParameterBufferJPEG 10865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 10875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID reconstructed_picture; 10885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short picture_width; 10895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short picture_height; 10905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VABufferID coded_buf; 10915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncPictureParameterBufferJPEG; 10925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1093f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#include <va/va_dec_jpeg.h> 10945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/**************************** 10965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * MPEG-2 data structures 10975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ****************************/ 10985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* MPEG-2 Picture Parameter Buffer */ 11005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 11015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * For each frame or field, and before any slice data, a single 11025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * picture parameter buffer must be send. 11035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 11045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAPictureParameterBufferMPEG2 11055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 11065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short horizontal_size; 11075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short vertical_size; 11085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID forward_reference_picture; 11095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID backward_reference_picture; 11105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* meanings of the following fields are the same as in the standard */ 11115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int picture_coding_type; 11125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int f_code; /* pack all four fcode into this */ 11135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 11145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 11155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int intra_dc_precision : 2; 11165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int picture_structure : 2; 11175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int top_field_first : 1; 11185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int frame_pred_frame_dct : 1; 11195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int concealment_motion_vectors : 1; 11205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int q_scale_type : 1; 11215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int intra_vlc_format : 1; 11225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int alternate_scan : 1; 11235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int repeat_first_field : 1; 11245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int progressive_frame : 1; 11255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int is_first_field : 1; /* indicate whether the current field 11265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * is the first field for field picture 11275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 11285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 11295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 11305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } picture_coding_extension; 11315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAPictureParameterBufferMPEG2; 11325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1133116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** MPEG-2 Inverse Quantization Matrix Buffer */ 11345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAIQMatrixBufferMPEG2 11355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 11365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int load_intra_quantiser_matrix; 11375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int load_non_intra_quantiser_matrix; 11385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int load_chroma_intra_quantiser_matrix; 11395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int load_chroma_non_intra_quantiser_matrix; 11405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char intra_quantiser_matrix[64]; 11415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char non_intra_quantiser_matrix[64]; 11425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char chroma_intra_quantiser_matrix[64]; 11435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char chroma_non_intra_quantiser_matrix[64]; 11445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAIQMatrixBufferMPEG2; 11455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1146116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** MPEG-2 Slice Parameter Buffer */ 11475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VASliceParameterBufferMPEG2 11485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 11495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_size;/* number of bytes in the slice data buffer for this slice */ 11505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_offset;/* the offset to the first byte of slice data */ 11515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_flag; /* see VA_SLICE_DATA_FLAG_XXX defintions */ 11525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int macroblock_offset;/* the offset to the first bit of MB from the first byte of slice data */ 11535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_horizontal_position; 11545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_vertical_position; 11555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int quantiser_scale_code; 11565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int intra_slice_flag; 11575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VASliceParameterBufferMPEG2; 11585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1159116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** MPEG-2 Macroblock Parameter Buffer */ 11605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAMacroblockParameterBufferMPEG2 11615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 11625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short macroblock_address; 11635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 11645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * macroblock_address (in raster scan order) 11655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * top-left: 0 11665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * bottom-right: picture-height-in-mb*picture-width-in-mb - 1 11675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 11685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char macroblock_type; /* see definition below */ 11695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 11705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 11715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int frame_motion_type : 2; 11725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int field_motion_type : 2; 11735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int dct_type : 1; 11745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 11755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 11765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } macroblock_modes; 11775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char motion_vertical_field_select; 11785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 11795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * motion_vertical_field_select: 11805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * see section 6.3.17.2 in the spec 11815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * only the lower 4 bits are used 11825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * bit 0: first vector forward 11835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * bit 1: first vector backward 11845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * bit 2: second vector forward 11855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * bit 3: second vector backward 11865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 11875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short PMV[2][2][2]; /* see Table 7-7 in the spec */ 11885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short coded_block_pattern; 11895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 11905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The bitplanes for coded_block_pattern are described 11915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * in Figure 6.10-12 in the spec 11925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 11935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 11945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* Number of skipped macroblocks after this macroblock */ 11955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short num_skipped_macroblocks; 11965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAMacroblockParameterBufferMPEG2; 11975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 11985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 11995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * OR'd flags for macroblock_type (section 6.3.17.1 in the spec) 12005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 12015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_MB_TYPE_MOTION_FORWARD 0x02 12025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_MB_TYPE_MOTION_BACKWARD 0x04 12035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_MB_TYPE_MOTION_PATTERN 0x08 12045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_MB_TYPE_MOTION_INTRA 0x10 12055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1206116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 12075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * MPEG-2 Residual Data Buffer 12085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * For each macroblock, there wil be 64 shorts (16-bit) in the 12095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * residual data buffer 12105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 12115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 12125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/**************************** 12135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * MPEG-4 Part 2 data structures 12145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ****************************/ 12155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 12165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* MPEG-4 Picture Parameter Buffer */ 12175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 12185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * For each frame or field, and before any slice data, a single 12195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * picture parameter buffer must be send. 12205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 12215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAPictureParameterBufferMPEG4 12225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 12235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short vop_width; 12245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short vop_height; 12255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID forward_reference_picture; 12265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID backward_reference_picture; 12275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 12285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 12295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int short_video_header : 1; 12305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int chroma_format : 2; 12315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int interlaced : 1; 12325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int obmc_disable : 1; 12335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int sprite_enable : 2; 12345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int sprite_warping_accuracy : 2; 12355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int quant_type : 1; 12365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int quarter_sample : 1; 12375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int data_partitioned : 1; 12385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int reversible_vlc : 1; 12395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int resync_marker_disable : 1; 12405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 12415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 12425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } vol_fields; 12435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char no_of_sprite_warping_points; 12445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short sprite_trajectory_du[3]; 12455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short sprite_trajectory_dv[3]; 12465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char quant_precision; 12475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 12485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 12495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int vop_coding_type : 2; 12505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int backward_reference_vop_coding_type : 2; 12515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int vop_rounding_type : 1; 12525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int intra_dc_vlc_thr : 3; 12535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int top_field_first : 1; 12545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int alternate_vertical_scan_flag : 1; 12555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 12565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 12575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } vop_fields; 12585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char vop_fcode_forward; 12595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char vop_fcode_backward; 12605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short vop_time_increment_resolution; 12615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* short header related */ 12625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char num_gobs_in_vop; 12635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char num_macroblocks_in_gob; 12645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* for direct mode prediction */ 12655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short TRB; 12665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short TRD; 12675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAPictureParameterBufferMPEG4; 12685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1269116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** MPEG-4 Inverse Quantization Matrix Buffer */ 12705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAIQMatrixBufferMPEG4 12715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 12725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int load_intra_quant_mat; 12735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int load_non_intra_quant_mat; 12745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char intra_quant_mat[64]; 12755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char non_intra_quant_mat[64]; 12765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAIQMatrixBufferMPEG4; 12775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1278116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** MPEG-4 Slice Parameter Buffer */ 12795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VASliceParameterBufferMPEG4 12805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 12815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_size;/* number of bytes in the slice data buffer for this slice */ 12825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_offset;/* the offset to the first byte of slice data */ 12835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_flag; /* see VA_SLICE_DATA_FLAG_XXX defintions */ 12845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int macroblock_offset;/* the offset to the first bit of MB from the first byte of slice data */ 12855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int macroblock_number; 12865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int quant_scale; 12875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VASliceParameterBufferMPEG4; 12885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1289116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 12905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VC-1 data structures 12915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)*/ 12925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 12935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef enum /* see 7.1.1.32 */ 12945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 12955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAMvMode1Mv = 0, 12965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAMvMode1MvHalfPel = 1, 12975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAMvMode1MvHalfPelBilinear = 2, 12985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAMvModeMixedMv = 3, 12995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAMvModeIntensityCompensation = 4 13005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAMvModeVC1; 13015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1302116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** VC-1 Picture Parameter Buffer */ 13035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 13045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * For each picture, and before any slice data, a picture parameter 13055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * buffer must be send. Multiple picture parameter buffers may be 13065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * sent for a single picture. In that case picture parameters will 13075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * apply to all slice data that follow it until a new picture 13085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * parameter buffer is sent. 13095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 13105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Notes: 13115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * pic_quantizer_type should be set to the applicable quantizer 13125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * type as defined by QUANTIZER (J.1.19) and either 13135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * PQUANTIZER (7.1.1.8) or PQINDEX (7.1.1.6) 13145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 13155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAPictureParameterBufferVC1 13165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 13175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID forward_reference_picture; 13185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID backward_reference_picture; 13195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* if out-of-loop post-processing is done on the render 13205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) target, then we need to keep the in-loop decoded 13215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) picture as a reference picture */ 13225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID inloop_decoded_picture; 13235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 13245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* sequence layer for AP or meta data for SP and MP */ 13255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 13265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 13275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int pulldown : 1; /* SEQUENCE_LAYER::PULLDOWN */ 13285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int interlace : 1; /* SEQUENCE_LAYER::INTERLACE */ 13295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int tfcntrflag : 1; /* SEQUENCE_LAYER::TFCNTRFLAG */ 13305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int finterpflag : 1; /* SEQUENCE_LAYER::FINTERPFLAG */ 13315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int psf : 1; /* SEQUENCE_LAYER::PSF */ 13325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int multires : 1; /* METADATA::MULTIRES */ 13335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int overlap : 1; /* METADATA::OVERLAP */ 13345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int syncmarker : 1; /* METADATA::SYNCMARKER */ 13355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int rangered : 1; /* METADATA::RANGERED */ 13365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int max_b_frames : 3; /* METADATA::MAXBFRAMES */ 13375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int profile : 2; /* SEQUENCE_LAYER::PROFILE or The MSB of METADATA::PROFILE */ 13385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 13395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 13405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } sequence_fields; 13415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 13425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short coded_width; /* ENTRY_POINT_LAYER::CODED_WIDTH */ 13435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short coded_height; /* ENTRY_POINT_LAYER::CODED_HEIGHT */ 13445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 13455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 13465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int broken_link : 1; /* ENTRY_POINT_LAYER::BROKEN_LINK */ 13475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int closed_entry : 1; /* ENTRY_POINT_LAYER::CLOSED_ENTRY */ 13485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int panscan_flag : 1; /* ENTRY_POINT_LAYER::PANSCAN_FLAG */ 13495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int loopfilter : 1; /* ENTRY_POINT_LAYER::LOOPFILTER */ 13505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 13515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 13525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } entrypoint_fields; 13535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char conditional_overlap_flag; /* ENTRY_POINT_LAYER::CONDOVER */ 13545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char fast_uvmc_flag; /* ENTRY_POINT_LAYER::FASTUVMC */ 13555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 13565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 13575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int luma_flag : 1; /* ENTRY_POINT_LAYER::RANGE_MAPY_FLAG */ 13585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int luma : 3; /* ENTRY_POINT_LAYER::RANGE_MAPY */ 13595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int chroma_flag : 1; /* ENTRY_POINT_LAYER::RANGE_MAPUV_FLAG */ 13605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int chroma : 3; /* ENTRY_POINT_LAYER::RANGE_MAPUV */ 13615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 13625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 13635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } range_mapping_fields; 13645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 13655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char b_picture_fraction; /* PICTURE_LAYER::BFRACTION */ 13665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char cbp_table; /* PICTURE_LAYER::CBPTAB/ICBPTAB */ 13675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char mb_mode_table; /* PICTURE_LAYER::MBMODETAB */ 13685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char range_reduction_frame;/* PICTURE_LAYER::RANGEREDFRM */ 13695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char rounding_control; /* PICTURE_LAYER::RNDCTRL */ 13705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char post_processing; /* PICTURE_LAYER::POSTPROC */ 13715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char picture_resolution_index; /* PICTURE_LAYER::RESPIC */ 13725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char luma_scale; /* PICTURE_LAYER::LUMSCALE */ 13735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char luma_shift; /* PICTURE_LAYER::LUMSHIFT */ 13745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 13755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 13765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int picture_type : 3; /* PICTURE_LAYER::PTYPE */ 13775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int frame_coding_mode : 3; /* PICTURE_LAYER::FCM */ 13785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int top_field_first : 1; /* PICTURE_LAYER::TFF */ 13795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int is_first_field : 1; /* set to 1 if it is the first field */ 13805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int intensity_compensation : 1; /* PICTURE_LAYER::INTCOMP */ 13815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 13825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 13835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } picture_fields; 13845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 13855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 13865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int mv_type_mb : 1; /* PICTURE::MVTYPEMB */ 13875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int direct_mb : 1; /* PICTURE::DIRECTMB */ 13885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int skip_mb : 1; /* PICTURE::SKIPMB */ 13895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int field_tx : 1; /* PICTURE::FIELDTX */ 13905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int forward_mb : 1; /* PICTURE::FORWARDMB */ 13915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int ac_pred : 1; /* PICTURE::ACPRED */ 13925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int overflags : 1; /* PICTURE::OVERFLAGS */ 13935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } flags; 13945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 13955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } raw_coding; 13965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 13975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 13985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int bp_mv_type_mb : 1; /* PICTURE::MVTYPEMB */ 13995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int bp_direct_mb : 1; /* PICTURE::DIRECTMB */ 14005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int bp_skip_mb : 1; /* PICTURE::SKIPMB */ 14015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int bp_field_tx : 1; /* PICTURE::FIELDTX */ 14025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int bp_forward_mb : 1; /* PICTURE::FORWARDMB */ 14035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int bp_ac_pred : 1; /* PICTURE::ACPRED */ 14045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int bp_overflags : 1; /* PICTURE::OVERFLAGS */ 14055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } flags; 14065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 14075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bitplane_present; /* signal what bitplane is being passed via the bitplane buffer */ 14085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 14095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 14105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int reference_distance_flag : 1;/* PICTURE_LAYER::REFDIST_FLAG */ 14115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int reference_distance : 5;/* PICTURE_LAYER::REFDIST */ 14125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int num_reference_pictures: 1;/* PICTURE_LAYER::NUMREF */ 14135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int reference_field_pic_indicator : 1;/* PICTURE_LAYER::REFFIELD */ 14145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 14155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 14165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } reference_fields; 14175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 14185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 14195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int mv_mode : 3; /* PICTURE_LAYER::MVMODE */ 14205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int mv_mode2 : 3; /* PICTURE_LAYER::MVMODE2 */ 14215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int mv_table : 3; /* PICTURE_LAYER::MVTAB/IMVTAB */ 14225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int two_mv_block_pattern_table: 2; /* PICTURE_LAYER::2MVBPTAB */ 14235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int four_mv_switch : 1; /* PICTURE_LAYER::4MVSWITCH */ 14245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int four_mv_block_pattern_table : 2; /* PICTURE_LAYER::4MVBPTAB */ 14255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int extended_mv_flag : 1; /* ENTRY_POINT_LAYER::EXTENDED_MV */ 14265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int extended_mv_range : 2; /* PICTURE_LAYER::MVRANGE */ 14275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int extended_dmv_flag : 1; /* ENTRY_POINT_LAYER::EXTENDED_DMV */ 14285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int extended_dmv_range : 2; /* PICTURE_LAYER::DMVRANGE */ 14295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 14305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 14315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } mv_fields; 14325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 14335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 14345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int dquant : 2; /* ENTRY_POINT_LAYER::DQUANT */ 14355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int quantizer : 2; /* ENTRY_POINT_LAYER::QUANTIZER */ 14365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int half_qp : 1; /* PICTURE_LAYER::HALFQP */ 14375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int pic_quantizer_scale : 5;/* PICTURE_LAYER::PQUANT */ 14385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int pic_quantizer_type : 1;/* PICTURE_LAYER::PQUANTIZER */ 14395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int dq_frame : 1; /* VOPDQUANT::DQUANTFRM */ 14405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int dq_profile : 2; /* VOPDQUANT::DQPROFILE */ 14415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int dq_sb_edge : 2; /* VOPDQUANT::DQSBEDGE */ 14425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int dq_db_edge : 2; /* VOPDQUANT::DQDBEDGE */ 14435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int dq_binary_level : 1; /* VOPDQUANT::DQBILEVEL */ 14445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int alt_pic_quantizer : 5;/* VOPDQUANT::ALTPQUANT */ 14455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 14465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 14475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } pic_quantizer_fields; 14485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 14495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 14505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int variable_sized_transform_flag : 1;/* ENTRY_POINT_LAYER::VSTRANSFORM */ 14515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int mb_level_transform_type_flag : 1;/* PICTURE_LAYER::TTMBF */ 14525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int frame_level_transform_type : 2;/* PICTURE_LAYER::TTFRM */ 14535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int transform_ac_codingset_idx1 : 2;/* PICTURE_LAYER::TRANSACFRM */ 14545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int transform_ac_codingset_idx2 : 2;/* PICTURE_LAYER::TRANSACFRM2 */ 14555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int intra_transform_dc_table : 1;/* PICTURE_LAYER::TRANSDCTAB */ 14565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 14575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 14585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } transform_fields; 14595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAPictureParameterBufferVC1; 14605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1461116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** VC-1 Bitplane Buffer 14625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)There will be at most three bitplanes coded in any picture header. To send 14635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)the bitplane data more efficiently, each byte is divided in two nibbles, with 14645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)each nibble carrying three bitplanes for one macroblock. The following table 14655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)shows the bitplane data arrangement within each nibble based on the picture 14665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)type. 14675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 14685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)Picture Type Bit3 Bit2 Bit1 Bit0 14695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)I or BI OVERFLAGS ACPRED FIELDTX 14705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)P MYTYPEMB SKIPMB DIRECTMB 14715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)B FORWARDMB SKIPMB DIRECTMB 14725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 14735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)Within each byte, the lower nibble is for the first MB and the upper nibble is 14745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)for the second MB. E.g. the lower nibble of the first byte in the bitplane 14755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)buffer is for Macroblock #1 and the upper nibble of the first byte is for 14765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)Macroblock #2 in the first row. 14775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)*/ 14785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 14795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* VC-1 Slice Parameter Buffer */ 14805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VASliceParameterBufferVC1 14815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 14825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_size;/* number of bytes in the slice data buffer for this slice */ 14835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_offset;/* the offset to the first byte of slice data */ 14845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_flag; /* see VA_SLICE_DATA_FLAG_XXX defintions */ 14855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int macroblock_offset;/* the offset to the first bit of MB from the first byte of slice data */ 14865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_vertical_position; 14875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VASliceParameterBufferVC1; 14885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 14895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* VC-1 Slice Data Buffer */ 14905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 14915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)This is simplely a buffer containing raw bit-stream bytes 14925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)*/ 14935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 14945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/**************************** 14955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * H.264/AVC data structures 14965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ****************************/ 14975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 14985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAPictureH264 14995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 15005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID picture_id; 15015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int frame_idx; 15025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int flags; 15035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) signed int TopFieldOrderCnt; 15045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) signed int BottomFieldOrderCnt; 15055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAPictureH264; 15065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* flags in VAPictureH264 could be OR of the following */ 15075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_PICTURE_H264_INVALID 0x00000001 15085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_PICTURE_H264_TOP_FIELD 0x00000002 15095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_PICTURE_H264_BOTTOM_FIELD 0x00000004 15105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_PICTURE_H264_SHORT_TERM_REFERENCE 0x00000008 15115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_PICTURE_H264_LONG_TERM_REFERENCE 0x00000010 15125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1513116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** H.264 Picture Parameter Buffer */ 15145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 15155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * For each picture, and before any slice data, a single 15165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * picture parameter buffer must be send. 15175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 15185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAPictureParameterBufferH264 15195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 15205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAPictureH264 CurrPic; 15215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAPictureH264 ReferenceFrames[16]; /* in DPB */ 15225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short picture_width_in_mbs_minus1; 15235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short picture_height_in_mbs_minus1; 15245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char bit_depth_luma_minus8; 15255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char bit_depth_chroma_minus8; 15265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char num_ref_frames; 15275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 15285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 15295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int chroma_format_idc : 2; 15305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int residual_colour_transform_flag : 1; 15315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int gaps_in_frame_num_value_allowed_flag : 1; 15325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int frame_mbs_only_flag : 1; 15335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int mb_adaptive_frame_field_flag : 1; 15345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int direct_8x8_inference_flag : 1; 15355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int MinLumaBiPredSize8x8 : 1; /* see A.3.3.2 */ 15365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int log2_max_frame_num_minus4 : 4; 15375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int pic_order_cnt_type : 2; 15385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int log2_max_pic_order_cnt_lsb_minus4 : 4; 15395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int delta_pic_order_always_zero_flag : 1; 15405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 15415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 15425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } seq_fields; 15435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char num_slice_groups_minus1; 15445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char slice_group_map_type; 15455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short slice_group_change_rate_minus1; 15465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) signed char pic_init_qp_minus26; 15475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) signed char pic_init_qs_minus26; 15485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) signed char chroma_qp_index_offset; 15495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) signed char second_chroma_qp_index_offset; 15505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 15515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 15525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int entropy_coding_mode_flag : 1; 15535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int weighted_pred_flag : 1; 15545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int weighted_bipred_idc : 2; 15555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int transform_8x8_mode_flag : 1; 15565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int field_pic_flag : 1; 15575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int constrained_intra_pred_flag : 1; 15585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int pic_order_present_flag : 1; 15595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int deblocking_filter_control_present_flag : 1; 15605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int redundant_pic_cnt_present_flag : 1; 15615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int reference_pic_flag : 1; /* nal_ref_idc != 0 */ 15625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 15635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 15645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } pic_fields; 15655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short frame_num; 15665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAPictureParameterBufferH264; 15675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1568116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** H.264 Inverse Quantization Matrix Buffer */ 15695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAIQMatrixBufferH264 15705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 15715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char ScalingList4x4[6][16]; 15725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char ScalingList8x8[2][64]; 15735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAIQMatrixBufferH264; 15745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1575116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 15765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * H.264 Slice Group Map Buffer 15775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * When VAPictureParameterBufferH264::num_slice_group_minus1 is not equal to 0, 15785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * A slice group map buffer should be sent for each picture if required. The buffer 15795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * is sent only when there is a change in the mapping values. 15805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The slice group map buffer map "map units" to slice groups as specified in 15815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * section 8.2.2 of the H.264 spec. The buffer will contain one byte for each macroblock 15825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * in raster scan order 15835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 15845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1585116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** H.264 Slice Parameter Buffer */ 15865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VASliceParameterBufferH264 15875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 15885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_size;/* number of bytes in the slice data buffer for this slice */ 15895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** \brief Byte offset to the NAL Header Unit for this slice. */ 15905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_offset; 15915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_flag; /* see VA_SLICE_DATA_FLAG_XXX defintions */ 15925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 15935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * \brief Bit offset from NAL Header Unit to the begining of slice_data(). 15945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 15955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * This bit offset is relative to and includes the NAL unit byte 15965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * and represents the number of bits parsed in the slice_header() 15975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * after the removal of any emulation prevention bytes in 15985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * there. However, the slice data buffer passed to the hardware is 15995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * the original bitstream, thus including any emulation prevention 16005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * bytes. 16015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 16025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short slice_data_bit_offset; 16035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short first_mb_in_slice; 16045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char slice_type; 16055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char direct_spatial_mv_pred_flag; 16065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char num_ref_idx_l0_active_minus1; 16075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char num_ref_idx_l1_active_minus1; 16085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char cabac_init_idc; 16095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) char slice_qp_delta; 16105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char disable_deblocking_filter_idc; 16115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) char slice_alpha_c0_offset_div2; 16125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) char slice_beta_offset_div2; 16135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAPictureH264 RefPicList0[32]; /* See 8.2.4.2 */ 16145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAPictureH264 RefPicList1[32]; /* See 8.2.4.2 */ 16155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char luma_log2_weight_denom; 16165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char chroma_log2_weight_denom; 16175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char luma_weight_l0_flag; 16185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short luma_weight_l0[32]; 16195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short luma_offset_l0[32]; 16205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char chroma_weight_l0_flag; 16215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short chroma_weight_l0[32][2]; 16225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short chroma_offset_l0[32][2]; 16235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char luma_weight_l1_flag; 16245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short luma_weight_l1[32]; 16255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short luma_offset_l1[32]; 16265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char chroma_weight_l1_flag; 16275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short chroma_weight_l1[32][2]; 16285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short chroma_offset_l1[32][2]; 16295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VASliceParameterBufferH264; 16305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 16315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/**************************** 16325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Common encode data structures 16335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ****************************/ 16345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef enum 16355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 16365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncPictureTypeIntra = 0, 16375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncPictureTypePredictive = 1, 16385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncPictureTypeBidirectional = 2, 16395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncPictureType; 16405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 16415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* Encode Slice Parameter Buffer */ 16425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAEncSliceParameterBuffer 16435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 16445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int start_row_number; /* starting MB row number for this slice */ 16455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_height; /* slice height measured in MB */ 16465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 16475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 16485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int is_intra : 1; 16495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int disable_deblocking_filter_idc : 2; 16505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int uses_long_term_ref :1; 16515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int is_long_term_ref :1; 16525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 16535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 16545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } slice_flags; 16555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncSliceParameterBuffer; 16565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 16575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 16585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/**************************** 16595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * H.263 specific encode data structures 16605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ****************************/ 16615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 16625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAEncSequenceParameterBufferH263 16635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 16645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int intra_period; 16655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int bits_per_second; 16665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int frame_rate; 16675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int initial_qp; 16685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int min_qp; 16695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncSequenceParameterBufferH263; 16705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 16715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAEncPictureParameterBufferH263 16725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 16735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID reference_picture; 16745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID reconstructed_picture; 16755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VABufferID coded_buf; 16765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short picture_width; 16775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short picture_height; 16785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncPictureType picture_type; 16795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncPictureParameterBufferH263; 16805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 16815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/**************************** 16825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * MPEG-4 specific encode data structures 16835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ****************************/ 16845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 16855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAEncSequenceParameterBufferMPEG4 16865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 16875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char profile_and_level_indication; 16885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int intra_period; 16895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int video_object_layer_width; 16905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int video_object_layer_height; 16915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int vop_time_increment_resolution; 16925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int fixed_vop_rate; 16935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int fixed_vop_time_increment; 16945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int bits_per_second; 16955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int frame_rate; 16965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int initial_qp; 16975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int min_qp; 16985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncSequenceParameterBufferMPEG4; 16995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 17005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAEncPictureParameterBufferMPEG4 17015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 17025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID reference_picture; 17035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID reconstructed_picture; 17045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VABufferID coded_buf; 17055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short picture_width; 17065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short picture_height; 17075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int modulo_time_base; /* number of 1s */ 17085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int vop_time_increment; 17095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncPictureType picture_type; 17105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncPictureParameterBufferMPEG4; 17115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 17125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 17135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1714116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** Buffer functions */ 17155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1716116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 17175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Creates a buffer for "num_elements" elements of "size" bytes and 17185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * initalize with "data". 17195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * if "data" is null, then the contents of the buffer data store 17205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * are undefined. 17215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Basically there are two ways to get buffer data to the server side. One is 17225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * to call vaCreateBuffer() with a non-null "data", which results the data being 17235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * copied to the data store on the server side. A different method that 17245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * eliminates this copy is to pass null as "data" when calling vaCreateBuffer(), 17255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * and then use vaMapBuffer() to map the data store from the server side to the 17265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * client address space for access. 17275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Note: image buffers are created by the library, not the client. Please see 17285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaCreateImage on how image buffers are managed. 17295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 17305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaCreateBuffer ( 17315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 17325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAContextID context, 17335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VABufferType type, /* in */ 17345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int size, /* in */ 17355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int num_elements, /* in */ 17365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void *data, /* in */ 17375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VABufferID *buf_id /* out */ 17385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 17395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1740116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 17415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Convey to the server how many valid elements are in the buffer. 17425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * e.g. if multiple slice parameters are being held in a single buffer, 17435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * this will communicate to the server the number of slice parameters 17445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * that are valid in the buffer. 17455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 17465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaBufferSetNumElements ( 17475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 17485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VABufferID buf_id, /* in */ 17495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int num_elements /* in */ 17505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 17515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 17525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1753116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 17545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * device independent data structure for codedbuffer 17555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 17565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 17575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 17585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * FICTURE_AVE_QP(bit7-0): The average Qp value used during this frame 17595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * LARGE_SLICE(bit8):At least one slice in the current frame was large 17605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * enough for the encoder to attempt to limit its size. 17615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * SLICE_OVERFLOW(bit9): At least one slice in the current frame has 17625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * exceeded the maximum slice size specified. 17635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * BITRATE_OVERFLOW(bit10): The peak bitrate was exceeded for this frame. 17645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * BITRATE_HIGH(bit11): The frame size got within the safety margin of the maximum size (VCM only) 17655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * AIR_MB_OVER_THRESHOLD: the number of MBs adapted to Intra MB 17665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 17675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_CODED_BUF_STATUS_PICTURE_AVE_QP_MASK 0xff 17685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_CODED_BUF_STATUS_LARGE_SLICE_MASK 0x100 17695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_CODED_BUF_STATUS_SLICE_OVERFLOW_MASK 0x200 17705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_CODED_BUF_STATUS_BITRATE_OVERFLOW 0x400 17715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_CODED_BUF_STATUS_BITRATE_HIGH 0x800 1772f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** 1773f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * \brief The frame has exceeded the maximum requested size. 1774f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 1775f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * This flag indicates that the encoded frame size exceeds the value 1776f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * specified through a misc parameter buffer of type 1777f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * #VAEncMiscParameterTypeMaxFrameSize. 1778f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) */ 1779f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_CODED_BUF_STATUS_FRAME_SIZE_OVERFLOW 0x1000 17805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_CODED_BUF_STATUS_AIR_MB_OVER_THRESHOLD 0xff0000 17815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1782f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** 1783f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * \brief The coded buffer segment contains a single NAL unit. 1784f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 1785f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * This flag indicates that the coded buffer segment contains a 1786f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * single NAL unit. This flag might be useful to the user for 1787f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * processing the coded buffer. 1788f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) */ 1789f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_CODED_BUF_STATUS_SINGLE_NALU 0x10000000 1790f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 1791f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/** 1792f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * \brief Coded buffer segment. 1793f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * 1794f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * #VACodedBufferSegment is an element of a linked list describing 1795f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * some information on the coded buffer. The coded buffer segment 1796f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * could contain either a single NAL unit, or more than one NAL unit. 1797f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * It is recommended (but not required) to return a single NAL unit 1798f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * in a coded buffer segment, and the implementation should set the 1799f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * VA_CODED_BUF_STATUS_SINGLE_NALU status flag if that is the case. 18005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 18015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VACodedBufferSegment { 1802f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** 1803f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * \brief Size of the data buffer in this segment (in bytes). 1804f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) */ 1805f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int size; 1806f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Bit offset into the data buffer where the video data starts. */ 1807f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int bit_offset; 1808f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Status set by the driver. See \c VA_CODED_BUF_STATUS_*. */ 1809f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int status; 1810f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Reserved for future use. */ 1811f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) unsigned int reserved; 1812f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** \brief Pointer to the start of the data buffer. */ 1813f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) void *buf; 1814f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) /** 1815f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * \brief Pointer to the next #VACodedBufferSegment element, 1816f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * or \c NULL if there is none. 1817f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) */ 1818f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) void *next; 18195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VACodedBufferSegment; 18205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1821116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 18225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Map data store of the buffer into the client's address space 18235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaCreateBuffer() needs to be called with "data" set to NULL before 18245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * calling vaMapBuffer() 18255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 18265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * if buffer type is VAEncCodedBufferType, pbuf points to link-list of 18275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * VACodedBufferSegment, and the list is terminated if "next" is NULL 18285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 18295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaMapBuffer ( 18305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 18315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VABufferID buf_id, /* in */ 18325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void **pbuf /* out */ 18335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 18345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1835116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 18365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * After client making changes to a mapped data store, it needs to 18375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * "Unmap" it to let the server know that the data is ready to be 18385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * consumed by the server 18395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 18405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaUnmapBuffer ( 18415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 18425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VABufferID buf_id /* in */ 18435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 18445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1845116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 18465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * After this call, the buffer is deleted and this buffer_id is no longer valid 18475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Only call this if the buffer is not going to be passed to vaRenderBuffer 18485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 18495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaDestroyBuffer ( 18505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 18515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VABufferID buffer_id 18525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 18535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 18545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 18555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)Render (Decode) Pictures 18565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 18575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)A picture represents either a frame or a field. 18585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 18595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)The Begin/Render/End sequence sends the decode buffers to the server 18605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)*/ 18615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1862116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 18635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Get ready to decode a picture to a target surface 18645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 18655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaBeginPicture ( 18665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 18675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAContextID context, 18685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID render_target 18695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 18705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1871116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 18725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Send decode buffers to the server. 18735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Buffers are automatically destroyed afterwards 18745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 18755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaRenderPicture ( 18765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 18775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAContextID context, 18785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VABufferID *buffers, 18795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int num_buffers 18805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 18815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1882116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 18835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Make the end of rendering for a picture. 18845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The server should start processing all pending operations for this 18855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * surface. This call is non-blocking. The client can start another 18865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Begin/Render/End sequence on a different render target. 18875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 18885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaEndPicture ( 18895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 18905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAContextID context 18915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 18925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 18935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 18945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 18955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)Synchronization 18965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 18975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)*/ 18985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1899116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 19005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * This function blocks until all pending operations on the render target 19015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * have been completed. Upon return it is safe to use the render target for a 19025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * different picture. 19035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 19045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaSyncSurface ( 19055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 19065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID render_target 19075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 19085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 19095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef enum 19105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 19115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceRendering = 1, /* Rendering in progress */ 19125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceDisplaying = 2, /* Displaying in progress (not safe to render into it) */ 19135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* this status is useful if surface is used as the source */ 19145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* of an overlay */ 19155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceReady = 4, /* not being rendered or displayed */ 19165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceSkipped = 8 /* Indicate a skipped frame during encode */ 19175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VASurfaceStatus; 19185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1919116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 19205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Find out any pending ops on the render target 19215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 19225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaQuerySurfaceStatus ( 19235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 19245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID render_target, 19255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceStatus *status /* out */ 19265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 19275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 19285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef enum 19295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 19305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADecodeSliceMissing = 0, 19315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADecodeMBError = 1, 19325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VADecodeErrorType; 19335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1934116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 19355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Client calls vaQuerySurfaceError with VA_STATUS_ERROR_DECODING_ERROR, server side returns 19365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * an array of structure VASurfaceDecodeMBErrors, and the array is terminated by setting status=-1 19375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)*/ 19385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VASurfaceDecodeMBErrors 19395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 19405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int status; /* 1 if hardware has returned detailed info below, -1 means this record is invalid */ 19415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int start_mb; /* start mb address with errors */ 19425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int end_mb; /* end mb address with errors */ 19435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADecodeErrorType decode_error_type; 19445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VASurfaceDecodeMBErrors; 19455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1946116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 19475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * After the application gets VA_STATUS_ERROR_DECODING_ERROR after calling vaSyncSurface(), 19485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * it can call vaQuerySurfaceError to find out further details on the particular error. 19495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * VA_STATUS_ERROR_DECODING_ERROR should be passed in as "error_status", 19505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * upon the return, error_info will point to an array of _VASurfaceDecodeMBErrors structure, 19515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * which is allocated and filled by libVA with detailed information on the missing or error macroblocks. 19525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The array is terminated if "status==-1" is detected. 19535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 19545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaQuerySurfaceError( 19555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 19565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID surface, 19575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAStatus error_status, 19585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void **error_info 19595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 19605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1961116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 19625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Images and Subpictures 19635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * VAImage is used to either get the surface data to client memory, or 19645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * to copy image data in client memory to a surface. 19655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Both images, subpictures and surfaces follow the same 2D coordinate system where origin 19665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * is at the upper left corner with positive X to the right and positive Y down 19675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 19685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FOURCC(ch0, ch1, ch2, ch3) \ 19695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ((unsigned long)(unsigned char) (ch0) | ((unsigned long)(unsigned char) (ch1) << 8) | \ 19705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ((unsigned long)(unsigned char) (ch2) << 16) | ((unsigned long)(unsigned char) (ch3) << 24 )) 19715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1972f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/* 1973f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) * Pre-defined fourcc codes 1974f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) */ 19755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FOURCC_NV12 0x3231564E 19765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FOURCC_AI44 0x34344149 19775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FOURCC_RGBA 0x41424752 1978f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_FOURCC_RGBX 0x58424752 19795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FOURCC_BGRA 0x41524742 1980f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_FOURCC_BGRX 0x58524742 1981f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_FOURCC_ARGB 0x42475241 1982f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_FOURCC_XRGB 0x42475258 1983116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch#define VA_FOURCC_ABGR 0x52474241 1984116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch#define VA_FOURCC_XBGR 0x52474258 19855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FOURCC_UYVY 0x59565955 19865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FOURCC_YUY2 0x32595559 19875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FOURCC_AYUV 0x56555941 19885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FOURCC_NV11 0x3131564e 19895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FOURCC_YV12 0x32315659 19905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FOURCC_P208 0x38303250 19915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FOURCC_IYUV 0x56555949 1992f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_FOURCC_YV24 0x34325659 1993f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_FOURCC_YV32 0x32335659 1994f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_FOURCC_Y800 0x30303859 1995f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_FOURCC_IMC3 0x33434D49 1996f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_FOURCC_411P 0x50313134 1997f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_FOURCC_422H 0x48323234 1998f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_FOURCC_422V 0x56323234 1999f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_FOURCC_444P 0x50343434 2000f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_FOURCC_RGBP 0x50424752 2001f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_FOURCC_BGRP 0x50524742 2002f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#define VA_FOURCC_411R 0x52313134 /* rotated 411P */ 20035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 20045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* byte order */ 20055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_LSB_FIRST 1 20065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_MSB_FIRST 2 20075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 20085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAImageFormat 20095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 20105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int fourcc; 20115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int byte_order; /* VA_LSB_FIRST, VA_MSB_FIRST */ 20125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int bits_per_pixel; 20135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* for RGB formats */ 20145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int depth; /* significant bits per pixel */ 20155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int red_mask; 20165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int green_mask; 20175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int blue_mask; 20185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int alpha_mask; 20195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAImageFormat; 20205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 20215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef VAGenericID VAImageID; 20225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 20235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAImage 20245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 20255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImageID image_id; /* uniquely identify this image */ 20265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImageFormat format; 20275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VABufferID buf; /* image data buffer */ 20285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 20295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Image data will be stored in a buffer of type VAImageBufferType to facilitate 20305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * data store on the server side for optimal performance. The buffer will be 20315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * created by the CreateImage function, and proper storage allocated based on the image 20325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * size and format. This buffer is managed by the library implementation, and 20335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * accessed by the client through the buffer Map/Unmap functions. 20345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 20355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short width; 20365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short height; 20375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int data_size; 20385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int num_planes; /* can not be greater than 3 */ 20395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 20405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * An array indicating the scanline pitch in bytes for each plane. 20415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Each plane may have a different pitch. Maximum 3 planes for planar formats 20425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 20435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int pitches[3]; 20445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 20455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * An array indicating the byte offset from the beginning of the image data 20465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * to the start of each plane. 20475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 20485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int offsets[3]; 20495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 20505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* The following fields are only needed for paletted formats */ 20515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int num_palette_entries; /* set to zero for non-palette images */ 20525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 20535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Each component is one byte and entry_bytes indicates the number of components in 20545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * each entry (eg. 3 for YUV palette entries). set to zero for non-palette images 20555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 20565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int entry_bytes; 20575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 20585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * An array of ascii characters describing the order of the components within the bytes. 20595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Only entry_bytes characters of the string are used. 20605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 20615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) char component_order[4]; 20625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAImage; 20635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2064116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** Get maximum number of image formats supported by the implementation */ 20655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)int vaMaxNumImageFormats ( 20665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy 20675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 20685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2069116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 20705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Query supported image formats 20715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The caller must provide a "format_list" array that can hold at 20725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * least vaMaxNumImageFormats() entries. The actual number of formats 20735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * returned in "format_list" is returned in "num_formats". 20745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 20755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaQueryImageFormats ( 20765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 20775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImageFormat *format_list, /* out */ 20785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int *num_formats /* out */ 20795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 20805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2081116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 20825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Create a VAImage structure 20835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The width and height fields returned in the VAImage structure may get 20845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * enlarged for some YUV formats. Upon return from this function, 20855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * image->buf has been created and proper storage allocated by the library. 20865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The client can access the image through the Map/Unmap calls. 20875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 20885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaCreateImage ( 20895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 20905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImageFormat *format, 20915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int width, 20925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int height, 20935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImage *image /* out */ 20945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 20955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2096116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 20975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Should call DestroyImage before destroying the surface it is bound to 20985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 20995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaDestroyImage ( 21005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 21015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImageID image 21025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 21035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 21045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaSetImagePalette ( 21055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 21065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImageID image, 21075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 21085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * pointer to an array holding the palette data. The size of the array is 21095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * num_palette_entries * entry_bytes in size. The order of the components 21105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * in the palette is described by the component_order in VAImage struct 21115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 21125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char *palette 21135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 21145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2115116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 21165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Retrive surface data into a VAImage 21175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Image must be in a format supported by the implementation 21185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 21195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaGetImage ( 21205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 21215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID surface, 21225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int x, /* coordinates of the upper left source pixel */ 21235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int y, 21245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int width, /* width and height of the region */ 21255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int height, 21265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImageID image 21275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 21285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2129116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 21305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Copy data from a VAImage to a surface 21315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Image must be in a format supported by the implementation 21325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Returns a VA_STATUS_ERROR_SURFACE_BUSY if the surface 21335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * shouldn't be rendered into when this is called 21345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 21355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaPutImage ( 21365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 21375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID surface, 21385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImageID image, 21395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int src_x, 21405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int src_y, 21415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int src_width, 21425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int src_height, 21435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int dest_x, 21445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int dest_y, 21455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int dest_width, 21465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int dest_height 21475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 21485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2149116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 21505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Derive an VAImage from an existing surface. 21515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * This interface will derive a VAImage and corresponding image buffer from 21525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * an existing VA Surface. The image buffer can then be mapped/unmapped for 21535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * direct CPU access. This operation is only possible on implementations with 21545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * direct rendering capabilities and internal surface formats that can be 21555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * represented with a VAImage. When the operation is not possible this interface 21565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * will return VA_STATUS_ERROR_OPERATION_FAILED. Clients should then fall back 21575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * to using vaCreateImage + vaPutImage to accomplish the same task in an 21585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * indirect manner. 21595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 21605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Implementations should only return success when the resulting image buffer 21615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * would be useable with vaMap/Unmap. 21625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 21635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * When directly accessing a surface special care must be taken to insure 21645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * proper synchronization with the graphics hardware. Clients should call 21655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaQuerySurfaceStatus to insure that a surface is not the target of concurrent 21665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * rendering or currently being displayed by an overlay. 21675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 21685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Additionally nothing about the contents of a surface should be assumed 21695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * following a vaPutSurface. Implementations are free to modify the surface for 21705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * scaling or subpicture blending within a call to vaPutImage. 21715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 21725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Calls to vaPutImage or vaGetImage using the same surface from which the image 21735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * has been derived will return VA_STATUS_ERROR_SURFACE_BUSY. vaPutImage or 21745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaGetImage with other surfaces is supported. 21755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 21765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * An image created with vaDeriveImage should be freed with vaDestroyImage. The 21775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * image and image buffer structures will be destroyed; however, the underlying 21785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * surface will remain unchanged until freed with vaDestroySurfaces. 21795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 21805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaDeriveImage ( 21815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 21825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID surface, 21835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImage *image /* out */ 21845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 21855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2186116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 21875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Subpictures 21885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Subpicture is a special type of image that can be blended 21895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * with a surface during vaPutSurface(). Subpicture can be used to render 21905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * DVD sub-titles or closed captioning text etc. 21915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 21925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 21935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef VAGenericID VASubpictureID; 21945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2195116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** Get maximum number of subpicture formats supported by the implementation */ 21965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)int vaMaxNumSubpictureFormats ( 21975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy 21985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 21995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2200116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** flags for subpictures */ 22015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_SUBPICTURE_CHROMA_KEYING 0x0001 22025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_SUBPICTURE_GLOBAL_ALPHA 0x0002 22035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_SUBPICTURE_DESTINATION_IS_SCREEN_COORD 0x0004 2204116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 22055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Query supported subpicture formats 22065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The caller must provide a "format_list" array that can hold at 22075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * least vaMaxNumSubpictureFormats() entries. The flags arrary holds the flag 22085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * for each format to indicate additional capabilities for that format. The actual 22095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * number of formats returned in "format_list" is returned in "num_formats". 22105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * flags: returned value to indicate addtional capabilities 22115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * VA_SUBPICTURE_CHROMA_KEYING - supports chroma-keying 22125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * VA_SUBPICTURE_GLOBAL_ALPHA - supports global alpha 22135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * VA_SUBPICTURE_DESTINATION_IS_SCREEN_COORD - supports unscaled screen relative subpictures for On Screen Display 22145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 22155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 22165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaQuerySubpictureFormats ( 22175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 22185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImageFormat *format_list, /* out */ 22195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int *flags, /* out */ 22205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int *num_formats /* out */ 22215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 22225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2223116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 22245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Subpictures are created with an image associated. 22255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 22265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaCreateSubpicture ( 22275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 22285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImageID image, 22295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASubpictureID *subpicture /* out */ 22305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 22315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2232116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 22335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Destroy the subpicture before destroying the image it is assocated to 22345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 22355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaDestroySubpicture ( 22365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 22375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASubpictureID subpicture 22385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 22395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2240116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 22415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Bind an image to the subpicture. This image will now be associated with 22425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * the subpicture instead of the one at creation. 22435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 22445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaSetSubpictureImage ( 22455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 22465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASubpictureID subpicture, 22475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImageID image 22485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 22495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2250116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 22515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * If chromakey is enabled, then the area where the source value falls within 22525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * the chromakey [min, max] range is transparent 22535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The chromakey component format is the following: 22545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * For RGB: [0:7] Red [8:15] Blue [16:23] Green 22555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * For YUV: [0:7] V [8:15] U [16:23] Y 22565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The chromakey mask can be used to mask out certain components for chromakey 22575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * comparision 22585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 22595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaSetSubpictureChromakey ( 22605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 22615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASubpictureID subpicture, 22625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int chromakey_min, 22635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int chromakey_max, 22645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int chromakey_mask 22655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 22665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2267116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 22685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Global alpha value is between 0 and 1. A value of 1 means fully opaque and 22695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * a value of 0 means fully transparent. If per-pixel alpha is also specified then 22705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * the overall alpha is per-pixel alpha multiplied by the global alpha 22715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 22725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaSetSubpictureGlobalAlpha ( 22735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 22745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASubpictureID subpicture, 22755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) float global_alpha 22765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 22775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2278116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 22795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaAssociateSubpicture associates the subpicture with target_surfaces. 22805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * It defines the region mapping between the subpicture and the target 22815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * surfaces through source and destination rectangles (with the same width and height). 22825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Both will be displayed at the next call to vaPutSurface. Additional 22835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * associations before the call to vaPutSurface simply overrides the association. 22845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 22855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaAssociateSubpicture ( 22865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 22875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASubpictureID subpicture, 22885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID *target_surfaces, 22895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int num_surfaces, 22905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short src_x, /* upper left offset in subpicture */ 22915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short src_y, 22925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short src_width, 22935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short src_height, 22945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short dest_x, /* upper left offset in surface */ 22955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short dest_y, 22965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short dest_width, 22975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short dest_height, 22985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 22995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * whether to enable chroma-keying, global-alpha, or screen relative mode 23005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * see VA_SUBPICTURE_XXX values 23015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 23025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int flags 23035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 23045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2305116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 23065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaDeassociateSubpicture removes the association of the subpicture with target_surfaces. 23075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 23085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaDeassociateSubpicture ( 23095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 23105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASubpictureID subpicture, 23115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID *target_surfaces, 23125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int num_surfaces 23135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 23145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 23155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VARectangle 23165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 23175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short x; 23185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short y; 23195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short width; 23205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short height; 23215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VARectangle; 23225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2323116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 23245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Display attributes 23255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Display attributes are used to control things such as contrast, hue, saturation, 23265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * brightness etc. in the rendering process. The application can query what 23275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * attributes are supported by the driver, and then set the appropriate attributes 23285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * before calling vaPutSurface() 23295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 23305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* PowerVR IEP Lite attributes */ 23315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef enum 23325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 23335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADISPLAYATTRIB_BLE_OFF = 0x00, 23345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADISPLAYATTRIB_BLE_LOW, 23355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADISPLAYATTRIB_BLE_MEDIUM, 23365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADISPLAYATTRIB_BLE_HIGH, 23375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADISPLAYATTRIB_BLE_NONE, 23385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VADisplayAttribBLEMode; 23395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2340116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** attribute value for VADisplayAttribRotation */ 23415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_ROTATION_NONE 0x00000000 23425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_ROTATION_90 0x00000001 23435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_ROTATION_180 0x00000002 23445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_ROTATION_270 0x00000003 23455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2346116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** attribute value for VADisplayAttribOutOfLoopDeblock */ 23475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_OOL_DEBLOCKING_FALSE 0x00000000 23485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_OOL_DEBLOCKING_TRUE 0x00000001 23495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2350116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** Render mode */ 23515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RENDER_MODE_UNDEFINED 0 23525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RENDER_MODE_LOCAL_OVERLAY 1 23535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RENDER_MODE_LOCAL_GPU 2 23545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RENDER_MODE_EXTERNAL_OVERLAY 4 23555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RENDER_MODE_EXTERNAL_GPU 8 23565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2357116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** Render device */ 23585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RENDER_DEVICE_UNDEFINED 0 23595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RENDER_DEVICE_LOCAL 1 23605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RENDER_DEVICE_EXTERNAL 2 23615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2362116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** Currently defined display attribute types */ 23635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef enum 23645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 23655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribBrightness = 0, 23665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribContrast = 1, 23675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribHue = 2, 23685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribSaturation = 3, 23695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* client can specifiy a background color for the target window 23705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * the new feature of video conference, 23715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * the uncovered area of the surface is filled by this color 23725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * also it will blend with the decoded video color 23735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 23745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribBackgroundColor = 4, 23755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 23765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * this is a gettable only attribute. For some implementations that use the 23775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * hardware overlay, after PutSurface is called, the surface can not be 23785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * re-used until after the subsequent PutSurface call. If this is the case 23795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * then the value for this attribute will be set to 1 so that the client 23805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * will not attempt to re-use the surface right after returning from a call 23815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * to PutSurface. 23825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 23835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Don't use it, use flag VASurfaceDisplaying of vaQuerySurfaceStatus since 23845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * driver may use overlay or GPU alternatively 23855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 23865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribDirectSurface = 5, 23875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribRotation = 6, 23885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribOutofLoopDeblock = 7, 23895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 23905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* PowerVR IEP Lite specific attributes */ 23915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribBLEBlackMode = 8, 23925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribBLEWhiteMode = 9, 23935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribBlueStretch = 10, 23945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribSkinColorCorrection = 11, 23955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 23965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * For type VADisplayAttribCSCMatrix, "value" field is a pointer to the color 23975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * conversion matrix. Each element in the matrix is float-point 23985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 23995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribCSCMatrix = 12, 24005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* specify the constant color used to blend with video surface 24015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Cd = Cv*Cc*Ac + Cb *(1 - Ac) C means the constant RGB 24025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * d: the final color to overwrite into the frame buffer 24035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * v: decoded video after color conversion, 24045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * c: video color specified by VADisplayAttribBlendColor 24055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * b: background color of the drawable 24065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 24075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribBlendColor = 13, 24085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 24095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Indicate driver to skip painting color key or not. 24105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * only applicable if the render is overlay 24115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 24125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribOverlayAutoPaintColorKey = 14, 24135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 24145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * customized overlay color key, the format is RGB888 24155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * [23:16] = Red, [15:08] = Green, [07:00] = Blue. 24165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 24175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribOverlayColorKey = 15, 24185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 24195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The hint for the implementation of vaPutSurface 24205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * normally, the driver could use an overlay or GPU to render the surface on the screen 24215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * this flag provides APP the flexibity to switch the render dynamically 24225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 24235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribRenderMode = 16, 24245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 24255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * specify if vaPutSurface needs to render into specified monitors 24265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * one example is that one external monitor (e.g. HDMI) is enabled, 24275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * but the window manager is not aware of it, and there is no associated drawable 24285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 24295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribRenderDevice = 17, 24305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 24315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * specify vaPutSurface render area if there is no drawable on the monitor 24325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 24335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribRenderRect = 18, 24345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VADisplayAttribType; 24355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 24365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* flags for VADisplayAttribute */ 24375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_DISPLAY_ATTRIB_NOT_SUPPORTED 0x0000 24385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_DISPLAY_ATTRIB_GETTABLE 0x0001 24395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_DISPLAY_ATTRIB_SETTABLE 0x0002 24405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 24415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VADisplayAttribute 24425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 24435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribType type; 24445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int min_value; 24455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int max_value; 24465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int value; /* used by the set/get attribute functions */ 24475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* flags can be VA_DISPLAY_ATTRIB_GETTABLE or VA_DISPLAY_ATTRIB_SETTABLE or OR'd together */ 24485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int flags; 24495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VADisplayAttribute; 24505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2451116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** Get maximum number of display attributs supported by the implementation */ 24525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)int vaMaxNumDisplayAttributes ( 24535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy 24545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 24555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2456116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 24575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Query display attributes 24585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The caller must provide a "attr_list" array that can hold at 24595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * least vaMaxNumDisplayAttributes() entries. The actual number of attributes 24605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * returned in "attr_list" is returned in "num_attributes". 24615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 24625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaQueryDisplayAttributes ( 24635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 24645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribute *attr_list, /* out */ 24655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int *num_attributes /* out */ 24665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 24675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2468116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 24695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Get display attributes 24705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * This function returns the current attribute values in "attr_list". 24715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Only attributes returned with VA_DISPLAY_ATTRIB_GETTABLE set in the "flags" field 24725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * from vaQueryDisplayAttributes() can have their values retrieved. 24735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 24745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaGetDisplayAttributes ( 24755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 24765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribute *attr_list, /* in/out */ 24775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int num_attributes 24785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 24795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2480116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch/** 24815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Set display attributes 24825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Only attributes returned with VA_DISPLAY_ATTRIB_SETTABLE set in the "flags" field 24835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * from vaQueryDisplayAttributes() can be set. If the attribute is not settable or 24845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * the value is out of range, the function returns VA_STATUS_ERROR_ATTR_NOT_SUPPORTED 24855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 24865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaSetDisplayAttributes ( 24875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 24885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribute *attr_list, 24895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int num_attributes 24905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 24915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2492f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)/**@}*/ 2493f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 24945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifdef __cplusplus 24955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 24965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif 24975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 24985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif /* _VA_H_ */ 2499