Statistics
| Branch: | Revision:

ffmpeg / libavcodec / xvmc.h @ 02c0c8d1

History | View | Annotate | Download (6.52 KB)

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
#include <X11/extensions/XvMC.h>
25

    
26
#include "avcodec.h"
27

    
28
#if LIBAVCODEC_VERSION_MAJOR < 53
29
#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
#define AV_XVMC_STATE_OSD_SOURCE               4  /**  the surface is needed for subpicture rendering */
32
#endif
33
#define AV_XVMC_ID                    0x1DC711C0  /**< special value to ensure that regular pixel routines haven't corrupted the struct
34
                                                       the number is 1337 speak for the letters IDCT MCo (motion compensation) */
35

    
36
struct xvmc_pix_fmt {
37
    /** The field contains the special constant value AV_XVMC_ID.
38
        It is used as a test that the application correctly uses the API,
39
        and that there is no corruption caused by pixel routines.
40
        - application - set during initialization
41
        - libavcodec  - unchanged
42
    */
43
    int             xvmc_id;
44

    
45
    /** Pointer to the block array allocated by XvMCCreateBlocks().
46
        The array is have to be freed by XvMCDestroyBlocks().
47
        Each 64 values represent one data block of
48
        differential pixel data (in MoCo mode) or coefficients for IDCT.
49
        - application - set the pointer during initialization
50
        - libavcodec  - fills coefficients/pixel data into the array
51
    */
52
    short*          data_blocks;
53

    
54
    /** Pointer to the macroblock description array allocated by
55
        XvMCCreateMacroBlocks() and freed by XvMCDestroyMacroBlocks().
56
        - application - set the pointer during initialization
57
        - libavcodec  - fills description data into the array
58
    */
59
    XvMCMacroBlock* mv_blocks;
60

    
61
    /** Number of macroblock descriptions that can be stored in the mv_blocks
62
        array.
63
        - application - set during initialization
64
        - libavcodec  - unchanged
65
    */
66
    int             allocated_mv_blocks;
67

    
68
    /** Number of blocks that can be stored at once in the data_blocks array.
69
        - application - set during initialization
70
        - libavcodec  - unchanged
71
    */
72
    int             allocated_data_blocks;
73

    
74
    /** Indicates that the hardware would interpret data_blocks as IDCT
75
        coefficients and perform IDCT on them.
76
        - application - set during initialization
77
        - libavcodec  - unchanged
78
    */
79
    int             idct;
80

    
81
    /** In MoCo mode it indicates that intra macroblocks are assumed to be in
82
        unsigned format; same as the XVMC_INTRA_UNSIGNED flag.
83
        - application - set during initialization
84
        - libavcodec  - unchanged
85
    */
86
    int             unsigned_intra;
87

    
88
    /** Pointer to the surface allocated by XvMCCreateSurface().
89
        It have to be freed by XvMCDestroySurface() on application exit.
90
        It identifies the frame and its state on the video hardware.
91
        - application - set during initialization
92
        - libavcodec  - unchanged
93
    */
94
    XvMCSurface*    p_surface;
95

    
96
/** Set by the decoder before calling ff_draw_horiz_band(),
97
    needed by the XvMCRenderSurface function. */
98
//@{
99
    /** Pointer to the surface used as past reference
100
        - application - unchanged
101
        - libavcodec  - set
102
    */
103
    XvMCSurface*    p_past_surface;
104

    
105
    /** Pointer to the surface used as future reference
106
        - application - unchanged
107
        - libavcodec  - set
108
    */
109
    XvMCSurface*    p_future_surface;
110

    
111
    /** top/bottom field or frame
112
        - application - unchanged
113
        - libavcodec  - set
114
    */
115
    unsigned int    picture_structure;
116

    
117
    /** XVMC_SECOND_FIELD - 1st or 2nd field in the sequence
118
        - application - unchanged
119
        - libavcodec  - set
120
    */
121
    unsigned int    flags;
122
//}@
123

    
124
    /** Number of macro block descriptions in the mv_blocks array
125
        that have already been passed to the hardware.
126
        - application - zeroes it on get_buffer().
127
                        A successful ff_draw_horiz_band() may increment it
128
                        with filled_mb_block_num or zero both.
129
        - libavcodec  - unchanged
130
    */
131
    int             start_mv_blocks_num;
132

    
133
    /** Number of new macro blocks descriptions in mv_blocks array (after start_mv_blocks_num)
134
        that are filled by libavcodec and have to be passed to the hardware.
135
        - application - zeroes it on get_buffer() or after successful
136
                        ff_draw_horiz_band().
137
        - libavcodec  - increment with one of each stored MB
138
    */
139
    int             filled_mv_blocks_num;
140

    
141
    /** Number of the the next free data block.
142
        One data block is 64 short values in data_blocks array.
143
        All blocks before this one are already claimed by filling their number
144
        in the corresponding blocks description structure field,
145
        that are hold in mv_blocks array.
146
        - application - zeroes it on get_buffer().
147
                        A successful ff_draw_horiz_band() may zero it together
148
                        with start_mb_blocks_num.
149
        - libavcodec  - each decoded macroblock increases it with the number
150
                        of coded blocks it contains.
151
    */
152
    int             next_free_data_block_num;
153

    
154
/** extensions may be placed here */
155
#if LIBAVCODEC_VERSION_MAJOR < 53
156
//@{
157
    /** State flags used to work around limitations in the MPlayer video system.
158
        0   - Surface is not used.
159
        1   - Surface is still held in application to be displayed or is
160
              still visible.
161
        2   - Surface is still held in libavcodec buffer for prediction.
162
    */
163
    int             state;
164

    
165
    /** pointer to the surface where the subpicture is rendered */
166
    void*           p_osd_target_surface_render;
167
//}@
168
#endif
169
};
170

    
171
#endif /* AVCODEC_XVMC_H */