28 |
* ToDo ? : when BFRAMES is defined, the API_VERSION should not |
* ToDo ? : when BFRAMES is defined, the API_VERSION should not |
29 |
* be the same (3.0 ?) |
* be the same (3.0 ?) |
30 |
* |
* |
31 |
* $Id: xvid.h,v 1.17.2.1 2002-10-05 21:34:04 Isibaar Exp $ |
* $Id: xvid.h,v 1.17.2.14 2002-12-12 10:37:44 suxen_drol Exp $ |
32 |
* |
* |
33 |
*****************************************************************************/ |
*****************************************************************************/ |
34 |
|
|
47 |
/* API Version : 2.1 */ |
/* API Version : 2.1 */ |
48 |
#define API_VERSION ((2 << 16) | (1)) |
#define API_VERSION ((2 << 16) | (1)) |
49 |
|
|
50 |
|
/* Bitstream Version |
51 |
|
* this will be writen into the bitstream to allow easy detection of xvid |
52 |
|
* encoder bugs in the decoder, without this it might not possible to |
53 |
|
* automatically distinquish between a file which has been encoded with an |
54 |
|
* old & buggy XVID from a file which has been encoded with a bugfree version |
55 |
|
* see the infamous interlacing bug ... |
56 |
|
* |
57 |
|
* this MUST be increased if an encoder bug is fixed, increasing it too often |
58 |
|
* doesnt hurt but not increasing it could cause difficulty for decoders in the |
59 |
|
* future |
60 |
|
*/ |
61 |
|
#define XVID_BS_VERSION "0003" |
62 |
|
|
63 |
|
|
64 |
/* Error codes */ |
/* Error codes */ |
65 |
#define XVID_ERR_FAIL -1 |
#define XVID_ERR_FAIL -1 |
69 |
|
|
70 |
|
|
71 |
/* Colorspaces */ |
/* Colorspaces */ |
72 |
#define XVID_CSP_RGB24 0 |
#define XVID_CSP_RGB24 0 /* [b|g|r] */ |
73 |
#define XVID_CSP_YV12 1 |
#define XVID_CSP_YV12 1 |
74 |
#define XVID_CSP_YUY2 2 |
#define XVID_CSP_YUY2 2 |
75 |
#define XVID_CSP_UYVY 3 |
#define XVID_CSP_UYVY 3 |
79 |
#define XVID_CSP_USER 12 |
#define XVID_CSP_USER 12 |
80 |
#define XVID_CSP_EXTERN 1004 // per slice rendering |
#define XVID_CSP_EXTERN 1004 // per slice rendering |
81 |
#define XVID_CSP_YVYU 1002 |
#define XVID_CSP_YVYU 1002 |
82 |
#define XVID_CSP_RGB32 1000 |
#define XVID_CSP_RGB32 1000 /* [b|g|r|a] */ |
83 |
|
#define XVID_CSP_ABGR 1006 /* [a|b|g|r] */ |
84 |
|
#define XVID_CSP_RGBA 1005 /* [r|g|b|a] */ |
85 |
|
|
86 |
|
|
87 |
|
|
88 |
#define XVID_CSP_NULL 9999 |
#define XVID_CSP_NULL 9999 |
89 |
|
|
90 |
#define XVID_CSP_VFLIP 0x80000000 // flip mask |
#define XVID_CSP_VFLIP 0x80000000 // flip mask |
110 |
#define XVID_CPU_CHKONLY 0x40000000 /* check cpu only; dont init globals */ |
#define XVID_CPU_CHKONLY 0x40000000 /* check cpu only; dont init globals */ |
111 |
#define XVID_CPU_FORCE 0x80000000 |
#define XVID_CPU_FORCE 0x80000000 |
112 |
|
|
113 |
|
typedef struct |
114 |
|
{ |
115 |
|
int colorspace; |
116 |
|
void * y; |
117 |
|
void * u; |
118 |
|
void * v; |
119 |
|
int y_stride; |
120 |
|
int uv_stride; |
121 |
|
} XVID_IMAGE; /* from yv12 */ |
122 |
|
|
123 |
|
#define XVID_INIT_INIT 0 |
124 |
|
#define XVID_INIT_CONVERT 1 |
125 |
|
|
126 |
/***************************************************************************** |
/***************************************************************************** |
127 |
* Initialization structures |
* Initialization structures |
135 |
} |
} |
136 |
XVID_INIT_PARAM; |
XVID_INIT_PARAM; |
137 |
|
|
138 |
|
typedef struct |
139 |
|
{ |
140 |
|
XVID_IMAGE input; |
141 |
|
XVID_IMAGE output; |
142 |
|
int width; |
143 |
|
int height; |
144 |
|
int interlacing; |
145 |
|
} XVID_INIT_CONVERTINFO; |
146 |
|
|
147 |
/***************************************************************************** |
/***************************************************************************** |
148 |
* Initialization entry point |
* Initialization entry point |
149 |
****************************************************************************/ |
****************************************************************************/ |
159 |
****************************************************************************/ |
****************************************************************************/ |
160 |
|
|
161 |
/* Flags for XVID_DEC_FRAME.general */ |
/* Flags for XVID_DEC_FRAME.general */ |
162 |
|
#define XVID_DEC_LOWDELAY 0x00000001 /* decode lowdelay mode (ie. video-for-windows) */ |
163 |
#define XVID_QUICK_DECODE 0x00000010 |
#define XVID_QUICK_DECODE 0x00000010 |
164 |
|
|
165 |
/***************************************************************************** |
/***************************************************************************** |
175 |
XVID_DEC_PARAM; |
XVID_DEC_PARAM; |
176 |
|
|
177 |
|
|
178 |
|
#define XVID_DEC_VOP 0 |
179 |
|
#define XVID_DEC_VOL 1 |
180 |
|
#define XVID_DEC_NOTHING 2 /* nothing was decoded */ |
181 |
|
|
182 |
|
typedef struct |
183 |
|
{ |
184 |
|
int notify; /* [out] output 'mode' */ |
185 |
|
union |
186 |
|
{ |
187 |
|
struct /* XVID_DEC_VOP */ |
188 |
|
{ |
189 |
|
int time_base; /* [out] time base */ |
190 |
|
int time_increment; /* [out] time increment */ |
191 |
|
} vop; |
192 |
|
struct /* XVID_DEC_VOL */ |
193 |
|
{ |
194 |
|
int general; /* [out] flags: eg. frames are interlaced */ |
195 |
|
int width; /* [out] width */ |
196 |
|
int height; /* [out] height */ |
197 |
|
int aspect_ratio; /* [out] aspect ratio */ |
198 |
|
int par_width; /* [out] aspect ratio width */ |
199 |
|
int par_height; /* [out] aspect ratio height */ |
200 |
|
} vol; |
201 |
|
} data; |
202 |
|
} XVID_DEC_STATS; |
203 |
|
|
204 |
|
|
205 |
typedef struct |
typedef struct |
206 |
{ |
{ |
207 |
int general; |
int general; |
246 |
#define XVID_GLOBAL_PACKED 0x00000001 /* packed bitstream */ |
#define XVID_GLOBAL_PACKED 0x00000001 /* packed bitstream */ |
247 |
#define XVID_GLOBAL_DX50BVOP 0x00000002 /* dx50 bvop compatibility */ |
#define XVID_GLOBAL_DX50BVOP 0x00000002 /* dx50 bvop compatibility */ |
248 |
#define XVID_GLOBAL_DEBUG 0x00000004 /* print debug info on each frame */ |
#define XVID_GLOBAL_DEBUG 0x00000004 /* print debug info on each frame */ |
249 |
|
#define XVID_GLOBAL_REDUCED 0x04000000 /* reduced resolution vop enable */ |
250 |
|
|
251 |
/* Flags for XVID_ENC_FRAME.general */ |
/* Flags for XVID_ENC_FRAME.general */ |
252 |
#define XVID_VALID_FLAGS 0x80000000 |
#define XVID_VALID_FLAGS 0x80000000 |
275 |
#define XVID_ME_PMVFAST 0x00080000 |
#define XVID_ME_PMVFAST 0x00080000 |
276 |
#define XVID_ME_EPZS 0x00100000 |
#define XVID_ME_EPZS 0x00100000 |
277 |
|
|
|
|
|
278 |
#define XVID_GREYSCALE 0x01000000 /* enable greyscale only mode (even for */ |
#define XVID_GREYSCALE 0x01000000 /* enable greyscale only mode (even for */ |
279 |
#define XVID_GRAYSCALE 0x01000000 /* color input material chroma is ignored) */ |
#define XVID_GRAYSCALE 0x01000000 /* color input material chroma is ignored) */ |
280 |
|
|
281 |
|
#define XVID_GMC 0x20000000 |
282 |
|
#define XVID_ME_COLOUR 0x40000000 |
283 |
|
|
284 |
|
#define XVID_REDUCED 0x04000000 /* reduced resolution vop */ |
285 |
|
|
286 |
/* Flags for XVID_ENC_FRAME.motion */ |
/* Flags for XVID_ENC_FRAME.motion */ |
287 |
#define PMV_ADVANCEDDIAMOND8 0x00004000 |
#define PMV_ADVANCEDDIAMOND8 0x00004000 |
306 |
#define PMV_USESQUARES8 0x80000000 |
#define PMV_USESQUARES8 0x80000000 |
307 |
|
|
308 |
|
|
309 |
|
|
310 |
/***************************************************************************** |
/***************************************************************************** |
311 |
* Encoder structures |
* Encoder structures |
312 |
****************************************************************************/ |
****************************************************************************/ |
325 |
#ifdef _SMP |
#ifdef _SMP |
326 |
int num_threads; /* number of threads */ |
int num_threads; /* number of threads */ |
327 |
#endif |
#endif |
|
#ifdef BFRAMES |
|
328 |
int global; /* global/debug options */ |
int global; /* global/debug options */ |
329 |
int max_bframes; /* max sequential bframes (0=disable bframes) */ |
int max_bframes; /* max sequential bframes (0=disable bframes) */ |
330 |
int bquant_ratio; /* bframe quantizer multipier (percentage). |
int bquant_ratio; /* bframe quantizer multipier (percentage). |
332 |
* eg. 200 = x2 multiplier |
* eg. 200 = x2 multiplier |
333 |
* quant = ((past_quant + future_quant) * bquant_ratio)/200 |
* quant = ((past_quant + future_quant) * bquant_ratio)/200 |
334 |
*/ |
*/ |
335 |
|
int bquant_offset; /* bquant += bquant_offset */ |
336 |
int frame_drop_ratio; /* frame dropping: 0=drop none... 100=drop all */ |
int frame_drop_ratio; /* frame dropping: 0=drop none... 100=drop all */ |
|
#endif |
|
337 |
void *handle; /* [out] encoder instance handle */ |
void *handle; /* [out] encoder instance handle */ |
338 |
} |
} |
339 |
XVID_ENC_PARAM; |
XVID_ENC_PARAM; |
378 |
int length; /* [out] bitstream length (bytes) */ |
int length; /* [out] bitstream length (bytes) */ |
379 |
|
|
380 |
void *image; /* [in] image ptr */ |
void *image; /* [in] image ptr */ |
381 |
|
int stride; |
382 |
int colorspace; /* [in] source colorspace */ |
int colorspace; /* [in] source colorspace */ |
383 |
|
|
384 |
unsigned char *quant_intra_matrix; // [in] custom intra qmatrix */ |
unsigned char *quant_intra_matrix; // [in] custom intra qmatrix */ |
389 |
*/ |
*/ |
390 |
HINTINFO hint; /* [in/out] mv hint information */ |
HINTINFO hint; /* [in/out] mv hint information */ |
391 |
|
|
|
#ifdef BFRAMES |
|
392 |
int bquant; /* [in] bframe quantizer */ |
int bquant; /* [in] bframe quantizer */ |
|
#endif |
|
393 |
|
|
394 |
} |
} |
395 |
XVID_ENC_FRAME; |
XVID_ENC_FRAME; |
400 |
int quant; /* [out] frame quantizer */ |
int quant; /* [out] frame quantizer */ |
401 |
int hlength; /* [out] header length (bytes) */ |
int hlength; /* [out] header length (bytes) */ |
402 |
int kblks, mblks, ublks; /* [out] */ |
int kblks, mblks, ublks; /* [out] */ |
|
|
|
403 |
} |
} |
404 |
XVID_ENC_STATS; |
XVID_ENC_STATS; |
405 |
|
|