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
39
48
50 {
52 unsigned int i;
53
58 }
59
63 }
64
69 codec_ctx = stream->
codec;
70 /* Reencode video & audio and remux subtitles etc. */
73 /* Open decoder */
76 if (ret < 0) {
79 }
80 }
81 }
82
84 return 0;
85 }
86
88 {
94 unsigned int i;
95
98 if (!ofmt_ctx) {
101 }
102
103
106 if (!out_stream) {
109 }
110
111 in_stream = ifmt_ctx->
streams[i];
112 dec_ctx = in_stream->
codec;
113 enc_ctx = out_stream->
codec;
114
117 /* in this example, we choose transcoding to same codec */
119 if (!encoder) {
122 }
123
124 /* In this example, we transcode to same properties (picture size,
125 * sample rate etc.). These properties can be changed for output
126 * streams easily using filters */
131 /* take first format from list of supported formats */
133 /* video time_base can be set to whatever is handy and supported by encoder */
135 } else {
139 /* take first format from list of supported formats */
142 }
143
144 /* Third parameter can be used to pass settings to encoder */
146 if (ret < 0) {
149 }
153 } else {
154 /* if this stream must be remuxed */
157 if (ret < 0) {
160 }
161 }
162
165
166 }
168
171 if (ret < 0) {
174 }
175 }
176
177 /* init muxer, write output file header */
179 if (ret < 0) {
182 }
183
184 return 0;
185 }
186
189 {
199
200 if (!outputs || !inputs || !filter_graph) {
203 }
204
208 if (!buffersrc || !buffersink) {
212 }
213
215 "video_size=%dx%d:pix_fmt=%d:time_base=%d/%d:pixel_aspect=%d/%d",
220
222 args,
NULL, filter_graph);
223 if (ret < 0) {
226 }
227
230 if (ret < 0) {
233 }
234
238 if (ret < 0) {
241 }
245 if (!buffersrc || !buffersink) {
249 }
250
255 "time_base=%d/%d:sample_rate=%d:sample_fmt=%s:channel_layout=0x%"PRIx64,
260 args,
NULL, filter_graph);
261 if (ret < 0) {
264 }
265
268 if (ret < 0) {
271 }
272
276 if (ret < 0) {
279 }
280
284 if (ret < 0) {
287 }
288
292 if (ret < 0) {
295 }
296 } else {
299 }
300
301 /* Endpoints for the filter graph. */
306
311
312 if (!outputs->
name || !inputs->
name) {
315 }
316
318 &inputs, &outputs,
NULL)) < 0)
320
323
324 /* Fill FilteringContext */
328
332
334 }
335
337 {
338 const char *filter_spec;
339 unsigned int i;
342 if (!filter_ctx)
344
351 continue;
352
353
355 filter_spec = "null"; /* passthrough (dummy) filter for video */
356 else
357 filter_spec = "anull"; /* passthrough (dummy) filter for audio */
360 if (ret)
362 }
363 return 0;
364 }
365
368 int got_frame_local;
373
374 if (!got_frame)
375 got_frame = &got_frame_local;
376
378 /* encode filtered frame */
382 ret = enc_func(ofmt_ctx->
streams[stream_index]->
codec, &enc_pkt,
383 filt_frame, got_frame);
385 if (ret < 0)
387 if (!(*got_frame))
388 return 0;
389
390 /* prepare packet for muxing */
395
397 /* mux encoded frame */
400 }
401
403 {
406
408 /* push the decoded frame into the filtergraph */
410 frame, 0);
411 if (ret < 0) {
414 }
415
416 /* pull filtered frames from the filtergraph */
417 while (1) {
419 if (!filt_frame) {
421 break;
422 }
425 filt_frame);
426 if (ret < 0) {
427 /* if no more frames for output - returns AVERROR(EAGAIN)
428 * if flushed and no more frames for output - returns AVERROR_EOF
429 * rewrite retcode to 0 to show it as normal procedure completion
430 */
432 ret = 0;
434 break;
435 }
436
439 if (ret < 0)
440 break;
441 }
442
444 }
445
447 {
449 int got_frame;
450
453 return 0;
454
455 while (1) {
458 if (ret < 0)
459 break;
460 if (!got_frame)
461 return 0;
462 }
464 }
465
466 int main(
int argc,
char **argv)
467 {
472 unsigned int stream_index;
473 unsigned int i;
474 int got_frame;
476
477 if (argc != 3) {
479 return 1;
480 }
481
484
491
492 /* read all packets */
493 while (1) {
495 break;
499 stream_index);
500
504 if (!frame) {
506 break;
507 }
513 ret = dec_func(ifmt_ctx->
streams[stream_index]->
codec, frame,
514 &got_frame, &packet);
515 if (ret < 0) {
518 break;
519 }
520
521 if (got_frame) {
525 if (ret < 0)
527 } else {
529 }
530 } else {
531 /* remux this frame without reencoding */
535
537 if (ret < 0)
539 }
541 }
542
543 /* flush filters and encoders */
545 /* flush filter */
547 continue;
549 if (ret < 0) {
552 }
553
554 /* flush encoder */
556 if (ret < 0) {
559 }
560 }
561
572 }
578
579 if (ret < 0)
581
582 return ret ? 1 : 0;
583 }
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.
void av_free_packet(AVPacket *pkt)
Free a packet.
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.
int avformat_write_header(AVFormatContext *s, AVDictionary **options)
Allocate the stream private data and write the stream header to an output media file.
AVFilterGraph * avfilter_graph_alloc(void)
Allocate a filter graph.
static const AVFilterPad outputs[]
int avformat_open_input(AVFormatContext **ps, const char *filename, AVInputFormat *fmt, AVDictionary **options)
Open an input stream and read the header.
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
enum AVSampleFormat sample_fmt
audio sample format
AVFrame * av_frame_alloc(void)
Allocate an AVFrame and set its fields to default values.
#define CODEC_FLAG_GLOBAL_HEADER
Place global headers in extradata instead of every keyframe.
static av_cold int end(AVCodecContext *avctx)
libavcodec/libavfilter gluing utilities
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.
int attribute_align_arg av_buffersrc_add_frame_flags(AVFilterContext *ctx, AVFrame *frame, int flags)
Add a frame to the buffer source.
#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...
#define CODEC_CAP_DELAY
Encoder or decoder requires flushing with NULL input at the end in order to give the complete and cor...
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.
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.
Libavcodec external API header.
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)
#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.
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.
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.
static const AVFilterPad inputs[]
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
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)
#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 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