--- encoder.h 2002/06/12 20:38:40 1.9 +++ encoder.h 2003/02/22 08:49:44 1.27.2.1 @@ -1,49 +1,77 @@ -/************************************************************************** +/***************************************************************************** * - * Modifications: + * XVID MPEG-4 VIDEO CODEC + * - Encoder header - * - * 22.08.2001 added support for EXT_MODE encoding mode - * support for EXTENDED API - * 22.08.2001 fixed bug in iDQtab + * 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. * - * Michael Militzer + * 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 + * + * - 13.06.2002 Added legal header + * - 22.08.2001 Added support for EXT_MODE encoding mode + * support for EXTENDED API + * - 22.08.2001 fixed bug in iDQtab + * + * $Id: encoder.h,v 1.27.2.1 2003/02/22 08:49:44 suxen_drol Exp $ + * + ****************************************************************************/ #ifndef _ENCODER_H_ #define _ENCODER_H_ - #include "xvid.h" - #include "portab.h" #include "global.h" -#include "image/image.h" #include "utils/ratecontrol.h" +/***************************************************************************** + * Constants + ****************************************************************************/ + +/* Quatization type */ #define H263_QUANT 0 #define MPEG4_QUANT 1 +/* Indicates no quantizer changes in INTRA_Q/INTER_Q modes */ +#define NO_CHANGE 64 -typedef uint32_t bool; - - -typedef enum -{ - I_VOP = 0, - P_VOP = 1, - B_VOP = 2 -} -VOP_TYPE; - -/*********************************** - - Encoding Parameters - -************************************/ +/***************************************************************************** + * Types + ****************************************************************************/ + +typedef int bool; + +/***************************************************************************** + * Structures + ****************************************************************************/ typedef struct { + /* --- constants --- */ uint32_t width; uint32_t height; @@ -56,66 +84,86 @@ uint32_t fincr; uint32_t fbase; -#ifdef BFRAMES - int max_bframes; + xvid_global_t global_flags; + int bquant_ratio; + int bquant_offset; + int frame_drop_ratio; + +#ifdef _SMP + int num_threads; #endif + + int iMaxKeyInterval; + int max_bframes; + +/* --- inbetween vop stuff --- */ /* rounding type; alternate 0-1 after each interframe */ /* 1 <= fixed_code <= 4 automatically adjusted using motion vector statistics inside */ /* vars that not "quite" frame independant */ - uint32_t m_quant_type; uint32_t m_rounding_type; uint32_t m_fcode; + xvid_vol_t vol_flags; - HINTINFO *hint; + int64_t m_stamp; +} +MBParam; -#ifdef BFRAMES - uint32_t m_seconds; - uint32_t m_ticks; -#endif +typedef struct +{ + int iTextBits; + int iMvSum; + int iMvCount; + int kblks; + int mblks; + int ublks; + int gblks; } -MBParam; +Statistics; +/* encoding queue */ typedef struct { - uint32_t quant; - uint32_t motion_flags; - uint32_t global_flags; + xvid_enc_frame_t frame; + unsigned char quant_intra_matrix[64]; + unsigned char quant_inter_matrix[64]; + IMAGE image; +} QUEUEINFO; + - VOP_TYPE coding_type; +typedef struct +{ + xvid_vol_t vol_flags; + xvid_vop_t vop_flags; + xvid_motion_t motion_flags; + + int coding_type; + uint32_t quant; uint32_t rounding_type; uint32_t fcode; uint32_t bcode; -#ifdef BFRAMES uint32_t seconds; uint32_t ticks; -#endif + int64_t stamp; IMAGE image; MACROBLOCK *mbs; -} -FRAMEINFO; + WARPPOINTS warp; // as in bitstream + GMC_DATA gmc_data; // common data for all MBs -typedef struct -{ - int iTextBits; - float fMvPrevSigma; - int iMvSum; - int iMvCount; - int kblks; - int mblks; - int ublks; + int length; /* the encoded size of this frame */ + + Statistics sStat; } -Statistics; - +FRAMEINFO; typedef struct @@ -123,7 +171,6 @@ MBParam mbParam; int iFrameNum; - int iMaxKeyInterval; int bitrate; // images @@ -131,19 +178,22 @@ FRAMEINFO *current; FRAMEINFO *reference; -#ifdef _DEBUG IMAGE sOriginal; -#endif IMAGE vInterH; IMAGE vInterV; IMAGE vInterVf; IMAGE vInterHV; IMAGE vInterHVf; -#ifdef BFRAMES - /* constants */ - int bquant_ratio; - /* vars */ + IMAGE vGMC; + + /* image queue */ + int queue_head; + int queue_tail; + int queue_size; + QUEUEINFO *queue; + + /* bframe buffer */ int bframenum_head; int bframenum_tail; int flush_bframes; @@ -152,23 +202,22 @@ IMAGE f_refh; IMAGE f_refv; IMAGE f_refhv; -#endif - Statistics sStat; - RateControl rate_control; -} -Encoder; + /* closed_gop fixup temporary storage */ + int closed_bframenum; /* == -1 if there is no fixup intended */ + QUEUEINFO closed_qframe; /* qFrame, only valid when >= 0 */ -// indicates no quantizer changes in INTRA_Q/INTER_Q modes -#define NO_CHANGE 64 + int m_framenum; /* debug frame num counter; unlike iFrameNum, does not reset at ivop */ -void init_encoder(uint32_t cpu_flags); + RateControl rate_control; -int encoder_create(XVID_ENC_PARAM * pParam); -int encoder_destroy(Encoder * pEnc); -int encoder_encode(Encoder * pEnc, - XVID_ENC_FRAME * pFrame, - XVID_ENC_STATS * pResult); + float fMvPrevSigma; +} +Encoder; + +/***************************************************************************** + * Inline functions + ****************************************************************************/ static __inline uint8_t get_fcode(uint16_t sr) @@ -198,4 +247,17 @@ return 0; } -#endif /* _ENCODER_H_ */ + +/***************************************************************************** + * Prototypes + ****************************************************************************/ + +void init_encoder(uint32_t cpu_flags); + +int enc_create(xvid_enc_create_t * create, xvid_enc_rc_t * rc); +int enc_destroy(Encoder * pEnc); +int enc_encode(Encoder * pEnc, + xvid_enc_frame_t * pFrame, + xvid_enc_stats_t * stats); + +#endif