c85dead5c6e91373c1edfd6cbe0673010c77f399
[ffmpeg.git] / libavcodec / avcodec.h
1 #ifndef AVCODEC_H
2 #define AVCODEC_H
3
4 #include "common.h"
5
6 #define LIBAVCODEC_VERSION_INT 0x000406
7 #define LIBAVCODEC_VERSION     "0.4.6"
8 #define LIBAVCODEC_BUILD       4634
9 #define LIBAVCODEC_BUILD_STR   "4634"
10
11 enum CodecID {
12     CODEC_ID_NONE, 
13     CODEC_ID_MPEG1VIDEO,
14     CODEC_ID_H263,
15     CODEC_ID_RV10,
16     CODEC_ID_MP2,
17     CODEC_ID_MP3LAME,
18     CODEC_ID_VORBIS,
19     CODEC_ID_AC3,
20     CODEC_ID_MJPEG,
21     CODEC_ID_MPEG4,
22     CODEC_ID_RAWVIDEO,
23     CODEC_ID_MSMPEG4V1,
24     CODEC_ID_MSMPEG4V2,
25     CODEC_ID_MSMPEG4V3,
26     CODEC_ID_WMV1,
27     CODEC_ID_WMV2,
28     CODEC_ID_H263P,
29     CODEC_ID_H263I,
30     CODEC_ID_SVQ1,
31     CODEC_ID_DVVIDEO,
32     CODEC_ID_DVAUDIO,
33     CODEC_ID_WMAV1,
34     CODEC_ID_WMAV2,
35     CODEC_ID_MACE3,
36     CODEC_ID_MACE6,
37
38     /* various pcm "codecs" */
39     CODEC_ID_PCM_S16LE,
40     CODEC_ID_PCM_S16BE,
41     CODEC_ID_PCM_U16LE,
42     CODEC_ID_PCM_U16BE,
43     CODEC_ID_PCM_S8,
44     CODEC_ID_PCM_U8,
45     CODEC_ID_PCM_MULAW,
46     CODEC_ID_PCM_ALAW,
47
48     /* various adpcm codecs */
49     CODEC_ID_ADPCM_IMA_QT,
50     CODEC_ID_ADPCM_IMA_WAV,
51     CODEC_ID_ADPCM_MS,
52 };
53 #define CODEC_ID_MSMPEG4 CODEC_ID_MSMPEG4V3
54
55 enum CodecType {
56     CODEC_TYPE_UNKNOWN = -1,
57     CODEC_TYPE_VIDEO,
58     CODEC_TYPE_AUDIO,
59 };
60
61 enum PixelFormat {
62     PIX_FMT_ANY = -1,
63     PIX_FMT_YUV420P,
64     PIX_FMT_YUV422,
65     PIX_FMT_RGB24,
66     PIX_FMT_BGR24,
67     PIX_FMT_YUV422P,
68     PIX_FMT_YUV444P,
69     PIX_FMT_RGBA32,
70     PIX_FMT_BGRA32,
71     PIX_FMT_YUV410P,
72     PIX_FMT_YUV411P
73 };
74
75 /* currently unused, may be used if 24/32 bits samples ever supported */
76 enum SampleFormat {
77     SAMPLE_FMT_S16 = 0,         /* signed 16 bits */
78 };
79
80 /* in bytes */
81 #define AVCODEC_MAX_AUDIO_FRAME_SIZE 131072
82
83 /* motion estimation type, EPZS by default */
84 enum Motion_Est_ID {
85     ME_ZERO = 1,
86     ME_FULL,
87     ME_LOG,
88     ME_PHODS,
89     ME_EPZS,
90     ME_X1
91 };
92
93 typedef struct RcOverride{
94     int start_frame;
95     int end_frame;
96     int qscale; // if this is 0 then quality_factor will be used instead
97     float quality_factor;
98 } RcOverride;
99
100 /* only for ME compatiblity with old apps */
101 extern int motion_estimation_method;
102
103 /* ME algos sorted by quality */
104 static const int Motion_Est_QTab[] = { ME_ZERO, ME_PHODS, ME_LOG, 
105                                        ME_X1, ME_EPZS, ME_FULL };
106
107
108 #define FF_MAX_B_FRAMES 4
109
110 /* encoding support
111    these flags can be passed in AVCodecContext.flags before initing 
112    Note: note not everything is supported yet 
113 */
114
115 #define CODEC_FLAG_HQ     0x0001  /* brute force MB-type decission mode (slow) */
116 #define CODEC_FLAG_QSCALE 0x0002  /* use fixed qscale */
117 #define CODEC_FLAG_4MV    0x0004  /* 4 MV per MB allowed */
118 #define CODEC_FLAG_QPEL   0x0010  /* use qpel MC */
119 #define CODEC_FLAG_GMC    0x0020  /* use GMC */
120 #define CODEC_FLAG_TYPE   0x0040  /* fixed I/P frame type, from avctx->key_frame */
121 #define CODEC_FLAG_PART   0x0080  /* use data partitioning */
122 /* parent program gurantees that the input for b-frame containing streams is not written to 
123    for at least s->max_b_frames+1 frames, if this is not set than the input will be copied */
124 #define CODEC_FLAG_INPUT_PRESERVED 0x0100
125 #define CODEC_FLAG_PASS1 0x0200   /* use internal 2pass ratecontrol in first  pass mode */
126 #define CODEC_FLAG_PASS2 0x0400   /* use internal 2pass ratecontrol in second pass mode */
127 #define CODEC_FLAG_EXTERN_HUFF 0x1000 /* use external huffman table (for mjpeg) */
128 #define CODEC_FLAG_GRAY  0x2000   /* only decode/encode grayscale */
129 #define CODEC_FLAG_EMU_EDGE 0x4000/* dont draw edges */
130 #define CODEC_FLAG_DR1    0x8000  /* direct renderig type 1 (store internal frames in external buffers) */
131 #define CODEC_FLAG_NOT_TRUNCATED  0x00010000 /* input bitstream is not truncated, except before a startcode 
132                                                 allows the last part of a frame to be decoded earlier */
133 #define CODEC_FLAG_NORMALIZE_AQP  0x00020000 /* normalize adaptive quantization */
134 #define CODEC_FLAG_INTERLACED_DCT 0x00040000 /* use interlaced dct */
135
136 /* codec capabilities */
137
138 #define CODEC_CAP_DRAW_HORIZ_BAND 0x0001 /* decoder can use draw_horiz_band callback */
139 #define CODEC_CAP_DR1             0x0002 /* direct rendering method 1 */
140 /* if 'parse_only' field is true, then avcodec_parse_frame() can be
141    used */
142 #define CODEC_CAP_PARSE_ONLY      0x0004
143
144 #define FRAME_RATE_BASE 10000
145
146 typedef struct AVCodecContext {
147     /**
148      * the average bitrate
149      * encoding: set by user. unused for constant quantizer encoding
150      * decoding: set by lavc. 0 or some bitrate if this info is available in the stream 
151      */
152     int bit_rate;
153
154     /**
155      * number of bits the bitstream is allowed to diverge from the reference
156      *           the reference can be CBR (for CBR pass1) or VBR (for pass2)
157      * encoding: set by user. unused for constant quantizer encoding
158      * decoding: unused
159      */
160     int bit_rate_tolerance; 
161
162     /**
163      * CODEC_FLAG_*
164      * encoding: set by user.
165      * decoding: set by user.
166      */
167     int flags;
168
169     /**
170      * some codecs needs additionnal format info. It is stored here
171      * encoding: set by user. 
172      * decoding: set by lavc. (FIXME is this ok?)
173      */
174     int sub_id;
175
176     /**
177      * motion estimation algorithm used for video coding
178      * encoding: set by user.
179      * decoding: unused
180      */
181     int me_method;
182
183     /**
184      * some codecs need / can use extra-data like huffman tables
185      * mjpeg: huffman tables
186      * rv10: additional flags
187      * mpeg4: global headers (they can be in the bitstream or here)
188      * encoding: set/allocated/freed by lavc.
189      * decoding: set/allocated/freed by user.
190      */
191     void *extradata;
192     int extradata_size;
193     
194     /* video only */
195     /**
196      * frames per sec multiplied by FRAME_RATE_BASE
197      * for variable fps this is the precission, so if the timestamps 
198      * can be specified in msec precssion then this is 1000*FRAME_RATE_BASE
199      * encoding: set by user
200      * decoding: set by lavc. 0 or the frame_rate if available
201      */
202     int frame_rate;
203
204     /**
205      * encoding: set by user.
206      * decoding: set by user, some codecs might override / change it during playback
207      */
208     int width, height;
209     
210     /**
211      * encoding: set by user. 0 if not known
212      * decoding: set by lavc. 0 if not known
213      */
214     int aspect_ratio_info;
215 #define FF_ASPECT_SQUARE 1
216 #define FF_ASPECT_4_3_625 2
217 #define FF_ASPECT_4_3_525 3
218 #define FF_ASPECT_16_9_625 4
219 #define FF_ASPECT_16_9_525 5
220 #define FF_ASPECT_EXTENDED 15
221
222     /**
223      * the number of pictures in a group of pitures, or 0 for intra_only
224      * encoding: set by user.
225      * decoding: unused
226      */
227     int gop_size;
228
229     /**
230      * pixel format, see PIX_FMT_xxx
231      * encoding: unused
232      * decoding: set by lavc.
233      */
234     enum PixelFormat pix_fmt;
235     
236     int repeat_pict; /* when decoding, this signal how much the picture */
237                      /* must be delayed.                                */
238                      /* extra_delay = (repeat_pict / 2) * (1/fps)       */
239     
240     /**
241      * if non NULL, 'draw_horiz_band' is called by the libavcodec
242      * decoder to draw an horizontal band. It improve cache usage. Not
243      * all codecs can do that. You must check the codec capabilities
244      * before
245      * encoding: unused
246      * decoding: set by user.
247      */
248     void (*draw_horiz_band)(struct AVCodecContext *s,
249                             UINT8 **src_ptr, int linesize,
250                             int y, int width, int height);
251
252     /* audio only */
253     int sample_rate; /* samples per sec */
254     int channels;
255     int sample_fmt;  /* sample format, currenly unused */
256
257     /* the following data should not be initialized */
258     int frame_size;     /* in samples, initialized when calling 'init' */
259     int frame_number;   /* audio or video frame number */
260     int real_pict_num;  /* returns the real picture number of
261                            previous encoded frame */
262                            
263     /**
264      * 1 -> keyframe, 0-> not
265      * encoding: set by lavc (for the outputed bitstream, not the input frame)
266      * decoding: set by lavc (for the decoded  bitstream, not the displayed frame)
267      */
268     int key_frame;
269
270     /**
271      * picture type of the previous en/decoded frame, see ?_TYPE below
272      * encoding: set by lavc (for the outputed bitstream, not the input frame)
273      * decoding: set by lavc (for the decoded  bitstream, not the displayed frame)
274      */
275     int pict_type;
276 /* FIXME: these should have FF_ */
277 #define I_TYPE 1 // Intra
278 #define P_TYPE 2 // Predicted
279 #define B_TYPE 3 // Bi-dir predicted
280 #define S_TYPE 4 // S(GMC)-VOP MPEG4
281
282     /**
283      * number of frames the decoded output will be delayed relative to 
284      * the encoded input
285      * encoding: set by lavc.
286      * decoding: unused
287      */
288     int delay;
289
290     /**
291      * mbskip_table[mb]=1 if MB didnt change, is only valid for I/P frames 
292      * stride= mb_width = (width+15)>>4 (FIXME export stride?)
293      * encoding: unused
294      * decoding: set by lavc
295      */
296     uint8_t *mbskip_table;
297     
298     /* encoding parameters */
299     /**
300      * quality (between 1 (good) and 31 (bad)) 
301      * encoding: set by user if CODEC_FLAG_QSCALE is set otherwise set by lavc
302      * decoding: set by lavc
303      */
304     int quality;      /* quality of the previous encoded frame 
305                          
306                          this is allso used to set the quality in vbr mode
307                          and the per frame quality in CODEC_FLAG_TYPE (second pass mode) */
308     float qcompress;  /* amount of qscale change between easy & hard scenes (0.0-1.0)*/
309     float qblur;      /* amount of qscale smoothing over time (0.0-1.0) */
310     
311     /**
312      * minimum quantizer
313      * encoding: set by user.
314      * decoding: unused
315      */
316     int qmin;
317
318     /**
319      * maximum quantizer
320      * encoding: set by user.
321      * decoding: unused
322      */
323     int qmax;
324
325     /**
326      * maximum quantizer difference etween frames
327      * encoding: set by user.
328      * decoding: unused
329      */
330     int max_qdiff;
331
332     /**
333      * maximum number of b frames between non b frames
334      * note: the output will be delayed by max_b_frames+1 relative to the input
335      * encoding: set by user.
336      * decoding: unused
337      */
338     int max_b_frames;
339
340     /**
341      * qscale factor between ip and b frames
342      * encoding: set by user.
343      * decoding: unused
344      */
345     float b_quant_factor;
346     
347     /** obsolete FIXME remove */
348     int rc_strategy;
349     int b_frame_strategy;
350
351     /**
352      * encoding: unused
353      * decoding: set by user. 1-> skip b frames, 2-> skip idct/dequant too
354      */
355     int hurry_up;
356     
357     struct AVCodec *codec;
358     
359     void *priv_data;
360
361     /* The following data is for RTP friendly coding */
362     /* By now only H.263/H.263+/MPEG4 coder honours this   */
363     int rtp_mode;   /* 1 for activate RTP friendly-mode           */
364                     /* highers numbers represent more error-prone */
365                     /* enviroments, by now just "1" exist         */
366     
367     int rtp_payload_size;   /* The size of the RTP payload, the coder will  */
368                             /* do it's best to deliver a chunk with size    */
369                             /* below rtp_payload_size, the chunk will start */
370                             /* with a start code on some codecs like H.263  */
371                             /* This doesn't take account of any particular  */
372                             /* headers inside the transmited RTP payload    */
373
374     
375     /* The RTP callcack: This function is called  */
376     /* every time the encoder as a packet to send */
377     /* Depends on the encoder if the data starts  */
378     /* with a Start Code (it should) H.263 does   */
379     void (*rtp_callback)(void *data, int size, int packet_number); 
380
381     /**
382      * if you set get_psnr to 1 then after encoding you will have the 
383      * PSNR on psnr_y/cb/cr
384      * encoding: set by user (1-> on, 0-> off)
385      * decoding: unused
386      */
387     int get_psnr;
388     float psnr_y;
389     float psnr_cb;
390     float psnr_cr;
391     
392     /* statistics, used for 2-pass encoding */
393     int mv_bits;
394     int header_bits;
395     int i_tex_bits;
396     int p_tex_bits;
397     int i_count;
398     int p_count;
399     int skip_count;
400     int misc_bits;
401     
402     /**
403      * number of bits used for the previously encoded frame
404      * encoding: set by lavc
405      * decoding: unused
406      */
407     int frame_bits;
408                  
409     /**
410      * private data of the user, can be used to carry app specific stuff
411      * encoding: set by user
412      * decoding: set by user
413      */
414     void *opaque;
415
416     char codec_name[32];
417     enum CodecType codec_type; /* see CODEC_TYPE_xxx */
418     enum CodecID codec_id; /* see CODEC_ID_xxx */
419     unsigned int codec_tag;  /* codec tag, only used if unknown codec */
420     
421     /**
422      * workaround bugs in encoders which sometimes cannot be detected automatically
423      * encoding: unused
424      * decoding: set by user
425      */
426     int workaround_bugs;
427 #define FF_BUG_AUTODETECT       1  //autodetection
428 #define FF_BUG_OLD_MSMPEG4      2
429 #define FF_BUG_XVID_ILACE       4
430 #define FF_BUG_UMP4             8
431 #define FF_BUG_NO_PADDING       16
432 #define FF_BUG_AC_VLC           32
433 #define FF_BUG_QPEL_CHROMA      64
434 //#define FF_BUG_FAKE_SCALABILITY 16 //autodetection should work 100%
435         
436     /**
437      * encoding: set by user
438      * decoding: unused
439      */
440     int luma_elim_threshold;
441     
442     /**
443      * encoding: set by user
444      * decoding: unused
445      */
446     int chroma_elim_threshold;
447     
448     /**
449      * strictly follow the std (MPEG4, ...)
450      * encoding: set by user
451      * decoding: unused
452      */
453     int strict_std_compliance;
454     
455     /**
456      * qscale offset between ip and b frames
457      * if > 0 then the last p frame quantizer will be used (q= lastp_q*factor+offset)
458      * if < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset)
459      * encoding: set by user.
460      * decoding: unused
461      */
462     float b_quant_offset;
463     
464     /**
465      * error resilience {-1,0,1} higher values will detect more errors but may missdetect
466      * some more or less valid parts as errors
467      * encoding: unused
468      * decoding: set by user
469      */
470     int error_resilience;
471     
472     /**
473      * obsolete, just here to keep ABI compatible (should be removed perhaps, dunno)
474      */
475     int *quant_store;
476
477     /**
478      * QP store stride
479      * encoding: unused
480      * decoding: set by lavc
481      */
482     int qstride;
483     
484     /**
485      * buffer, where the next picture should be decoded into
486      * encoding: unused
487      * decoding: set by user in get_buffer_callback to a buffer into which the next part
488      *           of the bitstream will be decoded, and set by lavc at end of frame to the
489      *           next frame which needs to be displayed
490      */
491     uint8_t *dr_buffer[3];
492     
493     /**
494      * stride of the luminance part of the dr buffer
495      * encoding: unused
496      * decoding: set by user
497      */
498     int dr_stride;
499     
500     /**
501      * same behavior as dr_buffer, just for some private data of the user
502      * encoding: unused
503      * decoding: set by user in get_buffer_callback, and set by lavc at end of frame
504      */
505     void *dr_opaque_frame;
506     
507     /**
508      * called at the beginning of each frame to get a buffer for it
509      * encoding: unused
510      * decoding: set by user
511      */
512     int (*get_buffer_callback)(struct AVCodecContext *c, int width, int height, int pict_type);
513
514     /**
515      * is 1 if the decoded stream contains b frames, 0 otherwise
516      * encoding: unused
517      * decoding: set by lavc
518      */
519     int has_b_frames;
520
521     /**
522      * stride of the chrominance part of the dr buffer
523      * encoding: unused
524      * decoding: set by user
525      */
526     int dr_uvstride;
527     
528     /**
529      * number of dr buffers
530      * encoding: unused
531      * decoding: set by user
532      */
533     int dr_ip_buffer_count;
534     
535     int block_align; /* used by some WAV based audio codecs */
536     
537     int parse_only; /* decoding only: if true, only parsing is done
538                        (function avcodec_parse_frame()). The frame
539                        data is returned. Only MPEG codecs support this now. */
540     
541     /**
542      * 0-> h263 quant 1-> mpeg quant
543      * encoding: set by user.
544      * decoding: unused
545      */
546     int mpeg_quant;
547     
548     /**
549      * pass1 encoding statistics output buffer
550      * encoding: set by lavc
551      * decoding: unused
552      */
553     char *stats_out; /* encoding statistics output buffer */
554     
555     /**
556      * pass2 encoding statistics input buffer.
557      * concatenated stuff from stats_out of pass1 should be placed here
558      * encoding: allocated/set/freed by user
559      * decoding: unused
560      */
561     char *stats_in;
562     
563     /**
564      * ratecontrol qmin qmax limiting method
565      * 0-> clipping, 1-> use a nice continous function to limit qscale wthin qmin/qmax
566      * encoding: set by user.
567      * decoding: unused
568      */
569     float rc_qsquish;
570
571     float rc_qmod_amp;
572     int rc_qmod_freq;
573     
574     /**
575      * ratecontrol override, see RcOverride
576      * encoding: allocated/set/freed by user.
577      * decoding: unused
578      */
579     RcOverride *rc_override;
580     int rc_override_count;
581     
582     /**
583      * rate control equation
584      * encoding: set by user
585      * decoding: unused
586      */
587     char *rc_eq;
588     
589     /**
590      * maximum bitrate
591      * encoding: set by user.
592      * decoding: unused
593      */
594     int rc_max_rate;
595     
596     /**
597      * minimum bitrate
598      * encoding: set by user.
599      * decoding: unused
600      */
601     int rc_min_rate;
602     
603     /**
604      * decoder bitstream buffer size
605      * encoding: set by user.
606      * decoding: unused
607      */
608     int rc_buffer_size;
609     float rc_buffer_aggressivity;
610
611     /**
612      * qscale factor between p and i frames
613      * encoding: set by user.
614      * decoding: unused
615      */
616     float i_quant_factor;
617     
618     /**
619      * qscale offset between p and i frames
620      * if > 0 then the last p frame quantizer will be used (q= lastp_q*factor+offset)
621      * if < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset)
622      * encoding: set by user.
623      * decoding: unused
624      */
625     float i_quant_offset;
626     
627     /**
628      * initial complexity for pass1 ratecontrol
629      * encoding: set by user.
630      * decoding: unused
631      */
632     float rc_initial_cplx;
633
634     /**
635      * custom aspect ratio, used if aspect_info==FF_ASPECT_EXTENDED
636      * encoding: set by user.
637      * decoding: set by lavc.
638      */
639     int aspected_width;
640     int aspected_height;
641
642     /**
643      * dct algorithm, see FF_DCT_* below
644      * encoding: set by user
645      * decoding: unused
646      */
647     int dct_algo;
648 #define FF_DCT_AUTO    0
649 #define FF_DCT_FASTINT 1
650 #define FF_DCT_INT     2
651 #define FF_DCT_MMX     3
652 #define FF_DCT_MLIB    4
653
654     /**
655      * presentation timestamp in micro seconds (time when frame should be shown to user)
656      * if 0 then the frame_rate will be used as reference
657      * encoding: set by user
658      * decoding; set by lavc
659      */
660     long long int pts;
661     
662     /**
663      * luminance masking (0-> disabled)
664      * encoding: set by user
665      * decoding: unused
666      */
667     float lumi_masking;
668     
669     /**
670      * temporary complexity masking (0-> disabled)
671      * encoding: set by user
672      * decoding: unused
673      */
674     float temporal_cplx_masking;
675     
676     /**
677      * spatial complexity masking (0-> disabled)
678      * encoding: set by user
679      * decoding: unused
680      */
681     float spatial_cplx_masking;
682     
683     /**
684      * p block masking (0-> disabled)
685      * encoding: set by user
686      * decoding: unused
687      */
688     float p_masking;
689
690     /**
691      * darkness masking (0-> disabled)
692      * encoding: set by user
693      * decoding: unused
694      */
695     float dark_masking;
696     
697     /**
698      * fourcc (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A')
699      * this is used to workaround some encoder bugs
700      * encoding: unused
701      * decoding: set by user, will be converted to upper case by lavc during init
702      */
703     int fourcc;
704
705     /**
706      * idct algorithm, see FF_IDCT_* below
707      * encoding: set by user
708      * decoding: set by user
709      */
710     int idct_algo;
711 #define FF_IDCT_AUTO         0
712 #define FF_IDCT_INT          1
713 #define FF_IDCT_SIMPLE       2
714 #define FF_IDCT_SIMPLEMMX    3
715 #define FF_IDCT_LIBMPEG2MMX  4
716 #define FF_IDCT_PS2          5
717 #define FF_IDCT_MLIB         6
718 #define FF_IDCT_ARM          7
719
720     /**
721      * slice count
722      * encoding: set by lavc
723      * decoding: set by user (or 0)
724      */
725     int slice_count;
726     /**
727      * slice offsets in the frame in bytes
728      * encoding: set/allocated by lavc
729      * decoding: set/allocated by user (or NULL)
730      */
731     int *slice_offset;
732
733     /**
734      * error concealment flags
735      * encoding: unused
736      * decoding: set by user
737      */
738     int error_concealment;
739 #define FF_EC_GUESS_MVS   1
740 #define FF_EC_DEBLOCK     2
741
742     /**
743      * QP table of the currently decoded frame
744      * encoding; unused
745      * decoding: set by lavc
746      */
747      int8_t *current_qscale_table;
748     /**
749      * QP table of the currently displayed frame
750      * encoding; unused
751      * decoding: set by lavc
752      */
753      int8_t *display_qscale_table;
754 } AVCodecContext;
755
756 typedef struct AVCodec {
757     char *name;
758     int type;
759     int id;
760     int priv_data_size;
761     int (*init)(AVCodecContext *);
762     int (*encode)(AVCodecContext *, UINT8 *buf, int buf_size, void *data);
763     int (*close)(AVCodecContext *);
764     int (*decode)(AVCodecContext *, void *outdata, int *outdata_size,
765                   UINT8 *buf, int buf_size);
766     int capabilities;
767     struct AVCodec *next;
768 } AVCodec;
769
770 /* three components are given, that's all */
771 typedef struct AVPicture {
772     UINT8 *data[3];
773     int linesize[3];
774 } AVPicture;
775
776 extern AVCodec ac3_encoder;
777 extern AVCodec mp2_encoder;
778 extern AVCodec mp3lame_encoder;
779 extern AVCodec oggvorbis_encoder;
780 extern AVCodec mpeg1video_encoder;
781 extern AVCodec h263_encoder;
782 extern AVCodec h263p_encoder;
783 extern AVCodec rv10_encoder;
784 extern AVCodec mjpeg_encoder;
785 extern AVCodec mpeg4_encoder;
786 extern AVCodec msmpeg4v1_encoder;
787 extern AVCodec msmpeg4v2_encoder;
788 extern AVCodec msmpeg4v3_encoder;
789 extern AVCodec wmv1_encoder;
790 extern AVCodec wmv2_encoder;
791
792 extern AVCodec h263_decoder;
793 extern AVCodec mpeg4_decoder;
794 extern AVCodec msmpeg4v1_decoder;
795 extern AVCodec msmpeg4v2_decoder;
796 extern AVCodec msmpeg4v3_decoder;
797 extern AVCodec wmv1_decoder;
798 extern AVCodec wmv2_decoder;
799 extern AVCodec mpeg_decoder;
800 extern AVCodec h263i_decoder;
801 extern AVCodec rv10_decoder;
802 extern AVCodec svq1_decoder;
803 extern AVCodec dvvideo_decoder;
804 extern AVCodec dvaudio_decoder;
805 extern AVCodec wmav1_decoder;
806 extern AVCodec wmav2_decoder;
807 extern AVCodec mjpeg_decoder;
808 extern AVCodec mp2_decoder;
809 extern AVCodec mp3_decoder;
810 extern AVCodec mace3_decoder;
811 extern AVCodec mace6_decoder;
812
813 /* pcm codecs */
814 #define PCM_CODEC(id, name) \
815 extern AVCodec name ## _decoder; \
816 extern AVCodec name ## _encoder;
817
818 PCM_CODEC(CODEC_ID_PCM_S16LE, pcm_s16le);
819 PCM_CODEC(CODEC_ID_PCM_S16BE, pcm_s16be);
820 PCM_CODEC(CODEC_ID_PCM_U16LE, pcm_u16le);
821 PCM_CODEC(CODEC_ID_PCM_U16BE, pcm_u16be);
822 PCM_CODEC(CODEC_ID_PCM_S8, pcm_s8);
823 PCM_CODEC(CODEC_ID_PCM_U8, pcm_u8);
824 PCM_CODEC(CODEC_ID_PCM_ALAW, pcm_alaw);
825 PCM_CODEC(CODEC_ID_PCM_MULAW, pcm_mulaw);
826
827 /* adpcm codecs */
828
829 PCM_CODEC(CODEC_ID_ADPCM_IMA_QT, adpcm_ima_qt);
830 PCM_CODEC(CODEC_ID_ADPCM_IMA_WAV, adpcm_ima_wav);
831 PCM_CODEC(CODEC_ID_ADPCM_MS, adpcm_ms);
832
833 #undef PCM_CODEC
834
835 /* dummy raw video codec */
836 extern AVCodec rawvideo_codec;
837
838 /* the following codecs use external GPL libs */
839 extern AVCodec ac3_decoder;
840
841 /* resample.c */
842
843 struct ReSampleContext;
844
845 typedef struct ReSampleContext ReSampleContext;
846
847 ReSampleContext *audio_resample_init(int output_channels, int input_channels, 
848                                      int output_rate, int input_rate);
849 int audio_resample(ReSampleContext *s, short *output, short *input, int nb_samples);
850 void audio_resample_close(ReSampleContext *s);
851
852 /* YUV420 format is assumed ! */
853
854 struct ImgReSampleContext;
855
856 typedef struct ImgReSampleContext ImgReSampleContext;
857
858 ImgReSampleContext *img_resample_init(int output_width, int output_height,
859                                       int input_width, int input_height);
860
861 ImgReSampleContext *img_resample_full_init(int owidth, int oheight,
862                                       int iwidth, int iheight,
863                                       int topBand, int bottomBand,
864                                       int leftBand, int rightBand);
865
866 void img_resample(ImgReSampleContext *s, 
867                   AVPicture *output, AVPicture *input);
868
869 void img_resample_close(ImgReSampleContext *s);
870
871 void avpicture_fill(AVPicture *picture, UINT8 *ptr,
872                     int pix_fmt, int width, int height);
873 int avpicture_get_size(int pix_fmt, int width, int height);
874
875 /* convert among pixel formats */
876 int img_convert(AVPicture *dst, int dst_pix_fmt,
877                 AVPicture *src, int pix_fmt, 
878                 int width, int height);
879
880 /* deinterlace a picture */
881 int avpicture_deinterlace(AVPicture *dst, AVPicture *src,
882                           int pix_fmt, int width, int height);
883
884 /* external high level API */
885
886 extern AVCodec *first_avcodec;
887
888 /* returns LIBAVCODEC_VERSION_INT constant */
889 unsigned avcodec_version(void);
890 /* returns LIBAVCODEC_BUILD constant */
891 unsigned avcodec_build(void);
892 void avcodec_init(void);
893
894 void avcodec_set_bit_exact(void);
895
896 void register_avcodec(AVCodec *format);
897 AVCodec *avcodec_find_encoder(enum CodecID id);
898 AVCodec *avcodec_find_encoder_by_name(const char *name);
899 AVCodec *avcodec_find_decoder(enum CodecID id);
900 AVCodec *avcodec_find_decoder_by_name(const char *name);
901 void avcodec_string(char *buf, int buf_size, AVCodecContext *enc, int encode);
902
903 AVCodecContext *avcodec_alloc_context(void);
904 int avcodec_open(AVCodecContext *avctx, AVCodec *codec);
905 int avcodec_decode_audio(AVCodecContext *avctx, INT16 *samples, 
906                          int *frame_size_ptr,
907                          UINT8 *buf, int buf_size);
908 int avcodec_decode_video(AVCodecContext *avctx, AVPicture *picture, 
909                          int *got_picture_ptr,
910                          UINT8 *buf, int buf_size);
911 int avcodec_parse_frame(AVCodecContext *avctx, UINT8 **pdata, 
912                         int *data_size_ptr,
913                         UINT8 *buf, int buf_size);
914 int avcodec_encode_audio(AVCodecContext *avctx, UINT8 *buf, int buf_size, 
915                          const short *samples);
916 int avcodec_encode_video(AVCodecContext *avctx, UINT8 *buf, int buf_size, 
917                          const AVPicture *pict);
918
919 int avcodec_close(AVCodecContext *avctx);
920
921 void avcodec_register_all(void);
922
923 void avcodec_flush_buffers(AVCodecContext *avctx);
924
925 // deprecated / obsolete stuff, WILL be removed
926 #ifndef MBC
927 #define MBC 128
928 #define MBR 96
929 #endif
930 #define QP_TYPE int
931
932 /**
933  * Interface for 0.5.0 version
934  *
935  * do not even think about it's usage for this moment
936  */
937
938 typedef struct {
939     // compressed size used from given memory buffer
940     int size;
941     /// I/P/B frame type
942     int frame_type;
943 } avc_enc_result_t;
944
945 /**
946  * Commands
947  * order can't be changed - once it was defined
948  */
949 typedef enum {
950     // general commands
951     AVC_OPEN_BY_NAME = 0xACA000,
952     AVC_OPEN_BY_CODEC_ID,
953     AVC_OPEN_BY_FOURCC,
954     AVC_CLOSE,
955
956     AVC_FLUSH,
957     // pin - struct { uint8_t* src, uint_t src_size }
958     // pout - struct { AVPicture* img, consumed_bytes,
959     AVC_DECODE,
960     // pin - struct { AVPicture* img, uint8_t* dest, uint_t dest_size }
961     // pout - uint_t used_from_dest_size
962     AVC_ENCODE, 
963
964     // query/get video commands
965     AVC_GET_VERSION = 0xACB000,
966     AVC_GET_WIDTH,
967     AVC_GET_HEIGHT,
968     AVC_GET_DELAY,
969     AVC_GET_QUANT_TABLE,
970     // ...
971
972     // query/get audio commands
973     AVC_GET_FRAME_SIZE = 0xABC000,
974
975     // maybe define some simple structure which
976     // might be passed to the user - but they can't
977     // contain any codec specific parts and these
978     // calls are usualy necessary only few times
979
980     // set video commands
981     AVC_SET_WIDTH = 0xACD000,
982     AVC_SET_HEIGHT,
983
984     // set video encoding commands
985     AVC_SET_FRAME_RATE = 0xACD800,
986     AVC_SET_QUALITY,
987     AVC_SET_HURRY_UP,
988
989     // set audio commands
990     AVC_SET_SAMPLE_RATE = 0xACE000,
991     AVC_SET_CHANNELS,
992
993 } avc_cmd_t;
994
995 /**
996  * \param handle  allocated private structure by libavcodec
997  *                for initialization pass NULL - will be returned pout
998  *                user is supposed to know nothing about its structure
999  * \param cmd     type of operation to be performed
1000  * \param pint    input parameter
1001  * \param pout    output parameter
1002  *
1003  * \returns  command status - eventually for query command it might return
1004  * integer resulting value
1005  */
1006 int avcodec(void* handle, avc_cmd_t cmd, void* pin, void* pout);
1007
1008 /* memory */
1009 void *av_malloc(int size);
1010 void *av_mallocz(int size);
1011 void av_free(void *ptr);
1012 void __av_freep(void **ptr);
1013 #define av_freep(p) __av_freep((void **)(p))
1014
1015 #endif /* AVCODEC_H */