2 * copyright (c) 2001 Fabrice Bellard
4 * This file is part of FFmpeg.
6 * FFmpeg is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
11 * FFmpeg is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with FFmpeg; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
23 * avcodec API use example.
25 * Note that this library only handles codecs (mpeg, mpeg4, etc...),
26 * not file formats (avi, vob, etc...). See library 'libavformat' for the
34 #ifdef HAVE_AV_CONFIG_H
35 #undef HAVE_AV_CONFIG_H
38 #include "libavcodec/avcodec.h"
39 #include "libavutil/mathematics.h"
41 #define INBUF_SIZE 4096
42 #define AUDIO_INBUF_SIZE 20480
43 #define AUDIO_REFILL_THRESH 4096
46 * Audio encoding example
48 static void audio_encode_example(const char *filename
)
51 AVCodecContext
*c
= NULL
;
52 int frame_size
, i
, j
, out_size
, outbuf_size
;
58 printf("Audio encoding\n");
60 /* find the MP2 encoder */
61 codec
= avcodec_find_encoder(CODEC_ID_MP2
);
63 fprintf(stderr
, "codec not found\n");
67 c
= avcodec_alloc_context();
69 /* put sample parameters */
71 c
->sample_rate
= 44100;
75 if (avcodec_open(c
, codec
) < 0) {
76 fprintf(stderr
, "could not open codec\n");
80 /* the codec gives us the frame size, in samples */
81 frame_size
= c
->frame_size
;
82 samples
= malloc(frame_size
* 2 * c
->channels
);
84 outbuf
= malloc(outbuf_size
);
86 f
= fopen(filename
, "wb");
88 fprintf(stderr
, "could not open %s\n", filename
);
92 /* encode a single tone sound */
94 tincr
= 2 * M_PI
* 440.0 / c
->sample_rate
;
96 for(j
=0;j
<frame_size
;j
++) {
97 samples
[2*j
] = (int)(sin(t
) * 10000);
98 samples
[2*j
+1] = samples
[2*j
];
101 /* encode the samples */
102 out_size
= avcodec_encode_audio(c
, outbuf
, outbuf_size
, samples
);
103 fwrite(outbuf
, 1, out_size
, f
);
116 static void audio_decode_example(const char *outfilename
, const char *filename
)
119 AVCodecContext
*c
= NULL
;
123 uint8_t inbuf
[AUDIO_INBUF_SIZE
+ FF_INPUT_BUFFER_PADDING_SIZE
];
126 av_init_packet(&avpkt
);
128 printf("Audio decoding\n");
130 /* find the mpeg audio decoder */
131 codec
= avcodec_find_decoder(CODEC_ID_MP2
);
133 fprintf(stderr
, "codec not found\n");
137 c
= avcodec_alloc_context();
140 if (avcodec_open(c
, codec
) < 0) {
141 fprintf(stderr
, "could not open codec\n");
145 outbuf
= malloc(AVCODEC_MAX_AUDIO_FRAME_SIZE
);
147 f
= fopen(filename
, "rb");
149 fprintf(stderr
, "could not open %s\n", filename
);
152 outfile
= fopen(outfilename
, "wb");
158 /* decode until eof */
160 avpkt
.size
= fread(inbuf
, 1, AUDIO_INBUF_SIZE
, f
);
162 while (avpkt
.size
> 0) {
163 out_size
= AVCODEC_MAX_AUDIO_FRAME_SIZE
;
164 len
= avcodec_decode_audio3(c
, (short *)outbuf
, &out_size
, &avpkt
);
166 fprintf(stderr
, "Error while decoding\n");
170 /* if a frame has been decoded, output it */
171 fwrite(outbuf
, 1, out_size
, outfile
);
175 if (avpkt
.size
< AUDIO_REFILL_THRESH
) {
176 /* Refill the input buffer, to avoid trying to decode
177 * incomplete frames. Instead of this, one could also use
178 * a parser, or use a proper container format through
180 memmove(inbuf
, avpkt
.data
, avpkt
.size
);
182 len
= fread(avpkt
.data
+ avpkt
.size
, 1,
183 AUDIO_INBUF_SIZE
- avpkt
.size
, f
);
198 * Video encoding example
200 static void video_encode_example(const char *filename
)
203 AVCodecContext
*c
= NULL
;
204 int i
, out_size
, size
, x
, y
, outbuf_size
;
207 uint8_t *outbuf
, *picture_buf
;
209 printf("Video encoding\n");
211 /* find the mpeg1 video encoder */
212 codec
= avcodec_find_encoder(CODEC_ID_MPEG1VIDEO
);
214 fprintf(stderr
, "codec not found\n");
218 c
= avcodec_alloc_context();
219 picture
= avcodec_alloc_frame();
221 /* put sample parameters */
222 c
->bit_rate
= 400000;
223 /* resolution must be a multiple of two */
226 /* frames per second */
227 c
->time_base
= (AVRational
){1,25};
228 c
->gop_size
= 10; /* emit one intra frame every ten frames */
230 c
->pix_fmt
= PIX_FMT_YUV420P
;
233 if (avcodec_open(c
, codec
) < 0) {
234 fprintf(stderr
, "could not open codec\n");
238 f
= fopen(filename
, "wb");
240 fprintf(stderr
, "could not open %s\n", filename
);
244 /* alloc image and output buffer */
245 outbuf_size
= 100000;
246 outbuf
= malloc(outbuf_size
);
247 size
= c
->width
* c
->height
;
248 picture_buf
= malloc((size
* 3) / 2); /* size for YUV 420 */
250 picture
->data
[0] = picture_buf
;
251 picture
->data
[1] = picture
->data
[0] + size
;
252 picture
->data
[2] = picture
->data
[1] + size
/ 4;
253 picture
->linesize
[0] = c
->width
;
254 picture
->linesize
[1] = c
->width
/ 2;
255 picture
->linesize
[2] = c
->width
/ 2;
257 /* encode 1 second of video */
260 /* prepare a dummy image */
262 for(y
=0;y
<c
->height
;y
++) {
263 for(x
=0;x
<c
->width
;x
++) {
264 picture
->data
[0][y
* picture
->linesize
[0] + x
] = x
+ y
+ i
* 3;
269 for(y
=0;y
<c
->height
/2;y
++) {
270 for(x
=0;x
<c
->width
/2;x
++) {
271 picture
->data
[1][y
* picture
->linesize
[1] + x
] = 128 + y
+ i
* 2;
272 picture
->data
[2][y
* picture
->linesize
[2] + x
] = 64 + x
+ i
* 5;
276 /* encode the image */
277 out_size
= avcodec_encode_video(c
, outbuf
, outbuf_size
, picture
);
278 printf("encoding frame %3d (size=%5d)\n", i
, out_size
);
279 fwrite(outbuf
, 1, out_size
, f
);
282 /* get the delayed frames */
283 for(; out_size
; i
++) {
286 out_size
= avcodec_encode_video(c
, outbuf
, outbuf_size
, NULL
);
287 printf("write frame %3d (size=%5d)\n", i
, out_size
);
288 fwrite(outbuf
, 1, out_size
, f
);
291 /* add sequence end code to have a real mpeg file */
296 fwrite(outbuf
, 1, 4, f
);
308 * Video decoding example
311 static void pgm_save(unsigned char *buf
, int wrap
, int xsize
, int ysize
,
317 f
=fopen(filename
,"w");
318 fprintf(f
,"P5\n%d %d\n%d\n",xsize
,ysize
,255);
320 fwrite(buf
+ i
* wrap
,1,xsize
,f
);
324 static void video_decode_example(const char *outfilename
, const char *filename
)
327 AVCodecContext
*c
= NULL
;
328 int frame
, got_picture
, len
;
331 uint8_t inbuf
[INBUF_SIZE
+ FF_INPUT_BUFFER_PADDING_SIZE
];
335 av_init_packet(&avpkt
);
337 /* set end of buffer to 0 (this ensures that no overreading happens for damaged mpeg streams) */
338 memset(inbuf
+ INBUF_SIZE
, 0, FF_INPUT_BUFFER_PADDING_SIZE
);
340 printf("Video decoding\n");
342 /* find the mpeg1 video decoder */
343 codec
= avcodec_find_decoder(CODEC_ID_MPEG1VIDEO
);
345 fprintf(stderr
, "codec not found\n");
349 c
= avcodec_alloc_context();
350 picture
= avcodec_alloc_frame();
352 if(codec
->capabilities
&CODEC_CAP_TRUNCATED
)
353 c
->flags
|= CODEC_FLAG_TRUNCATED
; /* we do not send complete frames */
355 /* For some codecs, such as msmpeg4 and mpeg4, width and height
356 MUST be initialized there because this information is not
357 available in the bitstream. */
360 if (avcodec_open(c
, codec
) < 0) {
361 fprintf(stderr
, "could not open codec\n");
365 /* the codec gives us the frame size, in samples */
367 f
= fopen(filename
, "rb");
369 fprintf(stderr
, "could not open %s\n", filename
);
375 avpkt
.size
= fread(inbuf
, 1, INBUF_SIZE
, f
);
379 /* NOTE1: some codecs are stream based (mpegvideo, mpegaudio)
380 and this is the only method to use them because you cannot
381 know the compressed data size before analysing it.
383 BUT some other codecs (msmpeg4, mpeg4) are inherently frame
384 based, so you must call them with all the data for one
385 frame exactly. You must also initialize 'width' and
386 'height' before initializing them. */
388 /* NOTE2: some codecs allow the raw parameters (frame size,
389 sample rate) to be changed at any frame. We handle this, so
390 you should also take care of it */
392 /* here, we use a stream based decoder (mpeg1video), so we
393 feed decoder and see if it could decode a frame */
395 while (avpkt
.size
> 0) {
396 len
= avcodec_decode_video2(c
, picture
, &got_picture
, &avpkt
);
398 fprintf(stderr
, "Error while decoding frame %d\n", frame
);
402 printf("saving frame %3d\n", frame
);
405 /* the picture is allocated by the decoder. no need to
407 snprintf(buf
, sizeof(buf
), outfilename
, frame
);
408 pgm_save(picture
->data
[0], picture
->linesize
[0],
409 c
->width
, c
->height
, buf
);
417 /* some codecs, such as MPEG, transmit the I and P frame with a
418 latency of one frame. You must do the following to have a
419 chance to get the last frame of the video */
422 len
= avcodec_decode_video2(c
, picture
, &got_picture
, &avpkt
);
424 printf("saving last frame %3d\n", frame
);
427 /* the picture is allocated by the decoder. no need to
429 snprintf(buf
, sizeof(buf
), outfilename
, frame
);
430 pgm_save(picture
->data
[0], picture
->linesize
[0],
431 c
->width
, c
->height
, buf
);
443 int main(int argc
, char **argv
)
445 const char *filename
;
447 /* must be called before using avcodec lib */
450 /* register all the codecs */
451 avcodec_register_all();
454 audio_encode_example("/tmp/test.mp2");
455 audio_decode_example("/tmp/test.sw", "/tmp/test.mp2");
457 video_encode_example("/tmp/test.mpg");
458 filename
= "/tmp/test.mpg";
463 // audio_decode_example("/tmp/test.sw", filename);
464 video_decode_example("/tmp/test%d.pgm", filename
);