xvmc_pix_fmt Struct Reference

#include <xvmc.h>

Data Fields
int	xvmc_id
	The field contains the special constant value AV_XVMC_ID.
short *	data_blocks
	Pointer to the block array allocated by XvMCCreateBlocks().
XvMCMacroBlock *	mv_blocks
	Pointer to the macroblock description array allocated by XvMCCreateMacroBlocks() and freed by XvMCDestroyMacroBlocks().
int	allocated_mv_blocks
	Number of macroblock descriptions that can be stored in the mv_blocks array.
int	allocated_data_blocks
	Number of blocks that can be stored at once in the data_blocks array.
int	idct
	Indicate that the hardware would interpret data_blocks as IDCT coefficients and perform IDCT on them.
int	unsigned_intra
	In MoCo mode it indicates that intra macroblocks are assumed to be in unsigned format; same as the XVMC_INTRA_UNSIGNED flag.
XvMCSurface *	p_surface
	Pointer to the surface allocated by XvMCCreateSurface().
XvMCSurface *	p_past_surface
	Set by the decoder before calling ff_draw_horiz_band(), needed by the XvMCRenderSurface function.
XvMCSurface *	p_future_surface
	Pointer to the surface used as future reference application - unchanged libavcodec - set.
unsigned int	picture_structure
	top/bottom field or frame application - unchanged libavcodec - set
unsigned int	flags
	XVMC_SECOND_FIELD - 1st or 2nd field in the sequence application - unchanged libavcodec - set.
int	start_mv_blocks_num
	Number of macroblock descriptions in the mv_blocks array that have already been passed to the hardware.
int	filled_mv_blocks_num
	Number of new macroblock descriptions in the mv_blocks array (after start_mv_blocks_num) that are filled by libavcodec and have to be passed to the hardware.
int	next_free_data_block_num
	Number of the the next free data block; one data block consists of 64 short values in the data_blocks array.

---

Detailed Description

Definition at line 31 of file xvmc.h.

---

Field Documentation

int xvmc_pix_fmt::allocated_data_blocks

Number of blocks that can be stored at once in the data_blocks array.

• application - set during initialization
• libavcodec - unchanged

Definition at line 67 of file xvmc.h.

Referenced by ff_xvmc_decode_mb(), and ff_xvmc_field_start().

int xvmc_pix_fmt::allocated_mv_blocks

Number of macroblock descriptions that can be stored in the mv_blocks array.

• application - set during initialization
• libavcodec - unchanged

Definition at line 61 of file xvmc.h.

Referenced by ff_xvmc_decode_mb(), and ff_xvmc_field_start().

short* xvmc_pix_fmt::data_blocks

Pointer to the block array allocated by XvMCCreateBlocks().

The array has to be freed by XvMCDestroyBlocks(). Each group of 64 values represents one data block of differential pixel information (in MoCo mode) or coefficients for IDCT.

• application - set the pointer during initialization
• libavcodec - fills coefficients/pixel data into the array

Definition at line 47 of file xvmc.h.

Referenced by ff_xvmc_decode_mb(), ff_xvmc_field_start(), and ff_xvmc_init_block().

int xvmc_pix_fmt::filled_mv_blocks_num

Number of new macroblock descriptions in the mv_blocks array (after start_mv_blocks_num) that are filled by libavcodec and have to be passed to the hardware.

• application - zeroes it on get_buffer() or after successful ff_draw_horiz_band().
• libavcodec - increment with one of each stored MB

Definition at line 135 of file xvmc.h.

Referenced by ff_xvmc_decode_mb(), ff_xvmc_field_end(), and ff_xvmc_field_start().

unsigned int xvmc_pix_fmt::flags

XVMC_SECOND_FIELD - 1st or 2nd field in the sequence

• application - unchanged
• libavcodec - set.

Definition at line 116 of file xvmc.h.

Referenced by ff_xvmc_field_start().

int xvmc_pix_fmt::idct

Indicate that the hardware would interpret data_blocks as IDCT coefficients and perform IDCT on them.

• application - set during initialization
• libavcodec - unchanged

Definition at line 74 of file xvmc.h.

Referenced by ff_xvmc_decode_mb().

XvMCMacroBlock* xvmc_pix_fmt::mv_blocks

Pointer to the macroblock description array allocated by XvMCCreateMacroBlocks() and freed by XvMCDestroyMacroBlocks().

• application - set the pointer during initialization
• libavcodec - fills description data into the array

Definition at line 54 of file xvmc.h.

Referenced by ff_xvmc_decode_mb(), and ff_xvmc_field_start().

int xvmc_pix_fmt::next_free_data_block_num

Number of the the next free data block; one data block consists of 64 short values in the data_blocks array.

All blocks before this one have already been claimed by placing their position into the corresponding block description structure field, that are part of the mv_blocks array.

• application - zeroes it on get_buffer(). A successful ff_draw_horiz_band() may zero it together with start_mb_blocks_num.
• libavcodec - each decoded macroblock increases it by the number of coded blocks it contains.

Definition at line 148 of file xvmc.h.

Referenced by ff_xvmc_decode_mb(), ff_xvmc_field_start(), and ff_xvmc_init_block().

XvMCSurface* xvmc_pix_fmt::p_future_surface

Pointer to the surface used as future reference

• application - unchanged
• libavcodec - set.

Definition at line 104 of file xvmc.h.

Referenced by ff_xvmc_field_start().

XvMCSurface* xvmc_pix_fmt::p_past_surface

Set by the decoder before calling ff_draw_horiz_band(), needed by the XvMCRenderSurface function.

Pointer to the surface used as past reference

• application - unchanged
• libavcodec - set

Definition at line 98 of file xvmc.h.

Referenced by ff_xvmc_field_start().

XvMCSurface* xvmc_pix_fmt::p_surface

Pointer to the surface allocated by XvMCCreateSurface().

It has to be freed by XvMCDestroySurface() on application exit. It identifies the frame and its state on the video hardware.

• application - set during initialization
• libavcodec - unchanged

Definition at line 89 of file xvmc.h.

Referenced by ff_xvmc_field_start().

unsigned int xvmc_pix_fmt::picture_structure

top/bottom field or frame

• application - unchanged
• libavcodec - set

Definition at line 110 of file xvmc.h.

Referenced by ff_xvmc_field_start().

int xvmc_pix_fmt::start_mv_blocks_num

Number of macroblock descriptions in the mv_blocks array that have already been passed to the hardware.

• application - zeroes it on get_buffer(). A successful ff_draw_horiz_band() may increment it with filled_mb_block_num or zero both.
• libavcodec - unchanged

Definition at line 126 of file xvmc.h.

Referenced by ff_xvmc_decode_mb(), and ff_xvmc_field_start().

int xvmc_pix_fmt::unsigned_intra

In MoCo mode it indicates that intra macroblocks are assumed to be in unsigned format; same as the XVMC_INTRA_UNSIGNED flag.

• application - set during initialization
• libavcodec - unchanged

Definition at line 81 of file xvmc.h.

Referenced by ff_xvmc_decode_mb().

int xvmc_pix_fmt::xvmc_id

The field contains the special constant value AV_XVMC_ID.

It is used as a test that the application correctly uses the API, and that there is no corruption caused by pixel routines.

• application - set during initialization
• libavcodec - unchanged

Definition at line 38 of file xvmc.h.

Referenced by ff_xvmc_decode_mb(), ff_xvmc_field_start(), and ff_xvmc_init_block().

---

The documentation for this struct was generated from the following file:

• libavcodec/xvmc.h