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) 715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifndef _VA_H_ 725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define _VA_H_ 735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <va/va_version.h> 755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifdef __cplusplus 775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)extern "C" { 785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif 795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)Overview 825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)The VA API is intended to provide an interface between a video decode/encode/display 845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)application (client) and a hardware accelerator (server), to off-load 855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)video decode/encode/display operations from the host to the hardware accelerator at various 865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)entry-points. 875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)The basic operation steps are: 895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)- Negotiate a mutually acceptable configuration with the server to lock 915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) down profile, entrypoints, and other attributes that will not change on 925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) a frame-by-frame basis. 935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)- Create a decode context which represents a "virtualized" hardware decode 945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) device 955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)- Get and fill decode buffers with picture level, slice level and macroblock 965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) level data (depending on entrypoints) 975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)- Pass the decode buffers to the server to decode the current frame 985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)Initialization & Configuration Management 1005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)- Find out supported profiles 1025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)- Find out entrypoints for a given profile 1035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)- Find out configuration attributes for a given profile/entrypoint pair 1045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)- Create a configuration for use by the decoder 1055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)*/ 1075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef void* VADisplay; /* window system dependent */ 1095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef int VAStatus; /* Return status type from functions */ 1115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* Values for the return status */ 1125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_SUCCESS 0x00000000 1135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_OPERATION_FAILED 0x00000001 1145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_ALLOCATION_FAILED 0x00000002 1155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_INVALID_DISPLAY 0x00000003 1165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_INVALID_CONFIG 0x00000004 1175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_INVALID_CONTEXT 0x00000005 1185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_INVALID_SURFACE 0x00000006 1195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_INVALID_BUFFER 0x00000007 1205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_INVALID_IMAGE 0x00000008 1215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_INVALID_SUBPICTURE 0x00000009 1225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_ATTR_NOT_SUPPORTED 0x0000000a 1235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_MAX_NUM_EXCEEDED 0x0000000b 1245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_UNSUPPORTED_PROFILE 0x0000000c 1255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_UNSUPPORTED_ENTRYPOINT 0x0000000d 1265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_UNSUPPORTED_RT_FORMAT 0x0000000e 1275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_UNSUPPORTED_BUFFERTYPE 0x0000000f 1285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_SURFACE_BUSY 0x00000010 1295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_FLAG_NOT_SUPPORTED 0x00000011 1305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_INVALID_PARAMETER 0x00000012 1315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_RESOLUTION_NOT_SUPPORTED 0x00000013 1325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_UNIMPLEMENTED 0x00000014 1335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_SURFACE_IN_DISPLAYING 0x00000015 1345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_INVALID_IMAGE_FORMAT 0x00000016 1355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_DECODING_ERROR 0x00000017 1365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_ENCODING_ERROR 0x00000018 1375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_STATUS_ERROR_UNKNOWN 0xFFFFFFFF 1385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* De-interlacing flags for vaPutSurface() */ 1405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FRAME_PICTURE 0x00000000 1415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_TOP_FIELD 0x00000001 1425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_BOTTOM_FIELD 0x00000002 1435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 1455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Enabled the positioning/cropping/blending feature: 1465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 1, specify the video playback position in the isurface 1475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 2, specify the cropping info for video playback 1485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 3, encoded video will blend with background color 1495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 1505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_ENABLE_BLEND 0x00000004 /* video area blend with the constant color */ 1515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 1535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Clears the drawable with background color. 1545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * for hardware overlay based implementation this flag 1555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * can be used to turn off the overlay 1565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 1575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_CLEAR_DRAWABLE 0x00000008 1585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* Color space conversion flags for vaPutSurface() */ 1605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_SRC_BT601 0x00000010 1615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_SRC_BT709 0x00000020 1625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_SRC_SMPTE_240 0x00000040 1635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* Scaling flags for vaPutSurface() */ 1655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FILTER_SCALING_DEFAULT 0x00000000 1665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FILTER_SCALING_FAST 0x00000100 1675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FILTER_SCALING_HQ 0x00000200 1685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FILTER_SCALING_NL_ANAMORPHIC 0x00000300 1695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FILTER_SCALING_MASK 0x00000f00 1705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 1725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Returns a short english description of error_status 1735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 1745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const char *vaErrorStr(VAStatus error_status); 1755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 1775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Initialization: 1785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * A display must be obtained by calling vaGetDisplay() before calling 1795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaInitialize() and other functions. This connects the API to the 1805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * native window system. 1815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * For X Windows, native_dpy would be from XOpenDisplay() 1825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 1835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef void* VANativeDisplay; /* window system dependent */ 1845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)int vaDisplayIsValid(VADisplay dpy); 1865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 1885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Initialize the library 1895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 1905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaInitialize ( 1915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 1925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int *major_version, /* out */ 1935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int *minor_version /* out */ 1945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 1955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 1975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * After this call, all library internal resources will be cleaned up 1985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 1995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaTerminate ( 2005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy 2015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 2025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 2045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaQueryVendorString returns a pointer to a zero-terminated string 2055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * describing some aspects of the VA implemenation on a specific 2065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * hardware accelerator. The format of the returned string is vendor 2075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * specific and at the discretion of the implementer. 2085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * e.g. for the Intel GMA500 implementation, an example would be: 2095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * "Intel GMA500 - 2.0.0.32L.0005" 2105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 2115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)const char *vaQueryVendorString ( 2125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy 2135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 2145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef int (*VAPrivFunc)(); 2165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 2185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Return a function pointer given a function name in the library. 2195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * This allows private interfaces into the library 2205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 2215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAPrivFunc vaGetLibFunc ( 2225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 2235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const char *func 2245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 2255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* Currently defined profiles */ 2275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef enum 2285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 2295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfileMPEG2Simple = 0, 2305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfileMPEG2Main = 1, 2315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfileMPEG4Simple = 2, 2325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfileMPEG4AdvancedSimple = 3, 2335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfileMPEG4Main = 4, 2345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfileH264Baseline = 5, 2355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfileH264Main = 6, 2365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfileH264High = 7, 2375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfileVC1Simple = 8, 2385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfileVC1Main = 9, 2395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfileVC1Advanced = 10, 2405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfileH263Baseline = 11, 2415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfileJPEGBaseline = 12, 2425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfileH264ConstrainedBaseline = 13 2435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAProfile; 2445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 2465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Currently defined entrypoints 2475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 2485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef enum 2495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 2505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEntrypointVLD = 1, 2515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEntrypointIZZ = 2, 2525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEntrypointIDCT = 3, 2535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEntrypointMoComp = 4, 2545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEntrypointDeblocking = 5, 2555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEntrypointEncSlice = 6, /* slice level encode */ 2565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEntrypointEncPicture = 7 /* pictuer encode, JPEG, etc */ 2575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEntrypoint; 2585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* Currently defined configuration attribute types */ 2605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef enum 2615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 2625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAConfigAttribRTFormat = 0, 2635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAConfigAttribSpatialResidual = 1, 2645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAConfigAttribSpatialClipping = 2, 2655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAConfigAttribIntraResidual = 3, 2665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAConfigAttribEncryption = 4, 2675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAConfigAttribRateControl = 5 2685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAConfigAttribType; 2695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 2715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Configuration attributes 2725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * If there is more than one value for an attribute, a default 2735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * value will be assigned to the attribute if the client does not 2745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * specify the attribute when creating a configuration 2755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 2765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAConfigAttrib { 2775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAConfigAttribType type; 2785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; /* OR'd flags (bits) for this attribute */ 2795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAConfigAttrib; 2805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* attribute value for VAConfigAttribRTFormat */ 2825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RT_FORMAT_YUV420 0x00000001 2835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RT_FORMAT_YUV422 0x00000002 2845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RT_FORMAT_YUV444 0x00000004 2855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RT_FORMAT_PROTECTED 0x80000000 2865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* attribute value for VAConfigAttribRateControl */ 2885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RC_NONE 0x00000001 2895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RC_CBR 0x00000002 2905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RC_VBR 0x00000004 2915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RC_VCM 0x00000008 /* video conference mode */ 2925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 2945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * if an attribute is not applicable for a given 2955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * profile/entrypoint pair, then set the value to the following 2965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 2975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_ATTRIB_NOT_SUPPORTED 0x80000000 2985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* Get maximum number of profiles supported by the implementation */ 3005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)int vaMaxNumProfiles ( 3015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy 3025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 3035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* Get maximum number of entrypoints supported by the implementation */ 3055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)int vaMaxNumEntrypoints ( 3065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy 3075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 3085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* Get maximum number of attributs supported by the implementation */ 3105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)int vaMaxNumConfigAttributes ( 3115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy 3125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 3135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 3155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Query supported profiles 3165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The caller must provide a "profile_list" array that can hold at 3175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * least vaMaxNumProfile() entries. The actual number of profiles 3185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * returned in "profile_list" is returned in "num_profile". 3195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 3205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaQueryConfigProfiles ( 3215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 3225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfile *profile_list, /* out */ 3235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int *num_profiles /* out */ 3245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 3255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 3275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Query supported entrypoints for a given profile 3285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The caller must provide an "entrypoint_list" array that can hold at 3295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * least vaMaxNumEntrypoints() entries. The actual number of entrypoints 3305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * returned in "entrypoint_list" is returned in "num_entrypoints". 3315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 3325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaQueryConfigEntrypoints ( 3335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 3345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfile profile, 3355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEntrypoint *entrypoint_list, /* out */ 3365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int *num_entrypoints /* out */ 3375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 3385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 3405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Get attributes for a given profile/entrypoint pair 3415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The caller must provide an "attrib_list" with all attributes to be 3425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * retrieved. Upon return, the attributes in "attrib_list" have been 3435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * updated with their value. Unknown attributes or attributes that are 3445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * not supported for the given profile/entrypoint pair will have their 3455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * value set to VA_ATTRIB_NOT_SUPPORTED 3465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 3475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaGetConfigAttributes ( 3485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 3495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfile profile, 3505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEntrypoint entrypoint, 3515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAConfigAttrib *attrib_list, /* in/out */ 3525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int num_attribs 3535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 3545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* Generic ID type, can be re-typed for specific implementation */ 3565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef unsigned int VAGenericID; 3575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef VAGenericID VAConfigID; 3595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 3615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Create a configuration for the decode pipeline 3625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * it passes in the attribute list that specifies the attributes it cares 3635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * about, with the rest taking default values. 3645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 3655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaCreateConfig ( 3665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 3675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfile profile, 3685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEntrypoint entrypoint, 3695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAConfigAttrib *attrib_list, 3705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int num_attribs, 3715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAConfigID *config_id /* out */ 3725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 3735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 3755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Free resources associdated with a given config 3765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 3775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaDestroyConfig ( 3785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 3795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAConfigID config_id 3805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 3815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 3835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Query all attributes for a given configuration 3845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The profile of the configuration is returned in "profile" 3855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The entrypoint of the configuration is returned in "entrypoint" 3865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The caller must provide an "attrib_list" array that can hold at least 3875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaMaxNumConfigAttributes() entries. The actual number of attributes 3885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * returned in "attrib_list" is returned in "num_attribs" 3895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 3905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaQueryConfigAttributes ( 3915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 3925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAConfigID config_id, 3935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProfile *profile, /* out */ 3945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEntrypoint *entrypoint, /* out */ 3955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAConfigAttrib *attrib_list,/* out */ 3965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int *num_attribs /* out */ 3975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 3985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 4015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Contexts and Surfaces 4025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 4035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Context represents a "virtual" video decode pipeline. Surfaces are render 4045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * targets for a given context. The data in the surfaces are not accessible 4055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * to the client and the internal data format of the surface is implementatin 4065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * specific. 4075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 4085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Surfaces will be bound to a context when the context is created. Once 4095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * a surface is bound to a given context, it can not be used to create 4105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * another context. The association is removed when the context is destroyed 4115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 4125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Both contexts and surfaces are identified by unique IDs and its 4135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * implementation specific internals are kept opaque to the clients 4145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 4155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef VAGenericID VAContextID; 4175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef VAGenericID VASurfaceID; 4195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_INVALID_ID 0xffffffff 4215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_INVALID_SURFACE VA_INVALID_ID 4225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 4245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaCreateSurfaces - Create an array of surfaces used for decode and display 4255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * dpy: display 4265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * width: surface width 4275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * height: surface height 4285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * format: VA_RT_FORMAT_YUV420, VA_RT_FORMAT_YUV422 or VA_RT_FORMAT_YUV444 4295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * num_surfaces: number of surfaces to be created 4305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * surfaces: array of surfaces created upon return 4315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 4325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaCreateSurfaces ( 4335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 4345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int width, 4355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int height, 4365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int format, 4375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int num_surfaces, 4385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID *surfaces /* out */ 4395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 4405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 4435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaDestroySurfaces - Destroy resources associated with surfaces. 4445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Surfaces can only be destroyed after the context associated has been 4455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * destroyed. 4465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * dpy: display 4475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * surfaces: array of surfaces to destroy 4485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * num_surfaces: number of surfaces in the array to be destroyed. 4495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 4505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaDestroySurfaces ( 4515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 4525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID *surfaces, 4535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int num_surfaces 4545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 4555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_PROGRESSIVE 0x1 4575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 4585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaCreateContext - Create a context 4595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * dpy: display 4605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * config_id: configuration for the context 4615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * picture_width: coded picture width 4625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * picture_height: coded picture height 4635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * flag: any combination of the following: 4645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * VA_PROGRESSIVE (only progressive frame pictures in the sequence when set) 4655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * render_targets: render targets (surfaces) tied to the context 4665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * num_render_targets: number of render targets in the above array 4675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * context: created context id upon return 4685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 4695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaCreateContext ( 4705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 4715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAConfigID config_id, 4725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int picture_width, 4735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int picture_height, 4745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int flag, 4755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID *render_targets, 4765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int num_render_targets, 4775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAContextID *context /* out */ 4785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 4795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 4815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaDestroyContext - Destroy a context 4825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * dpy: display 4835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * context: context to be destroyed 4845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 4855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaDestroyContext ( 4865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 4875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAContextID context 4885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 4895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 4915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Buffers 4925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Buffers are used to pass various types of data from the 4935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * client to the server. The server maintains a data store 4945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * for each buffer created, and the client idenfies a buffer 4955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * through a unique buffer id assigned by the server. 4965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 4975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef VAGenericID VABufferID; 4995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef enum 5015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 5025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAPictureParameterBufferType = 0, 5035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAIQMatrixBufferType = 1, 5045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VABitPlaneBufferType = 2, 5055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASliceGroupMapBufferType = 3, 5065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASliceParameterBufferType = 4, 5075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASliceDataBufferType = 5, 5085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAMacroblockParameterBufferType = 6, 5095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAResidualDataBufferType = 7, 5105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADeblockingParameterBufferType = 8, 5115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImageBufferType = 9, 5125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAProtectedSliceDataBufferType = 10, 5135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAQMatrixBufferType = 11, 5145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAHuffmanTableBufferType = 12, 5155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* Following are encode buffer types */ 5175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncCodedBufferType = 21, 5185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncSequenceParameterBufferType = 22, 5195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncPictureParameterBufferType = 23, 5205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncSliceParameterBufferType = 24, 5215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncH264VUIBufferType = 25, 5225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncH264SEIBufferType = 26, 5235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncMiscParameterBufferType = 27, 5245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VABufferTypeMax = 0xff 5255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VABufferType; 5265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef enum 5285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 5295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncMiscParameterTypeFrameRate = 0, 5305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncMiscParameterTypeRateControl = 1, 5315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncMiscParameterTypeMaxSliceSize = 2, 5325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncMiscParameterTypeAIR = 3, 5335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncMiscParameterType; 5345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 5365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * For application, e.g. set a new bitrate 5375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * VABufferID buf_id; 5385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * VAEncMiscParameterBuffer *misc_param; 5395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * VAEncMiscParameterRateControl *misc_rate_ctrl; 5405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 5415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaCreateBuffer(dpy, context, VAEncMiscParameterBufferType, 5425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * sizeof(VAEncMiscParameterBuffer) + sizeof(VAEncMiscParameterRateControl), 5435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 1, NULL, &buf_id); 5445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 5455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaMapBuffer(dpy,buf_id,(void **)&misc_param); 5465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * misc_param->type = VAEncMiscParameterTypeRateControl; 5475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * misc_rate_ctrl= (VAEncMiscParameterRateControl *)misc_param->data; 5485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * misc_rate_ctrl->bits_per_second = 6400000; 5495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaUnmapBuffer(dpy, buf_id); 5505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaRenderPicture(dpy, context, &buf_id, 1); 5515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 5525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAEncMiscParameterBuffer 5535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 5545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncMiscParameterType type; 5555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int data[0]; 5565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncMiscParameterBuffer; 5575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAEncMiscParameterRateControl 5595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 5605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int bits_per_second; /* this is the maximum bit-rate to be constrained by the rate control implementation */ 5615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int target_percentage; /* this is the bit-rate the rate control is targeting, as a percentage of the maximum bit-rate */ 5625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* for example if target_percentage is 95 then the rate control will target a bit-rate that is */ 5635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 95% of the maximum bit-rate */ 5645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int window_size; /* windows size in milliseconds. For example if this is set to 500, then the rate control will guarantee the */ 5655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* target bit-rate over a 500 ms window */ 5665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int initial_qp; /* initial QP at I frames */ 5675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int min_qp; 5685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncMiscParameterRateControl; 5695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAEncMiscParameterFrameRate 5715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 5725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int framerate; 5735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncMiscParameterFrameRate; 5745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 5765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Allow a maximum slice size to be specified (in bits). 5775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The encoder will attempt to make sure that individual slices do not exceed this size 5785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Or to signal applicate if the slice size exceed this size, see "status" of VACodedBufferSegment 5795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 5805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAEncMiscParameterMaxSliceSize 5815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 5825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int max_slice_size; 5835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncMiscParameterMaxSliceSize; 5845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAEncMiscParameterAIR 5865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 5875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int air_num_mbs; 5885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int air_threshold; 5895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int air_auto; /* if set to 1 then hardware auto-tune the AIR threshold */ 5905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncMiscParameterAIR; 5915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 5935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 5945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * There will be cases where the bitstream buffer will not have enough room to hold 5955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * the data for the entire slice, and the following flags will be used in the slice 5965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * parameter to signal to the server for the possible cases. 5975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * If a slice parameter buffer and slice data buffer pair is sent to the server with 5985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * the slice data partially in the slice data buffer (BEGIN and MIDDLE cases below), 5995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * then a slice parameter and data buffer needs to be sent again to complete this slice. 6005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 6015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_SLICE_DATA_FLAG_ALL 0x00 /* whole slice is in the buffer */ 6025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_SLICE_DATA_FLAG_BEGIN 0x01 /* The beginning of the slice is in the buffer but the end if not */ 6035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_SLICE_DATA_FLAG_MIDDLE 0x02 /* Neither beginning nor end of the slice is in the buffer */ 6045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_SLICE_DATA_FLAG_END 0x04 /* end of the slice is in the buffer */ 6055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* Codec-independent Slice Parameter Buffer base */ 6075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VASliceParameterBufferBase 6085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 6095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_size; /* number of bytes in the slice data buffer for this slice */ 6105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_offset; /* the offset to the first byte of slice data */ 6115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_flag; /* see VA_SLICE_DATA_FLAG_XXX definitions */ 6125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VASliceParameterBufferBase; 6135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/**************************** 6165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * JEPG data structure 6175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ***************************/ 6185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAQMatrixBufferJPEG 6195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 6205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int load_lum_quantiser_matrix; 6215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int load_chroma_quantiser_matrix; 6225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char lum_quantiser_matrix[64]; 6235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char chroma_quantiser_matrix[64]; 6245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAQMatrixBufferJPEG; 6255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAEncPictureParameterBufferJPEG 6275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 6285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID reconstructed_picture; 6295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short picture_width; 6305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short picture_height; 6315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VABufferID coded_buf; 6325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncPictureParameterBufferJPEG; 6335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* data struct for JPEG decoding */ 6355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* Quantization table */ 6375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAIQMatrixBufferJPEG 6385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 6395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int precision[4]; /* valid value: 0(8-bits) , 1(16-bits), precision[Tq](Tq=0,1,2,3) 6405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * specifies precision for destination Tq 6415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 6425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char quantiser_matrix[4][128]; /* quantiser_matrix[Tq](Tq=0,1,2,3) specifies a 6435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * quantization table for destination Tq in zig-zag 6445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * scan order. Only the first 64 bytes are valid for each 6455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * table if precision is 0(8-bits). 6465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 6475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAIQMatrixBufferJPEG; 6485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_JPEG_SOF0 0xC0 6505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_JPEG_SOF1 0xC1 6515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_JPEG_SOF2 0xC2 6525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_JPEG_SOF3 0xC3 6535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_JPEG_SOF5 0xC5 6545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_JPEG_SOF6 0xC6 6555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_JPEG_SOF7 0xC7 6565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_JPEG_SOF9 0xC9 6575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_JPEG_SOF10 0xCA 6585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_JPEG_SOF11 0xCB 6595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_JPEG_SOF13 0xCD 6605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_JPEG_SOF14 0xCE 6615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* JPEG Picture Parameter Buffer */ 6635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAPictureParameterBufferJPEG 6645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 6655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int type; /* SOFn */ 6665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int sample_precision; 6675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int image_width; 6685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int image_height; 6695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int num_components; 6705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 6715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char component_id; /* Ci, the range is 0-255, see B.2.2 */ 6725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char h_sampling_factor; 6735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char v_sampling_factor; 6745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char quantiser_table_selector; /* Tqi, quantization table destination selector */ 6755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } components[4]; 6765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* ROI (region of interest), for JPEG2000 */ 6785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 6795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int enabled; 6805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int start_x; 6815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int start_y; 6825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int end_x; 6835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int end_y; 6845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } roi; 6855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int rotation; 6875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAPictureParameterBufferJPEG; 6885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 6895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAHuffmanTableBufferJPEG 6905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 6915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 6925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char dc_bits[16]; /* Number of Huffman codes of length i for DC */ 6935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char dc_huffval[20]; /* Value associated with each Huffman code for DC */ 6945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char ac_bits[16]; /* Number of Huffman codes of length i for AC */ 6955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char ac_huffval[256]; /* Value associated with each Huffman code for AC */ 6965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } huffman_table[4]; /* Up to 4 huffman tables, huffman_table[Th](Th=0,1,2,3) 6975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * specifies a buffman table for destination Th. 6985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 6995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAHuffmanTableBufferJPEG; 7015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* JPEG Scan Parameter Buffer, The Scan of is similar to 7035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * the Slice of other codecs */ 7045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VASliceParameterBufferJPEG 7055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 7065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_size; /* number of bytes in the slice data buffer for this slice */ 7075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_offset; /* the offset to the first byte of slice data */ 7085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_flag; /* see VA_SLICE_DATA_FLAG_XXX definitions */ 7095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_horizontal_position; 7105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_vertical_position; 7115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int num_components; 7135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 7145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int component_id; /* Csj, it must match one of component_ids specified in VAPictureParameterBufferJPEG */ 7155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int dc_selector; /* Tdj(0,1,2,3) */ 7165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int ac_selector; /* Taj(0,1,2,3) */ 7175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } components[4]; 7185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int restart_interval; /* specifies the number of MCUs in restart interval, defined in DRI marker */ 7205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int num_mcus; /* indicates the number of MCUs in a scan */ 7215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VASliceParameterBufferJPEG; 7225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/**************************** 7245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * MPEG-2 data structures 7255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ****************************/ 7265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* MPEG-2 Picture Parameter Buffer */ 7285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 7295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * For each frame or field, and before any slice data, a single 7305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * picture parameter buffer must be send. 7315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 7325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAPictureParameterBufferMPEG2 7335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 7345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short horizontal_size; 7355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short vertical_size; 7365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID forward_reference_picture; 7375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID backward_reference_picture; 7385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* meanings of the following fields are the same as in the standard */ 7395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int picture_coding_type; 7405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int f_code; /* pack all four fcode into this */ 7415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 7425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 7435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int intra_dc_precision : 2; 7445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int picture_structure : 2; 7455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int top_field_first : 1; 7465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int frame_pred_frame_dct : 1; 7475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int concealment_motion_vectors : 1; 7485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int q_scale_type : 1; 7495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int intra_vlc_format : 1; 7505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int alternate_scan : 1; 7515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int repeat_first_field : 1; 7525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int progressive_frame : 1; 7535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int is_first_field : 1; /* indicate whether the current field 7545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * is the first field for field picture 7555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 7565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 7575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 7585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } picture_coding_extension; 7595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAPictureParameterBufferMPEG2; 7605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* MPEG-2 Inverse Quantization Matrix Buffer */ 7625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAIQMatrixBufferMPEG2 7635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 7645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int load_intra_quantiser_matrix; 7655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int load_non_intra_quantiser_matrix; 7665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int load_chroma_intra_quantiser_matrix; 7675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int load_chroma_non_intra_quantiser_matrix; 7685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char intra_quantiser_matrix[64]; 7695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char non_intra_quantiser_matrix[64]; 7705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char chroma_intra_quantiser_matrix[64]; 7715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char chroma_non_intra_quantiser_matrix[64]; 7725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAIQMatrixBufferMPEG2; 7735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* MPEG-2 Slice Parameter Buffer */ 7755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VASliceParameterBufferMPEG2 7765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 7775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_size;/* number of bytes in the slice data buffer for this slice */ 7785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_offset;/* the offset to the first byte of slice data */ 7795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_flag; /* see VA_SLICE_DATA_FLAG_XXX defintions */ 7805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int macroblock_offset;/* the offset to the first bit of MB from the first byte of slice data */ 7815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_horizontal_position; 7825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_vertical_position; 7835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int quantiser_scale_code; 7845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int intra_slice_flag; 7855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VASliceParameterBufferMPEG2; 7865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 7875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* MPEG-2 Macroblock Parameter Buffer */ 7885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAMacroblockParameterBufferMPEG2 7895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 7905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short macroblock_address; 7915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 7925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * macroblock_address (in raster scan order) 7935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * top-left: 0 7945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * bottom-right: picture-height-in-mb*picture-width-in-mb - 1 7955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 7965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char macroblock_type; /* see definition below */ 7975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 7985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 7995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int frame_motion_type : 2; 8005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int field_motion_type : 2; 8015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int dct_type : 1; 8025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 8035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 8045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } macroblock_modes; 8055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char motion_vertical_field_select; 8065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 8075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * motion_vertical_field_select: 8085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * see section 6.3.17.2 in the spec 8095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * only the lower 4 bits are used 8105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * bit 0: first vector forward 8115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * bit 1: first vector backward 8125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * bit 2: second vector forward 8135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * bit 3: second vector backward 8145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 8155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short PMV[2][2][2]; /* see Table 7-7 in the spec */ 8165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short coded_block_pattern; 8175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 8185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The bitplanes for coded_block_pattern are described 8195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * in Figure 6.10-12 in the spec 8205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 8215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* Number of skipped macroblocks after this macroblock */ 8235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short num_skipped_macroblocks; 8245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAMacroblockParameterBufferMPEG2; 8255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 8275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * OR'd flags for macroblock_type (section 6.3.17.1 in the spec) 8285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 8295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_MB_TYPE_MOTION_FORWARD 0x02 8305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_MB_TYPE_MOTION_BACKWARD 0x04 8315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_MB_TYPE_MOTION_PATTERN 0x08 8325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_MB_TYPE_MOTION_INTRA 0x10 8335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 8355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * MPEG-2 Residual Data Buffer 8365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * For each macroblock, there wil be 64 shorts (16-bit) in the 8375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * residual data buffer 8385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 8395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/**************************** 8415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * MPEG-4 Part 2 data structures 8425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ****************************/ 8435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* MPEG-4 Picture Parameter Buffer */ 8455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 8465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * For each frame or field, and before any slice data, a single 8475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * picture parameter buffer must be send. 8485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 8495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAPictureParameterBufferMPEG4 8505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 8515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short vop_width; 8525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short vop_height; 8535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID forward_reference_picture; 8545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID backward_reference_picture; 8555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 8565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 8575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int short_video_header : 1; 8585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int chroma_format : 2; 8595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int interlaced : 1; 8605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int obmc_disable : 1; 8615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int sprite_enable : 2; 8625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int sprite_warping_accuracy : 2; 8635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int quant_type : 1; 8645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int quarter_sample : 1; 8655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int data_partitioned : 1; 8665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int reversible_vlc : 1; 8675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int resync_marker_disable : 1; 8685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 8695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 8705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } vol_fields; 8715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char no_of_sprite_warping_points; 8725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short sprite_trajectory_du[3]; 8735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short sprite_trajectory_dv[3]; 8745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char quant_precision; 8755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 8765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 8775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int vop_coding_type : 2; 8785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int backward_reference_vop_coding_type : 2; 8795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int vop_rounding_type : 1; 8805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int intra_dc_vlc_thr : 3; 8815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int top_field_first : 1; 8825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int alternate_vertical_scan_flag : 1; 8835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 8845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 8855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } vop_fields; 8865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char vop_fcode_forward; 8875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char vop_fcode_backward; 8885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short vop_time_increment_resolution; 8895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* short header related */ 8905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char num_gobs_in_vop; 8915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char num_macroblocks_in_gob; 8925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* for direct mode prediction */ 8935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short TRB; 8945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short TRD; 8955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAPictureParameterBufferMPEG4; 8965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 8975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* MPEG-4 Inverse Quantization Matrix Buffer */ 8985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAIQMatrixBufferMPEG4 8995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 9005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int load_intra_quant_mat; 9015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int load_non_intra_quant_mat; 9025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char intra_quant_mat[64]; 9035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char non_intra_quant_mat[64]; 9045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAIQMatrixBufferMPEG4; 9055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 9065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* MPEG-4 Slice Parameter Buffer */ 9075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VASliceParameterBufferMPEG4 9085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 9095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_size;/* number of bytes in the slice data buffer for this slice */ 9105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_offset;/* the offset to the first byte of slice data */ 9115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_flag; /* see VA_SLICE_DATA_FLAG_XXX defintions */ 9125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int macroblock_offset;/* the offset to the first bit of MB from the first byte of slice data */ 9135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int macroblock_number; 9145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int quant_scale; 9155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VASliceParameterBufferMPEG4; 9165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 9175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 9185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VC-1 data structures 9195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)*/ 9205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 9215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef enum /* see 7.1.1.32 */ 9225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 9235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAMvMode1Mv = 0, 9245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAMvMode1MvHalfPel = 1, 9255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAMvMode1MvHalfPelBilinear = 2, 9265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAMvModeMixedMv = 3, 9275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAMvModeIntensityCompensation = 4 9285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAMvModeVC1; 9295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 9305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* VC-1 Picture Parameter Buffer */ 9315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 9325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * For each picture, and before any slice data, a picture parameter 9335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * buffer must be send. Multiple picture parameter buffers may be 9345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * sent for a single picture. In that case picture parameters will 9355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * apply to all slice data that follow it until a new picture 9365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * parameter buffer is sent. 9375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 9385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Notes: 9395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * pic_quantizer_type should be set to the applicable quantizer 9405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * type as defined by QUANTIZER (J.1.19) and either 9415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * PQUANTIZER (7.1.1.8) or PQINDEX (7.1.1.6) 9425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 9435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAPictureParameterBufferVC1 9445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 9455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID forward_reference_picture; 9465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID backward_reference_picture; 9475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* if out-of-loop post-processing is done on the render 9485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) target, then we need to keep the in-loop decoded 9495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) picture as a reference picture */ 9505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID inloop_decoded_picture; 9515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 9525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* sequence layer for AP or meta data for SP and MP */ 9535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 9545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 9555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int pulldown : 1; /* SEQUENCE_LAYER::PULLDOWN */ 9565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int interlace : 1; /* SEQUENCE_LAYER::INTERLACE */ 9575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int tfcntrflag : 1; /* SEQUENCE_LAYER::TFCNTRFLAG */ 9585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int finterpflag : 1; /* SEQUENCE_LAYER::FINTERPFLAG */ 9595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int psf : 1; /* SEQUENCE_LAYER::PSF */ 9605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int multires : 1; /* METADATA::MULTIRES */ 9615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int overlap : 1; /* METADATA::OVERLAP */ 9625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int syncmarker : 1; /* METADATA::SYNCMARKER */ 9635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int rangered : 1; /* METADATA::RANGERED */ 9645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int max_b_frames : 3; /* METADATA::MAXBFRAMES */ 9655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int profile : 2; /* SEQUENCE_LAYER::PROFILE or The MSB of METADATA::PROFILE */ 9665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 9675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 9685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } sequence_fields; 9695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 9705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short coded_width; /* ENTRY_POINT_LAYER::CODED_WIDTH */ 9715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short coded_height; /* ENTRY_POINT_LAYER::CODED_HEIGHT */ 9725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 9735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 9745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int broken_link : 1; /* ENTRY_POINT_LAYER::BROKEN_LINK */ 9755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int closed_entry : 1; /* ENTRY_POINT_LAYER::CLOSED_ENTRY */ 9765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int panscan_flag : 1; /* ENTRY_POINT_LAYER::PANSCAN_FLAG */ 9775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int loopfilter : 1; /* ENTRY_POINT_LAYER::LOOPFILTER */ 9785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 9795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 9805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } entrypoint_fields; 9815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char conditional_overlap_flag; /* ENTRY_POINT_LAYER::CONDOVER */ 9825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char fast_uvmc_flag; /* ENTRY_POINT_LAYER::FASTUVMC */ 9835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 9845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 9855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int luma_flag : 1; /* ENTRY_POINT_LAYER::RANGE_MAPY_FLAG */ 9865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int luma : 3; /* ENTRY_POINT_LAYER::RANGE_MAPY */ 9875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int chroma_flag : 1; /* ENTRY_POINT_LAYER::RANGE_MAPUV_FLAG */ 9885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int chroma : 3; /* ENTRY_POINT_LAYER::RANGE_MAPUV */ 9895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 9905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 9915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } range_mapping_fields; 9925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 9935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char b_picture_fraction; /* PICTURE_LAYER::BFRACTION */ 9945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char cbp_table; /* PICTURE_LAYER::CBPTAB/ICBPTAB */ 9955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char mb_mode_table; /* PICTURE_LAYER::MBMODETAB */ 9965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char range_reduction_frame;/* PICTURE_LAYER::RANGEREDFRM */ 9975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char rounding_control; /* PICTURE_LAYER::RNDCTRL */ 9985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char post_processing; /* PICTURE_LAYER::POSTPROC */ 9995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char picture_resolution_index; /* PICTURE_LAYER::RESPIC */ 10005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char luma_scale; /* PICTURE_LAYER::LUMSCALE */ 10015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char luma_shift; /* PICTURE_LAYER::LUMSHIFT */ 10025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 10035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 10045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int picture_type : 3; /* PICTURE_LAYER::PTYPE */ 10055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int frame_coding_mode : 3; /* PICTURE_LAYER::FCM */ 10065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int top_field_first : 1; /* PICTURE_LAYER::TFF */ 10075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int is_first_field : 1; /* set to 1 if it is the first field */ 10085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int intensity_compensation : 1; /* PICTURE_LAYER::INTCOMP */ 10095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 10105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 10115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } picture_fields; 10125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 10135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 10145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int mv_type_mb : 1; /* PICTURE::MVTYPEMB */ 10155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int direct_mb : 1; /* PICTURE::DIRECTMB */ 10165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int skip_mb : 1; /* PICTURE::SKIPMB */ 10175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int field_tx : 1; /* PICTURE::FIELDTX */ 10185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int forward_mb : 1; /* PICTURE::FORWARDMB */ 10195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int ac_pred : 1; /* PICTURE::ACPRED */ 10205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int overflags : 1; /* PICTURE::OVERFLAGS */ 10215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } flags; 10225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 10235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } raw_coding; 10245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 10255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 10265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int bp_mv_type_mb : 1; /* PICTURE::MVTYPEMB */ 10275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int bp_direct_mb : 1; /* PICTURE::DIRECTMB */ 10285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int bp_skip_mb : 1; /* PICTURE::SKIPMB */ 10295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int bp_field_tx : 1; /* PICTURE::FIELDTX */ 10305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int bp_forward_mb : 1; /* PICTURE::FORWARDMB */ 10315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int bp_ac_pred : 1; /* PICTURE::ACPRED */ 10325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int bp_overflags : 1; /* PICTURE::OVERFLAGS */ 10335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } flags; 10345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 10355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bitplane_present; /* signal what bitplane is being passed via the bitplane buffer */ 10365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 10375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 10385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int reference_distance_flag : 1;/* PICTURE_LAYER::REFDIST_FLAG */ 10395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int reference_distance : 5;/* PICTURE_LAYER::REFDIST */ 10405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int num_reference_pictures: 1;/* PICTURE_LAYER::NUMREF */ 10415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int reference_field_pic_indicator : 1;/* PICTURE_LAYER::REFFIELD */ 10425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 10435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 10445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } reference_fields; 10455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 10465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 10475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int mv_mode : 3; /* PICTURE_LAYER::MVMODE */ 10485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int mv_mode2 : 3; /* PICTURE_LAYER::MVMODE2 */ 10495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int mv_table : 3; /* PICTURE_LAYER::MVTAB/IMVTAB */ 10505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int two_mv_block_pattern_table: 2; /* PICTURE_LAYER::2MVBPTAB */ 10515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int four_mv_switch : 1; /* PICTURE_LAYER::4MVSWITCH */ 10525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int four_mv_block_pattern_table : 2; /* PICTURE_LAYER::4MVBPTAB */ 10535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int extended_mv_flag : 1; /* ENTRY_POINT_LAYER::EXTENDED_MV */ 10545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int extended_mv_range : 2; /* PICTURE_LAYER::MVRANGE */ 10555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int extended_dmv_flag : 1; /* ENTRY_POINT_LAYER::EXTENDED_DMV */ 10565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int extended_dmv_range : 2; /* PICTURE_LAYER::DMVRANGE */ 10575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 10585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 10595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } mv_fields; 10605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 10615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 10625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int dquant : 2; /* ENTRY_POINT_LAYER::DQUANT */ 10635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int quantizer : 2; /* ENTRY_POINT_LAYER::QUANTIZER */ 10645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int half_qp : 1; /* PICTURE_LAYER::HALFQP */ 10655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int pic_quantizer_scale : 5;/* PICTURE_LAYER::PQUANT */ 10665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int pic_quantizer_type : 1;/* PICTURE_LAYER::PQUANTIZER */ 10675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int dq_frame : 1; /* VOPDQUANT::DQUANTFRM */ 10685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int dq_profile : 2; /* VOPDQUANT::DQPROFILE */ 10695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int dq_sb_edge : 2; /* VOPDQUANT::DQSBEDGE */ 10705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int dq_db_edge : 2; /* VOPDQUANT::DQDBEDGE */ 10715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int dq_binary_level : 1; /* VOPDQUANT::DQBILEVEL */ 10725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int alt_pic_quantizer : 5;/* VOPDQUANT::ALTPQUANT */ 10735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 10745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 10755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } pic_quantizer_fields; 10765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 10775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 10785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int variable_sized_transform_flag : 1;/* ENTRY_POINT_LAYER::VSTRANSFORM */ 10795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int mb_level_transform_type_flag : 1;/* PICTURE_LAYER::TTMBF */ 10805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int frame_level_transform_type : 2;/* PICTURE_LAYER::TTFRM */ 10815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int transform_ac_codingset_idx1 : 2;/* PICTURE_LAYER::TRANSACFRM */ 10825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int transform_ac_codingset_idx2 : 2;/* PICTURE_LAYER::TRANSACFRM2 */ 10835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int intra_transform_dc_table : 1;/* PICTURE_LAYER::TRANSDCTAB */ 10845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 10855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 10865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } transform_fields; 10875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAPictureParameterBufferVC1; 10885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* VC-1 Bitplane Buffer 10905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)There will be at most three bitplanes coded in any picture header. To send 10915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)the bitplane data more efficiently, each byte is divided in two nibbles, with 10925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)each nibble carrying three bitplanes for one macroblock. The following table 10935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)shows the bitplane data arrangement within each nibble based on the picture 10945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)type. 10955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)Picture Type Bit3 Bit2 Bit1 Bit0 10975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)I or BI OVERFLAGS ACPRED FIELDTX 10985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)P MYTYPEMB SKIPMB DIRECTMB 10995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)B FORWARDMB SKIPMB DIRECTMB 11005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 11015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)Within each byte, the lower nibble is for the first MB and the upper nibble is 11025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)for the second MB. E.g. the lower nibble of the first byte in the bitplane 11035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)buffer is for Macroblock #1 and the upper nibble of the first byte is for 11045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)Macroblock #2 in the first row. 11055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)*/ 11065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 11075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* VC-1 Slice Parameter Buffer */ 11085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VASliceParameterBufferVC1 11095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 11105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_size;/* number of bytes in the slice data buffer for this slice */ 11115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_offset;/* the offset to the first byte of slice data */ 11125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_flag; /* see VA_SLICE_DATA_FLAG_XXX defintions */ 11135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int macroblock_offset;/* the offset to the first bit of MB from the first byte of slice data */ 11145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_vertical_position; 11155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VASliceParameterBufferVC1; 11165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 11175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* VC-1 Slice Data Buffer */ 11185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 11195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)This is simplely a buffer containing raw bit-stream bytes 11205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)*/ 11215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 11225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/**************************** 11235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * H.264/AVC data structures 11245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ****************************/ 11255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 11265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAPictureH264 11275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 11285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID picture_id; 11295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int frame_idx; 11305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int flags; 11315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) signed int TopFieldOrderCnt; 11325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) signed int BottomFieldOrderCnt; 11335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAPictureH264; 11345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* flags in VAPictureH264 could be OR of the following */ 11355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_PICTURE_H264_INVALID 0x00000001 11365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_PICTURE_H264_TOP_FIELD 0x00000002 11375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_PICTURE_H264_BOTTOM_FIELD 0x00000004 11385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_PICTURE_H264_SHORT_TERM_REFERENCE 0x00000008 11395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_PICTURE_H264_LONG_TERM_REFERENCE 0x00000010 11405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 11415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* H.264 Picture Parameter Buffer */ 11425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 11435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * For each picture, and before any slice data, a single 11445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * picture parameter buffer must be send. 11455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 11465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAPictureParameterBufferH264 11475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 11485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAPictureH264 CurrPic; 11495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAPictureH264 ReferenceFrames[16]; /* in DPB */ 11505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short picture_width_in_mbs_minus1; 11515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short picture_height_in_mbs_minus1; 11525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char bit_depth_luma_minus8; 11535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char bit_depth_chroma_minus8; 11545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char num_ref_frames; 11555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 11565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 11575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int chroma_format_idc : 2; 11585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int residual_colour_transform_flag : 1; 11595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int gaps_in_frame_num_value_allowed_flag : 1; 11605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int frame_mbs_only_flag : 1; 11615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int mb_adaptive_frame_field_flag : 1; 11625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int direct_8x8_inference_flag : 1; 11635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int MinLumaBiPredSize8x8 : 1; /* see A.3.3.2 */ 11645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int log2_max_frame_num_minus4 : 4; 11655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int pic_order_cnt_type : 2; 11665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int log2_max_pic_order_cnt_lsb_minus4 : 4; 11675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int delta_pic_order_always_zero_flag : 1; 11685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 11695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 11705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } seq_fields; 11715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char num_slice_groups_minus1; 11725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char slice_group_map_type; 11735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short slice_group_change_rate_minus1; 11745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) signed char pic_init_qp_minus26; 11755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) signed char pic_init_qs_minus26; 11765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) signed char chroma_qp_index_offset; 11775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) signed char second_chroma_qp_index_offset; 11785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 11795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 11805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int entropy_coding_mode_flag : 1; 11815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int weighted_pred_flag : 1; 11825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int weighted_bipred_idc : 2; 11835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int transform_8x8_mode_flag : 1; 11845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int field_pic_flag : 1; 11855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int constrained_intra_pred_flag : 1; 11865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int pic_order_present_flag : 1; 11875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int deblocking_filter_control_present_flag : 1; 11885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int redundant_pic_cnt_present_flag : 1; 11895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int reference_pic_flag : 1; /* nal_ref_idc != 0 */ 11905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 11915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 11925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } pic_fields; 11935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short frame_num; 11945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAPictureParameterBufferH264; 11955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 11965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* H.264 Inverse Quantization Matrix Buffer */ 11975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAIQMatrixBufferH264 11985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 11995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char ScalingList4x4[6][16]; 12005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char ScalingList8x8[2][64]; 12015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAIQMatrixBufferH264; 12025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 12035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 12045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * H.264 Slice Group Map Buffer 12055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * When VAPictureParameterBufferH264::num_slice_group_minus1 is not equal to 0, 12065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * A slice group map buffer should be sent for each picture if required. The buffer 12075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * is sent only when there is a change in the mapping values. 12085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The slice group map buffer map "map units" to slice groups as specified in 12095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * section 8.2.2 of the H.264 spec. The buffer will contain one byte for each macroblock 12105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * in raster scan order 12115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 12125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 12135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* H.264 Slice Parameter Buffer */ 12145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VASliceParameterBufferH264 12155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 12165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_size;/* number of bytes in the slice data buffer for this slice */ 12175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** \brief Byte offset to the NAL Header Unit for this slice. */ 12185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_offset; 12195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_data_flag; /* see VA_SLICE_DATA_FLAG_XXX defintions */ 12205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /** 12215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * \brief Bit offset from NAL Header Unit to the begining of slice_data(). 12225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 12235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * This bit offset is relative to and includes the NAL unit byte 12245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * and represents the number of bits parsed in the slice_header() 12255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * after the removal of any emulation prevention bytes in 12265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * there. However, the slice data buffer passed to the hardware is 12275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * the original bitstream, thus including any emulation prevention 12285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * bytes. 12295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 12305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short slice_data_bit_offset; 12315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short first_mb_in_slice; 12325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char slice_type; 12335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char direct_spatial_mv_pred_flag; 12345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char num_ref_idx_l0_active_minus1; 12355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char num_ref_idx_l1_active_minus1; 12365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char cabac_init_idc; 12375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) char slice_qp_delta; 12385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char disable_deblocking_filter_idc; 12395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) char slice_alpha_c0_offset_div2; 12405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) char slice_beta_offset_div2; 12415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAPictureH264 RefPicList0[32]; /* See 8.2.4.2 */ 12425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAPictureH264 RefPicList1[32]; /* See 8.2.4.2 */ 12435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char luma_log2_weight_denom; 12445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char chroma_log2_weight_denom; 12455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char luma_weight_l0_flag; 12465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short luma_weight_l0[32]; 12475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short luma_offset_l0[32]; 12485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char chroma_weight_l0_flag; 12495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short chroma_weight_l0[32][2]; 12505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short chroma_offset_l0[32][2]; 12515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char luma_weight_l1_flag; 12525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short luma_weight_l1[32]; 12535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short luma_offset_l1[32]; 12545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char chroma_weight_l1_flag; 12555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short chroma_weight_l1[32][2]; 12565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short chroma_offset_l1[32][2]; 12575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VASliceParameterBufferH264; 12585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 12595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/**************************** 12605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Common encode data structures 12615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ****************************/ 12625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef enum 12635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 12645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncPictureTypeIntra = 0, 12655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncPictureTypePredictive = 1, 12665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncPictureTypeBidirectional = 2, 12675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncPictureType; 12685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 12695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* Encode Slice Parameter Buffer */ 12705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAEncSliceParameterBuffer 12715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 12725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int start_row_number; /* starting MB row number for this slice */ 12735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int slice_height; /* slice height measured in MB */ 12745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) union { 12755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct { 12765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int is_intra : 1; 12775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int disable_deblocking_filter_idc : 2; 12785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int uses_long_term_ref :1; 12795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int is_long_term_ref :1; 12805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } bits; 12815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int value; 12825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } slice_flags; 12835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncSliceParameterBuffer; 12845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 12855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/**************************** 12865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * H.264 specific encode data structures 12875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ****************************/ 12885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 12895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAEncSequenceParameterBufferH264 12905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 12915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char seq_parameter_set_id; 12925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char level_idc; 12935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int intra_period; 12945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int intra_idr_period; 12955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int max_num_ref_frames; 12965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int picture_width_in_mbs; 12975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int picture_height_in_mbs; 12985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int bits_per_second; 12995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int frame_rate; 13005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int initial_qp; 13015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int min_qp; 13025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int basic_unit_size; 13035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char vui_flag; 13045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncSequenceParameterBufferH264; 13055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 13065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define H264_LAST_PICTURE_EOSEQ 0x01 /* the last picture in the sequence */ 13075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define H264_LAST_PICTURE_EOSTREAM 0x02 /* the last picture in the stream */ 13085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAEncPictureParameterBufferH264 13095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 13105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID reference_picture; 13115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID reconstructed_picture; 13125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VABufferID coded_buf; 13135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short picture_width; 13145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short picture_height; 13155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char last_picture; 13165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncPictureParameterBufferH264; 13175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 13185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/**************************** 13195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * H.263 specific encode data structures 13205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ****************************/ 13215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 13225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAEncSequenceParameterBufferH263 13235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 13245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int intra_period; 13255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int bits_per_second; 13265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int frame_rate; 13275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int initial_qp; 13285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int min_qp; 13295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncSequenceParameterBufferH263; 13305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 13315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAEncPictureParameterBufferH263 13325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 13335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID reference_picture; 13345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID reconstructed_picture; 13355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VABufferID coded_buf; 13365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short picture_width; 13375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short picture_height; 13385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncPictureType picture_type; 13395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncPictureParameterBufferH263; 13405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 13415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/**************************** 13425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * MPEG-4 specific encode data structures 13435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ****************************/ 13445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 13455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAEncSequenceParameterBufferMPEG4 13465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 13475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char profile_and_level_indication; 13485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int intra_period; 13495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int video_object_layer_width; 13505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int video_object_layer_height; 13515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int vop_time_increment_resolution; 13525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int fixed_vop_rate; 13535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int fixed_vop_time_increment; 13545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int bits_per_second; 13555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int frame_rate; 13565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int initial_qp; 13575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int min_qp; 13585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncSequenceParameterBufferMPEG4; 13595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 13605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAEncPictureParameterBufferMPEG4 13615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 13625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID reference_picture; 13635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID reconstructed_picture; 13645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VABufferID coded_buf; 13655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short picture_width; 13665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short picture_height; 13675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int modulo_time_base; /* number of 1s */ 13685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int vop_time_increment; 13695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAEncPictureType picture_type; 13705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAEncPictureParameterBufferMPEG4; 13715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 13725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 13735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 13745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* Buffer functions */ 13755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 13765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 13775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Creates a buffer for "num_elements" elements of "size" bytes and 13785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * initalize with "data". 13795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * if "data" is null, then the contents of the buffer data store 13805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * are undefined. 13815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Basically there are two ways to get buffer data to the server side. One is 13825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * to call vaCreateBuffer() with a non-null "data", which results the data being 13835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * copied to the data store on the server side. A different method that 13845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * eliminates this copy is to pass null as "data" when calling vaCreateBuffer(), 13855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * and then use vaMapBuffer() to map the data store from the server side to the 13865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * client address space for access. 13875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Note: image buffers are created by the library, not the client. Please see 13885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaCreateImage on how image buffers are managed. 13895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 13905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaCreateBuffer ( 13915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 13925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAContextID context, 13935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VABufferType type, /* in */ 13945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int size, /* in */ 13955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int num_elements, /* in */ 13965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void *data, /* in */ 13975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VABufferID *buf_id /* out */ 13985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 13995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 14005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 14015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Convey to the server how many valid elements are in the buffer. 14025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * e.g. if multiple slice parameters are being held in a single buffer, 14035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * this will communicate to the server the number of slice parameters 14045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * that are valid in the buffer. 14055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 14065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaBufferSetNumElements ( 14075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 14085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VABufferID buf_id, /* in */ 14095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int num_elements /* in */ 14105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 14115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 14125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 14135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 14145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * device independent data structure for codedbuffer 14155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 14165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 14175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 14185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * FICTURE_AVE_QP(bit7-0): The average Qp value used during this frame 14195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * LARGE_SLICE(bit8):At least one slice in the current frame was large 14205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * enough for the encoder to attempt to limit its size. 14215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * SLICE_OVERFLOW(bit9): At least one slice in the current frame has 14225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * exceeded the maximum slice size specified. 14235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * BITRATE_OVERFLOW(bit10): The peak bitrate was exceeded for this frame. 14245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * BITRATE_HIGH(bit11): The frame size got within the safety margin of the maximum size (VCM only) 14255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * AIR_MB_OVER_THRESHOLD: the number of MBs adapted to Intra MB 14265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 14275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_CODED_BUF_STATUS_PICTURE_AVE_QP_MASK 0xff 14285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_CODED_BUF_STATUS_LARGE_SLICE_MASK 0x100 14295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_CODED_BUF_STATUS_SLICE_OVERFLOW_MASK 0x200 14305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_CODED_BUF_STATUS_BITRATE_OVERFLOW 0x400 14315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_CODED_BUF_STATUS_BITRATE_HIGH 0x800 14325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_CODED_BUF_STATUS_AIR_MB_OVER_THRESHOLD 0xff0000 14335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 14345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 14355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * device independent data structure for codedbuffer 14365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 14375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VACodedBufferSegment { 14385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int size;/* size of the data buffer in the coded buffer segment, in bytes */ 14395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int bit_offset; /* bit offset into the data buffer where valid bitstream data begins */ 14405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int status; /* status set by the driver on the coded buffer*/ 14415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int reserved; /* for future use */ 14425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void *buf; /* pointer to the beginning of the data buffer in the coded buffer segment */ 14435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void *next; /* pointer to the next VACodedBufferSegment */ 14445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VACodedBufferSegment; 14455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 14465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 14475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Map data store of the buffer into the client's address space 14485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaCreateBuffer() needs to be called with "data" set to NULL before 14495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * calling vaMapBuffer() 14505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 14515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * if buffer type is VAEncCodedBufferType, pbuf points to link-list of 14525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * VACodedBufferSegment, and the list is terminated if "next" is NULL 14535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 14545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaMapBuffer ( 14555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 14565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VABufferID buf_id, /* in */ 14575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void **pbuf /* out */ 14585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 14595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 14605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 14615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * After client making changes to a mapped data store, it needs to 14625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * "Unmap" it to let the server know that the data is ready to be 14635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * consumed by the server 14645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 14655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaUnmapBuffer ( 14665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 14675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VABufferID buf_id /* in */ 14685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 14695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 14705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 14715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * After this call, the buffer is deleted and this buffer_id is no longer valid 14725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Only call this if the buffer is not going to be passed to vaRenderBuffer 14735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 14745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaDestroyBuffer ( 14755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 14765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VABufferID buffer_id 14775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 14785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 14795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 14805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)Render (Decode) Pictures 14815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 14825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)A picture represents either a frame or a field. 14835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 14845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)The Begin/Render/End sequence sends the decode buffers to the server 14855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)*/ 14865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 14875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 14885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Get ready to decode a picture to a target surface 14895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 14905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaBeginPicture ( 14915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 14925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAContextID context, 14935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID render_target 14945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 14955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 14965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 14975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Send decode buffers to the server. 14985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Buffers are automatically destroyed afterwards 14995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 15005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaRenderPicture ( 15015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 15025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAContextID context, 15035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VABufferID *buffers, 15045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int num_buffers 15055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 15065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 15075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 15085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Make the end of rendering for a picture. 15095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The server should start processing all pending operations for this 15105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * surface. This call is non-blocking. The client can start another 15115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Begin/Render/End sequence on a different render target. 15125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 15135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaEndPicture ( 15145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 15155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAContextID context 15165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 15175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 15185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 15195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 15205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)Synchronization 15215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 15225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)*/ 15235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 15245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 15255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * This function blocks until all pending operations on the render target 15265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * have been completed. Upon return it is safe to use the render target for a 15275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * different picture. 15285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 15295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaSyncSurface ( 15305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 15315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID render_target 15325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 15335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 15345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef enum 15355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 15365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceRendering = 1, /* Rendering in progress */ 15375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceDisplaying = 2, /* Displaying in progress (not safe to render into it) */ 15385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* this status is useful if surface is used as the source */ 15395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* of an overlay */ 15405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceReady = 4, /* not being rendered or displayed */ 15415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceSkipped = 8 /* Indicate a skipped frame during encode */ 15425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VASurfaceStatus; 15435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 15445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 15455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Find out any pending ops on the render target 15465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 15475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaQuerySurfaceStatus ( 15485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 15495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID render_target, 15505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceStatus *status /* out */ 15515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 15525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 15535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef enum 15545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 15555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADecodeSliceMissing = 0, 15565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADecodeMBError = 1, 15575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VADecodeErrorType; 15585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 15595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 15605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Client calls vaQuerySurfaceError with VA_STATUS_ERROR_DECODING_ERROR, server side returns 15615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * an array of structure VASurfaceDecodeMBErrors, and the array is terminated by setting status=-1 15625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)*/ 15635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VASurfaceDecodeMBErrors 15645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 15655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int status; /* 1 if hardware has returned detailed info below, -1 means this record is invalid */ 15665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int start_mb; /* start mb address with errors */ 15675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int end_mb; /* end mb address with errors */ 15685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADecodeErrorType decode_error_type; 15695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VASurfaceDecodeMBErrors; 15705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 15715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 15725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * After the application gets VA_STATUS_ERROR_DECODING_ERROR after calling vaSyncSurface(), 15735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * it can call vaQuerySurfaceError to find out further details on the particular error. 15745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * VA_STATUS_ERROR_DECODING_ERROR should be passed in as "error_status", 15755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * upon the return, error_info will point to an array of _VASurfaceDecodeMBErrors structure, 15765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * which is allocated and filled by libVA with detailed information on the missing or error macroblocks. 15775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The array is terminated if "status==-1" is detected. 15785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 15795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaQuerySurfaceError( 15805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 15815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID surface, 15825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAStatus error_status, 15835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void **error_info 15845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 15855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 15865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 15875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Images and Subpictures 15885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * VAImage is used to either get the surface data to client memory, or 15895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * to copy image data in client memory to a surface. 15905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Both images, subpictures and surfaces follow the same 2D coordinate system where origin 15915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * is at the upper left corner with positive X to the right and positive Y down 15925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 15935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FOURCC(ch0, ch1, ch2, ch3) \ 15945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ((unsigned long)(unsigned char) (ch0) | ((unsigned long)(unsigned char) (ch1) << 8) | \ 15955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ((unsigned long)(unsigned char) (ch2) << 16) | ((unsigned long)(unsigned char) (ch3) << 24 )) 15965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 15975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* a few common FourCCs */ 15985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FOURCC_NV12 0x3231564E 15995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FOURCC_AI44 0x34344149 16005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FOURCC_RGBA 0x41424752 16015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FOURCC_BGRA 0x41524742 16025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FOURCC_UYVY 0x59565955 16035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FOURCC_YUY2 0x32595559 16045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FOURCC_AYUV 0x56555941 16055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FOURCC_NV11 0x3131564e 16065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FOURCC_YV12 0x32315659 16075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FOURCC_P208 0x38303250 16085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_FOURCC_IYUV 0x56555949 16095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 16105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* byte order */ 16115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_LSB_FIRST 1 16125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_MSB_FIRST 2 16135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 16145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAImageFormat 16155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 16165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int fourcc; 16175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int byte_order; /* VA_LSB_FIRST, VA_MSB_FIRST */ 16185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int bits_per_pixel; 16195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* for RGB formats */ 16205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int depth; /* significant bits per pixel */ 16215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int red_mask; 16225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int green_mask; 16235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int blue_mask; 16245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int alpha_mask; 16255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAImageFormat; 16265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 16275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef VAGenericID VAImageID; 16285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 16295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VAImage 16305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 16315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImageID image_id; /* uniquely identify this image */ 16325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImageFormat format; 16335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VABufferID buf; /* image data buffer */ 16345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 16355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Image data will be stored in a buffer of type VAImageBufferType to facilitate 16365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * data store on the server side for optimal performance. The buffer will be 16375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * created by the CreateImage function, and proper storage allocated based on the image 16385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * size and format. This buffer is managed by the library implementation, and 16395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * accessed by the client through the buffer Map/Unmap functions. 16405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 16415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short width; 16425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short height; 16435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int data_size; 16445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int num_planes; /* can not be greater than 3 */ 16455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 16465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * An array indicating the scanline pitch in bytes for each plane. 16475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Each plane may have a different pitch. Maximum 3 planes for planar formats 16485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 16495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int pitches[3]; 16505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 16515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * An array indicating the byte offset from the beginning of the image data 16525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * to the start of each plane. 16535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 16545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int offsets[3]; 16555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 16565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* The following fields are only needed for paletted formats */ 16575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int num_palette_entries; /* set to zero for non-palette images */ 16585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 16595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Each component is one byte and entry_bytes indicates the number of components in 16605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * each entry (eg. 3 for YUV palette entries). set to zero for non-palette images 16615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 16625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int entry_bytes; 16635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 16645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * An array of ascii characters describing the order of the components within the bytes. 16655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Only entry_bytes characters of the string are used. 16665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 16675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) char component_order[4]; 16685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VAImage; 16695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 16705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* Get maximum number of image formats supported by the implementation */ 16715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)int vaMaxNumImageFormats ( 16725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy 16735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 16745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 16755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 16765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Query supported image formats 16775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The caller must provide a "format_list" array that can hold at 16785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * least vaMaxNumImageFormats() entries. The actual number of formats 16795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * returned in "format_list" is returned in "num_formats". 16805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 16815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaQueryImageFormats ( 16825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 16835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImageFormat *format_list, /* out */ 16845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int *num_formats /* out */ 16855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 16865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 16875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 16885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Create a VAImage structure 16895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The width and height fields returned in the VAImage structure may get 16905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * enlarged for some YUV formats. Upon return from this function, 16915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * image->buf has been created and proper storage allocated by the library. 16925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The client can access the image through the Map/Unmap calls. 16935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 16945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaCreateImage ( 16955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 16965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImageFormat *format, 16975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int width, 16985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int height, 16995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImage *image /* out */ 17005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 17015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 17025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 17035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Should call DestroyImage before destroying the surface it is bound to 17045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 17055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaDestroyImage ( 17065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 17075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImageID image 17085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 17095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 17105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaSetImagePalette ( 17115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 17125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImageID image, 17135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 17145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * pointer to an array holding the palette data. The size of the array is 17155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * num_palette_entries * entry_bytes in size. The order of the components 17165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * in the palette is described by the component_order in VAImage struct 17175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 17185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned char *palette 17195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 17205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 17215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 17225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Retrive surface data into a VAImage 17235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Image must be in a format supported by the implementation 17245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 17255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaGetImage ( 17265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 17275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID surface, 17285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int x, /* coordinates of the upper left source pixel */ 17295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int y, 17305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int width, /* width and height of the region */ 17315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int height, 17325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImageID image 17335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 17345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 17355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 17365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Copy data from a VAImage to a surface 17375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Image must be in a format supported by the implementation 17385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Returns a VA_STATUS_ERROR_SURFACE_BUSY if the surface 17395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * shouldn't be rendered into when this is called 17405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 17415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaPutImage ( 17425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 17435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID surface, 17445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImageID image, 17455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int src_x, 17465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int src_y, 17475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int src_width, 17485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int src_height, 17495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int dest_x, 17505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int dest_y, 17515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int dest_width, 17525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int dest_height 17535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 17545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 17555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 17565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Derive an VAImage from an existing surface. 17575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * This interface will derive a VAImage and corresponding image buffer from 17585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * an existing VA Surface. The image buffer can then be mapped/unmapped for 17595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * direct CPU access. This operation is only possible on implementations with 17605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * direct rendering capabilities and internal surface formats that can be 17615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * represented with a VAImage. When the operation is not possible this interface 17625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * will return VA_STATUS_ERROR_OPERATION_FAILED. Clients should then fall back 17635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * to using vaCreateImage + vaPutImage to accomplish the same task in an 17645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * indirect manner. 17655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 17665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Implementations should only return success when the resulting image buffer 17675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * would be useable with vaMap/Unmap. 17685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 17695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * When directly accessing a surface special care must be taken to insure 17705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * proper synchronization with the graphics hardware. Clients should call 17715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaQuerySurfaceStatus to insure that a surface is not the target of concurrent 17725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * rendering or currently being displayed by an overlay. 17735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 17745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Additionally nothing about the contents of a surface should be assumed 17755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * following a vaPutSurface. Implementations are free to modify the surface for 17765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * scaling or subpicture blending within a call to vaPutImage. 17775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 17785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Calls to vaPutImage or vaGetImage using the same surface from which the image 17795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * has been derived will return VA_STATUS_ERROR_SURFACE_BUSY. vaPutImage or 17805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaGetImage with other surfaces is supported. 17815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 17825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * An image created with vaDeriveImage should be freed with vaDestroyImage. The 17835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * image and image buffer structures will be destroyed; however, the underlying 17845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * surface will remain unchanged until freed with vaDestroySurfaces. 17855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 17865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaDeriveImage ( 17875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 17885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID surface, 17895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImage *image /* out */ 17905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 17915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 17925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 17935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Subpictures 17945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Subpicture is a special type of image that can be blended 17955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * with a surface during vaPutSurface(). Subpicture can be used to render 17965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * DVD sub-titles or closed captioning text etc. 17975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 17985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 17995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef VAGenericID VASubpictureID; 18005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 18015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* Get maximum number of subpicture formats supported by the implementation */ 18025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)int vaMaxNumSubpictureFormats ( 18035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy 18045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 18055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 18065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* flags for subpictures */ 18075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_SUBPICTURE_CHROMA_KEYING 0x0001 18085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_SUBPICTURE_GLOBAL_ALPHA 0x0002 18095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_SUBPICTURE_DESTINATION_IS_SCREEN_COORD 0x0004 18105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 18115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Query supported subpicture formats 18125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The caller must provide a "format_list" array that can hold at 18135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * least vaMaxNumSubpictureFormats() entries. The flags arrary holds the flag 18145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * for each format to indicate additional capabilities for that format. The actual 18155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * number of formats returned in "format_list" is returned in "num_formats". 18165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * flags: returned value to indicate addtional capabilities 18175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * VA_SUBPICTURE_CHROMA_KEYING - supports chroma-keying 18185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * VA_SUBPICTURE_GLOBAL_ALPHA - supports global alpha 18195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * VA_SUBPICTURE_DESTINATION_IS_SCREEN_COORD - supports unscaled screen relative subpictures for On Screen Display 18205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 18215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 18225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaQuerySubpictureFormats ( 18235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 18245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImageFormat *format_list, /* out */ 18255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int *flags, /* out */ 18265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int *num_formats /* out */ 18275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 18285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 18295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 18305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Subpictures are created with an image associated. 18315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 18325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaCreateSubpicture ( 18335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 18345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImageID image, 18355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASubpictureID *subpicture /* out */ 18365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 18375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 18385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 18395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Destroy the subpicture before destroying the image it is assocated to 18405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 18415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaDestroySubpicture ( 18425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 18435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASubpictureID subpicture 18445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 18455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 18465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 18475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Bind an image to the subpicture. This image will now be associated with 18485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * the subpicture instead of the one at creation. 18495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 18505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaSetSubpictureImage ( 18515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 18525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASubpictureID subpicture, 18535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VAImageID image 18545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 18555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 18565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 18575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * If chromakey is enabled, then the area where the source value falls within 18585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * the chromakey [min, max] range is transparent 18595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The chromakey component format is the following: 18605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * For RGB: [0:7] Red [8:15] Blue [16:23] Green 18615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * For YUV: [0:7] V [8:15] U [16:23] Y 18625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The chromakey mask can be used to mask out certain components for chromakey 18635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * comparision 18645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 18655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaSetSubpictureChromakey ( 18665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 18675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASubpictureID subpicture, 18685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int chromakey_min, 18695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int chromakey_max, 18705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int chromakey_mask 18715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 18725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 18735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 18745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Global alpha value is between 0 and 1. A value of 1 means fully opaque and 18755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * a value of 0 means fully transparent. If per-pixel alpha is also specified then 18765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * the overall alpha is per-pixel alpha multiplied by the global alpha 18775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 18785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaSetSubpictureGlobalAlpha ( 18795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 18805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASubpictureID subpicture, 18815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) float global_alpha 18825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 18835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 18845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 18855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaAssociateSubpicture associates the subpicture with target_surfaces. 18865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * It defines the region mapping between the subpicture and the target 18875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * surfaces through source and destination rectangles (with the same width and height). 18885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Both will be displayed at the next call to vaPutSurface. Additional 18895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * associations before the call to vaPutSurface simply overrides the association. 18905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 18915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaAssociateSubpicture ( 18925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 18935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASubpictureID subpicture, 18945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID *target_surfaces, 18955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int num_surfaces, 18965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short src_x, /* upper left offset in subpicture */ 18975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short src_y, 18985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short src_width, 18995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short src_height, 19005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short dest_x, /* upper left offset in surface */ 19015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short dest_y, 19025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short dest_width, 19035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short dest_height, 19045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 19055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * whether to enable chroma-keying, global-alpha, or screen relative mode 19065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * see VA_SUBPICTURE_XXX values 19075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 19085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int flags 19095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 19105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 19115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 19125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * vaDeassociateSubpicture removes the association of the subpicture with target_surfaces. 19135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 19145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaDeassociateSubpicture ( 19155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 19165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASubpictureID subpicture, 19175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VASurfaceID *target_surfaces, 19185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int num_surfaces 19195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 19205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 19215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VARectangle 19225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 19235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short x; 19245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) short y; 19255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short width; 19265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned short height; 19275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VARectangle; 19285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 19295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 19305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Display attributes 19315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Display attributes are used to control things such as contrast, hue, saturation, 19325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * brightness etc. in the rendering process. The application can query what 19335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * attributes are supported by the driver, and then set the appropriate attributes 19345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * before calling vaPutSurface() 19355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 19365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* PowerVR IEP Lite attributes */ 19375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef enum 19385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 19395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADISPLAYATTRIB_BLE_OFF = 0x00, 19405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADISPLAYATTRIB_BLE_LOW, 19415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADISPLAYATTRIB_BLE_MEDIUM, 19425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADISPLAYATTRIB_BLE_HIGH, 19435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADISPLAYATTRIB_BLE_NONE, 19445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VADisplayAttribBLEMode; 19455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 19465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* attribute value for VADisplayAttribRotation */ 19475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_ROTATION_NONE 0x00000000 19485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_ROTATION_90 0x00000001 19495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_ROTATION_180 0x00000002 19505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_ROTATION_270 0x00000003 19515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 19525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* attribute value for VADisplayAttribOutOfLoopDeblock */ 19535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_OOL_DEBLOCKING_FALSE 0x00000000 19545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_OOL_DEBLOCKING_TRUE 0x00000001 19555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 19565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* Render mode */ 19575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RENDER_MODE_UNDEFINED 0 19585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RENDER_MODE_LOCAL_OVERLAY 1 19595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RENDER_MODE_LOCAL_GPU 2 19605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RENDER_MODE_EXTERNAL_OVERLAY 4 19615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RENDER_MODE_EXTERNAL_GPU 8 19625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 19635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* Render device */ 19645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RENDER_DEVICE_UNDEFINED 0 19655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RENDER_DEVICE_LOCAL 1 19665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_RENDER_DEVICE_EXTERNAL 2 19675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 19685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* Currently defined display attribute types */ 19695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef enum 19705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 19715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribBrightness = 0, 19725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribContrast = 1, 19735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribHue = 2, 19745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribSaturation = 3, 19755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* client can specifiy a background color for the target window 19765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * the new feature of video conference, 19775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * the uncovered area of the surface is filled by this color 19785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * also it will blend with the decoded video color 19795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 19805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribBackgroundColor = 4, 19815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 19825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * this is a gettable only attribute. For some implementations that use the 19835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * hardware overlay, after PutSurface is called, the surface can not be 19845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * re-used until after the subsequent PutSurface call. If this is the case 19855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * then the value for this attribute will be set to 1 so that the client 19865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * will not attempt to re-use the surface right after returning from a call 19875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * to PutSurface. 19885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 19895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Don't use it, use flag VASurfaceDisplaying of vaQuerySurfaceStatus since 19905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * driver may use overlay or GPU alternatively 19915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 19925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribDirectSurface = 5, 19935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribRotation = 6, 19945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribOutofLoopDeblock = 7, 19955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 19965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* PowerVR IEP Lite specific attributes */ 19975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribBLEBlackMode = 8, 19985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribBLEWhiteMode = 9, 19995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribBlueStretch = 10, 20005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribSkinColorCorrection = 11, 20015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 20025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * For type VADisplayAttribCSCMatrix, "value" field is a pointer to the color 20035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * conversion matrix. Each element in the matrix is float-point 20045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 20055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribCSCMatrix = 12, 20065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* specify the constant color used to blend with video surface 20075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Cd = Cv*Cc*Ac + Cb *(1 - Ac) C means the constant RGB 20085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * d: the final color to overwrite into the frame buffer 20095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * v: decoded video after color conversion, 20105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * c: video color specified by VADisplayAttribBlendColor 20115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * b: background color of the drawable 20125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 20135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribBlendColor = 13, 20145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 20155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Indicate driver to skip painting color key or not. 20165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * only applicable if the render is overlay 20175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 20185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribOverlayAutoPaintColorKey = 14, 20195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 20205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * customized overlay color key, the format is RGB888 20215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * [23:16] = Red, [15:08] = Green, [07:00] = Blue. 20225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 20235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribOverlayColorKey = 15, 20245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 20255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The hint for the implementation of vaPutSurface 20265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * normally, the driver could use an overlay or GPU to render the surface on the screen 20275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * this flag provides APP the flexibity to switch the render dynamically 20285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 20295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribRenderMode = 16, 20305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 20315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * specify if vaPutSurface needs to render into specified monitors 20325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * one example is that one external monitor (e.g. HDMI) is enabled, 20335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * but the window manager is not aware of it, and there is no associated drawable 20345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 20355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribRenderDevice = 17, 20365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 20375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * specify vaPutSurface render area if there is no drawable on the monitor 20385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 20395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribRenderRect = 18, 20405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VADisplayAttribType; 20415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 20425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* flags for VADisplayAttribute */ 20435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_DISPLAY_ATTRIB_NOT_SUPPORTED 0x0000 20445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_DISPLAY_ATTRIB_GETTABLE 0x0001 20455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define VA_DISPLAY_ATTRIB_SETTABLE 0x0002 20465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 20475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef struct _VADisplayAttribute 20485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 20495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribType type; 20505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int min_value; 20515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int max_value; 20525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int value; /* used by the set/get attribute functions */ 20535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* flags can be VA_DISPLAY_ATTRIB_GETTABLE or VA_DISPLAY_ATTRIB_SETTABLE or OR'd together */ 20545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) unsigned int flags; 20555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} VADisplayAttribute; 20565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 20575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* Get maximum number of display attributs supported by the implementation */ 20585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)int vaMaxNumDisplayAttributes ( 20595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy 20605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 20615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 20625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 20635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Query display attributes 20645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * The caller must provide a "attr_list" array that can hold at 20655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * least vaMaxNumDisplayAttributes() entries. The actual number of attributes 20665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * returned in "attr_list" is returned in "num_attributes". 20675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 20685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaQueryDisplayAttributes ( 20695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 20705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribute *attr_list, /* out */ 20715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int *num_attributes /* out */ 20725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 20735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 20745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 20755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Get display attributes 20765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * This function returns the current attribute values in "attr_list". 20775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Only attributes returned with VA_DISPLAY_ATTRIB_GETTABLE set in the "flags" field 20785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * from vaQueryDisplayAttributes() can have their values retrieved. 20795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 20805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaGetDisplayAttributes ( 20815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 20825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribute *attr_list, /* in/out */ 20835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int num_attributes 20845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 20855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 20865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 20875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Set display attributes 20885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Only attributes returned with VA_DISPLAY_ATTRIB_SETTABLE set in the "flags" field 20895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * from vaQueryDisplayAttributes() can be set. If the attribute is not settable or 20905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * the value is out of range, the function returns VA_STATUS_ERROR_ATTR_NOT_SUPPORTED 20915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 20925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)VAStatus vaSetDisplayAttributes ( 20935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplay dpy, 20945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VADisplayAttribute *attr_list, 20955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int num_attributes 20965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)); 20975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 20985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifdef __cplusplus 20995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 21005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif 21015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 21025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif /* _VA_H_ */ 2103