xvid.h

用MPEG-4对YUV视频文件编码压缩成divx视频文件

/*****************************************************************************
*
*  XVID MPEG-4 VIDEO CODEC
*  - XviD Main header file -
*
*  This program is an implementation of a part of one or more MPEG-4
*  Video tools as specified in ISO/IEC 14496-2 standard.  Those intending
*  to use this software module in hardware or software products are
*  advised that its use may infringe existing patents or copyrights, and
*  any such use would be at such party's own risk.  The original
*  developer of this software module and his/her company, and subsequent
*  editors and their companies, will have no liability for use of this
*  software or modifications or derivatives thereof.
*
*  This program is free software ; you can redistribute it and/or modify
*  it under the terms of the GNU General Public License as published by
*  the Free Software Foundation ; either version 2 of the License, or
*  (at your option) any later version.
*
*  This program is distributed in the hope that it will be useful,
*  but WITHOUT ANY WARRANTY ; without even the implied warranty of
*  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
*  GNU General Public License for more details.
*
*  You should have received a copy of the GNU General Public License
*  along with this program ; if not, write to the Free Software
*  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
*
*****************************************************************************/
/*****************************************************************************
*
*  History
*
*  - 2002/06/13 Added legal header, ANSI C comment style (only for this header
*               as it can be included in a ANSI C project).
*
*               ToDo ? : when BFRAMES is defined, the API_VERSION should not
*                        be the same (3.0 ?)
*
*  $Id: xvid.h,v 1.13 2002/06/23 03:58:32 suxen_drol Exp $
*
*****************************************************************************/


#ifndef _XVID_H_
#define _XVID_H_

#ifdef __cplusplus
extern "C" {
#endif
#include "user_macro.h"
/*****************************************************************************
 * Global constants
 ****************************************************************************/

/* API Version : 2.1 */
/*#define API_VERSION ((2 << 16) | (1))*/


/* Error codes */
#define XVID_ERR_FAIL		-1
#define XVID_ERR_OK			0
#define	XVID_ERR_MEMORY		1
#define XVID_ERR_FORMAT		2


/* Colorspaces */
#if 0
#define XVID_CSP_RGB24 	0
#define XVID_CSP_YV12	1
#define XVID_CSP_YUY2	2
#define XVID_CSP_UYVY	3
#define XVID_CSP_I420	4
#define XVID_CSP_RGB555	10
#define XVID_CSP_RGB565	11
#define XVID_CSP_USER	12
#define XVID_CSP_YVYU	1002
#define XVID_CSP_RGB32 	1000
#define XVID_CSP_NULL 	9999

#define XVID_CSP_VFLIP	0x80000000	/* flip mask*/
#endif

/*****************************************************************************
 *  Initialization constants
 ****************************************************************************/

/* CPU flags for XVID_INIT_PARAM.cpu_flags */
#if 0
#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_IA64		0x00000080

#define XVID_CPU_CHKONLY	0x40000000		/* check cpu only; dont init globals */
#define XVID_CPU_FORCE		0x80000000
#endif

/*****************************************************************************
 *  Initialization entry point
 ****************************************************************************/
void xvid_init(void);

/*****************************************************************************
 * Encoder constants
 ****************************************************************************/

/* Flags for XVID_ENC_PARAM.global */
#define XVID_GLOBAL_PACKED		0x00000001	/* packed bitstream */
#define XVID_GLOBAL_DX50BVOP	0x00000002	/* dx50 bvop compatibility */
#define XVID_GLOBAL_DEBUG		0x00000004	/* print debug info on each frame */

/* Flags for XVID_ENC_FRAME.general */
#define XVID_VALID_FLAGS		0x80000000

#define XVID_CUSTOM_QMATRIX		0x00000004	/* use custom quant matrix */
#define XVID_H263QUANT			0x00000010
#define XVID_MPEGQUANT			0x00000020
#define XVID_HALFPEL			0x00000040	/* use halfpel interpolation */
#define XVID_ADAPTIVEQUANT		0x00000080
#define XVID_LUMIMASKING		0x00000100
#define XVID_LATEINTRA			0x00000200

/*#define XVID_INTERLACING		0x00000400*/	/* enable interlaced encoding */
#define XVID_TOPFIELDFIRST		0x00000800	/* set top-field-first flag  */
#define XVID_ALTERNATESCAN		0x00001000	/* set alternate vertical scan flag */

#define XVID_HINTEDME_GET		0x00002000	/* receive mv hint data from core (1st pass) */
#define XVID_HINTEDME_SET		0x00004000	/* send mv hint data to core (2nd pass) */

#define XVID_INTER4V			0x00008000

#define XVID_ME_ZERO			0x00010000
#define XVID_ME_LOGARITHMIC		0x00020000
#define XVID_ME_FULLSEARCH		0x00040000
#define XVID_ME_PMVFAST			0x00080000
#define XVID_ME_EPZS			0x00100000


/* Flags for XVID_ENC_FRAME.motion */
#define HALFPELREFINE16 	0x00020000
#define HALFPELREFINE8 	    0x02000000
#if 0
#define PMV_ADVANCEDDIAMOND8	0x00004000
#define PMV_ADVANCEDDIAMOND16   0x00008000

#define PMV_HALFPELDIAMOND16 	0x00010000
#define PMV_HALFPELREFINE16 	0x00020000
#define PMV_EXTSEARCH16 		0x00040000	/* extend PMV by more searches */
#define PMV_EARLYSTOP16	   		0x00080000
#define PMV_QUICKSTOP16	   		0x00100000	/* like early, but without any more refinement */
#define PMV_UNRESTRICTED16   	0x00200000	/* unrestricted ME, not implemented */
#define PMV_OVERLAPPING16   	0x00400000	/* overlapping ME, not implemented */
#define PMV_USESQUARES16		0x00800000

#define PMV_HALFPELDIAMOND8 	0x01000000
#define PMV_HALFPELREFINE8 		0x02000000
#define PMV_EXTSEARCH8 			0x04000000	/* extend PMV by more searches */
#define PMV_EARLYSTOP8	   		0x08000000
#define PMV_QUICKSTOP8	   		0x10000000	/* like early, but without any more refinement */
#define PMV_UNRESTRICTED8   	0x20000000	/* unrestricted ME, not implemented */
#define PMV_OVERLAPPING8   		0x40000000	/* overlapping ME, not implemented */
#define PMV_USESQUARES8			0x80000000
#endif

#if 0 
#define ENC_CSP_RGB24 	0

/** Planar YUV, U & V subsampled by 2 in both directions, 
    average 12 bit per pixel; order of components y-v-u **/
#define ENC_CSP_YV12	1

/** Packed YUV, U and V subsampled by 2 horizontally,
    average 16 bit per pixel; order of components y-u-y-v **/
#define ENC_CSP_YUY2	2

/** Same as above, but order of components is u-y-v-y **/
#define ENC_CSP_UYVY	3

/** Same as ENC_CSP_YV12, but chroma components are swapped ( order y-u-v ) **/
#define ENC_CSP_I420	4

/** Same as above **/
#define ENC_CSP_IYUV	ENC_CSP_I420
#endif

/*****************************************************************************
 * Encoder structures
 ****************************************************************************/

	typedef struct
	{
		int width, height;
		int fincr, fbase;		/* frame increment, fbase. each frame = "fincr/fbase" seconds */
		int rc_type;			/*0-1表示使用位率控制模型0－为高位率模型，1－为低位率模型*/
		int rc_bitrate;			/* the bitrate of the target encoded stream, in bits/second */
		int rc_reaction_delay_factor;	/* how fast the rate control reacts - lower values are faster */
		int rc_averaging_period;	/* as above */
		int rc_buffer;			/* as above */
		int max_quantizer;		/* the upper limit of the quantizer */
		int min_quantizer;		/* the lower limit of the quantizer */
		int max_key_interval;	/* the maximum interval between key frames */
		int framerate;          
		int sequence_time;

		int global;				/* global/debug options */

/*		int bquant_ratio;*/		/* bframe quantizer multipier (percentage).
								 * used only when bquant < 1
								 * eg. 200 = x2 multiplier
								 * quant = ((past_quant + future_quant) * bquant_ratio)/200
								 */
/*#endif*/
		void *handle;			/* [out] encoder instance handle */
/*#ifdef CORE_DEBUG 
		void *pFile;		
#endif */
        void *pFile;
	}
	XVID_ENC_PARAM;

	typedef struct
	{
		int x;
		int y;
	}
	VECTOR;

#if 0
	typedef struct
	{
		int mode;				/* macroblock mode */
		VECTOR mvs[4];
	}
	MVBLOCKHINT;

	typedef struct
	{
		int intra;				/* frame intra choice */
		int fcode;				/* frame fcode */
		MVBLOCKHINT *block;		/* caller-allocated array of block hints (mb_width * mb_height) */
	}
	MVFRAMEHINT;

	typedef struct
	{
		int rawhints;			/* if set, use MVFRAMEHINT, else use compressed buffer */

		MVFRAMEHINT mvhint;
		void *hintstream;		/* compressed hint buffer */
		int hintlength;			/* length of buffer (bytes) */
	}
	HINTINFO;
#endif

	typedef struct
	{
		int rc_type;            /*-1,0,1 -1表示不在编码时改变编码器位率，*/
		/*0,1表示改变位率，分别使用一阶、二阶模型进行位率控制         */
		int framerate;	/*帧率*/
		int rc_bitrate; /*位率*/
		int rc_reaction_delay_factor;	/* how fast the rate control reacts - lower values are faster */
		int rc_averaging_period;	/* as above */
		int rc_buffer;			/* as above */
		/*int bquant_ratio;*/		/* bframe quantizer multipier (percentage).
								 * used only when bquant < 1
								 * eg. 200 = x2 multiplier
								 * quant = ((past_quant + future_quant) * bquant_ratio)/200
								 */
		int max_quantizer;		/* the upper limit of the quantizer */
		int min_quantizer;		/* the lower limit of the quantizer */
		/*int sequence_time;		*/
	
		int general;			/* [in] general options */
		int motion;				/* [in] ME options */
		void *bitstream;		/* [in] bitstream ptr */
		int length;				/* [out] bitstream length (bytes) */

		void *image;			/* [in] image ptr */

#ifdef _OUT_CONSTRUCT_IMAGE
		void *constructimage;
#endif
/*		int colorspace;*/			/* [in] source colorspace */
		int stride;

		float psnr;
/*		unsigned char *quant_intra_matrix;*/	/* [in] custom intra qmatrix */
		/*unsigned char *quant_inter_matrix;*/	/* [in] custom inter qmatrix */
		int quant;				/* [in] frame quantizer (vbr) */
		int intra;				/* [in] force intra frame (vbr only)
								 * [out] intra state
								 */
		/*HINTINFO hint;*/			/* [in/out] mv hint information */


		/* 12.7 fyh add */
        int flag_skipframe;
	}
	XVID_ENC_FRAME;

#if 0
	typedef struct
	{
		int quant;				/* [out] frame quantizer */
		int hlength;			/* [out] header length (bytes) */
		int kblks, mblks, ublks;	/* [out] */

	}
	XVID_ENC_STATS;
#endif

#ifdef __cplusplus
}
#endif

#endif