Mercurial > libavcodec.hg
annotate avcodec.h @ 322:ce35fd27bbb0 libavcodec
- Versions defined for libav/libavcodec.
- Bug fix in wav muxer for MP2 audio.
- ffmpeg/libavcodec version in MPEG-4 user data.
author | pulento |
---|---|
date | Mon, 15 Apr 2002 02:28:05 +0000 |
parents | 2b00e171b1d4 |
children | 9c6f056f0e41 |
rev | line source |
---|---|
92 | 1 #ifndef AVCODEC_H |
2 #define AVCODEC_H | |
3 | |
0 | 4 #include "common.h" |
5 | |
322 | 6 #define LIBAVCODEC_VERSION_INT 0x000406 |
7 #define LIBAVCODEC_VERSION "0.4.6" | |
8 #define LIBAVCODEC_BUILD 4600 | |
9 #define LIBAVCODEC_BUILD_STR "4600" | |
10 | |
0 | 11 enum CodecID { |
12 CODEC_ID_NONE, | |
13 CODEC_ID_MPEG1VIDEO, | |
14 CODEC_ID_H263, | |
15 CODEC_ID_RV10, | |
16 CODEC_ID_MP2, | |
260
e1bacfb3f51f
- Added MP3 encoding through libmp3lame contributed by Lennert Buytenhek.
pulento
parents:
252
diff
changeset
|
17 CODEC_ID_MP3LAME, |
0 | 18 CODEC_ID_AC3, |
19 CODEC_ID_MJPEG, | |
67 | 20 CODEC_ID_MPEG4, |
0 | 21 CODEC_ID_RAWVIDEO, |
307 | 22 CODEC_ID_MSMPEG4V1, |
23 CODEC_ID_MSMPEG4V2, | |
24 CODEC_ID_MSMPEG4V3, | |
311 | 25 CODEC_ID_WMV1, |
0 | 26 CODEC_ID_H263P, |
27 CODEC_ID_H263I, | |
92 | 28 |
29 /* various pcm "codecs" */ | |
30 CODEC_ID_PCM_S16LE, | |
31 CODEC_ID_PCM_S16BE, | |
32 CODEC_ID_PCM_U16LE, | |
33 CODEC_ID_PCM_U16BE, | |
34 CODEC_ID_PCM_S8, | |
35 CODEC_ID_PCM_U8, | |
36 CODEC_ID_PCM_MULAW, | |
37 CODEC_ID_PCM_ALAW, | |
0 | 38 }; |
307 | 39 #define CODEC_ID_MSMPEG4 CODEC_ID_MSMPEG4V3 |
0 | 40 |
41 enum CodecType { | |
42 CODEC_TYPE_VIDEO, | |
43 CODEC_TYPE_AUDIO, | |
44 }; | |
45 | |
46 enum PixelFormat { | |
317
5afea0021fb8
- PIX_FMT_ANY = -1 to avoid breaking any stuff that could be using it.
pulento
parents:
316
diff
changeset
|
47 PIX_FMT_ANY = -1, |
0 | 48 PIX_FMT_YUV420P, |
49 PIX_FMT_YUV422, | |
50 PIX_FMT_RGB24, | |
51 PIX_FMT_BGR24, | |
27
b8723ec6c80f
added 422P and 444P formats (need to patch ffmpeg.c so that it is handled in all the program)
glantau
parents:
24
diff
changeset
|
52 PIX_FMT_YUV422P, |
b8723ec6c80f
added 422P and 444P formats (need to patch ffmpeg.c so that it is handled in all the program)
glantau
parents:
24
diff
changeset
|
53 PIX_FMT_YUV444P, |
0 | 54 }; |
55 | |
92 | 56 /* currently unused, may be used if 24/32 bits samples ever supported */ |
57 enum SampleFormat { | |
58 SAMPLE_FMT_S16 = 0, /* signed 16 bits */ | |
59 }; | |
60 | |
0 | 61 /* in bytes */ |
62 #define AVCODEC_MAX_AUDIO_FRAME_SIZE 18432 | |
63 | |
320
cda7d0857baf
- ME setting moved to AVCodecContext/MpegEncContext, no longer a global.
pulento
parents:
317
diff
changeset
|
64 /* motion estimation type, EPZS by default */ |
cda7d0857baf
- ME setting moved to AVCodecContext/MpegEncContext, no longer a global.
pulento
parents:
317
diff
changeset
|
65 enum Motion_Est_ID { |
321 | 66 ME_ZERO = 1, |
320
cda7d0857baf
- ME setting moved to AVCodecContext/MpegEncContext, no longer a global.
pulento
parents:
317
diff
changeset
|
67 ME_FULL, |
cda7d0857baf
- ME setting moved to AVCodecContext/MpegEncContext, no longer a global.
pulento
parents:
317
diff
changeset
|
68 ME_LOG, |
cda7d0857baf
- ME setting moved to AVCodecContext/MpegEncContext, no longer a global.
pulento
parents:
317
diff
changeset
|
69 ME_PHODS, |
cda7d0857baf
- ME setting moved to AVCodecContext/MpegEncContext, no longer a global.
pulento
parents:
317
diff
changeset
|
70 ME_EPZS, |
cda7d0857baf
- ME setting moved to AVCodecContext/MpegEncContext, no longer a global.
pulento
parents:
317
diff
changeset
|
71 ME_X1 |
cda7d0857baf
- ME setting moved to AVCodecContext/MpegEncContext, no longer a global.
pulento
parents:
317
diff
changeset
|
72 }; |
cda7d0857baf
- ME setting moved to AVCodecContext/MpegEncContext, no longer a global.
pulento
parents:
317
diff
changeset
|
73 |
321 | 74 /* only for ME compatiblity with old apps */ |
75 extern int motion_estimation_method; | |
76 | |
320
cda7d0857baf
- ME setting moved to AVCodecContext/MpegEncContext, no longer a global.
pulento
parents:
317
diff
changeset
|
77 /* ME algos sorted by quality */ |
322 | 78 static const int Motion_Est_QTab[] = { 1, 4, 3, 6, 5, 2 }; |
0 | 79 |
80 /* encoding support */ | |
294 | 81 /* note not everything is supported yet */ |
0 | 82 |
83 #define CODEC_FLAG_HQ 0x0001 /* high quality (non real time) encoding */ | |
84 #define CODEC_FLAG_QSCALE 0x0002 /* use fixed qscale */ | |
294 | 85 #define CODEC_FLAG_4MV 0x0004 /* 4 MV per MB allowed */ |
86 #define CODEC_FLAG_B 0x0008 /* use B frames */ | |
87 #define CODEC_FLAG_QPEL 0x0010 /* use qpel MC */ | |
88 #define CODEC_FLAG_GMC 0x0020 /* use GMC */ | |
298
e20de99b6295
using Juanjo's way to pass forced type - especially as I_TYPE/P_TYPE defines aren't exported in the public interface, and the flagged method matches the way as qscale forcing work
arpi_esp
parents:
297
diff
changeset
|
89 #define CODEC_FLAG_TYPE 0x0040 /* fixed I/P frame type, from avctx->key_frame */ |
0 | 90 |
67 | 91 /* codec capabilities */ |
92 | |
93 /* decoder can use draw_horiz_band callback */ | |
94 #define CODEC_CAP_DRAW_HORIZ_BAND 0x0001 | |
95 | |
0 | 96 #define FRAME_RATE_BASE 10000 |
97 | |
98 typedef struct AVCodecContext { | |
99 int bit_rate; | |
268 | 100 int bit_rate_tolerance; /* amount of +- bits (>0)*/ |
0 | 101 int flags; |
102 int sub_id; /* some codecs needs additionnal format info. It is | |
103 stored there */ | |
320
cda7d0857baf
- ME setting moved to AVCodecContext/MpegEncContext, no longer a global.
pulento
parents:
317
diff
changeset
|
104 |
cda7d0857baf
- ME setting moved to AVCodecContext/MpegEncContext, no longer a global.
pulento
parents:
317
diff
changeset
|
105 int me_method; /* ME algorithm used for video coding */ |
cda7d0857baf
- ME setting moved to AVCodecContext/MpegEncContext, no longer a global.
pulento
parents:
317
diff
changeset
|
106 |
0 | 107 /* video only */ |
108 int frame_rate; /* frames per sec multiplied by FRAME_RATE_BASE */ | |
109 int width, height; | |
281
1fc96b02142e
mpeg4 aspect_ratio_info in AVCodecContext (requested by alex)
michaelni
parents:
277
diff
changeset
|
110 int aspect_ratio_info; |
282 | 111 #define FF_ASPECT_SQUARE 1 |
112 #define FF_ASPECT_4_3_625 2 | |
113 #define FF_ASPECT_4_3_525 3 | |
114 #define FF_ASPECT_16_9_625 4 | |
115 #define FF_ASPECT_16_9_525 5 | |
0 | 116 int gop_size; /* 0 = intra only */ |
315 | 117 enum PixelFormat pix_fmt; /* pixel format, see PIX_FMT_xxx */ |
67 | 118 |
119 /* if non NULL, 'draw_horiz_band' is called by the libavcodec | |
120 decoder to draw an horizontal band. It improve cache usage. Not | |
121 all codecs can do that. You must check the codec capabilities | |
122 before */ | |
123 void (*draw_horiz_band)(struct AVCodecContext *s, | |
124 UINT8 **src_ptr, int linesize, | |
125 int y, int width, int height); | |
126 | |
0 | 127 /* audio only */ |
128 int sample_rate; /* samples per sec */ | |
129 int channels; | |
92 | 130 int sample_fmt; /* sample format, currenly unused */ |
0 | 131 |
132 /* the following data should not be initialized */ | |
133 int frame_size; /* in samples, initialized when calling 'init' */ | |
134 int frame_number; /* audio or video frame number */ | |
135 int key_frame; /* true if the previous compressed frame was | |
136 a key frame (intra, or seekable) */ | |
137 int quality; /* quality of the previous encoded frame | |
138 (between 1 (good) and 31 (bad)) */ | |
268 | 139 float qcompress; /* amount of qscale change between easy & hard scenes (0.0-1.0)*/ |
140 float qblur; /* amount of qscale smoothing over time (0.0-1.0) */ | |
141 int qmin; /* min qscale */ | |
142 int qmax; /* max qscale */ | |
143 int max_qdiff; /* max qscale difference between frames */ | |
297 | 144 |
0 | 145 struct AVCodec *codec; |
146 void *priv_data; | |
147 | |
162 | 148 /* The following data is for RTP friendly coding */ |
149 /* By now only H.263/H.263+ coder honours this */ | |
150 int rtp_mode; /* 1 for activate RTP friendly-mode */ | |
151 /* highers numbers represent more error-prone */ | |
152 /* enviroments, by now just "1" exist */ | |
153 | |
154 int rtp_payload_size; /* The size of the RTP payload, the coder will */ | |
155 /* do it's best to deliver a chunk with size */ | |
156 /* below rtp_payload_size, the chunk will start */ | |
157 /* with a start code on some codecs like H.263 */ | |
158 /* This doesn't take account of any particular */ | |
159 /* headers inside the transmited RTP payload */ | |
231 | 160 |
161 | |
162 /* The RTP callcack: This function is called */ | |
163 /* every time the encoder as a packet to send */ | |
164 /* Depends on the encoder if the data starts */ | |
165 /* with a Start Code (it should) H.263 does */ | |
166 void (*rtp_callback)(void *data, int size, int packet_number); | |
167 | |
252
ddb1a0e94cf4
- Added PSNR feature to libavcodec and ffmpeg. By now just Y PSNR until I'm
pulento
parents:
231
diff
changeset
|
168 /* These are for PSNR calculation, if you set get_psnr to 1 */ |
ddb1a0e94cf4
- Added PSNR feature to libavcodec and ffmpeg. By now just Y PSNR until I'm
pulento
parents:
231
diff
changeset
|
169 /* after encoding you will have the PSNR on psnr_y/cb/cr */ |
ddb1a0e94cf4
- Added PSNR feature to libavcodec and ffmpeg. By now just Y PSNR until I'm
pulento
parents:
231
diff
changeset
|
170 int get_psnr; |
ddb1a0e94cf4
- Added PSNR feature to libavcodec and ffmpeg. By now just Y PSNR until I'm
pulento
parents:
231
diff
changeset
|
171 float psnr_y; |
ddb1a0e94cf4
- Added PSNR feature to libavcodec and ffmpeg. By now just Y PSNR until I'm
pulento
parents:
231
diff
changeset
|
172 float psnr_cb; |
ddb1a0e94cf4
- Added PSNR feature to libavcodec and ffmpeg. By now just Y PSNR until I'm
pulento
parents:
231
diff
changeset
|
173 float psnr_cr; |
286 | 174 |
175 /* statistics, used for 2-pass encoding */ | |
176 int mv_bits; | |
177 int header_bits; | |
178 int i_tex_bits; | |
179 int p_tex_bits; | |
180 int i_count; | |
181 int p_count; | |
182 int skip_count; | |
183 int misc_bits; // cbp, mb_type | |
184 int frame_bits; | |
162 | 185 |
0 | 186 /* the following fields are ignored */ |
67 | 187 void *opaque; /* can be used to carry app specific stuff */ |
0 | 188 char codec_name[32]; |
189 int codec_type; /* see CODEC_TYPE_xxx */ | |
190 int codec_id; /* see CODEC_ID_xxx */ | |
191 unsigned int codec_tag; /* codec tag, only used if unknown codec */ | |
192 } AVCodecContext; | |
193 | |
194 typedef struct AVCodec { | |
195 char *name; | |
196 int type; | |
197 int id; | |
198 int priv_data_size; | |
199 int (*init)(AVCodecContext *); | |
200 int (*encode)(AVCodecContext *, UINT8 *buf, int buf_size, void *data); | |
201 int (*close)(AVCodecContext *); | |
202 int (*decode)(AVCodecContext *, void *outdata, int *outdata_size, | |
203 UINT8 *buf, int buf_size); | |
67 | 204 int capabilities; |
0 | 205 struct AVCodec *next; |
206 } AVCodec; | |
207 | |
208 /* three components are given, that's all */ | |
209 typedef struct AVPicture { | |
210 UINT8 *data[3]; | |
211 int linesize[3]; | |
212 } AVPicture; | |
213 | |
214 extern AVCodec ac3_encoder; | |
215 extern AVCodec mp2_encoder; | |
260
e1bacfb3f51f
- Added MP3 encoding through libmp3lame contributed by Lennert Buytenhek.
pulento
parents:
252
diff
changeset
|
216 extern AVCodec mp3lame_encoder; |
0 | 217 extern AVCodec mpeg1video_encoder; |
218 extern AVCodec h263_encoder; | |
219 extern AVCodec h263p_encoder; | |
220 extern AVCodec rv10_encoder; | |
221 extern AVCodec mjpeg_encoder; | |
67 | 222 extern AVCodec mpeg4_encoder; |
307 | 223 extern AVCodec msmpeg4v1_encoder; |
224 extern AVCodec msmpeg4v2_encoder; | |
225 extern AVCodec msmpeg4v3_encoder; | |
0 | 226 |
227 extern AVCodec h263_decoder; | |
67 | 228 extern AVCodec mpeg4_decoder; |
307 | 229 extern AVCodec msmpeg4v1_decoder; |
230 extern AVCodec msmpeg4v2_decoder; | |
231 extern AVCodec msmpeg4v3_decoder; | |
311 | 232 extern AVCodec wmv1_decoder; |
0 | 233 extern AVCodec mpeg_decoder; |
234 extern AVCodec h263i_decoder; | |
235 extern AVCodec rv10_decoder; | |
24 | 236 extern AVCodec mjpeg_decoder; |
322 | 237 extern AVCodec mp2_decoder; |
92 | 238 extern AVCodec mp3_decoder; |
0 | 239 |
92 | 240 /* pcm codecs */ |
241 #define PCM_CODEC(id, name) \ | |
242 extern AVCodec name ## _decoder; \ | |
243 extern AVCodec name ## _encoder; | |
244 | |
245 PCM_CODEC(CODEC_ID_PCM_S16LE, pcm_s16le); | |
246 PCM_CODEC(CODEC_ID_PCM_S16BE, pcm_s16be); | |
247 PCM_CODEC(CODEC_ID_PCM_U16LE, pcm_u16le); | |
248 PCM_CODEC(CODEC_ID_PCM_U16BE, pcm_u16be); | |
249 PCM_CODEC(CODEC_ID_PCM_S8, pcm_s8); | |
250 PCM_CODEC(CODEC_ID_PCM_U8, pcm_u8); | |
251 PCM_CODEC(CODEC_ID_PCM_ALAW, pcm_alaw); | |
252 PCM_CODEC(CODEC_ID_PCM_MULAW, pcm_mulaw); | |
253 | |
254 #undef PCM_CODEC | |
255 | |
256 /* dummy raw video codec */ | |
0 | 257 extern AVCodec rawvideo_codec; |
258 | |
259 /* the following codecs use external GPL libs */ | |
260 extern AVCodec ac3_decoder; | |
261 | |
262 /* resample.c */ | |
263 | |
264 struct ReSampleContext; | |
265 | |
266 typedef struct ReSampleContext ReSampleContext; | |
267 | |
268 ReSampleContext *audio_resample_init(int output_channels, int input_channels, | |
269 int output_rate, int input_rate); | |
270 int audio_resample(ReSampleContext *s, short *output, short *input, int nb_samples); | |
271 void audio_resample_close(ReSampleContext *s); | |
272 | |
273 /* YUV420 format is assumed ! */ | |
274 | |
275 struct ImgReSampleContext; | |
276 | |
277 typedef struct ImgReSampleContext ImgReSampleContext; | |
278 | |
279 ImgReSampleContext *img_resample_init(int output_width, int output_height, | |
280 int input_width, int input_height); | |
281 void img_resample(ImgReSampleContext *s, | |
282 AVPicture *output, AVPicture *input); | |
283 | |
284 void img_resample_close(ImgReSampleContext *s); | |
285 | |
49 | 286 void avpicture_fill(AVPicture *picture, UINT8 *ptr, |
287 int pix_fmt, int width, int height); | |
288 int avpicture_get_size(int pix_fmt, int width, int height); | |
289 | |
290 /* convert among pixel formats */ | |
291 int img_convert(AVPicture *dst, int dst_pix_fmt, | |
292 AVPicture *src, int pix_fmt, | |
293 int width, int height); | |
294 | |
295 /* deinterlace a picture */ | |
296 int avpicture_deinterlace(AVPicture *dst, AVPicture *src, | |
0 | 297 int pix_fmt, int width, int height); |
298 | |
299 /* external high level API */ | |
300 | |
301 extern AVCodec *first_avcodec; | |
302 | |
303 void avcodec_init(void); | |
304 | |
305 void register_avcodec(AVCodec *format); | |
306 AVCodec *avcodec_find_encoder(enum CodecID id); | |
177 | 307 AVCodec *avcodec_find_encoder_by_name(const char *name); |
0 | 308 AVCodec *avcodec_find_decoder(enum CodecID id); |
309 AVCodec *avcodec_find_decoder_by_name(const char *name); | |
310 void avcodec_string(char *buf, int buf_size, AVCodecContext *enc, int encode); | |
311 | |
312 int avcodec_open(AVCodecContext *avctx, AVCodec *codec); | |
313 int avcodec_decode_audio(AVCodecContext *avctx, INT16 *samples, | |
314 int *frame_size_ptr, | |
315 UINT8 *buf, int buf_size); | |
316 int avcodec_decode_video(AVCodecContext *avctx, AVPicture *picture, | |
317 int *got_picture_ptr, | |
318 UINT8 *buf, int buf_size); | |
319 int avcodec_encode_audio(AVCodecContext *avctx, UINT8 *buf, int buf_size, | |
320 const short *samples); | |
321 int avcodec_encode_video(AVCodecContext *avctx, UINT8 *buf, int buf_size, | |
322 const AVPicture *pict); | |
323 | |
324 int avcodec_close(AVCodecContext *avctx); | |
325 | |
326 void avcodec_register_all(void); | |
92 | 327 |
108
1e4a4af694d1
exporting qscale data for postprocessing (for MPlayer)
arpi_esp
parents:
92
diff
changeset
|
328 #ifdef FF_POSTPROCESS |
1e4a4af694d1
exporting qscale data for postprocessing (for MPlayer)
arpi_esp
parents:
92
diff
changeset
|
329 #ifndef MBC |
162 | 330 #define MBC 48 |
331 #define MBR 36 | |
108
1e4a4af694d1
exporting qscale data for postprocessing (for MPlayer)
arpi_esp
parents:
92
diff
changeset
|
332 #endif |
1e4a4af694d1
exporting qscale data for postprocessing (for MPlayer)
arpi_esp
parents:
92
diff
changeset
|
333 extern int quant_store[MBR+1][MBC+1]; // [Review] |
1e4a4af694d1
exporting qscale data for postprocessing (for MPlayer)
arpi_esp
parents:
92
diff
changeset
|
334 #endif |
1e4a4af694d1
exporting qscale data for postprocessing (for MPlayer)
arpi_esp
parents:
92
diff
changeset
|
335 |
92 | 336 #endif /* AVCODEC_H */ |