1 |
|
/***************************************************************************** |
2 |
|
* |
3 |
|
* XVID MPEG-4 VIDEO CODEC |
4 |
|
* - XviD Main header file - |
5 |
|
* |
6 |
|
* This program is an implementation of a part of one or more MPEG-4 |
7 |
|
* Video tools as specified in ISO/IEC 14496-2 standard. Those intending |
8 |
|
* to use this software module in hardware or software products are |
9 |
|
* advised that its use may infringe existing patents or copyrights, and |
10 |
|
* any such use would be at such party's own risk. The original |
11 |
|
* developer of this software module and his/her company, and subsequent |
12 |
|
* editors and their companies, will have no liability for use of this |
13 |
|
* software or modifications or derivatives thereof. |
14 |
|
* |
15 |
|
* This program is free software ; you can redistribute it and/or modify |
16 |
|
* it under the terms of the GNU General Public License as published by |
17 |
|
* the Free Software Foundation ; either version 2 of the License, or |
18 |
|
* (at your option) any later version. |
19 |
|
* |
20 |
|
* This program is distributed in the hope that it will be useful, |
21 |
|
* but WITHOUT ANY WARRANTY ; without even the implied warranty of |
22 |
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
23 |
|
* GNU General Public License for more details. |
24 |
|
* |
25 |
|
* You should have received a copy of the GNU General Public License |
26 |
|
* along with this program ; if not, write to the Free Software |
27 |
|
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
28 |
|
* |
29 |
|
*****************************************************************************/ |
30 |
|
/***************************************************************************** |
31 |
|
* |
32 |
|
* History |
33 |
|
* |
34 |
|
* - 2002/06/13 Added legal header, ANSI C comment style (only for this header |
35 |
|
* as it can be included in a ANSI C project). |
36 |
|
* |
37 |
|
* ToDo ? : when BFRAMES is defined, the API_VERSION should not |
38 |
|
* be the same (3.0 ?) |
39 |
|
* |
40 |
|
* $Id: xvid.h,v 1.7 2002-07-21 03:46:13 suxen_drol Exp $ |
41 |
|
* |
42 |
|
*****************************************************************************/ |
43 |
|
|
44 |
|
|
45 |
#ifndef _XVID_H_ |
#ifndef _XVID_H_ |
46 |
#define _XVID_H_ |
#define _XVID_H_ |
47 |
|
|
49 |
extern "C" { |
extern "C" { |
50 |
#endif |
#endif |
51 |
|
|
52 |
// ========================================== |
/***************************************************************************** |
53 |
// global |
* Global constants |
54 |
// ========================================== |
****************************************************************************/ |
55 |
|
|
56 |
// API Version: 2.0 |
/* API Version : 2.1 */ |
57 |
#define API_VERSION ((2 << 16) | (0)) |
#define API_VERSION ((2 << 16) | (1)) |
58 |
|
|
|
// cpu features |
|
|
#define XVID_CPU_MMX 0x00000001 |
|
|
#define XVID_CPU_MMXEXT 0x00000002 |
|
|
#define XVID_CPU_SSE 0x00000004 |
|
|
#define XVID_CPU_SSE2 0x00000008 |
|
|
#define XVID_CPU_3DNOW 0x00000010 |
|
|
#define XVID_CPU_3DNOWEXT 0x00000020 |
|
|
#define XVID_CPU_TSC 0x00000040 |
|
|
#define XVID_CPU_FORCE 0x80000000 |
|
59 |
|
|
60 |
// colorspaces |
/* Error codes */ |
61 |
|
#define XVID_ERR_FAIL -1 |
62 |
|
#define XVID_ERR_OK 0 |
63 |
|
#define XVID_ERR_MEMORY 1 |
64 |
|
#define XVID_ERR_FORMAT 2 |
65 |
|
|
66 |
|
|
67 |
|
/* Colorspaces */ |
68 |
#define XVID_CSP_RGB24 0 |
#define XVID_CSP_RGB24 0 |
69 |
#define XVID_CSP_YV12 1 |
#define XVID_CSP_YV12 1 |
70 |
#define XVID_CSP_YUY2 2 |
#define XVID_CSP_YUY2 2 |
73 |
#define XVID_CSP_RGB555 10 |
#define XVID_CSP_RGB555 10 |
74 |
#define XVID_CSP_RGB565 11 |
#define XVID_CSP_RGB565 11 |
75 |
#define XVID_CSP_USER 12 |
#define XVID_CSP_USER 12 |
76 |
|
#define XVID_CSP_EXTERN 1004 // per slice rendering |
77 |
#define XVID_CSP_YVYU 1002 |
#define XVID_CSP_YVYU 1002 |
78 |
#define XVID_CSP_RGB32 1000 |
#define XVID_CSP_RGB32 1000 |
79 |
#define XVID_CSP_NULL 9999 |
#define XVID_CSP_NULL 9999 |
80 |
|
|
81 |
#define XVID_CSP_VFLIP 0x80000000 // flip mask |
#define XVID_CSP_VFLIP 0x80000000 // flip mask |
82 |
|
|
83 |
// error |
|
84 |
#define XVID_ERR_FAIL -1 |
/***************************************************************************** |
85 |
#define XVID_ERR_OK 0 |
* Initialization constants |
86 |
#define XVID_ERR_MEMORY 1 |
****************************************************************************/ |
87 |
#define XVID_ERR_FORMAT 2 |
|
88 |
|
/* CPU flags for XVID_INIT_PARAM.cpu_flags */ |
89 |
|
|
90 |
|
#define XVID_CPU_MMX 0x00000001 |
91 |
|
#define XVID_CPU_MMXEXT 0x00000002 |
92 |
|
#define XVID_CPU_SSE 0x00000004 |
93 |
|
#define XVID_CPU_SSE2 0x00000008 |
94 |
|
#define XVID_CPU_3DNOW 0x00000010 |
95 |
|
#define XVID_CPU_3DNOWEXT 0x00000020 |
96 |
|
|
97 |
|
#define XVID_CPU_TSC 0x00000040 |
98 |
|
|
99 |
|
#define XVID_CPU_IA64 0x00000080 |
100 |
|
|
101 |
|
#define XVID_CPU_CHKONLY 0x40000000 /* check cpu only; dont init globals */ |
102 |
|
#define XVID_CPU_FORCE 0x80000000 |
103 |
|
|
104 |
|
|
105 |
|
/***************************************************************************** |
106 |
|
* Initialization structures |
107 |
|
****************************************************************************/ |
108 |
|
|
109 |
typedef struct |
typedef struct |
110 |
{ |
{ |
111 |
int cpu_flags; |
int cpu_flags; |
112 |
int api_version; |
int api_version; |
113 |
int core_build; |
int core_build; |
114 |
} XVID_INIT_PARAM; |
} |
115 |
|
XVID_INIT_PARAM; |
116 |
|
|
117 |
int xvid_init(void *handle, int opt, |
/***************************************************************************** |
118 |
void *param1, void *param2); |
* Initialization entry point |
119 |
|
****************************************************************************/ |
120 |
|
|
121 |
|
int xvid_init(void *handle, |
122 |
|
int opt, |
123 |
|
void *param1, |
124 |
|
void *param2); |
125 |
|
|
|
// ========================================== |
|
|
// decoder |
|
|
// ========================================== |
|
126 |
|
|
127 |
#define XVID_QUICK_DECODE 0x00000010 /* increases decoding speed but reduces quality */ |
/***************************************************************************** |
128 |
|
* Decoder constants |
129 |
|
****************************************************************************/ |
130 |
|
|
131 |
|
/* Flags for XVID_DEC_FRAME.general */ |
132 |
|
#define XVID_QUICK_DECODE 0x00000010 |
133 |
|
|
134 |
|
/***************************************************************************** |
135 |
|
* Decoder structures |
136 |
|
****************************************************************************/ |
137 |
|
|
138 |
typedef struct |
typedef struct |
139 |
{ |
{ |
140 |
int width; |
int width; |
141 |
int height; |
int height; |
142 |
void *handle; |
void *handle; |
143 |
} XVID_DEC_PARAM; |
} |
144 |
|
XVID_DEC_PARAM; |
145 |
|
|
146 |
|
|
147 |
typedef struct |
typedef struct |
153 |
void * image; |
void * image; |
154 |
int stride; |
int stride; |
155 |
int colorspace; |
int colorspace; |
156 |
} XVID_DEC_FRAME; |
} |
157 |
|
XVID_DEC_FRAME; |
158 |
|
|
159 |
|
|
160 |
|
// This struct is used for per slice rendering |
161 |
|
typedef struct |
162 |
|
{ |
163 |
|
void *y,*u,*v; |
164 |
|
int stride_y, stride_u,stride_v; |
165 |
|
} XVID_DEC_PICTURE; |
166 |
|
|
167 |
|
|
168 |
|
/***************************************************************************** |
169 |
|
* Decoder entry point |
170 |
|
****************************************************************************/ |
171 |
|
|
172 |
// decoder options |
/* decoder options */ |
173 |
#define XVID_DEC_DECODE 0 |
#define XVID_DEC_DECODE 0 |
174 |
#define XVID_DEC_CREATE 1 |
#define XVID_DEC_CREATE 1 |
175 |
#define XVID_DEC_DESTROY 2 |
#define XVID_DEC_DESTROY 2 |
180 |
void * param2); |
void * param2); |
181 |
|
|
182 |
|
|
183 |
// ========================================== |
/***************************************************************************** |
184 |
// encoder |
* Encoder constants |
185 |
// ========================================== |
****************************************************************************/ |
186 |
|
|
187 |
|
/* Flags for XVID_ENC_PARAM.global */ |
188 |
|
#define XVID_GLOBAL_PACKED 0x00000001 /* packed bitstream */ |
189 |
|
#define XVID_GLOBAL_DX50BVOP 0x00000002 /* dx50 bvop compatibility */ |
190 |
|
#define XVID_GLOBAL_DEBUG 0x00000004 /* print debug info on each frame */ |
191 |
|
|
192 |
/* Do not rely on the VALUES of these constants, they may be changed at any time */ |
/* Flags for XVID_ENC_FRAME.general */ |
193 |
#define XVID_VALID_FLAGS 0x80000000 |
#define XVID_VALID_FLAGS 0x80000000 |
194 |
|
|
195 |
#define XVID_CUSTOM_QMATRIX 0x00000004 /* use custom quant matrix */ |
#define XVID_CUSTOM_QMATRIX 0x00000004 /* use custom quant matrix */ |
201 |
#define XVID_LATEINTRA 0x00000200 |
#define XVID_LATEINTRA 0x00000200 |
202 |
|
|
203 |
#define XVID_INTERLACING 0x00000400 /* enable interlaced encoding */ |
#define XVID_INTERLACING 0x00000400 /* enable interlaced encoding */ |
204 |
#define XVID_TOPFIELDFIRST 0x00000800 /* set top-field-first flag (cosmetic only) */ |
#define XVID_TOPFIELDFIRST 0x00000800 /* set top-field-first flag */ |
205 |
#define XVID_ALTERNATESCAN 0x00001000 /* ?? sets alternate vertical scan flag */ |
#define XVID_ALTERNATESCAN 0x00001000 /* set alternate vertical scan flag */ |
206 |
|
|
207 |
#define XVID_HINTEDME_GET 0x00002000 /* receive mv hint data from core (1st pass) */ |
#define XVID_HINTEDME_GET 0x00002000 /* receive mv hint data from core (1st pass) */ |
208 |
#define XVID_HINTEDME_SET 0x00004000 /* send mv hint data to core (2nd pass) */ |
#define XVID_HINTEDME_SET 0x00004000 /* send mv hint data to core (2nd pass) */ |
215 |
#define XVID_ME_PMVFAST 0x00080000 |
#define XVID_ME_PMVFAST 0x00080000 |
216 |
#define XVID_ME_EPZS 0x00100000 |
#define XVID_ME_EPZS 0x00100000 |
217 |
|
|
218 |
|
|
219 |
|
/* Flags for XVID_ENC_FRAME.motion */ |
220 |
|
#define PMV_ADVANCEDDIAMOND8 0x00004000 |
221 |
|
#define PMV_ADVANCEDDIAMOND16 0x00008000 |
222 |
|
|
223 |
#define PMV_HALFPELDIAMOND16 0x00010000 |
#define PMV_HALFPELDIAMOND16 0x00010000 |
224 |
#define PMV_HALFPELREFINE16 0x00020000 |
#define PMV_HALFPELREFINE16 0x00020000 |
225 |
#define PMV_EXTSEARCH16 0x00040000 /* extend PMV by more searches */ |
#define PMV_EXTSEARCH16 0x00040000 /* extend PMV by more searches */ |
239 |
#define PMV_USESQUARES8 0x80000000 |
#define PMV_USESQUARES8 0x80000000 |
240 |
|
|
241 |
|
|
242 |
|
/***************************************************************************** |
243 |
|
* Encoder structures |
244 |
|
****************************************************************************/ |
245 |
|
|
246 |
typedef struct |
typedef struct |
247 |
{ |
{ |
248 |
int width, height; |
int width, height; |
249 |
int fincr, fbase; // frame increment, fbase. each frame = "fincr/fbase" seconds |
int fincr, fbase; /* frame increment, fbase. each frame = "fincr/fbase" seconds */ |
250 |
int rc_bitrate; // the bitrate of the target encoded stream, in bits/second |
int rc_bitrate; /* the bitrate of the target encoded stream, in bits/second */ |
251 |
int rc_reaction_delay_factor; // how fast the rate control reacts - lower values are faster |
int rc_reaction_delay_factor; /* how fast the rate control reacts - lower values are faster */ |
252 |
int rc_averaging_period; // as above |
int rc_averaging_period; /* as above */ |
253 |
int rc_buffer; // as above |
int rc_buffer; /* as above */ |
254 |
int max_quantizer; // the upper limit of the quantizer |
int max_quantizer; /* the upper limit of the quantizer */ |
255 |
int min_quantizer; // the lower limit of the quantizer |
int min_quantizer; /* the lower limit of the quantizer */ |
256 |
int max_key_interval; // the maximum interval between key frames |
int max_key_interval; /* the maximum interval between key frames */ |
257 |
|
#ifdef _SMP |
258 |
void * handle; // [out] encoder instance handle |
int num_threads; /* number of threads */ |
259 |
|
#endif |
260 |
} XVID_ENC_PARAM; |
#ifdef BFRAMES |
261 |
|
int global; /* global/debug options */ |
262 |
|
int max_bframes; /* max sequential bframes (0=disable bframes) */ |
263 |
|
int bquant_ratio; /* bframe quantizer multipier (percentage). |
264 |
|
* used only when bquant < 1 |
265 |
|
* eg. 200 = x2 multiplier |
266 |
|
* quant = ((past_quant + future_quant) * bquant_ratio)/200 |
267 |
|
*/ |
268 |
|
int frame_drop_ratio; /* frame dropping: 0=drop none... 100=drop all */ |
269 |
|
#endif |
270 |
|
void *handle; /* [out] encoder instance handle */ |
271 |
|
} |
272 |
|
XVID_ENC_PARAM; |
273 |
|
|
274 |
typedef struct |
typedef struct |
275 |
{ |
{ |
276 |
int x; |
int x; |
277 |
int y; |
int y; |
278 |
} VECTOR; |
} |
279 |
|
VECTOR; |
280 |
|
|
281 |
typedef struct |
typedef struct |
282 |
{ |
{ |
283 |
int mode; // macroblock mode |
int mode; /* macroblock mode */ |
284 |
VECTOR mvs[4]; |
VECTOR mvs[4]; |
285 |
} MVBLOCKHINT; |
} |
286 |
|
MVBLOCKHINT; |
287 |
|
|
288 |
typedef struct |
typedef struct |
289 |
{ |
{ |
290 |
int intra; // frame intra choice |
int intra; /* frame intra choice */ |
291 |
int fcode; // frame fcode |
int fcode; /* frame fcode */ |
292 |
MVBLOCKHINT * block; // caller-allocated array of block hints (mb_width * mb_height) |
MVBLOCKHINT *block; /* caller-allocated array of block hints (mb_width * mb_height) */ |
293 |
} MVFRAMEHINT; |
} |
294 |
|
MVFRAMEHINT; |
295 |
|
|
296 |
typedef struct |
typedef struct |
297 |
{ |
{ |
298 |
int rawhints; // if set, use MVFRAMEHINT, else use compressed buffer |
int rawhints; /* if set, use MVFRAMEHINT, else use compressed buffer */ |
299 |
|
|
300 |
MVFRAMEHINT mvhint; |
MVFRAMEHINT mvhint; |
301 |
void * hintstream; // compressed hint buffer |
void *hintstream; /* compressed hint buffer */ |
302 |
int hintlength; // length of buffer (bytes) |
int hintlength; /* length of buffer (bytes) */ |
303 |
} HINTINFO; |
} |
304 |
|
HINTINFO; |
305 |
|
|
306 |
typedef struct |
typedef struct |
307 |
{ |
{ |
308 |
int general; // [in] general options |
int general; /* [in] general options */ |
309 |
int motion; // [in] ME options |
int motion; /* [in] ME options */ |
310 |
void * bitstream; // [in] bitstream ptr |
void *bitstream; /* [in] bitstream ptr */ |
311 |
int length; // [out] bitstream length (bytes) |
int length; /* [out] bitstream length (bytes) */ |
312 |
|
|
313 |
|
void *image; /* [in] image ptr */ |
314 |
|
int colorspace; /* [in] source colorspace */ |
315 |
|
|
316 |
|
unsigned char *quant_intra_matrix; // [in] custom intra qmatrix */ |
317 |
|
unsigned char *quant_inter_matrix; // [in] custom inter qmatrix */ |
318 |
|
int quant; /* [in] frame quantizer (vbr) */ |
319 |
|
int intra; /* [in] force intra frame (vbr only) |
320 |
|
* [out] intra state |
321 |
|
*/ |
322 |
|
HINTINFO hint; /* [in/out] mv hint information */ |
323 |
|
|
324 |
void * image; // [in] image ptr |
#ifdef BFRAMES |
325 |
int colorspace; // [in] source colorspace |
int bquant; /* [in] bframe quantizer */ |
326 |
|
#endif |
327 |
|
|
328 |
unsigned char *quant_intra_matrix; // [in] custom intra qmatrix |
} |
329 |
unsigned char *quant_inter_matrix; // [in] custom inter qmatrix |
XVID_ENC_FRAME; |
|
int quant; // [in] frame quantizer (vbr) |
|
|
int intra; // [in] force intra frame (vbr only) |
|
|
// [out] intra state |
|
|
HINTINFO hint; // [in/out] mv hint information |
|
|
} XVID_ENC_FRAME; |
|
330 |
|
|
331 |
|
|
332 |
typedef struct |
typedef struct |
333 |
{ |
{ |
334 |
int quant; // [out] frame quantizer |
int quant; /* [out] frame quantizer */ |
335 |
int hlength; // [out] header length (bytes) |
int hlength; /* [out] header length (bytes) */ |
336 |
int kblks, mblks, ublks; // [out] |
int kblks, mblks, ublks; /* [out] */ |
337 |
|
|
338 |
|
} |
339 |
|
XVID_ENC_STATS; |
340 |
|
|
|
} XVID_ENC_STATS; |
|
341 |
|
|
342 |
|
/***************************************************************************** |
343 |
|
* Encoder entry point |
344 |
|
****************************************************************************/ |
345 |
|
|
346 |
|
/* Encoder options */ |
347 |
#define XVID_ENC_ENCODE 0 |
#define XVID_ENC_ENCODE 0 |
348 |
#define XVID_ENC_CREATE 1 |
#define XVID_ENC_CREATE 1 |
349 |
#define XVID_ENC_DESTROY 2 |
#define XVID_ENC_DESTROY 2 |
358 |
} |
} |
359 |
#endif |
#endif |
360 |
|
|
361 |
#endif /* _XVID_H_ */ |
#endif |