FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
Files | Data Structures | Macros | Typedefs | Functions
VDPAU Decoder and Renderer
Hardware Accelerators bridge

VDPAU hardware acceleration has two modules. More...

Files

file  vdpau.h
 Public libavcodec VDPAU header.
 

Data Structures

union  AVVDPAUPictureInfo
 
struct  AVVDPAUContext
 This structure is used to share data between the libavcodec library and the client video application. More...
 
struct  vdpau_render_state
 This structure is used as a callback between the FFmpeg decoder (vd_) and presentation (vo_) module. More...
 

Macros

#define FF_VDPAU_STATE_USED_FOR_RENDER   1
 The videoSurface is used for rendering.
 
#define FF_VDPAU_STATE_USED_FOR_REFERENCE   2
 The videoSurface is needed for reference/prediction.
 

Typedefs

typedef int(* AVVDPAU_Render2 )(struct AVCodecContext *, struct AVFrame *, const VdpPictureInfo *, uint32_t, const VdpBitstreamBuffer *)
 

Functions

AVVDPAUContextav_alloc_vdpaucontext (void)
 allocation function for AVVDPAUContext
 
AVVDPAU_Render2 av_vdpau_hwaccel_get_render2 (const AVVDPAUContext *)
 
void av_vdpau_hwaccel_set_render2 (AVVDPAUContext *, AVVDPAU_Render2)
 
int av_vdpau_bind_context (AVCodecContext *avctx, VdpDevice device, VdpGetProcAddress *get_proc_address, unsigned flags)
 Associate a VDPAU device with a codec context for hardware acceleration.
 
int av_vdpau_get_surface_parameters (AVCodecContext *avctx, VdpChromaType *type, uint32_t *width, uint32_t *height)
 Gets the parameters to create an adequate VDPAU video surface for the codec context using VDPAU hardware decoding acceleration.
 
AVVDPAUContextav_vdpau_alloc_context (void)
 Allocate an AVVDPAUContext.
 
int av_vdpau_get_profile (AVCodecContext *avctx, VdpDecoderProfile *profile)
 Get a decoder profile that should be used for initializing a VDPAU decoder.
 

Detailed Description

VDPAU hardware acceleration has two modules.

The VDPAU decoding module parses all headers using FFmpeg parsing mechanisms and uses VDPAU for the actual decoding.

As per the current implementation, the actual decoding and rendering (API calls) are done as part of the VDPAU presentation (vo_vdpau.c) module.

Macro Definition Documentation

#define FF_VDPAU_STATE_USED_FOR_RENDER   1

The videoSurface is used for rendering.

Definition at line 214 of file vdpau.h.

#define FF_VDPAU_STATE_USED_FOR_REFERENCE   2

The videoSurface is needed for reference/prediction.

The codec manipulates this.

Definition at line 220 of file vdpau.h.

Typedef Documentation

typedef int(* AVVDPAU_Render2)(struct AVCodecContext *, struct AVFrame *, const VdpPictureInfo *, uint32_t, const VdpBitstreamBuffer *)

Definition at line 72 of file vdpau.h.

Function Documentation

AVVDPAUContext* av_alloc_vdpaucontext ( void  )

allocation function for AVVDPAUContext

Allows extending the struct without breaking API/ABI

Definition at line 67 of file vdpau.c.

AVVDPAU_Render2 av_vdpau_hwaccel_get_render2 ( const AVVDPAUContext )
void av_vdpau_hwaccel_set_render2 ( AVVDPAUContext ,
AVVDPAU_Render2   
)
int av_vdpau_bind_context ( AVCodecContext avctx,
VdpDevice  device,
VdpGetProcAddress *  get_proc_address,
unsigned  flags 
)

Associate a VDPAU device with a codec context for hardware acceleration.

This function is meant to be called from the get_format() codec callback, or earlier. It can also be called after avcodec_flush_buffers() to change the underlying VDPAU device mid-stream (e.g. to recover from non-transparent display preemption).

Note
get_format() must return AV_PIX_FMT_VDPAU if this function completes successfully.
Parameters
avctxdecoding context whose get_format() callback is invoked
deviceVDPAU device handle to use for hardware acceleration
get_proc_addressVDPAU device driver
flagszero of more OR'd AV_HWACCEL_FLAG_* flags
Returns
0 on success, an AVERROR code on failure.

Definition at line 747 of file vdpau.c.

Referenced by vdpau_alloc().

int av_vdpau_get_surface_parameters ( AVCodecContext avctx,
VdpChromaType *  type,
uint32_t *  width,
uint32_t *  height 
)

Gets the parameters to create an adequate VDPAU video surface for the codec context using VDPAU hardware decoding acceleration.

Note
Behavior is undefined if the context was not successfully bound to a VDPAU device using av_vdpau_bind_context().
Parameters
avctxthe codec context being used for decoding the stream
typestorage space for the VDPAU video surface chroma type (or NULL to ignore)
widthstorage space for the VDPAU video surface pixel width (or NULL to ignore)
heightstorage space for the VDPAU video surface pixel height (or NULL to ignore)
Returns
0 on success, a negative AVERROR code on failure.

Definition at line 74 of file vdpau.c.

Referenced by ff_vdpau_common_init(), and vdpau_get_buffer().

AVVDPAUContext* av_vdpau_alloc_context ( void  )

Allocate an AVVDPAUContext.

Returns
Newly-allocated AVVDPAUContext or NULL on failure.

Definition at line 742 of file vdpau.c.

Referenced by av_alloc_vdpaucontext(), and vdpau_alloc().

int av_vdpau_get_profile ( AVCodecContext avctx,
VdpDecoderProfile *  profile 
)

Get a decoder profile that should be used for initializing a VDPAU decoder.

Should be called from the AVCodecContext.get_format() callback.

Parameters
avctxthe codec context being used for decoding the stream
profilea pointer into which the result will be written on success. The contents of profile are undefined if this function returns an error.
Returns
0 on success (non-negative), a negative AVERROR on failure.

Definition at line 695 of file vdpau.c.

Referenced by vdpau_old_init().