]> git.sesse.net Git - ffmpeg/blob - libavcodec/mpegvideo.h
more compare functions (rd & bit)
[ffmpeg] / libavcodec / mpegvideo.h
1 /*
2  * Generic DCT based hybrid video encoder
3  * Copyright (c) 2000, 2001, 2002 Fabrice Bellard.
4  *
5  * This library is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU Lesser General Public
7  * License as published by the Free Software Foundation; either
8  * version 2 of the License, or (at your option) any later version.
9  *
10  * This library is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  * Lesser General Public License for more details.
14  *
15  * You should have received a copy of the GNU Lesser General Public
16  * License along with this library; if not, write to the Free Software
17  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
18  */
19
20 #ifndef AVCODEC_MPEGVIDEO_H
21 #define AVCODEC_MPEGVIDEO_H
22
23 #define FRAME_SKIPED 100 // return value for header parsers if frame is not coded
24
25 enum OutputFormat {
26     FMT_MPEG1,
27     FMT_H263,
28     FMT_MJPEG, 
29 };
30
31 #define EDGE_WIDTH 16
32
33 #define MPEG_BUF_SIZE (16 * 1024)
34
35 #define QMAT_SHIFT_MMX 16
36 #define QMAT_SHIFT 22
37
38 #define MAX_FCODE 7
39 #define MAX_MV 2048
40
41 #define MAX_PICTURE_COUNT 15
42
43 #define ME_MAP_SIZE 64
44 #define ME_MAP_SHIFT 3
45 #define ME_MAP_MV_BITS 11
46
47 /* run length table */
48 #define MAX_RUN    64
49 #define MAX_LEVEL  64
50
51 #define I_TYPE FF_I_TYPE  // Intra
52 #define P_TYPE FF_P_TYPE  // Predicted
53 #define B_TYPE FF_B_TYPE  // Bi-dir predicted
54 #define S_TYPE FF_S_TYPE  // S(GMC)-VOP MPEG4
55
56 typedef struct Predictor{
57     double coeff;
58     double count;
59     double decay;
60 } Predictor;
61
62 typedef struct RateControlEntry{
63     int pict_type;
64     float qscale;
65     int mv_bits;
66     int i_tex_bits;
67     int p_tex_bits;
68     int misc_bits;
69     UINT64 expected_bits;
70     int new_pict_type;
71     float new_qscale;
72     int mc_mb_var_sum;
73     int mb_var_sum;
74     int i_count;
75     int f_code;
76     int b_code;
77 }RateControlEntry;
78
79 typedef struct RateControlContext{
80     FILE *stats_file;
81     int num_entries;          /* number of RateControlEntries */
82     RateControlEntry *entry;
83     int buffer_index;         /* amount of bits in the video/audio buffer */
84     Predictor pred[5];
85     double short_term_qsum;   /* sum of recent qscales */
86     double short_term_qcount; /* count of recent qscales */
87     double pass1_rc_eq_output_sum;/* sum of the output of the rc equation, this is used for normalization  */
88     double pass1_wanted_bits; /* bits which should have been outputed by the pass1 code (including complexity init) */
89     double last_qscale;
90     double last_qscale_for[5]; /* last qscale for a specific pict type, used for max_diff & ipb factor stuff */
91     int last_mc_mb_var_sum;
92     int last_mb_var_sum;
93     UINT64 i_cplx_sum[5];
94     UINT64 p_cplx_sum[5];
95     UINT64 mv_bits_sum[5];
96     UINT64 qscale_sum[5];
97     int frame_count[5];
98     int last_non_b_pict_type;
99 }RateControlContext;
100
101
102 typedef struct ScanTable{
103     const UINT8 *scantable;
104     UINT8 permutated[64];
105     UINT8 raster_end[64];
106 #ifdef ARCH_POWERPC
107                 /* Used by dct_quantise_alitvec to find last-non-zero */
108     UINT8 __align8 inverse[64];
109 #endif
110 } ScanTable;
111
112 typedef struct Picture{
113     FF_COMMON_FRAME
114
115     int mb_var_sum;             /* sum of MB variance for current frame */
116     int mc_mb_var_sum;          /* motion compensated MB variance for current frame */
117     uint16_t *mb_var;           /* Table for MB variances */
118     uint16_t *mc_mb_var;        /* Table for motion compensated MB variances */
119     uint8_t *mb_mean;           /* Table for MB luminance */
120     int b_frame_score;          /* */
121 } Picture;
122
123 typedef struct ParseContext{
124     UINT8 *buffer;
125     int index;
126     int last_index;
127     int buffer_size;
128     int state;
129     int frame_start_found;
130 } ParseContext;
131
132 struct MpegEncContext;
133
134 typedef struct MotionEstContext{
135     int skip;                          /* set if ME is skiped for the current MB */
136     int co_located_mv[4][2];           /* mv from last p frame for direct mode ME */
137     int direct_basis_mv[4][2];
138     uint8_t *scratchpad;               /* data area for the me algo, so that the ME doesnt need to malloc/free */
139     uint32_t *map;                     /* map to avoid duplicate evaluations */
140     uint32_t *score_map;               /* map to store the scores */
141     int map_generation;  
142     int pre_penalty_factor;
143     int penalty_factor;
144     int sub_penalty_factor;
145     int pre_pass;                      /* = 1 for the pre pass */
146     int dia_size;
147     UINT16 (*mv_penalty)[MAX_MV*2+1];  /* amount of bits needed to encode a MV */
148     int (*sub_motion_search)(struct MpegEncContext * s,
149                                   int *mx_ptr, int *my_ptr, int dmin,
150                                   int xmin, int ymin, int xmax, int ymax,
151                                   int pred_x, int pred_y, Picture *ref_picture, 
152                                   int n, int size, uint16_t * const mv_penalty);
153     int (*motion_search[7])(struct MpegEncContext * s, int block,
154                              int *mx_ptr, int *my_ptr,
155                              int P[10][2], int pred_x, int pred_y,
156                              int xmin, int ymin, int xmax, int ymax, Picture *ref_picture, int16_t (*last_mv)[2], 
157                              int ref_mv_scale, uint16_t * const mv_penalty);
158     int (*pre_motion_search)(struct MpegEncContext * s, int block,
159                              int *mx_ptr, int *my_ptr,
160                              int P[10][2], int pred_x, int pred_y,
161                              int xmin, int ymin, int xmax, int ymax, Picture *ref_picture, int16_t (*last_mv)[2], 
162                              int ref_mv_scale, uint16_t * const mv_penalty);
163 }MotionEstContext;
164
165 typedef struct MpegEncContext {
166     struct AVCodecContext *avctx;
167     /* the following parameters must be initialized before encoding */
168     int width, height; /* picture size. must be a multiple of 16 */
169     int gop_size;
170     int frame_rate; /* number of frames per second */
171     int intra_only; /* if true, only intra pictures are generated */
172     int bit_rate;        /* wanted bit rate */
173     int bit_rate_tolerance; /* amount of +- bits (>0)*/
174     enum OutputFormat out_format; /* output format */
175     int h263_pred;    /* use mpeg4/h263 ac/dc predictions */
176
177 /* the following codec id fields are deprecated in favor of codec_id */
178     int h263_plus; /* h263 plus headers */
179     int h263_rv10; /* use RV10 variation for H263 */
180     int h263_msmpeg4; /* generate MSMPEG4 compatible stream (deprecated, use msmpeg4_version instead)*/
181     int h263_intel; /* use I263 intel h263 header */
182     
183     int codec_id;     /* see CODEC_ID_xxx */
184     int fixed_qscale; /* fixed qscale if non zero */
185     float qcompress;  /* amount of qscale change between easy & hard scenes (0.0-1.0) */
186     float qblur;      /* amount of qscale smoothing over time (0.0-1.0) */
187     int qmin;         /* min qscale */
188     int qmax;         /* max qscale */
189     int max_qdiff;    /* max qscale difference between frames */
190     int encoding;     /* true if we are encoding (vs decoding) */
191     int flags;        /* AVCodecContext.flags (HQ, MV4, ...) */
192     int max_b_frames; /* max number of b-frames for encoding */
193     int b_frame_strategy;
194     int luma_elim_threshold;
195     int chroma_elim_threshold;
196     int strict_std_compliance; /* strictly follow the std (MPEG4, ...) */
197     int workaround_bugs;       /* workaround bugs in encoders which cannot be detected automatically */
198     /* the following fields are managed internally by the encoder */
199
200     /* bit output */
201     PutBitContext pb;
202
203     /* sequence parameters */
204     int context_initialized;
205     int input_picture_number;
206     int picture_number;
207     int picture_in_gop_number; /* 0-> first pic in gop, ... */
208     int b_frames_since_non_b;  /* used for encoding, relative to not yet reordered input */
209     int mb_width, mb_height;   /* number of MBs horizontally & vertically */
210     int h_edge_pos, v_edge_pos;/* horizontal / vertical position of the right/bottom edge (pixel replicateion)*/
211     int mb_num;                /* number of MBs of a picture */
212     int linesize;              /* line size, in bytes, may be different from width */
213     int uvlinesize;            /* line size, for chroma in bytes, may be different from width */
214     Picture picture[MAX_PICTURE_COUNT]; /* main picture buffer */
215     Picture *input_picture[MAX_PICTURE_COUNT]; /* next pictures on display order for encoding*/
216     Picture *reordered_input_picture[MAX_PICTURE_COUNT]; /* pointer to the next pictures in codedorder for encoding*/
217     Picture last_picture;       /* previous picture */
218     Picture next_picture;       /* previous picture (for bidir pred) */
219     Picture new_picture;        /* source picture for encoding */
220     Picture current_picture;    /* buffer to store the decompressed current picture */
221     int last_dc[3];              /* last DC values for MPEG1 */
222     INT16 *dc_val[3];            /* used for mpeg4 DC prediction, all 3 arrays must be continuous */
223     int y_dc_scale, c_dc_scale;
224     UINT8 *y_dc_scale_table;     /* qscale -> y_dc_scale table */
225     UINT8 *c_dc_scale_table;     /* qscale -> c_dc_scale table */
226     UINT8 *coded_block;          /* used for coded block pattern prediction (msmpeg4v3, wmv1)*/
227     INT16 (*ac_val[3])[16];      /* used for for mpeg4 AC prediction, all 3 arrays must be continuous */
228     int ac_pred;
229     int mb_skiped;              /* MUST BE SET only during DECODING */
230     UINT8 *mbskip_table;        /* used to avoid copy if macroblock skipped (for black regions for example) 
231                                    and used for b-frame encoding & decoding (contains skip table of next P Frame) */
232     UINT8 *mbintra_table;       /* used to avoid setting {ac, dc, cbp}-pred stuff to zero on inter MB decoding */
233     UINT8 *cbp_table;           /* used to store cbp, ac_pred for partitioned decoding */
234     UINT8 *pred_dir_table;      /* used to store pred_dir for partitioned decoding */
235     uint8_t *allocated_edge_emu_buffer;
236     uint8_t *edge_emu_buffer;     /* points into the middle of allocated_edge_emu_buffer */ 
237
238     int qscale;                 /* QP */
239     float frame_qscale;         /* qscale from the frame level rc FIXME remove*/
240     int adaptive_quant;         /* use adaptive quantization */
241     int dquant;                 /* qscale difference to prev qscale */ 
242     int pict_type;              /* I_TYPE, P_TYPE, B_TYPE, ... */
243     int last_pict_type;
244     int last_non_b_pict_type;   /* used for mpeg4 gmc b-frames & ratecontrol */
245     int frame_rate_index;
246     /* motion compensation */
247     int unrestricted_mv;
248     int h263_long_vectors; /* use horrible h263v1 long vector mode */
249
250     DSPContext dsp;             /* pointers for accelerated dsp fucntions */
251     int f_code; /* forward MV resolution */
252     int b_code; /* backward MV resolution for B Frames (mpeg4) */
253     INT16 (*motion_val)[2];            /* used for MV prediction (4MV per MB) */
254     INT16 (*p_mv_table)[2];            /* MV table (1MV per MB) p-frame encoding */
255     INT16 (*b_forw_mv_table)[2];       /* MV table (1MV per MB) forward mode b-frame encoding */
256     INT16 (*b_back_mv_table)[2];       /* MV table (1MV per MB) backward mode b-frame encoding */
257     INT16 (*b_bidir_forw_mv_table)[2]; /* MV table (1MV per MB) bidir mode b-frame encoding */
258     INT16 (*b_bidir_back_mv_table)[2]; /* MV table (1MV per MB) bidir mode b-frame encoding */
259     INT16 (*b_direct_mv_table)[2];     /* MV table (1MV per MB) direct mode b-frame encoding */
260     int me_method;                     /* ME algorithm */
261     int scene_change_score;
262     int mv_dir;
263 #define MV_DIR_BACKWARD  1
264 #define MV_DIR_FORWARD   2
265 #define MV_DIRECT        4 // bidirectional mode where the difference equals the MV of the last P/S/I-Frame (mpeg4)
266     int mv_type;
267 #define MV_TYPE_16X16       0   /* 1 vector for the whole mb */
268 #define MV_TYPE_8X8         1   /* 4 vectors (h263, mpeg4 4MV) */
269 #define MV_TYPE_16X8        2   /* 2 vectors, one per 16x8 block */ 
270 #define MV_TYPE_FIELD       3   /* 2 vectors, one per field */ 
271 #define MV_TYPE_DMV         4   /* 2 vectors, special mpeg2 Dual Prime Vectors */
272     /* motion vectors for a macroblock 
273        first coordinate : 0 = forward 1 = backward
274        second "         : depend on type
275        third  "         : 0 = x, 1 = y
276     */
277     int mv[2][4][2];
278     int field_select[2][2];
279     int last_mv[2][2][2];             /* last MV, used for MV prediction in MPEG1 & B-frame MPEG4 */
280     UINT8 *fcode_tab; /* smallest fcode needed for each MV */
281     
282     MotionEstContext me;
283
284     int no_rounding; /* apply no rounding to motion compensation (MPEG4, msmpeg4, ...) 
285                         for b-frames rounding mode is allways 0 */
286
287     int hurry_up;     /* when set to 1 during decoding, b frames will be skiped
288                          when set to 2 idct/dequant will be skipped too */
289                         
290     /* macroblock layer */
291     int mb_x, mb_y;
292     int mb_incr;
293     int mb_intra;
294     UINT8 *mb_type;       /* Table for MB type */
295 #define MB_TYPE_INTRA    0x01
296 #define MB_TYPE_INTER    0x02
297 #define MB_TYPE_INTER4V  0x04
298 #define MB_TYPE_SKIPED   0x08
299 #define MB_TYPE_GMC      0x10
300
301 #define MB_TYPE_DIRECT   0x10
302 #define MB_TYPE_FORWARD  0x20
303 #define MB_TYPE_BACKWARD 0x40
304 #define MB_TYPE_BIDIR    0x80
305
306     int block_index[6]; /* index to current MB in block based arrays with edges*/
307     int block_wrap[6];
308
309     /* matrix transmitted in the bitstream */
310     UINT16 intra_matrix[64];
311     UINT16 chroma_intra_matrix[64];
312     UINT16 inter_matrix[64];
313     UINT16 chroma_inter_matrix[64];
314 #define QUANT_BIAS_SHIFT 4
315     int intra_quant_bias;    /* bias for the quantizer */
316     int inter_quant_bias;    /* bias for the quantizer */
317     int min_qcoeff;          /* minimum encodable coefficient */
318     int max_qcoeff;          /* maximum encodable coefficient */
319     int ac_esc_length;       /* num of bits needed to encode the longest esc */
320     uint8_t *intra_ac_vlc_length;
321     uint8_t *intra_ac_vlc_last_length;
322     uint8_t *inter_ac_vlc_length;
323     uint8_t *inter_ac_vlc_last_length;
324 #define UNI_AC_ENC_INDEX(run,level) ((run)*128 + (level))
325
326     /* precomputed matrix (combine qscale and DCT renorm) */
327     int __align8 q_intra_matrix[32][64];
328     int __align8 q_inter_matrix[32][64];
329     /* identical to the above but for MMX & these are not permutated */
330     UINT16 __align8 q_intra_matrix16[32][64];
331     UINT16 __align8 q_inter_matrix16[32][64];
332     UINT16 __align8 q_intra_matrix16_bias[32][64];
333     UINT16 __align8 q_inter_matrix16_bias[32][64];
334     int block_last_index[6];  /* last non zero coefficient in block */
335     /* scantables */
336     ScanTable __align8 intra_scantable;
337     ScanTable intra_h_scantable;
338     ScanTable intra_v_scantable;
339     ScanTable inter_scantable; // if inter == intra then intra should be used to reduce tha cache usage
340     UINT8 idct_permutation[64];
341     int idct_permutation_type;
342 #define FF_NO_IDCT_PERM 1
343 #define FF_LIBMPEG2_IDCT_PERM 2
344 #define FF_SIMPLE_IDCT_PERM 3
345 #define FF_TRANSPOSE_IDCT_PERM 4
346
347     void *opaque; /* private data for the user */
348
349     /* bit rate control */
350     int I_frame_bits; //FIXME used in mpeg12 ...
351     INT64 wanted_bits;
352     INT64 total_bits;
353     int frame_bits;        /* bits used for the current frame */
354     RateControlContext rc_context; // contains stuff only accessed in ratecontrol.c
355
356     /* statistics, used for 2-pass encoding */
357     int mv_bits;
358     int header_bits;
359     int i_tex_bits;
360     int p_tex_bits;
361     int i_count;
362     int f_count;
363     int b_count;
364     int skip_count;
365     int misc_bits; // cbp, mb_type
366     int last_bits; //temp var used for calculating the above vars
367     
368     /* error concealment / resync */
369     UINT8 *error_status_table;       /* table of the error status of each MB */ 
370 #define VP_START            1        /* current MB is the first after a resync marker */
371 #define AC_ERROR            2
372 #define DC_ERROR            4
373 #define MV_ERROR            8
374 #define AC_END              16
375 #define DC_END              32
376 #define MV_END              64
377 //FIXME some prefix?
378     
379     int resync_mb_x;                 /* x position of last resync marker */
380     int resync_mb_y;                 /* y position of last resync marker */
381     GetBitContext last_resync_gb;    /* used to search for the next resync marker */
382     int mb_num_left;                 /* number of MBs left in this video packet (for partitioned Slices only)*/
383     int next_p_frame_damaged;        /* set if the next p frame is damaged, to avoid showing trashed b frames */
384     int error_resilience;
385     
386     ParseContext parse_context;
387
388     /* H.263 specific */
389     int gob_number;
390     int gob_index;
391         
392     /* H.263+ specific */
393     int umvplus;
394     int umvplus_dec;
395     int h263_aic; /* Advanded INTRA Coding (AIC) */
396     int h263_aic_dir; /* AIC direction: 0 = left, 1 = top */
397     
398     /* mpeg4 specific */
399     int time_increment_resolution;
400     int time_increment_bits;        /* number of bits to represent the fractional part of time */
401     int last_time_base;
402     int time_base;                  /* time in seconds of last I,P,S Frame */
403     INT64 time;                   /* time of current frame */ 
404     INT64 last_non_b_time;
405     UINT16 pp_time;               /* time distance between the last 2 p,s,i frames */
406     UINT16 pb_time;               /* time distance between the last b and p,s,i frame */
407     UINT16 pp_field_time;
408     UINT16 pb_field_time;         /* like above, just for interlaced */
409     int shape;
410     int vol_sprite_usage;
411     int sprite_width;
412     int sprite_height;
413     int sprite_left;
414     int sprite_top;
415     int sprite_brightness_change;
416     int num_sprite_warping_points;
417     int real_sprite_warping_points;
418     int sprite_offset[2][2];         /* sprite offset[isChroma][isMVY] */
419     int sprite_delta[2][2];          /* sprite_delta [isY][isMVY] */ 
420     int sprite_shift[2];             /* sprite shift [isChroma] */
421     int mcsel;
422     int quant_precision;
423     int quarter_sample;              /* 1->qpel, 0->half pel ME/MC */ 
424     int scalability;
425     int hierachy_type;
426     int enhancement_type;
427     int new_pred;
428     int reduced_res_vop;
429     int aspect_ratio_info;
430     int aspected_width;
431     int aspected_height;
432     int sprite_warping_accuracy;
433     int low_latency_sprite;
434     int data_partitioning;           /* data partitioning flag from header */
435     int partitioned_frame;           /* is current frame partitioned */
436     int rvlc;                        /* reversible vlc */
437     int resync_marker;               /* could this stream contain resync markers*/
438     int low_delay;                   /* no reordering needed / has no b-frames */
439     int vo_type;
440     int vol_control_parameters;      /* does the stream contain the low_delay flag, used to workaround buggy encoders */
441     PutBitContext tex_pb;            /* used for data partitioned VOPs */
442     PutBitContext pb2;               /* used for data partitioned VOPs */
443 #define PB_BUFFER_SIZE 1024*256
444     uint8_t *tex_pb_buffer;          
445     uint8_t *pb2_buffer;
446     int mpeg_quant;
447 #define CO_LOCATED_TYPE_4MV     1
448 #define CO_LOCATED_TYPE_FIELDMV 2
449     INT8 *co_located_type_table;     /* 4mv & field_mv info for next b frame */
450     INT16 (*field_mv_table)[2][2];   /* used for interlaced b frame decoding */
451     INT8 (*field_select_table)[2];   /* wtf, no really another table for interlaced b frames */
452     int t_frame;                     /* time distance of first I -> B, used for interlaced b frames */
453     int padding_bug_score;           /* used to detect the VERY common padding bug in MPEG4 */
454
455     /* divx specific, used to workaround (many) bugs in divx5 */
456     int divx_version;
457     int divx_build;
458 #define BITSTREAM_BUFFER_SIZE 1024*256
459     UINT8 *bitstream_buffer; //Divx 5.01 puts several frames in a single one, this is used to reorder them
460     int bitstream_buffer_size;
461     
462     int xvid_build;
463     
464     /* lavc specific stuff, used to workaround bugs in libavcodec */
465     int ffmpeg_version;
466     int lavc_build;
467     
468     /* RV10 specific */
469     int rv10_version; /* RV10 version: 0 or 3 */
470     int rv10_first_dc_coded[3];
471     
472     /* MJPEG specific */
473     struct MJpegContext *mjpeg_ctx;
474     int mjpeg_vsample[3]; /* vertical sampling factors, default = {2, 1, 1} */
475     int mjpeg_hsample[3]; /* horizontal sampling factors, default = {2, 1, 1} */
476     int mjpeg_write_tables; /* do we want to have quantisation- and
477                                huffmantables in the jpeg file ? */
478     int mjpeg_data_only_frames; /* frames only with SOI, SOS and EOI markers */
479
480     /* MSMPEG4 specific */
481     int mv_table_index;
482     int rl_table_index;
483     int rl_chroma_table_index;
484     int dc_table_index;
485     int use_skip_mb_code;
486     int slice_height;      /* in macroblocks */
487     int first_slice_line;  /* used in mpeg4 too to handle resync markers */
488     int flipflop_rounding;
489     int msmpeg4_version;   /* 0=not msmpeg4, 1=mp41, 2=mp42, 3=mp43/divx3 4=wmv1/7 5=wmv2/8*/
490     int per_mb_rl_table;
491     int esc3_level_length;
492     int esc3_run_length;
493     /* [mb_intra][isChroma][level][run][last] */
494     int (*ac_stats)[2][MAX_LEVEL+1][MAX_RUN+1][2];
495     int inter_intra_pred;
496     int mspel;
497
498     /* decompression specific */
499     GetBitContext gb;
500
501     /* Mpeg1 specific */
502     int fake_picture_number; /* picture number at the bitstream frame rate */
503     int gop_picture_number;  /* index of the first picture of a GOP based on fake_pic_num & mpeg1 specific */
504     
505     /* MPEG2 specific - I wish I had not to support this mess. */
506     int progressive_sequence;
507     int mpeg_f_code[2][2];
508     int picture_structure;
509 /* picture type */
510 #define PICT_TOP_FIELD     1
511 #define PICT_BOTTOM_FIELD  2
512 #define PICT_FRAME         3
513
514     int intra_dc_precision;
515     int frame_pred_frame_dct;
516     int top_field_first;
517     int concealment_motion_vectors;
518     int q_scale_type;
519     int intra_vlc_format;
520     int alternate_scan;
521     int repeat_first_field;
522     int chroma_420_type;
523     int progressive_frame;
524     int mpeg2;
525     int full_pel[2];
526     int interlaced_dct;
527     int first_slice;
528     
529     /* RTP specific */
530     /* These are explained on avcodec.h */
531     int rtp_mode;
532     int rtp_payload_size;
533     void (*rtp_callback)(void *data, int size, int packet_number);
534     UINT8 *ptr_lastgob;
535     UINT8 *ptr_last_mb_line;
536     UINT32 mb_line_avgsize;
537     
538     DCTELEM (*block)[64]; /* points to one of the following blocks */
539     DCTELEM blocks[2][6][64] __align8; // for HQ mode we need to keep the best block
540     int (*decode_mb)(struct MpegEncContext *s, DCTELEM block[6][64]); // used by some codecs to avoid a switch()
541 #define SLICE_OK         0
542 #define SLICE_ERROR     -1
543 #define SLICE_END       -2 //end marker found
544 #define SLICE_NOEND     -3 //no end marker or error found but mb count exceeded
545     
546     void (*dct_unquantize_mpeg1)(struct MpegEncContext *s, 
547                            DCTELEM *block/*align 16*/, int n, int qscale);
548     void (*dct_unquantize_mpeg2)(struct MpegEncContext *s, 
549                            DCTELEM *block/*align 16*/, int n, int qscale);
550     void (*dct_unquantize_h263)(struct MpegEncContext *s, 
551                            DCTELEM *block/*align 16*/, int n, int qscale);
552     void (*dct_unquantize)(struct MpegEncContext *s, // unquantizer to use (mpeg4 can use both)
553                            DCTELEM *block/*align 16*/, int n, int qscale);
554     int (*dct_quantize)(struct MpegEncContext *s, DCTELEM *block/*align 16*/, int n, int qscale, int *overflow);
555     int (*fast_dct_quantize)(struct MpegEncContext *s, DCTELEM *block/*align 16*/, int n, int qscale, int *overflow);
556     void (*fdct)(DCTELEM *block/* align 16*/);
557     void (*idct_put)(UINT8 *dest/*align 8*/, int line_size, DCTELEM *block/*align 16*/);
558     void (*idct_add)(UINT8 *dest/*align 8*/, int line_size, DCTELEM *block/*align 16*/);
559     //FIXME move above funcs into dspContext perhaps
560 } MpegEncContext;
561
562
563 int DCT_common_init(MpegEncContext *s);
564 int MPV_common_init(MpegEncContext *s);
565 void MPV_common_end(MpegEncContext *s);
566 void MPV_decode_mb(MpegEncContext *s, DCTELEM block[6][64]);
567 int MPV_frame_start(MpegEncContext *s, AVCodecContext *avctx);
568 void MPV_frame_end(MpegEncContext *s);
569 int MPV_encode_init(AVCodecContext *avctx);
570 int MPV_encode_end(AVCodecContext *avctx);
571 int MPV_encode_picture(AVCodecContext *avctx, unsigned char *buf, int buf_size, void *data);
572 #ifdef HAVE_MMX
573 void MPV_common_init_mmx(MpegEncContext *s);
574 #endif
575 #ifdef ARCH_ALPHA
576 void MPV_common_init_axp(MpegEncContext *s);
577 #endif
578 #ifdef HAVE_MLIB
579 void MPV_common_init_mlib(MpegEncContext *s);
580 #endif
581 #ifdef HAVE_MMI
582 void MPV_common_init_mmi(MpegEncContext *s);
583 #endif
584 #ifdef ARCH_ARMV4L
585 void MPV_common_init_armv4l(MpegEncContext *s);
586 #endif
587 #ifdef ARCH_POWERPC
588 void MPV_common_init_ppc(MpegEncContext *s);
589 #endif
590 extern void (*draw_edges)(UINT8 *buf, int wrap, int width, int height, int w);
591 void ff_conceal_past_errors(MpegEncContext *s, int conceal_all);
592 void ff_copy_bits(PutBitContext *pb, UINT8 *src, int length);
593 void ff_clean_intra_table_entries(MpegEncContext *s);
594 void ff_init_scantable(MpegEncContext *s, ScanTable *st, const UINT8 *src_scantable);
595 void ff_error_resilience(MpegEncContext *s);
596 void ff_draw_horiz_band(MpegEncContext *s);
597 void ff_emulated_edge_mc(MpegEncContext *s, UINT8 *src, int linesize, int block_w, int block_h, 
598                                     int src_x, int src_y, int w, int h);
599 char ff_get_pict_type_char(int pict_type);
600
601 extern enum PixelFormat ff_yuv420p_list[2];
602
603 extern int ff_bit_exact;
604
605 static inline void ff_init_block_index(MpegEncContext *s){
606     s->block_index[0]= s->block_wrap[0]*(s->mb_y*2 + 1) - 1 + s->mb_x*2;
607     s->block_index[1]= s->block_wrap[0]*(s->mb_y*2 + 1)     + s->mb_x*2;
608     s->block_index[2]= s->block_wrap[0]*(s->mb_y*2 + 2) - 1 + s->mb_x*2;
609     s->block_index[3]= s->block_wrap[0]*(s->mb_y*2 + 2)     + s->mb_x*2;
610     s->block_index[4]= s->block_wrap[4]*(s->mb_y + 1)                    + s->block_wrap[0]*(s->mb_height*2 + 2) + s->mb_x;
611     s->block_index[5]= s->block_wrap[4]*(s->mb_y + 1 + s->mb_height + 2) + s->block_wrap[0]*(s->mb_height*2 + 2) + s->mb_x;
612 }
613
614 static inline void ff_update_block_index(MpegEncContext *s){
615     s->block_index[0]+=2;
616     s->block_index[1]+=2;
617     s->block_index[2]+=2;
618     s->block_index[3]+=2;
619     s->block_index[4]++;
620     s->block_index[5]++;
621 }
622
623
624 /* motion_est.c */
625 void ff_estimate_p_frame_motion(MpegEncContext * s,
626                              int mb_x, int mb_y);
627 void ff_estimate_b_frame_motion(MpegEncContext * s,
628                              int mb_x, int mb_y);
629 int ff_get_best_fcode(MpegEncContext * s, int16_t (*mv_table)[2], int type);
630 void ff_fix_long_p_mvs(MpegEncContext * s);
631 void ff_fix_long_b_mvs(MpegEncContext * s, int16_t (*mv_table)[2], int f_code, int type);
632 void ff_init_me(MpegEncContext *s);
633 int ff_pre_estimate_p_frame_motion(MpegEncContext * s, int mb_x, int mb_y);
634
635
636 /* mpeg12.c */
637 extern const INT16 ff_mpeg1_default_intra_matrix[64];
638 extern const INT16 ff_mpeg1_default_non_intra_matrix[64];
639 extern UINT8 ff_mpeg1_dc_scale_table[128];
640
641 void mpeg1_encode_picture_header(MpegEncContext *s, int picture_number);
642 void mpeg1_encode_mb(MpegEncContext *s,
643                      DCTELEM block[6][64],
644                      int motion_x, int motion_y);
645 void ff_mpeg1_encode_init(MpegEncContext *s);
646
647
648 /* h263enc.c */
649 typedef struct RLTable {
650     int n; /* number of entries of table_vlc minus 1 */
651     int last; /* number of values for last = 0 */
652     const UINT16 (*table_vlc)[2];
653     const INT8 *table_run;
654     const INT8 *table_level;
655     UINT8 *index_run[2]; /* encoding only */
656     INT8 *max_level[2]; /* encoding & decoding */
657     INT8 *max_run[2];   /* encoding & decoding */
658     VLC vlc;            /* decoding only deprected FIXME remove*/
659     RL_VLC_ELEM *rl_vlc[32]; /* decoding only */
660 } RLTable;
661
662 void init_rl(RLTable *rl);
663 void init_vlc_rl(RLTable *rl);
664
665 static inline int get_rl_index(const RLTable *rl, int last, int run, int level)
666 {
667     int index;
668     index = rl->index_run[last][run];
669     if (index >= rl->n)
670         return rl->n;
671     if (level > rl->max_level[last][run])
672         return rl->n;
673     return index + level - 1;
674 }
675
676 extern UINT8 ff_mpeg4_y_dc_scale_table[32];
677 extern UINT8 ff_mpeg4_c_dc_scale_table[32];
678 extern const INT16 ff_mpeg4_default_intra_matrix[64];
679 extern const INT16 ff_mpeg4_default_non_intra_matrix[64];
680 int ff_h263_decode_init(AVCodecContext *avctx);
681 int ff_h263_decode_frame(AVCodecContext *avctx, 
682                              void *data, int *data_size,
683                              UINT8 *buf, int buf_size);
684 int ff_h263_decode_end(AVCodecContext *avctx);
685 void h263_encode_mb(MpegEncContext *s, 
686                     DCTELEM block[6][64],
687                     int motion_x, int motion_y);
688 void mpeg4_encode_mb(MpegEncContext *s, 
689                     DCTELEM block[6][64],
690                     int motion_x, int motion_y);
691 void h263_encode_picture_header(MpegEncContext *s, int picture_number);
692 int h263_encode_gob_header(MpegEncContext * s, int mb_line);
693 INT16 *h263_pred_motion(MpegEncContext * s, int block, 
694                         int *px, int *py);
695 void mpeg4_pred_ac(MpegEncContext * s, INT16 *block, int n, 
696                    int dir);
697 void ff_set_mpeg4_time(MpegEncContext * s, int picture_number);
698 void mpeg4_encode_picture_header(MpegEncContext *s, int picture_number);
699 void h263_encode_init(MpegEncContext *s);
700 void h263_decode_init_vlc(MpegEncContext *s);
701 int h263_decode_picture_header(MpegEncContext *s);
702 int ff_h263_decode_gob_header(MpegEncContext *s);
703 int ff_mpeg4_decode_picture_header(MpegEncContext * s, GetBitContext *gb);
704
705
706 int intel_h263_decode_picture_header(MpegEncContext *s);
707 int ff_h263_decode_mb(MpegEncContext *s,
708                       DCTELEM block[6][64]);
709 int h263_get_picture_format(int width, int height);
710 void ff_mpeg4_encode_video_packet_header(MpegEncContext *s);
711 void ff_mpeg4_clean_buffers(MpegEncContext *s);
712 void ff_mpeg4_stuffing(PutBitContext * pbc);
713 void ff_mpeg4_init_partitions(MpegEncContext *s);
714 void ff_mpeg4_merge_partitions(MpegEncContext *s);
715 void ff_clean_mpeg4_qscales(MpegEncContext *s);
716 void ff_clean_h263_qscales(MpegEncContext *s);
717 int ff_mpeg4_decode_partitions(MpegEncContext *s);
718 int ff_mpeg4_get_video_packet_prefix_length(MpegEncContext *s);
719 int ff_h263_resync(MpegEncContext *s);
720 int ff_h263_get_gob_height(MpegEncContext *s);
721 void ff_mpeg4_set_direct_mv(MpegEncContext *s, int mx, int my);
722
723
724 /* rv10.c */
725 void rv10_encode_picture_header(MpegEncContext *s, int picture_number);
726 int rv_decode_dc(MpegEncContext *s, int n);
727
728
729 /* msmpeg4.c */
730 void msmpeg4_encode_picture_header(MpegEncContext * s, int picture_number);
731 void msmpeg4_encode_ext_header(MpegEncContext * s);
732 void msmpeg4_encode_mb(MpegEncContext * s, 
733                        DCTELEM block[6][64],
734                        int motion_x, int motion_y);
735 int msmpeg4_decode_picture_header(MpegEncContext * s);
736 int msmpeg4_decode_ext_header(MpegEncContext * s, int buf_size);
737 int ff_msmpeg4_decode_init(MpegEncContext *s);
738 void ff_msmpeg4_encode_init(MpegEncContext *s);
739 int ff_wmv2_decode_picture_header(MpegEncContext * s);
740 void ff_wmv2_add_mb(MpegEncContext *s, DCTELEM block[6][64], uint8_t *dest_y, uint8_t *dest_cb, uint8_t *dest_cr);
741 void ff_mspel_motion(MpegEncContext *s,
742                                UINT8 *dest_y, UINT8 *dest_cb, UINT8 *dest_cr,
743                                UINT8 **ref_picture, op_pixels_func (*pix_op)[4],
744                                int motion_x, int motion_y, int h);
745 int ff_wmv2_encode_picture_header(MpegEncContext * s, int picture_number);
746 void ff_wmv2_encode_mb(MpegEncContext * s, 
747                        DCTELEM block[6][64],
748                        int motion_x, int motion_y);
749
750 /* mjpegenc.c */
751 int mjpeg_init(MpegEncContext *s);
752 void mjpeg_close(MpegEncContext *s);
753 void mjpeg_encode_mb(MpegEncContext *s, 
754                      DCTELEM block[6][64]);
755 void mjpeg_picture_header(MpegEncContext *s);
756 void mjpeg_picture_trailer(MpegEncContext *s);
757
758
759 /* rate control */
760 int ff_rate_control_init(MpegEncContext *s);
761 float ff_rate_estimate_qscale(MpegEncContext *s);
762 void ff_write_pass1_stats(MpegEncContext *s);
763 void ff_rate_control_uninit(MpegEncContext *s);
764 double ff_eval(char *s, double *const_value, char **const_name,
765                double (**func1)(void *, double), char **func1_name, 
766                double (**func2)(void *, double, double), char **func2_name,
767                void *opaque);
768
769
770 #endif /* AVCODEC_MPEGVIDEO_H */