2 * Libavformat API example: Output a media file in any supported
3 * libavformat format. The default codecs are used.
5 * Copyright (c) 2003 Fabrice Bellard
7 * Permission is hereby granted, free of charge, to any person obtaining a copy
8 * of this software and associated documentation files (the "Software"), to deal
9 * in the Software without restriction, including without limitation the rights
10 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
11 * copies of the Software, and to permit persons to whom the Software is
12 * furnished to do so, subject to the following conditions:
14 * The above copyright notice and this permission notice shall be included in
15 * all copies or substantial portions of the Software.
17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
20 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
22 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
31 #define M_PI 3.14159265358979323846
34 #include "libavformat/avformat.h"
35 #include "libswscale/swscale.h"
39 /* 5 seconds stream duration */
40 #define STREAM_DURATION 5.0
41 #define STREAM_FRAME_RATE 25 /* 25 images/s */
42 #define STREAM_NB_FRAMES ((int)(STREAM_DURATION * STREAM_FRAME_RATE))
43 #define STREAM_PIX_FMT PIX_FMT_YUV420P /* default pix_fmt */
45 static int sws_flags
= SWS_BICUBIC
;
47 /**************************************************************/
50 float t
, tincr
, tincr2
;
52 uint8_t *audio_outbuf
;
53 int audio_outbuf_size
;
54 int audio_input_frame_size
;
57 * add an audio output stream
59 static AVStream
*add_audio_stream(AVFormatContext
*oc
, int codec_id
)
64 st
= av_new_stream(oc
, 1);
66 fprintf(stderr
, "Could not alloc stream\n");
71 c
->codec_id
= codec_id
;
72 c
->codec_type
= CODEC_TYPE_AUDIO
;
74 /* put sample parameters */
76 c
->sample_rate
= 44100;
81 static void open_audio(AVFormatContext
*oc
, AVStream
*st
)
88 /* find the audio encoder */
89 codec
= avcodec_find_encoder(c
->codec_id
);
91 fprintf(stderr
, "codec not found\n");
96 if (avcodec_open(c
, codec
) < 0) {
97 fprintf(stderr
, "could not open codec\n");
101 /* init signal generator */
103 tincr
= 2 * M_PI
* 110.0 / c
->sample_rate
;
104 /* increment frequency by 110 Hz per second */
105 tincr2
= 2 * M_PI
* 110.0 / c
->sample_rate
/ c
->sample_rate
;
107 audio_outbuf_size
= 10000;
108 audio_outbuf
= av_malloc(audio_outbuf_size
);
110 /* ugly hack for PCM codecs (will be removed ASAP with new PCM
111 support to compute the input frame size in samples */
112 if (c
->frame_size
<= 1) {
113 audio_input_frame_size
= audio_outbuf_size
/ c
->channels
;
114 switch(st
->codec
->codec_id
) {
115 case CODEC_ID_PCM_S16LE
:
116 case CODEC_ID_PCM_S16BE
:
117 case CODEC_ID_PCM_U16LE
:
118 case CODEC_ID_PCM_U16BE
:
119 audio_input_frame_size
>>= 1;
125 audio_input_frame_size
= c
->frame_size
;
127 samples
= av_malloc(audio_input_frame_size
* 2 * c
->channels
);
130 /* prepare a 16 bit dummy audio frame of 'frame_size' samples and
131 'nb_channels' channels */
132 static void get_audio_frame(int16_t *samples
, int frame_size
, int nb_channels
)
138 for(j
=0;j
<frame_size
;j
++) {
139 v
= (int)(sin(t
) * 10000);
140 for(i
= 0; i
< nb_channels
; i
++)
147 static void write_audio_frame(AVFormatContext
*oc
, AVStream
*st
)
151 av_init_packet(&pkt
);
155 get_audio_frame(samples
, audio_input_frame_size
, c
->channels
);
157 pkt
.size
= avcodec_encode_audio(c
, audio_outbuf
, audio_outbuf_size
, samples
);
159 if (c
->coded_frame
->pts
!= AV_NOPTS_VALUE
)
160 pkt
.pts
= av_rescale_q(c
->coded_frame
->pts
, c
->time_base
, st
->time_base
);
161 pkt
.flags
|= PKT_FLAG_KEY
;
162 pkt
.stream_index
= st
->index
;
163 pkt
.data
= audio_outbuf
;
165 /* write the compressed frame in the media file */
166 if (av_interleaved_write_frame(oc
, &pkt
) != 0) {
167 fprintf(stderr
, "Error while writing audio frame\n");
172 static void close_audio(AVFormatContext
*oc
, AVStream
*st
)
174 avcodec_close(st
->codec
);
177 av_free(audio_outbuf
);
180 /**************************************************************/
183 AVFrame
*picture
, *tmp_picture
;
184 uint8_t *video_outbuf
;
185 int frame_count
, video_outbuf_size
;
187 /* add a video output stream */
188 static AVStream
*add_video_stream(AVFormatContext
*oc
, int codec_id
)
193 st
= av_new_stream(oc
, 0);
195 fprintf(stderr
, "Could not alloc stream\n");
200 c
->codec_id
= codec_id
;
201 c
->codec_type
= CODEC_TYPE_VIDEO
;
203 /* put sample parameters */
204 c
->bit_rate
= 400000;
205 /* resolution must be a multiple of two */
208 /* time base: this is the fundamental unit of time (in seconds) in terms
209 of which frame timestamps are represented. for fixed-fps content,
210 timebase should be 1/framerate and timestamp increments should be
212 c
->time_base
.den
= STREAM_FRAME_RATE
;
213 c
->time_base
.num
= 1;
214 c
->gop_size
= 12; /* emit one intra frame every twelve frames at most */
215 c
->pix_fmt
= STREAM_PIX_FMT
;
216 if (c
->codec_id
== CODEC_ID_MPEG2VIDEO
) {
217 /* just for testing, we also add B frames */
220 if (c
->codec_id
== CODEC_ID_MPEG1VIDEO
){
221 /* Needed to avoid using macroblocks in which some coeffs overflow.
222 This does not happen with normal video, it just happens here as
223 the motion of the chroma plane does not match the luma plane. */
226 // some formats want stream headers to be separate
227 if(oc
->oformat
->flags
& AVFMT_GLOBALHEADER
)
228 c
->flags
|= CODEC_FLAG_GLOBAL_HEADER
;
233 static AVFrame
*alloc_picture(int pix_fmt
, int width
, int height
)
236 uint8_t *picture_buf
;
239 picture
= avcodec_alloc_frame();
242 size
= avpicture_get_size(pix_fmt
, width
, height
);
243 picture_buf
= av_malloc(size
);
248 avpicture_fill((AVPicture
*)picture
, picture_buf
,
249 pix_fmt
, width
, height
);
253 static void open_video(AVFormatContext
*oc
, AVStream
*st
)
260 /* find the video encoder */
261 codec
= avcodec_find_encoder(c
->codec_id
);
263 fprintf(stderr
, "codec not found\n");
268 if (avcodec_open(c
, codec
) < 0) {
269 fprintf(stderr
, "could not open codec\n");
274 if (!(oc
->oformat
->flags
& AVFMT_RAWPICTURE
)) {
275 /* allocate output buffer */
276 /* XXX: API change will be done */
277 /* buffers passed into lav* can be allocated any way you prefer,
278 as long as they're aligned enough for the architecture, and
279 they're freed appropriately (such as using av_free for buffers
280 allocated with av_malloc) */
281 video_outbuf_size
= 200000;
282 video_outbuf
= av_malloc(video_outbuf_size
);
285 /* allocate the encoded raw picture */
286 picture
= alloc_picture(c
->pix_fmt
, c
->width
, c
->height
);
288 fprintf(stderr
, "Could not allocate picture\n");
292 /* if the output format is not YUV420P, then a temporary YUV420P
293 picture is needed too. It is then converted to the required
296 if (c
->pix_fmt
!= PIX_FMT_YUV420P
) {
297 tmp_picture
= alloc_picture(PIX_FMT_YUV420P
, c
->width
, c
->height
);
299 fprintf(stderr
, "Could not allocate temporary picture\n");
305 /* prepare a dummy image */
306 static void fill_yuv_image(AVFrame
*pict
, int frame_index
, int width
, int height
)
313 for(y
=0;y
<height
;y
++) {
314 for(x
=0;x
<width
;x
++) {
315 pict
->data
[0][y
* pict
->linesize
[0] + x
] = x
+ y
+ i
* 3;
320 for(y
=0;y
<height
/2;y
++) {
321 for(x
=0;x
<width
/2;x
++) {
322 pict
->data
[1][y
* pict
->linesize
[1] + x
] = 128 + y
+ i
* 2;
323 pict
->data
[2][y
* pict
->linesize
[2] + x
] = 64 + x
+ i
* 5;
328 static void write_video_frame(AVFormatContext
*oc
, AVStream
*st
)
332 static struct SwsContext
*img_convert_ctx
;
336 if (frame_count
>= STREAM_NB_FRAMES
) {
337 /* no more frame to compress. The codec has a latency of a few
338 frames if using B frames, so we get the last frames by
339 passing the same picture again */
341 if (c
->pix_fmt
!= PIX_FMT_YUV420P
) {
342 /* as we only generate a YUV420P picture, we must convert it
343 to the codec pixel format if needed */
344 if (img_convert_ctx
== NULL
) {
345 img_convert_ctx
= sws_getContext(c
->width
, c
->height
,
349 sws_flags
, NULL
, NULL
, NULL
);
350 if (img_convert_ctx
== NULL
) {
351 fprintf(stderr
, "Cannot initialize the conversion context\n");
355 fill_yuv_image(tmp_picture
, frame_count
, c
->width
, c
->height
);
356 sws_scale(img_convert_ctx
, tmp_picture
->data
, tmp_picture
->linesize
,
357 0, c
->height
, picture
->data
, picture
->linesize
);
359 fill_yuv_image(picture
, frame_count
, c
->width
, c
->height
);
364 if (oc
->oformat
->flags
& AVFMT_RAWPICTURE
) {
365 /* raw video case. The API will change slightly in the near
368 av_init_packet(&pkt
);
370 pkt
.flags
|= PKT_FLAG_KEY
;
371 pkt
.stream_index
= st
->index
;
372 pkt
.data
= (uint8_t *)picture
;
373 pkt
.size
= sizeof(AVPicture
);
375 ret
= av_interleaved_write_frame(oc
, &pkt
);
377 /* encode the image */
378 out_size
= avcodec_encode_video(c
, video_outbuf
, video_outbuf_size
, picture
);
379 /* if zero size, it means the image was buffered */
382 av_init_packet(&pkt
);
384 if (c
->coded_frame
->pts
!= AV_NOPTS_VALUE
)
385 pkt
.pts
= av_rescale_q(c
->coded_frame
->pts
, c
->time_base
, st
->time_base
);
386 if(c
->coded_frame
->key_frame
)
387 pkt
.flags
|= PKT_FLAG_KEY
;
388 pkt
.stream_index
= st
->index
;
389 pkt
.data
= video_outbuf
;
392 /* write the compressed frame in the media file */
393 ret
= av_interleaved_write_frame(oc
, &pkt
);
399 fprintf(stderr
, "Error while writing video frame\n");
405 static void close_video(AVFormatContext
*oc
, AVStream
*st
)
407 avcodec_close(st
->codec
);
408 av_free(picture
->data
[0]);
411 av_free(tmp_picture
->data
[0]);
412 av_free(tmp_picture
);
414 av_free(video_outbuf
);
417 /**************************************************************/
418 /* media file output */
420 int main(int argc
, char **argv
)
422 const char *filename
;
425 AVStream
*audio_st
, *video_st
;
426 double audio_pts
, video_pts
;
429 /* initialize libavcodec, and register all codecs and formats */
433 printf("usage: %s output_file\n"
434 "API example program to output a media file with libavformat.\n"
435 "The output format is automatically guessed according to the file extension.\n"
436 "Raw images can also be output by using '%%d' in the filename\n"
443 /* auto detect the output format from the name. default is
445 fmt
= guess_format(NULL
, filename
, NULL
);
447 printf("Could not deduce output format from file extension: using MPEG.\n");
448 fmt
= guess_format("mpeg", NULL
, NULL
);
451 fprintf(stderr
, "Could not find suitable output format\n");
455 /* allocate the output media context */
456 oc
= avformat_alloc_context();
458 fprintf(stderr
, "Memory error\n");
462 snprintf(oc
->filename
, sizeof(oc
->filename
), "%s", filename
);
464 /* add the audio and video streams using the default format codecs
465 and initialize the codecs */
468 if (fmt
->video_codec
!= CODEC_ID_NONE
) {
469 video_st
= add_video_stream(oc
, fmt
->video_codec
);
471 if (fmt
->audio_codec
!= CODEC_ID_NONE
) {
472 audio_st
= add_audio_stream(oc
, fmt
->audio_codec
);
475 /* set the output parameters (must be done even if no
477 if (av_set_parameters(oc
, NULL
) < 0) {
478 fprintf(stderr
, "Invalid output format parameters\n");
482 dump_format(oc
, 0, filename
, 1);
484 /* now that all the parameters are set, we can open the audio and
485 video codecs and allocate the necessary encode buffers */
487 open_video(oc
, video_st
);
489 open_audio(oc
, audio_st
);
491 /* open the output file, if needed */
492 if (!(fmt
->flags
& AVFMT_NOFILE
)) {
493 if (url_fopen(&oc
->pb
, filename
, URL_WRONLY
) < 0) {
494 fprintf(stderr
, "Could not open '%s'\n", filename
);
499 /* write the stream header, if any */
503 /* compute current audio and video time */
505 audio_pts
= (double)audio_st
->pts
.val
* audio_st
->time_base
.num
/ audio_st
->time_base
.den
;
510 video_pts
= (double)video_st
->pts
.val
* video_st
->time_base
.num
/ video_st
->time_base
.den
;
514 if ((!audio_st
|| audio_pts
>= STREAM_DURATION
) &&
515 (!video_st
|| video_pts
>= STREAM_DURATION
))
518 /* write interleaved audio and video frames */
519 if (!video_st
|| (video_st
&& audio_st
&& audio_pts
< video_pts
)) {
520 write_audio_frame(oc
, audio_st
);
522 write_video_frame(oc
, video_st
);
526 /* write the trailer, if any. the trailer must be written
527 * before you close the CodecContexts open when you wrote the
528 * header; otherwise write_trailer may try to use memory that
529 * was freed on av_codec_close() */
530 av_write_trailer(oc
);
532 /* close each codec */
534 close_video(oc
, video_st
);
536 close_audio(oc
, audio_st
);
538 /* free the streams */
539 for(i
= 0; i
< oc
->nb_streams
; i
++) {
540 av_freep(&oc
->streams
[i
]->codec
);
541 av_freep(&oc
->streams
[i
]);
544 if (!(fmt
->flags
& AVFMT_NOFILE
)) {
545 /* close the output file */
549 /* free the stream */