1 /*
2 * Copyright (c) 2010 Nicolas George
3 * Copyright (c) 2011 Stefano Sabatini
4 * Copyright (c) 2014 Andrey Utkin
5 *
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
12 *
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
15 *
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
22 * THE SOFTWARE.
23 */
24
25 /**
26 * @file
27 * API example for demuxing, decoding, filtering, encoding and muxing
28 * @example transcoding.c
29 */
30
38
47
49 {
50 int ret;
51 unsigned int i;
52
56 return ret;
57 }
58
61 return ret;
62 }
63
68 codec_ctx = stream->
codec;
69 /* Reencode video & audio and remux subtitles etc. */
72 /* Open decoder */
75 if (ret < 0) {
77 return ret;
78 }
79 }
80 }
81
83 return 0;
84 }
85
87 {
92 int ret;
93 unsigned int i;
94
97 if (!ofmt_ctx) {
100 }
101
102
105 if (!out_stream) {
108 }
109
110 in_stream = ifmt_ctx->
streams[i];
111 dec_ctx = in_stream->
codec;
112 enc_ctx = out_stream->
codec;
113
116 /* in this example, we choose transcoding to same codec */
118 if (!encoder) {
121 }
122
123 /* In this example, we transcode to same properties (picture size,
124 * sample rate etc.). These properties can be changed for output
125 * streams easily using filters */
130 /* take first format from list of supported formats */
132 /* video time_base can be set to whatever is handy and supported by encoder */
134 } else {
138 /* take first format from list of supported formats */
141 }
142
143 /* Third parameter can be used to pass settings to encoder */
145 if (ret < 0) {
147 return ret;
148 }
152 } else {
153 /* if this stream must be remuxed */
156 if (ret < 0) {
158 return ret;
159 }
160 }
161
164
165 }
167
170 if (ret < 0) {
172 return ret;
173 }
174 }
175
176 /* init muxer, write output file header */
178 if (ret < 0) {
180 return ret;
181 }
182
183 return 0;
184 }
185
188 {
190 int ret = 0;
198
199 if (!outputs || !inputs || !filter_graph) {
202 }
203
207 if (!buffersrc || !buffersink) {
211 }
212
214 "video_size=%dx%d:pix_fmt=%d:time_base=%d/%d:pixel_aspect=%d/%d",
219
221 args,
NULL, filter_graph);
222 if (ret < 0) {
225 }
226
229 if (ret < 0) {
232 }
233
237 if (ret < 0) {
240 }
244 if (!buffersrc || !buffersink) {
248 }
249
254 "time_base=%d/%d:sample_rate=%d:sample_fmt=%s:channel_layout=0x%"PRIx64,
259 args,
NULL, filter_graph);
260 if (ret < 0) {
263 }
264
267 if (ret < 0) {
270 }
271
275 if (ret < 0) {
278 }
279
283 if (ret < 0) {
286 }
287
291 if (ret < 0) {
294 }
295 } else {
298 }
299
300 /* Endpoints for the filter graph. */
305
310
311 if (!outputs->
name || !inputs->
name) {
314 }
315
317 &inputs, &outputs,
NULL)) < 0)
319
322
323 /* Fill FilteringContext */
327
331
332 return ret;
333 }
334
336 {
337 const char *filter_spec;
338 unsigned int i;
339 int ret;
341 if (!filter_ctx)
343
350 continue;
351
352
354 filter_spec = "null"; /* passthrough (dummy) filter for video */
355 else
356 filter_spec = "anull"; /* passthrough (dummy) filter for audio */
359 if (ret)
360 return ret;
361 }
362 return 0;
363 }
364
366 int ret;
367 int got_frame_local;
372
373 if (!got_frame)
374 got_frame = &got_frame_local;
375
377 /* encode filtered frame */
381 ret = enc_func(ofmt_ctx->
streams[stream_index]->
codec, &enc_pkt,
382 filt_frame, got_frame);
384 if (ret < 0)
385 return ret;
386 if (!(*got_frame))
387 return 0;
388
389 /* prepare packet for muxing */
394
396 /* mux encoded frame */
398 return ret;
399 }
400
402 {
403 int ret;
405
407 /* push the decoded frame into the filtergraph */
409 frame, 0);
410 if (ret < 0) {
412 return ret;
413 }
414
415 /* pull filtered frames from the filtergraph */
416 while (1) {
418 if (!filt_frame) {
420 break;
421 }
424 filt_frame);
425 if (ret < 0) {
426 /* if no more frames for output - returns AVERROR(EAGAIN)
427 * if flushed and no more frames for output - returns AVERROR_EOF
428 * rewrite retcode to 0 to show it as normal procedure completion
429 */
431 ret = 0;
433 break;
434 }
435
438 if (ret < 0)
439 break;
440 }
441
442 return ret;
443 }
444
446 {
447 int ret;
448 int got_frame;
449
452 return 0;
453
454 while (1) {
457 if (ret < 0)
458 break;
459 if (!got_frame)
460 return 0;
461 }
462 return ret;
463 }
464
465 int main(
int argc,
char **argv)
466 {
467 int ret;
471 unsigned int stream_index;
472 unsigned int i;
473 int got_frame;
475
476 if (argc != 3) {
478 return 1;
479 }
480
483
490
491 /* read all packets */
492 while (1) {
494 break;
498 stream_index);
499
503 if (!frame) {
505 break;
506 }
512 ret = dec_func(ifmt_ctx->
streams[stream_index]->
codec, frame,
513 &got_frame, &packet);
514 if (ret < 0) {
517 break;
518 }
519
520 if (got_frame) {
524 if (ret < 0)
526 } else {
528 }
529 } else {
530 /* remux this frame without reencoding */
534
536 if (ret < 0)
538 }
540 }
541
542 /* flush filters and encoders */
544 /* flush filter */
546 continue;
548 if (ret < 0) {
551 }
552
553 /* flush encoder */
555 if (ret < 0) {
558 }
559 }
560
571 }
577
578 if (ret < 0)
580
581 return ret ? 1 : 0;
582 }
int avio_open(AVIOContext **s, const char *url, int flags)
Create and initialize a AVIOContext for accessing the resource indicated by url.
AVFilterGraph * filter_graph
const struct AVCodec * codec
AVFilterContext * buffersink_ctx
static int encode_write_frame(AVFrame *filt_frame, unsigned int stream_index, int *got_frame)
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
This structure describes decoded (raw) audio or video data.
AVCodec * avcodec_find_encoder(enum AVCodecID id)
Find a registered encoder with a matching codec ID.
int av_interleaved_write_frame(AVFormatContext *s, AVPacket *pkt)
Write a packet to an output media file ensuring correct interleaving.
AVFilterGraph * avfilter_graph_alloc(void)
Allocate a filter graph.
Memory buffer source API.
AVFilterGraph * filter_graph
int avfilter_graph_config(AVFilterGraph *graphctx, void *log_ctx)
Check validity and configure all the links and formats in the graph.
void avfilter_inout_free(AVFilterInOut **inout)
Free the supplied list of AVFilterInOut and set *inout to NULL.
struct AVFilterInOut * next
next input/input in the list, NULL if this is the last
#define AVIO_FLAG_WRITE
write-only
AVRational sample_aspect_ratio
sample aspect ratio (0 if unknown) That is the width of a pixel divided by the height of the pixel...
void avfilter_graph_free(AVFilterGraph **graph)
Free a graph, destroy its links, and set *graph to NULL.
enum AVPixelFormat pix_fmt
Pixel format, see AV_PIX_FMT_xxx.
int av_opt_set_bin(void *obj, const char *name, const uint8_t *val, int len, int search_flags)
int avcodec_encode_audio2(AVCodecContext *avctx, AVPacket *avpkt, const AVFrame *frame, int *got_packet_ptr)
Encode a frame of audio.
int avcodec_copy_context(AVCodecContext *dest, const AVCodecContext *src)
Copy the settings of the source AVCodecContext into the destination AVCodecContext.
AVRational time_base
This is the fundamental unit of time (in seconds) in terms of which frame timestamps are represented...
int av_get_channel_layout_nb_channels(uint64_t channel_layout)
Return the number of channels in the channel layout.
static int open_input_file(const char *filename)
memory buffer sink API for audio and video
#define AV_CODEC_CAP_DELAY
Encoder or decoder requires flushing with NULL input at the end in order to give the complete and cor...
enum AVSampleFormat sample_fmt
audio sample format
AVFrame * av_frame_alloc(void)
Allocate an AVFrame and set its fields to default values.
static av_cold int end(AVCodecContext *avctx)
int64_t pts
Presentation timestamp in time_base units (time when frame should be shown to user).
AVStream * avformat_new_stream(AVFormatContext *s, const AVCodec *c)
Add a new stream to a media file.
AVStream ** streams
A list of all streams in the file.
int avcodec_encode_video2(AVCodecContext *avctx, AVPacket *avpkt, const AVFrame *frame, int *got_packet_ptr)
Encode a frame of video.
void avfilter_register_all(void)
Initialize the filter system.
int avfilter_graph_create_filter(AVFilterContext **filt_ctx, const AVFilter *filt, const char *name, const char *args, void *opaque, AVFilterGraph *graph_ctx)
Create and add a filter instance into an existing graph.
#define AVERROR_EOF
End of file.
int64_t av_frame_get_best_effort_timestamp(const AVFrame *frame)
Accessors for some AVFrame fields.
struct AVOutputFormat * oformat
The output container format.
void av_dump_format(AVFormatContext *ic, int index, const char *url, int is_output)
Print detailed information about the input or output format, such as duration, bitrate, streams, container, programs, metadata, side data, codec and time base.
int avcodec_close(AVCodecContext *avctx)
Close a given AVCodecContext and free all the data associated with it (but not the AVCodecContext its...
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
static int flush_encoder(unsigned int stream_index)
static AVFormatContext * ifmt_ctx
int avcodec_decode_video2(AVCodecContext *avctx, AVFrame *picture, int *got_picture_ptr, const AVPacket *avpkt)
Decode the video frame of size avpkt->size from avpkt->data into picture.
void av_packet_rescale_ts(AVPacket *pkt, AVRational tb_src, AVRational tb_dst)
Convert valid timing fields (timestamps / durations) in a packet from one timebase to another...
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
int capabilities
Codec capabilities.
#define AV_LOG_DEBUG
Stuff which is only useful for libav* developers.
int flags
AV_CODEC_FLAG_*.
AVFilterContext * buffersrc_ctx
static FilteringContext * filter_ctx
const char * av_get_sample_fmt_name(enum AVSampleFormat sample_fmt)
Return the name of sample_fmt, or NULL if sample_fmt is not recognized.
uint64_t channel_layout
Audio channel layout.
AVCodecContext * codec
Codec context associated with this stream.
const AVFilter * avfilter_get_by_name(const char *name)
Get a filter definition matching the given name.
unsigned int nb_streams
Number of elements in AVFormatContext.streams.
AVFilterContext * buffersrc_ctx
enum AVPixelFormat * pix_fmts
array of supported pixel formats, or NULL if unknown, array is terminated by -1
enum AVPictureType pict_type
Picture type of the frame.
static int init_filter(FilteringContext *fctx, AVCodecContext *dec_ctx, AVCodecContext *enc_ctx, const char *filter_spec)
av_warn_unused_result int avformat_write_header(AVFormatContext *s, AVDictionary **options)
Allocate the stream private data and write the stream header to an output media file.
#define AV_OPT_SEARCH_CHILDREN
Search in possible children of the given object first.
int width
picture width / height.
#define av_err2str(errnum)
Convenience macro, the return value should be used only directly in function arguments but never stan...
int avcodec_decode_audio4(AVCodecContext *avctx, AVFrame *frame, int *got_frame_ptr, const AVPacket *avpkt)
Decode the audio frame of size avpkt->size from avpkt->data into frame.
Usually treated as AVMEDIA_TYPE_DATA.
static const AVFilterPad outputs[]
AVFilterContext * filter_ctx
filter context associated to this input/output
static int init_filters(void)
A linked-list of the inputs/outputs of the filter chain.
#define AV_LOG_INFO
Standard information.
static const AVFilterPad inputs[]
Libavcodec external API header.
enum AVMediaType codec_type
char * av_strdup(const char *s)
Duplicate the string s.
int sample_rate
samples per second
AVIOContext * pb
I/O context.
main external API structure.
AVCodec * avcodec_find_decoder(enum AVCodecID id)
Find a registered decoder with a matching codec ID.
void av_packet_unref(AVPacket *pkt)
Wipe the packet.
int pad_idx
index of the filt_ctx pad to use for linking
rational number numerator/denominator
static int open_output_file(const char *filename)
int avcodec_open2(AVCodecContext *avctx, const AVCodec *codec, AVDictionary **options)
Initialize the AVCodecContext to use the given AVCodec.
void avformat_free_context(AVFormatContext *s)
Free an AVFormatContext and all its streams.
int av_read_frame(AVFormatContext *s, AVPacket *pkt)
Return the next frame of a stream.
char * name
unique name for this input/output in the list
#define AV_CODEC_FLAG_GLOBAL_HEADER
Place global headers in extradata instead of every keyframe.
AVFilterInOut * avfilter_inout_alloc(void)
Allocate a single AVFilterInOut entry.
int avformat_find_stream_info(AVFormatContext *ic, AVDictionary **options)
Read packets of a media file to get stream information.
static AVCodecContext * dec_ctx
void av_init_packet(AVPacket *pkt)
Initialize optional fields of a packet with default values.
static int filter_encode_write_frame(AVFrame *frame, unsigned int stream_index)
int attribute_align_arg av_buffersrc_add_frame_flags(AVFilterContext *ctx, AVFrame *frame, int flags)
Add a frame to the buffer source.
#define AVERROR_UNKNOWN
Unknown error, typically from an external library.
void avformat_close_input(AVFormatContext **s)
Close an opened input AVFormatContext.
int channels
number of audio channels
int avformat_open_input(AVFormatContext **ps, const char *url, AVInputFormat *fmt, AVDictionary **options)
Open an input stream and read the header.
int avfilter_graph_parse_ptr(AVFilterGraph *graph, const char *filters, AVFilterInOut **inputs, AVFilterInOut **outputs, void *log_ctx)
Add a graph described by a string to a graph.
int64_t av_get_default_channel_layout(int nb_channels)
Return default channel layout for a given number of channels.
int av_write_trailer(AVFormatContext *s)
Write the stream trailer to an output media file and free the file private data.
int main(int argc, char **argv)
#define AV_LOG_FATAL
Something went wrong and recovery is not possible.
#define av_malloc_array(a, b)
enum AVSampleFormat * sample_fmts
array of supported sample formats, or NULL if unknown, array is terminated by -1
AVFilterContext * buffersink_ctx
AVRational time_base
This is the fundamental unit of time (in seconds) in terms of which frame timestamps are represented...
int attribute_align_arg av_buffersink_get_frame(AVFilterContext *ctx, AVFrame *frame)
Get a frame with filtered data from sink and put it in frame.
This structure stores compressed data.
void av_register_all(void)
Initialize libavformat and register all the muxers, demuxers and protocols.
int avio_closep(AVIOContext **s)
Close the resource accessed by the AVIOContext *s, free it and set the pointer pointing to it to NULL...
static AVFormatContext * ofmt_ctx