3 |
* XVID MPEG-4 VIDEO CODEC |
* XVID MPEG-4 VIDEO CODEC |
4 |
* - Xvid Main header file - |
* - Xvid Main header file - |
5 |
* |
* |
6 |
* Copyright(C) 2001-2004 Peter Ross <pross@xvid.org> |
* Copyright(C) 2001-2011 Peter Ross <pross@xvid.org> |
7 |
* |
* |
8 |
* This program is free software ; you can redistribute it and/or modify |
* This program is free software ; you can redistribute it and/or modify |
9 |
* it under the terms of the GNU General Public License as published by |
* it under the terms of the GNU General Public License as published by |
19 |
* along with this program ; if not, write to the Free Software |
* along with this program ; if not, write to the Free Software |
20 |
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
21 |
* |
* |
22 |
* $Id: xvid.h,v 1.68 2010-09-13 07:38:09 Isibaar Exp $ |
* $Id$ |
23 |
* |
* |
24 |
****************************************************************************/ |
****************************************************************************/ |
25 |
|
|
26 |
#ifndef _XVID_H_ |
#ifndef _XVID_H_ |
27 |
#define _XVID_H_ |
#define _XVID_H_ |
28 |
|
|
|
|
|
29 |
#ifdef __cplusplus |
#ifdef __cplusplus |
30 |
extern "C" { |
extern "C" { |
31 |
#endif |
#endif |
32 |
|
|
33 |
/***************************************************************************** |
/***************************************************************************** |
34 |
|
* function export defines |
35 |
|
****************************************************************************/ |
36 |
|
|
37 |
|
#ifndef XVID_IMPEXP |
38 |
|
#define XVID_IMPEXP extern |
39 |
|
#endif |
40 |
|
|
41 |
|
#ifndef XVID_CALL |
42 |
|
#define XVID_CALL |
43 |
|
#endif |
44 |
|
|
45 |
|
/***************************************************************************** |
46 |
* versioning |
* versioning |
47 |
****************************************************************************/ |
****************************************************************************/ |
48 |
|
|
68 |
#define XVID_API_MAJOR(a) (((a)>>16) & 0xff) |
#define XVID_API_MAJOR(a) (((a)>>16) & 0xff) |
69 |
#define XVID_API_MINOR(a) (((a)>> 0) & 0xff) |
#define XVID_API_MINOR(a) (((a)>> 0) & 0xff) |
70 |
|
|
71 |
#define XVID_VERSION XVID_MAKE_VERSION(1,3,-127) |
#define XVID_VERSION XVID_MAKE_VERSION(1,4,-127) |
72 |
#define XVID_API XVID_MAKE_API(4, 3) |
#define XVID_API XVID_MAKE_API(4, 4) |
73 |
|
|
74 |
#define XVID_UNSTABLE |
#define XVID_UNSTABLE |
75 |
|
|
84 |
* doesnt hurt but not increasing it could cause difficulty for decoders in the |
* doesnt hurt but not increasing it could cause difficulty for decoders in the |
85 |
* future |
* future |
86 |
*/ |
*/ |
87 |
#define XVID_BS_VERSION 57 |
#define XVID_BS_VERSION 73 |
88 |
|
|
89 |
/***************************************************************************** |
/***************************************************************************** |
90 |
* error codes |
* error codes |
236 |
#define XVID_GBL_INFO 1 /* return some info about xvidcore, and the host computer */ |
#define XVID_GBL_INFO 1 /* return some info about xvidcore, and the host computer */ |
237 |
#define XVID_GBL_CONVERT 2 /* colorspace conversion utility */ |
#define XVID_GBL_CONVERT 2 /* colorspace conversion utility */ |
238 |
|
|
239 |
extern int xvid_global(void *handle, int opt, void *param1, void *param2); |
XVID_IMPEXP int XVID_CALL xvid_global(void *handle, int opt, void *param1, void *param2); |
240 |
|
|
241 |
|
|
242 |
/***************************************************************************** |
/***************************************************************************** |
247 |
#define XVID_DEC_DESTROY 1 /* destroy decore instance: return 0 on success */ |
#define XVID_DEC_DESTROY 1 /* destroy decore instance: return 0 on success */ |
248 |
#define XVID_DEC_DECODE 2 /* decode a frame: returns number of bytes consumed >= 0 */ |
#define XVID_DEC_DECODE 2 /* decode a frame: returns number of bytes consumed >= 0 */ |
249 |
|
|
250 |
extern int xvid_decore(void *handle, int opt, void *param1, void *param2); |
XVID_IMPEXP int XVID_CALL xvid_decore(void *handle, int opt, void *param1, void *param2); |
251 |
|
|
252 |
/* XVID_DEC_CREATE param 1 |
/* XVID_DEC_CREATE param 1 |
253 |
image width & height as well as FourCC code may be specified |
image width & height as well as FourCC code may be specified |
257 |
int width; /* [in:opt] image width */ |
int width; /* [in:opt] image width */ |
258 |
int height; /* [in:opt] image width */ |
int height; /* [in:opt] image width */ |
259 |
void * handle; /* [out] decore context handle */ |
void * handle; /* [out] decore context handle */ |
260 |
int fourcc; /* [in:opt] fourcc of the video */ |
/* ------- v1.3.x ------- */ |
261 |
|
int fourcc; /* [in:opt] fourcc of the input video */ |
262 |
|
int num_threads;/* [in:opt] number of threads to use in decoder */ |
263 |
} xvid_dec_create_t; |
} xvid_dec_create_t; |
264 |
|
|
265 |
|
|
383 |
#define XVID_REQDQUANTS (1<<2) /* plugin requires access to the dquant table */ |
#define XVID_REQDQUANTS (1<<2) /* plugin requires access to the dquant table */ |
384 |
#define XVID_REQLAMBDA (1<<3) /* plugin requires access to the lambda table */ |
#define XVID_REQLAMBDA (1<<3) /* plugin requires access to the lambda table */ |
385 |
|
|
|
|
|
386 |
typedef struct |
typedef struct |
387 |
{ |
{ |
388 |
int version; |
int version; |
486 |
|
|
487 |
****************************************************************************/ |
****************************************************************************/ |
488 |
|
|
489 |
typedef int (xvid_plugin_func)(void * handle, int opt, void * param1, void * param2); |
typedef int (XVID_CALL xvid_plugin_func)(void * handle, int opt, void * param1, void * param2); |
490 |
|
|
491 |
typedef struct |
typedef struct |
492 |
{ |
{ |
494 |
void * param; |
void * param; |
495 |
} xvid_enc_plugin_t; |
} xvid_enc_plugin_t; |
496 |
|
|
497 |
|
XVID_IMPEXP xvid_plugin_func xvid_plugin_single; /* single-pass rate control */ |
498 |
|
XVID_IMPEXP xvid_plugin_func xvid_plugin_2pass1; /* two-pass rate control: first pass */ |
499 |
|
XVID_IMPEXP xvid_plugin_func xvid_plugin_2pass2; /* two-pass rate control: second pass */ |
500 |
|
|
501 |
extern xvid_plugin_func xvid_plugin_single; /* single-pass rate control */ |
XVID_IMPEXP xvid_plugin_func xvid_plugin_lumimasking; /* lumimasking */ |
|
extern xvid_plugin_func xvid_plugin_2pass1; /* two-pass rate control: first pass */ |
|
|
extern xvid_plugin_func xvid_plugin_2pass2; /* two-pass rate control: second pass */ |
|
|
|
|
|
extern xvid_plugin_func xvid_plugin_lumimasking; /* lumimasking */ |
|
502 |
|
|
503 |
extern xvid_plugin_func xvid_plugin_psnr; /* write psnr values to stdout */ |
XVID_IMPEXP xvid_plugin_func xvid_plugin_psnr; /* write psnr values to stdout */ |
504 |
extern xvid_plugin_func xvid_plugin_dump; /* dump before and after yuvpgms */ |
XVID_IMPEXP xvid_plugin_func xvid_plugin_dump; /* dump before and after yuvpgms */ |
505 |
|
|
506 |
extern xvid_plugin_func xvid_plugin_ssim; /*write ssim values to stdout*/ |
XVID_IMPEXP xvid_plugin_func xvid_plugin_ssim; /*write ssim values to stdout*/ |
507 |
|
XVID_IMPEXP xvid_plugin_func xvid_plugin_psnrhvsm; /*write psnrhvsm values to stdout*/ |
508 |
|
|
509 |
|
|
510 |
/* single pass rate control |
/* single pass rate control |
552 |
int container_frame_overhead; /* [in] How many bytes the controller has to compensate per frame due to container format overhead */ |
int container_frame_overhead; /* [in] How many bytes the controller has to compensate per frame due to container format overhead */ |
553 |
|
|
554 |
/* ------- v1.1.x ------- */ |
/* ------- v1.1.x ------- */ |
555 |
int vbv_size; /* [in] buffer size (bits) */ |
int vbv_size; /* [in] buffer size (bits) If this is zero, VBV check is disabled.*/ |
556 |
int vbv_initial; /* [in] initial buffer occupancy (bits) */ |
int vbv_initial; /* [in] initial buffer occupancy (bits) */ |
557 |
int vbv_maxrate; /* [in] max processing bitrate (bits per second) */ |
int vbv_maxrate; /* [in] max processing bitrate (bits per second) */ |
558 |
int vbv_peakrate; /* [in:opt] max average bitrate over 3 seconds (bits per second) */ |
int vbv_peakrate; /* [in:opt] max average bitrate over 1 second (bits per second). |
559 |
|
* This is used for diagnostics only and won't affect the actual peak bitrate. |
560 |
|
* This is not a problem as long as vbv_peakrate > vbv_size + vbv_maxrate which |
561 |
|
* guarantees that vbv_peakrate won't be exceeded. */ |
562 |
}xvid_plugin_2pass2_t; |
}xvid_plugin_2pass2_t; |
563 |
|
|
564 |
|
|
601 |
* Encoder entry point |
* Encoder entry point |
602 |
*--------------------------------------------------------------------------*/ |
*--------------------------------------------------------------------------*/ |
603 |
|
|
604 |
extern int xvid_encore(void *handle, int opt, void *param1, void *param2); |
XVID_IMPEXP int XVID_CALL xvid_encore(void *handle, int opt, void *param1, void *param2); |
605 |
|
|
606 |
/* Quick API reference |
/* Quick API reference |
607 |
* |
* |
680 |
#define XVID_VOP_MODEDECISION_RD (1<< 8) /* enable DCT-ME and use it for mode decision */ |
#define XVID_VOP_MODEDECISION_RD (1<< 8) /* enable DCT-ME and use it for mode decision */ |
681 |
#define XVID_VOP_FAST_MODEDECISION_RD (1<<12) /* use simplified R-D mode decision */ |
#define XVID_VOP_FAST_MODEDECISION_RD (1<<12) /* use simplified R-D mode decision */ |
682 |
#define XVID_VOP_RD_BVOP (1<<13) /* enable rate-distortion mode decision in b-frames */ |
#define XVID_VOP_RD_BVOP (1<<13) /* enable rate-distortion mode decision in b-frames */ |
683 |
|
#define XVID_VOP_RD_PSNRHVSM (1<<14) /* use PSNR-HVS-M as metric for rate-distortion optimizations */ |
684 |
|
|
685 |
/* Only valid for vol_flags|=XVID_VOL_INTERLACING */ |
/* Only valid for vol_flags|=XVID_VOL_INTERLACING */ |
686 |
#define XVID_VOP_TOPFIELDFIRST (1<< 9) /* set top-field-first flag */ |
#define XVID_VOP_TOPFIELDFIRST (1<< 9) /* set top-field-first flag */ |
758 |
int num_plugins; /* [in:opt] number of plugins */ |
int num_plugins; /* [in:opt] number of plugins */ |
759 |
xvid_enc_plugin_t * plugins; /* ^^ plugin array */ |
xvid_enc_plugin_t * plugins; /* ^^ plugin array */ |
760 |
|
|
761 |
int num_threads; /* [in:opt] number of threads */ |
int num_threads; /* [in:opt] number of threads to use in encoder */ |
762 |
int max_bframes; /* [in:opt] max sequential bframes (0=disable bframes) */ |
int max_bframes; /* [in:opt] max sequential bframes (0=disable bframes) */ |
763 |
|
|
764 |
int global; /* [in:opt] global flags; controls encoding behavior */ |
int global; /* [in:opt] global flags; controls encoding behavior */ |
784 |
|
|
785 |
/* ------- v1.3.x ------- */ |
/* ------- v1.3.x ------- */ |
786 |
int start_frame_num; /* [in:opt] frame number of start frame relative to zones definitions. allows to encode sub-sequences */ |
int start_frame_num; /* [in:opt] frame number of start frame relative to zones definitions. allows to encode sub-sequences */ |
787 |
|
int num_slices; /* [in:opt] number of slices to code for each frame */ |
788 |
} xvid_enc_create_t; |
} xvid_enc_create_t; |
789 |
|
|
790 |
|
|