xvid.h

MPEG-4编解码的实现(包括MPEG4视音频编解码)

#ifndef _XVID_H_
#define _XVID_H_

#ifndef _WIN32
#include <config.h>
#endif

#ifdef __cplusplus
extern "C" {
#endif 

// ==========================================
//	global
// ==========================================

// API Version: 2.0
#define API_VERSION ((2 << 16) | (0))

// 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

// colorspaces
#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

// error
#define XVID_ERR_FAIL		-1
#define XVID_ERR_OK			0
#define	XVID_ERR_MEMORY		1
#define XVID_ERR_FORMAT		2

typedef struct 
{
	int cpu_flags;
	int api_version;
	int core_build;
} XVID_INIT_PARAM;

int xvid_init(void *handle, int opt,
			  void *param1, void *param2);


// ==========================================
//	decoder
// ==========================================

#define XVID_QUICK_DECODE		0x00000010 /* increases decoding speed but reduces quality */

typedef struct 
{
	int width;
	int height;
	void *handle;
} XVID_DEC_PARAM;


typedef struct
{
	int general;			
	void * bitstream;
	int length;

	void * image;
	int stride;
	int colorspace;
} XVID_DEC_FRAME;


// decoder options
#define XVID_DEC_DECODE		0
#define XVID_DEC_CREATE		1
#define XVID_DEC_DESTROY	2
#define XVID_DEC_ALLOC          3
#define XVID_DEC_FIND_VOL       4

int xvid_decore(void * handle,
		int opt,
		void * param1,
		void * param2);


// ==========================================
//	encoder
// ==========================================

/* Do not rely on the VALUES of these constants, they may be changed at any time */
#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 (cosmetic only) */
#define XVID_ALTERNATESCAN		0x00001000		/* ?? sets 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

#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		


typedef struct
{
	int width, height;
	int fincr, fbase;		// frame increment, fbase. each frame = "fincr/fbase" seconds
	int bitrate;			// the bitrate of the target encoded stream, in bits/second
	int rc_buffersize;		// the rate control buffersize / max. allowed deviation
	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

	void * handle;			// [out] encoder instance handle
						
} XVID_ENC_PARAM;


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

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;

typedef struct
{
	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
    int colorspace;			// [in] source colorspace

#ifdef MPEG4IP
	// [in] image ptr YUV planes
	void* image_y;
	void* image_u;
	void* image_v;
	int stride;				// [in] byte length of y scanline
#endif

	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
} XVID_ENC_FRAME;


typedef struct
{
	int quant;					// [out] frame quantizer
	int hlength;				// [out] header length (bytes)
	int kblks, mblks, ublks;	// [out]
	
#ifdef MPEG4IP
	// [out] reconstructed image
	void* image_y;
	void* image_u;
	void* image_v;
	int stride_y;
	int stride_uv;
#endif

} XVID_ENC_STATS;


#define XVID_ENC_ENCODE		0
#define XVID_ENC_CREATE		1
#define XVID_ENC_DESTROY	2

int xvid_encore(void * handle,
		int opt,
		void * param1,
		void * param2);


#ifdef __cplusplus
}
#endif 

#endif /* _XVID_H_ */