FFmpeg 5.1.4
xvmc.h
Go to the documentation of this file.
1/*
2 * Copyright (C) 2003 Ivan Kalvachev
3 *
4 * This file is part of FFmpeg.
5 *
6 * FFmpeg is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
10 *
11 * FFmpeg is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
15 *
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with FFmpeg; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19 */
20
21#ifndef AVCODEC_XVMC_H
22#define AVCODEC_XVMC_H
23
24/**
25 * @file
26 * @ingroup lavc_codec_hwaccel_xvmc
27 * Public libavcodec XvMC header.
28 */
29
30#pragma message("XvMC is no longer supported; this header is deprecated and will be removed")
31
32#include <X11/extensions/XvMC.h>
33
35#include "avcodec.h"
36
37/**
38 * @defgroup lavc_codec_hwaccel_xvmc XvMC
39 * @ingroup lavc_codec_hwaccel
40 *
41 * @{
42 */
43
44#define AV_XVMC_ID 0x1DC711C0 /**< special value to ensure that regular pixel routines haven't corrupted the struct
45 the number is 1337 speak for the letters IDCT MCo (motion compensation) */
46
48 /** The field contains the special constant value AV_XVMC_ID.
49 It is used as a test that the application correctly uses the API,
50 and that there is no corruption caused by pixel routines.
51 - application - set during initialization
52 - libavcodec - unchanged
53 */
55
56 /** Pointer to the block array allocated by XvMCCreateBlocks().
57 The array has to be freed by XvMCDestroyBlocks().
58 Each group of 64 values represents one data block of differential
59 pixel information (in MoCo mode) or coefficients for IDCT.
60 - application - set the pointer during initialization
61 - libavcodec - fills coefficients/pixel data into the array
62 */
64
65 /** Pointer to the macroblock description array allocated by
66 XvMCCreateMacroBlocks() and freed by XvMCDestroyMacroBlocks().
67 - application - set the pointer during initialization
68 - libavcodec - fills description data into the array
69 */
70 XvMCMacroBlock* mv_blocks;
71
72 /** Number of macroblock descriptions that can be stored in the mv_blocks
73 array.
74 - application - set during initialization
75 - libavcodec - unchanged
76 */
78
79 /** Number of blocks that can be stored at once in the data_blocks array.
80 - application - set during initialization
81 - libavcodec - unchanged
82 */
84
85 /** Indicate that the hardware would interpret data_blocks as IDCT
86 coefficients and perform IDCT on them.
87 - application - set during initialization
88 - libavcodec - unchanged
89 */
90 int idct;
91
92 /** In MoCo mode it indicates that intra macroblocks are assumed to be in
93 unsigned format; same as the XVMC_INTRA_UNSIGNED flag.
94 - application - set during initialization
95 - libavcodec - unchanged
96 */
98
99 /** Pointer to the surface allocated by XvMCCreateSurface().
100 It has to be freed by XvMCDestroySurface() on application exit.
101 It identifies the frame and its state on the video hardware.
102 - application - set during initialization
103 - libavcodec - unchanged
104 */
105 XvMCSurface* p_surface;
106
107/** Set by the decoder before calling ff_draw_horiz_band(),
108 needed by the XvMCRenderSurface function. */
109//@{
110 /** Pointer to the surface used as past reference
111 - application - unchanged
112 - libavcodec - set
113 */
114 XvMCSurface* p_past_surface;
115
116 /** Pointer to the surface used as future reference
117 - application - unchanged
118 - libavcodec - set
119 */
120 XvMCSurface* p_future_surface;
121
122 /** top/bottom field or frame
123 - application - unchanged
124 - libavcodec - set
125 */
126 unsigned int picture_structure;
127
128 /** XVMC_SECOND_FIELD - 1st or 2nd field in the sequence
129 - application - unchanged
130 - libavcodec - set
131 */
132 unsigned int flags;
133//}@
134
135 /** Number of macroblock descriptions in the mv_blocks array
136 that have already been passed to the hardware.
137 - application - zeroes it on get_buffer().
138 A successful ff_draw_horiz_band() may increment it
139 with filled_mb_block_num or zero both.
140 - libavcodec - unchanged
141 */
143
144 /** Number of new macroblock descriptions in the mv_blocks array (after
145 start_mv_blocks_num) that are filled by libavcodec and have to be
146 passed to the hardware.
147 - application - zeroes it on get_buffer() or after successful
148 ff_draw_horiz_band().
149 - libavcodec - increment with one of each stored MB
150 */
152
153 /** Number of the next free data block; one data block consists of
154 64 short values in the data_blocks array.
155 All blocks before this one have already been claimed by placing their
156 position into the corresponding block description structure field,
157 that are part of the mv_blocks array.
158 - application - zeroes it on get_buffer().
159 A successful ff_draw_horiz_band() may zero it together
160 with start_mb_blocks_num.
161 - libavcodec - each decoded macroblock increases it by the number
162 of coded blocks it contains.
163 */
165};
166
167/**
168 * @}
169 */
170
171#endif /* AVCODEC_XVMC_H */
Macro definitions for various function/variable attributes.
#define attribute_deprecated
Definition: attributes.h:100
Libavcodec external API header.
XvMCSurface * p_surface
Pointer to the surface allocated by XvMCCreateSurface().
Definition: xvmc.h:105
short * data_blocks
Pointer to the block array allocated by XvMCCreateBlocks().
Definition: xvmc.h:63
int unsigned_intra
In MoCo mode it indicates that intra macroblocks are assumed to be in unsigned format; same as the XV...
Definition: xvmc.h:97
unsigned int flags
XVMC_SECOND_FIELD - 1st or 2nd field in the sequence.
Definition: xvmc.h:132
int xvmc_id
The field contains the special constant value AV_XVMC_ID.
Definition: xvmc.h:54
unsigned int picture_structure
top/bottom field or frame
Definition: xvmc.h:126
int allocated_mv_blocks
Number of macroblock descriptions that can be stored in the mv_blocks array.
Definition: xvmc.h:77
XvMCSurface * p_past_surface
Set by the decoder before calling ff_draw_horiz_band(), needed by the XvMCRenderSurface function.
Definition: xvmc.h:114
int filled_mv_blocks_num
Number of new macroblock descriptions in the mv_blocks array (after start_mv_blocks_num) that are fil...
Definition: xvmc.h:151
int idct
Indicate that the hardware would interpret data_blocks as IDCT coefficients and perform IDCT on them.
Definition: xvmc.h:90
XvMCSurface * p_future_surface
Pointer to the surface used as future reference.
Definition: xvmc.h:120
XvMCMacroBlock * mv_blocks
Pointer to the macroblock description array allocated by XvMCCreateMacroBlocks() and freed by XvMCDes...
Definition: xvmc.h:70
int start_mv_blocks_num
Number of macroblock descriptions in the mv_blocks array that have already been passed to the hardwar...
Definition: xvmc.h:142
int allocated_data_blocks
Number of blocks that can be stored at once in the data_blocks array.
Definition: xvmc.h:83
int next_free_data_block_num
Number of the next free data block; one data block consists of 64 short values in the data_blocks arr...
Definition: xvmc.h:164