Statistics
| Branch: | Revision:

ffmpeg / libavcodec / xvmc.h @ b91813b6

History | View | Annotate | Download (6.56 KB)

1 ef4d08ac Diego Biurrun
/*
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 af28efa2 Diego Biurrun
#ifndef AVCODEC_XVMC_H
22
#define AVCODEC_XVMC_H
23 699b3f99 Måns Rullgård
24 c97dffbc Diego Biurrun
#include <X11/extensions/XvMC.h>
25 7fade368 Ivan Kalvachev
26 5d6c1110 Diego Biurrun
#include "avcodec.h"
27
28 eb3b2ef9 Ivan Kalvachev
#if LIBAVCODEC_VERSION_MAJOR < 53
29 c1a5aa29 Diego Biurrun
#define AV_XVMC_STATE_DISPLAY_PENDING          1  /**  the surface should be shown, the video driver manipulates this */
30
#define AV_XVMC_STATE_PREDICTION               2  /**  the surface is needed for prediction, the codec manipulates this */
31 1909fade Diego Biurrun
#define AV_XVMC_STATE_OSD_SOURCE               4  /**  the surface is needed for subpicture rendering */
32 eb3b2ef9 Ivan Kalvachev
#endif
33 4e30fa6e Diego Biurrun
#define AV_XVMC_ID                    0x1DC711C0  /**< special value to ensure that regular pixel routines haven't corrupted the struct
34 e98b4755 Diego Biurrun
                                                       the number is 1337 speak for the letters IDCT MCo (motion compensation) */
35 117f9234 Ivan Kalvachev
36 f602b044 Diego Biurrun
struct xvmc_pix_fmt {
37 058bcd7b Diego Biurrun
    /** The field contains the special constant value AV_XVMC_ID.
38 2f953883 Diego Biurrun
        It is used as a test that the application correctly uses the API,
39 ad0405fc Ivan Kalvachev
        and that there is no corruption caused by pixel routines.
40
        - application - set during initialization
41
        - libavcodec  - unchanged
42
    */
43
    int             xvmc_id;
44 7fade368 Ivan Kalvachev
45 e7de624b Ivan Kalvachev
    /** Pointer to the block array allocated by XvMCCreateBlocks().
46 9ba8bc01 Diego Biurrun
        The array has to be freed by XvMCDestroyBlocks().
47
        Each group of 64 values represents one data block of differential
48
        pixel information (in MoCo mode) or coefficients for IDCT.
49 e7de624b Ivan Kalvachev
        - application - set the pointer during initialization
50
        - libavcodec  - fills coefficients/pixel data into the array
51 ad0405fc Ivan Kalvachev
    */
52 6b6ea1df Diego Biurrun
    short*          data_blocks;
53 ad0405fc Ivan Kalvachev
54 df9d2e04 Diego Biurrun
    /** Pointer to the macroblock description array allocated by
55 e7de624b Ivan Kalvachev
        XvMCCreateMacroBlocks() and freed by XvMCDestroyMacroBlocks().
56
        - application - set the pointer during initialization
57
        - libavcodec  - fills description data into the array
58 ad0405fc Ivan Kalvachev
    */
59 6b6ea1df Diego Biurrun
    XvMCMacroBlock* mv_blocks;
60 ad0405fc Ivan Kalvachev
61 037f13fe Diego Biurrun
    /** Number of macroblock descriptions that can be stored in the mv_blocks
62
        array.
63 ad0405fc Ivan Kalvachev
        - application - set during initialization
64
        - libavcodec  - unchanged
65
    */
66 cad1928f Diego Biurrun
    int             allocated_mv_blocks;
67 ad0405fc Ivan Kalvachev
68 037f13fe Diego Biurrun
    /** Number of blocks that can be stored at once in the data_blocks array.
69 ad0405fc Ivan Kalvachev
        - application - set during initialization
70
        - libavcodec  - unchanged
71
    */
72 cad1928f Diego Biurrun
    int             allocated_data_blocks;
73 ad0405fc Ivan Kalvachev
74 df9d2e04 Diego Biurrun
    /** Indicates that the hardware would interpret data_blocks as IDCT
75
        coefficients and perform IDCT on them.
76 ad0405fc Ivan Kalvachev
        - application - set during initialization
77
        - libavcodec  - unchanged
78
    */
79
    int             idct;
80
81 037f13fe Diego Biurrun
    /** In MoCo mode it indicates that intra macroblocks are assumed to be in
82
        unsigned format; same as the XVMC_INTRA_UNSIGNED flag.
83 ad0405fc Ivan Kalvachev
        - application - set during initialization
84
        - libavcodec  - unchanged
85
    */
86
    int             unsigned_intra;
87
88 058bcd7b Diego Biurrun
    /** Pointer to the surface allocated by XvMCCreateSurface().
89 9ba8bc01 Diego Biurrun
        It has to be freed by XvMCDestroySurface() on application exit.
90 037f13fe Diego Biurrun
        It identifies the frame and its state on the video hardware.
91 ad0405fc Ivan Kalvachev
        - application - set during initialization
92
        - libavcodec  - unchanged
93
    */
94
    XvMCSurface*    p_surface;
95 7fade368 Ivan Kalvachev
96 8f66518d Diego Biurrun
/** Set by the decoder before calling ff_draw_horiz_band(),
97 1909fade Diego Biurrun
    needed by the XvMCRenderSurface function. */
98 6785e509 Ivan Kalvachev
//@{
99 ad0405fc Ivan Kalvachev
    /** Pointer to the surface used as past reference
100
        - application - unchanged
101
        - libavcodec  - set
102
    */
103
    XvMCSurface*    p_past_surface;
104
105 058bcd7b Diego Biurrun
    /** Pointer to the surface used as future reference
106 ad0405fc Ivan Kalvachev
        - application - unchanged
107
        - libavcodec  - set
108
    */
109
    XvMCSurface*    p_future_surface;
110 7fade368 Ivan Kalvachev
111 ad0405fc Ivan Kalvachev
    /** top/bottom field or frame
112
        - application - unchanged
113
        - libavcodec  - set
114
    */
115
    unsigned int    picture_structure;
116
117 058bcd7b Diego Biurrun
    /** XVMC_SECOND_FIELD - 1st or 2nd field in the sequence
118 ad0405fc Ivan Kalvachev
        - application - unchanged
119
        - libavcodec  - set
120
    */
121
    unsigned int    flags;
122 6785e509 Ivan Kalvachev
//}@
123 7fade368 Ivan Kalvachev
124 9ba8bc01 Diego Biurrun
    /** Number of macroblock descriptions in the mv_blocks array
125 e7de624b Ivan Kalvachev
        that have already been passed to the hardware.
126 2f953883 Diego Biurrun
        - application - zeroes it on get_buffer().
127 8f66518d Diego Biurrun
                        A successful ff_draw_horiz_band() may increment it
128 72d38a74 Ivan Kalvachev
                        with filled_mb_block_num or zero both.
129
        - libavcodec  - unchanged
130
    */
131
    int             start_mv_blocks_num;
132
133 9ba8bc01 Diego Biurrun
    /** Number of new macroblock descriptions in the mv_blocks array (after
134
        start_mv_blocks_num) that are filled by libavcodec and have to be
135
        passed to the hardware.
136 df9d2e04 Diego Biurrun
        - application - zeroes it on get_buffer() or after successful
137
                        ff_draw_horiz_band().
138 72d38a74 Ivan Kalvachev
        - libavcodec  - increment with one of each stored MB
139
    */
140
    int             filled_mv_blocks_num;
141
142 9ba8bc01 Diego Biurrun
    /** Number of the the next free data block; one data block consists of
143
        64 short values in the data_blocks array.
144 b91813b6 Diego Biurrun
        All blocks before this one have already been claimed by placing their
145
        position into the corresponding block description structure field,
146
        that are part of the mv_blocks array.
147 e7de624b Ivan Kalvachev
        - application - zeroes it on get_buffer().
148
                        A successful ff_draw_horiz_band() may zero it together
149
                        with start_mb_blocks_num.
150 9ba8bc01 Diego Biurrun
        - libavcodec  - each decoded macroblock increases it by the number
151 648410c1 Diego Biurrun
                        of coded blocks it contains.
152 72d38a74 Ivan Kalvachev
    */
153
    int             next_free_data_block_num;
154 115329f1 Diego Biurrun
155 05c363e9 Diego Biurrun
/** extensions may be placed here */
156 3bffe5fc Ivan Kalvachev
#if LIBAVCODEC_VERSION_MAJOR < 53
157 6785e509 Ivan Kalvachev
//@{
158 e7de624b Ivan Kalvachev
    /** State flags used to work around limitations in the MPlayer video system.
159 1909fade Diego Biurrun
        0   - Surface is not used.
160 df9d2e04 Diego Biurrun
        1   - Surface is still held in application to be displayed or is
161
              still visible.
162 1909fade Diego Biurrun
        2   - Surface is still held in libavcodec buffer for prediction.
163 72d38a74 Ivan Kalvachev
    */
164
    int             state;
165 df9d2e04 Diego Biurrun
166
    /** pointer to the surface where the subpicture is rendered */
167
    void*           p_osd_target_surface_render;
168 6785e509 Ivan Kalvachev
//}@
169 3bffe5fc Ivan Kalvachev
#endif
170 c96da3ed Diego Biurrun
};
171 699b3f99 Måns Rullgård
172 af28efa2 Diego Biurrun
#endif /* AVCODEC_XVMC_H */