VDPAU Generated by Doxygen 1.8.11 Contents 1 Video Decode and Presentation API for Unix1 1.1 Introduction .............................................. 1 1.2 API Partitioning ............................................ 1 1.3 Object Types.............................................. 1 1.3.1 Device Type.......................................... 2 1.3.2 Surface Types......................................... 2 1.3.3 Transfer Types ........................................ 2 1.4 Data Flow............................................... 2 1.5 Entry Point Retrieval.......................................... 3 1.5.1 Philosophy .......................................... 3 1.6 Multi-threading............................................. 3 1.7 Surface Endianness.......................................... 4 1.8 Video Decoder Usage......................................... 5 1.8.1 MPEG-1 and MPEG-2 .................................... 5 1.8.2 H.264............................................. 5 1.8.3 VC-1 Simple and Main Profile ................................ 6 1.8.4 VC-1 Advanced Profile.................................... 6 1.8.5 MPEG-4 Part 2 and DivX................................... 6 1.8.6 H.265/HEVC - High Efficiency Video Codec......................... 6 1.9 Video Mixer Usage .......................................... 7 1.9.1 VdpVideoSurface Content .................................. 7 1.9.2 VdpVideoMixer Surface List ................................. 7 1.9.3 Weave De-interlacing..................................... 8 1.9.4 Bob De-interlacing ...................................... 9 1.9.5 Advanced De-interlacing................................... 9 1.9.6 De-interlacing Rate...................................... 9 1.9.7 Inverse Telecine........................................ 10 1.9.8 Telecine (Pull-Down) Flags.................................. 10 1.10 Extending the API........................................... 10 1.10.1 Enumerations and Other Constants ............................. 10 1.10.2 Structures........................................... 11 1.10.3 Functions........................................... 11 1.11 Display Preemption.......................................... 11 1.11.1 Trademarks.......................................... 11 iv CONTENTS 2 Module Index 13 2.1 Modules................................................ 13 3 Data Structure Index 15 3.1 Data Structures............................................ 15 4 File Index 17 4.1 File List ................................................ 17 5 Module Documentation 19 5.1 Core API................................................ 20 5.1.1 Detailed Description ..................................... 21 5.2 Basic Types.............................................. 22 5.2.1 Detailed Description ..................................... 22 5.2.2 Macro Definition Documentation............................... 22 5.2.2.1 VDP_FALSE.................................... 22 5.2.2.2 VDP_TRUE .................................... 22 5.2.3 Typedef Documentation.................................... 22 5.2.3.1 VdpBool ...................................... 22 5.3 Miscellaneous Types ......................................... 23 5.3.1 Detailed Description ..................................... 24 5.3.2 Macro Definition Documentation............................... 24 5.3.2.1 VDP_CHROMA_TYPE_420............................ 24 5.3.2.2 VDP_CHROMA_TYPE_422............................ 24 5.3.2.3 VDP_CHROMA_TYPE_444............................ 24 5.3.2.4 VDP_INDEXED_FORMAT_A4I4 ......................... 24 5.3.2.5 VDP_INDEXED_FORMAT_A8I8 ......................... 25 5.3.2.6 VDP_INDEXED_FORMAT_I4A4 ......................... 25 5.3.2.7 VDP_INDEXED_FORMAT_I8A8 ......................... 25 5.3.2.8 VDP_INVALID_HANDLE ............................. 25 5.3.2.9 VDP_RGBA_FORMAT_A8 ............................ 25 5.3.2.10 VDP_RGBA_FORMAT_B10G10R10A2...................... 26 Generated by Doxygen CONTENTS v 5.3.2.11 VDP_RGBA_FORMAT_B8G8R8A8........................ 26 5.3.2.12 VDP_RGBA_FORMAT_R10G10B10A2...................... 26 5.3.2.13 VDP_RGBA_FORMAT_R8G8B8A8........................ 26 5.3.2.14 VDP_YCBCR_FORMAT_NV12.......................... 26 5.3.2.15 VDP_YCBCR_FORMAT_UYVY.......................... 27 5.3.2.16 VDP_YCBCR_FORMAT_V8U8Y8A8....................... 27 5.3.2.17 VDP_YCBCR_FORMAT_Y8U8V8A8....................... 27 5.3.2.18 VDP_YCBCR_FORMAT_YUYV.......................... 27 5.3.2.19 VDP_YCBCR_FORMAT_YV12.......................... 27 5.3.3 Typedef Documentation.................................... 28 5.3.3.1 VdpChromaType.................................. 28 5.3.3.2 VdpIndexedFormat................................. 28 5.3.3.3 VdpRGBAFormat ................................. 28 5.3.3.4 VdpYCbCrFormat ................................. 28 5.4 Error Handling............................................. 29 5.4.1 Detailed Description ..................................... 29 5.4.2 Typedef Documentation.................................... 29 5.4.2.1 VdpGetErrorString................................. 29 5.4.3 Enumeration Type Documentation.............................. 30 5.4.3.1 VdpStatus ..................................... 30 5.5 Versioning............................................... 32 5.5.1 Detailed Description ..................................... 32 5.5.2 Macro Definition Documentation............................... 32 5.5.2.1 VDPAU_INTERFACE_VERSION......................... 32 5.5.2.2 VDPAU_VERSION................................. 33 5.5.3 Typedef Documentation.................................... 33 5.5.3.1 VdpGetApiVersion................................. 33 5.5.3.2 VdpGetInformationString ............................. 33 5.6 VdpDevice; Primary API object.................................... 34 5.6.1 Detailed Description ..................................... 34 Generated by Doxygen vi CONTENTS 5.6.2 Typedef Documentation.................................... 34 5.6.2.1 VdpDevice..................................... 34 5.6.2.2 VdpDeviceDestroy................................. 34 5.7 VdpCSCMatrix; CSC Matrix Manipulation............................... 35 5.7.1 Detailed Description ..................................... 35 5.7.2 Macro Definition Documentation............................... 36 5.7.2.1 VDP_COLOR_STANDARD_ITUR_BT_601.................... 36 5.7.2.2 VDP_COLOR_STANDARD_ITUR_BT_709.................... 36 5.7.2.3 VDP_COLOR_STANDARD_SMPTE_240M.................... 36 5.7.2.4 VDP_PROCAMP_VERSION ........................... 36 5.7.3 Typedef Documentation.................................... 36 5.7.3.1 VdpColorStandard................................. 36 5.7.3.2 VdpCSCMatrix................................... 36 5.7.3.3 VdpGenerateCSCMatrix.............................. 36 5.8 VdpVideoSurface; Video Surface object ............................... 38 5.8.1 Detailed Description ..................................... 38 5.8.2 Typedef Documentation.................................... 39 5.8.2.1 VdpVideoSurface ................................. 39 5.8.2.2 VdpVideoSurfaceCreate.............................. 39 5.8.2.3 VdpVideoSurfaceDestroy ............................. 40 5.8.2.4 VdpVideoSurfaceGetBitsYCbCr.......................... 40 5.8.2.5 VdpVideoSurfaceGetParameters ......................... 40 5.8.2.6 VdpVideoSurfacePutBitsYCbCr.......................... 41 5.8.2.7 VdpVideoSurfaceQueryCapabilities........................ 41 5.8.2.8 VdpVideoSurfaceQueryGetPutBitsYCbCrCapabilities............... 42 5.9 VdpOutputSurface; Output Surfaceobject............................... 43 5.9.1 Detailed Description ..................................... 44 5.9.2 Macro Definition Documentation............................... 44 5.9.2.1 VDP_COLOR_TABLE_FORMAT_B8G8R8X8 .................. 44 5.9.3 Typedef Documentation.................................... 44 Generated by Doxygen CONTENTS vii 5.9.3.1 VdpColorTableFormat............................... 44 5.9.3.2 VdpOutputSurface................................. 45 5.9.3.3 VdpOutputSurfaceCreate ............................. 45 5.9.3.4 VdpOutputSurfaceDestroy............................. 45 5.9.3.5 VdpOutputSurfaceGetBitsNative.......................... 45 5.9.3.6 VdpOutputSurfaceGetParameters......................... 46 5.9.3.7 VdpOutputSurfacePutBitsIndexed......................... 46 5.9.3.8 VdpOutputSurfacePutBitsNative.......................... 47 5.9.3.9 VdpOutputSurfacePutBitsYCbCr ......................... 47 5.9.3.10 VdpOutputSurfaceQueryCapabilities ....................... 48 5.9.3.11 VdpOutputSurfaceQueryGetPutBitsNativeCapabilities .............. 48 5.9.3.12 VdpOutputSurfaceQueryPutBitsIndexedCapabilities ............... 48 5.9.3.13 VdpOutputSurfaceQueryPutBitsYCbCrCapabilities................ 49 5.10 VdpBitmapSurface; Bitmap Surfaceobject .............................. 50 5.10.1 Detailed Description ..................................... 50 5.10.2 Typedef Documentation.................................... 51 5.10.2.1 VdpBitmapSurface................................. 51 5.10.2.2 VdpBitmapSurfaceCreate ............................. 51 5.10.2.3 VdpBitmapSurfaceDestroy............................. 51 5.10.2.4 VdpBitmapSurfaceGetParameters......................... 51 5.10.2.5 VdpBitmapSurfacePutBitsNative.......................... 52 5.10.2.6 VdpBitmapSurfaceQueryCapabilities ....................... 52 5.11 VdpOutputSurface Rendering Functionality.............................. 54 5.11.1 Detailed Description ..................................... 55 5.11.2 Macro Definition Documentation..............................