2 * avconv filter configuration
4 * This file is part of Libav.
6 * Libav 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 * Libav 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 Libav; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
23 #include "libavfilter/avfilter.h"
25 #include "libavresample/avresample.h"
27 #include "libavutil/avassert.h"
28 #include "libavutil/avstring.h"
29 #include "libavutil/channel_layout.h"
30 #include "libavutil/opt.h"
31 #include "libavutil/pixdesc.h"
32 #include "libavutil/pixfmt.h"
33 #include "libavutil/samplefmt.h"
35 /* Define a function for building a string containing a list of
37 #define DEF_CHOOSE_FORMAT(type, var, supported_list, none, get_name) \
38 static char *choose_ ## var ## s(OutputStream *ost) \
40 if (ost->st->codec->var != none) { \
41 get_name(ost->st->codec->var); \
42 return av_strdup(name); \
43 } else if (ost->enc && ost->enc->supported_list) { \
45 AVIOContext *s = NULL; \
49 if (avio_open_dyn_buf(&s) < 0) \
52 for (p = ost->enc->supported_list; *p != none; p++) { \
54 avio_printf(s, "%s|", name); \
56 len = avio_close_dyn_buf(s, &ret); \
63 DEF_CHOOSE_FORMAT(enum AVPixelFormat, pix_fmt, pix_fmts, AV_PIX_FMT_NONE,
66 DEF_CHOOSE_FORMAT(enum AVSampleFormat, sample_fmt, sample_fmts,
67 AV_SAMPLE_FMT_NONE, GET_SAMPLE_FMT_NAME)
69 DEF_CHOOSE_FORMAT(int, sample_rate, supported_samplerates, 0,
72 DEF_CHOOSE_FORMAT(uint64_t, channel_layout, channel_layouts, 0,
75 FilterGraph *init_simple_filtergraph(InputStream *ist, OutputStream *ost)
77 FilterGraph *fg = av_mallocz(sizeof(*fg));
81 fg->index = nb_filtergraphs;
83 GROW_ARRAY(fg->outputs, fg->nb_outputs);
84 if (!(fg->outputs[0] = av_mallocz(sizeof(*fg->outputs[0]))))
86 fg->outputs[0]->ost = ost;
87 fg->outputs[0]->graph = fg;
89 ost->filter = fg->outputs[0];
91 GROW_ARRAY(fg->inputs, fg->nb_inputs);
92 if (!(fg->inputs[0] = av_mallocz(sizeof(*fg->inputs[0]))))
94 fg->inputs[0]->ist = ist;
95 fg->inputs[0]->graph = fg;
97 GROW_ARRAY(ist->filters, ist->nb_filters);
98 ist->filters[ist->nb_filters - 1] = fg->inputs[0];
100 GROW_ARRAY(filtergraphs, nb_filtergraphs);
101 filtergraphs[nb_filtergraphs - 1] = fg;
106 static void init_input_filter(FilterGraph *fg, AVFilterInOut *in)
108 InputStream *ist = NULL;
109 enum AVMediaType type = avfilter_pad_get_type(in->filter_ctx->input_pads, in->pad_idx);
112 // TODO: support other filter types
113 if (type != AVMEDIA_TYPE_VIDEO && type != AVMEDIA_TYPE_AUDIO) {
114 av_log(NULL, AV_LOG_FATAL, "Only video and audio filters supported "
123 int file_idx = strtol(in->name, &p, 0);
125 if (file_idx < 0 || file_idx >= nb_input_files) {
126 av_log(NULL, AV_LOG_FATAL, "Invalid file index %d in filtegraph description %s.\n",
127 file_idx, fg->graph_desc);
130 s = input_files[file_idx]->ctx;
132 for (i = 0; i < s->nb_streams; i++) {
133 if (s->streams[i]->codec->codec_type != type)
135 if (check_stream_specifier(s, s->streams[i], *p == ':' ? p + 1 : p) == 1) {
141 av_log(NULL, AV_LOG_FATAL, "Stream specifier '%s' in filtergraph description %s "
142 "matches no streams.\n", p, fg->graph_desc);
145 ist = input_streams[input_files[file_idx]->ist_index + st->index];
147 /* find the first unused stream of corresponding type */
148 for (i = 0; i < nb_input_streams; i++) {
149 ist = input_streams[i];
150 if (ist->st->codec->codec_type == type && ist->discard)
153 if (i == nb_input_streams) {
154 av_log(NULL, AV_LOG_FATAL, "Cannot find a matching stream for "
155 "unlabeled input pad %d on filter %s", in->pad_idx,
156 in->filter_ctx->name);
163 ist->decoding_needed = 1;
164 ist->st->discard = AVDISCARD_NONE;
166 GROW_ARRAY(fg->inputs, fg->nb_inputs);
167 if (!(fg->inputs[fg->nb_inputs - 1] = av_mallocz(sizeof(*fg->inputs[0]))))
169 fg->inputs[fg->nb_inputs - 1]->ist = ist;
170 fg->inputs[fg->nb_inputs - 1]->graph = fg;
172 GROW_ARRAY(ist->filters, ist->nb_filters);
173 ist->filters[ist->nb_filters - 1] = fg->inputs[fg->nb_inputs - 1];
176 static int insert_trim(OutputStream *ost, AVFilterContext **last_filter, int *pad_idx)
178 OutputFile *of = output_files[ost->file_index];
179 AVFilterGraph *graph = (*last_filter)->graph;
180 AVFilterContext *ctx;
181 const AVFilter *trim;
182 const char *name = ost->st->codec->codec_type == AVMEDIA_TYPE_VIDEO ? "trim" : "atrim";
183 char filter_name[128];
186 if (of->recording_time == INT64_MAX && !of->start_time)
189 trim = avfilter_get_by_name(name);
191 av_log(NULL, AV_LOG_ERROR, "%s filter not present, cannot limit "
192 "recording time.\n", name);
193 return AVERROR_FILTER_NOT_FOUND;
196 snprintf(filter_name, sizeof(filter_name), "%s for output stream %d:%d",
197 name, ost->file_index, ost->index);
198 ctx = avfilter_graph_alloc_filter(graph, trim, filter_name);
200 return AVERROR(ENOMEM);
202 if (of->recording_time != INT64_MAX) {
203 ret = av_opt_set_double(ctx, "duration", (double)of->recording_time / 1e6,
204 AV_OPT_SEARCH_CHILDREN);
206 if (ret >= 0 && of->start_time) {
207 ret = av_opt_set_double(ctx, "start", (double)of->start_time / 1e6,
208 AV_OPT_SEARCH_CHILDREN);
211 av_log(ctx, AV_LOG_ERROR, "Error configuring the %s filter", name);
215 ret = avfilter_init_str(ctx, NULL);
219 ret = avfilter_link(*last_filter, *pad_idx, ctx, 0);
228 static int configure_output_video_filter(FilterGraph *fg, OutputFilter *ofilter, AVFilterInOut *out)
231 OutputStream *ost = ofilter->ost;
232 AVCodecContext *codec = ost->st->codec;
233 AVFilterContext *last_filter = out->filter_ctx;
234 int pad_idx = out->pad_idx;
238 snprintf(name, sizeof(name), "output stream %d:%d", ost->file_index, ost->index);
239 ret = avfilter_graph_create_filter(&ofilter->filter,
240 avfilter_get_by_name("buffersink"),
241 name, NULL, NULL, fg->graph);
245 if (codec->width || codec->height) {
247 AVFilterContext *filter;
249 snprintf(args, sizeof(args), "%d:%d:0x%X",
252 (unsigned)ost->sws_flags);
253 snprintf(name, sizeof(name), "scaler for output stream %d:%d",
254 ost->file_index, ost->index);
255 if ((ret = avfilter_graph_create_filter(&filter, avfilter_get_by_name("scale"),
256 name, args, NULL, fg->graph)) < 0)
258 if ((ret = avfilter_link(last_filter, pad_idx, filter, 0)) < 0)
261 last_filter = filter;
265 if ((pix_fmts = choose_pix_fmts(ost))) {
266 AVFilterContext *filter;
267 snprintf(name, sizeof(name), "pixel format for output stream %d:%d",
268 ost->file_index, ost->index);
269 if ((ret = avfilter_graph_create_filter(&filter,
270 avfilter_get_by_name("format"),
271 "format", pix_fmts, NULL,
274 if ((ret = avfilter_link(last_filter, pad_idx, filter, 0)) < 0)
277 last_filter = filter;
282 if (ost->frame_rate.num) {
283 AVFilterContext *fps;
286 snprintf(args, sizeof(args), "fps=%d/%d", ost->frame_rate.num,
287 ost->frame_rate.den);
288 snprintf(name, sizeof(name), "fps for output stream %d:%d",
289 ost->file_index, ost->index);
290 ret = avfilter_graph_create_filter(&fps, avfilter_get_by_name("fps"),
291 name, args, NULL, fg->graph);
295 ret = avfilter_link(last_filter, pad_idx, fps, 0);
302 ret = insert_trim(ost, &last_filter, &pad_idx);
307 if ((ret = avfilter_link(last_filter, pad_idx, ofilter->filter, 0)) < 0)
313 static int configure_output_audio_filter(FilterGraph *fg, OutputFilter *ofilter, AVFilterInOut *out)
315 OutputStream *ost = ofilter->ost;
316 AVCodecContext *codec = ost->st->codec;
317 AVFilterContext *last_filter = out->filter_ctx;
318 int pad_idx = out->pad_idx;
319 char *sample_fmts, *sample_rates, *channel_layouts;
324 snprintf(name, sizeof(name), "output stream %d:%d", ost->file_index, ost->index);
325 ret = avfilter_graph_create_filter(&ofilter->filter,
326 avfilter_get_by_name("abuffersink"),
327 name, NULL, NULL, fg->graph);
331 if (codec->channels && !codec->channel_layout)
332 codec->channel_layout = av_get_default_channel_layout(codec->channels);
334 sample_fmts = choose_sample_fmts(ost);
335 sample_rates = choose_sample_rates(ost);
336 channel_layouts = choose_channel_layouts(ost);
337 if (sample_fmts || sample_rates || channel_layouts) {
338 AVFilterContext *format;
343 len += snprintf(args + len, sizeof(args) - len, "sample_fmts=%s:",
346 len += snprintf(args + len, sizeof(args) - len, "sample_rates=%s:",
349 len += snprintf(args + len, sizeof(args) - len, "channel_layouts=%s:",
353 av_freep(&sample_fmts);
354 av_freep(&sample_rates);
355 av_freep(&channel_layouts);
357 snprintf(name, sizeof(name), "audio format for output stream %d:%d",
358 ost->file_index, ost->index);
359 ret = avfilter_graph_create_filter(&format,
360 avfilter_get_by_name("aformat"),
361 name, args, NULL, fg->graph);
365 ret = avfilter_link(last_filter, pad_idx, format, 0);
369 last_filter = format;
373 ret = insert_trim(ost, &last_filter, &pad_idx);
377 if ((ret = avfilter_link(last_filter, pad_idx, ofilter->filter, 0)) < 0)
383 #define DESCRIBE_FILTER_LINK(f, inout, in) \
385 AVFilterContext *ctx = inout->filter_ctx; \
386 AVFilterPad *pads = in ? ctx->input_pads : ctx->output_pads; \
387 int nb_pads = in ? ctx->input_count : ctx->output_count; \
390 if (avio_open_dyn_buf(&pb) < 0) \
393 avio_printf(pb, "%s", ctx->filter->name); \
395 avio_printf(pb, ":%s", avfilter_pad_get_name(pads, inout->pad_idx));\
397 avio_close_dyn_buf(pb, &f->name); \
400 int configure_output_filter(FilterGraph *fg, OutputFilter *ofilter, AVFilterInOut *out)
402 av_freep(&ofilter->name);
403 DESCRIBE_FILTER_LINK(ofilter, out, 0);
405 switch (avfilter_pad_get_type(out->filter_ctx->output_pads, out->pad_idx)) {
406 case AVMEDIA_TYPE_VIDEO: return configure_output_video_filter(fg, ofilter, out);
407 case AVMEDIA_TYPE_AUDIO: return configure_output_audio_filter(fg, ofilter, out);
408 default: av_assert0(0);
412 static int configure_input_video_filter(FilterGraph *fg, InputFilter *ifilter,
415 AVFilterContext *first_filter = in->filter_ctx;
416 AVFilter *filter = avfilter_get_by_name("buffer");
417 InputStream *ist = ifilter->ist;
418 AVRational tb = ist->framerate.num ? av_inv_q(ist->framerate) :
421 char args[255], name[255];
422 int pad_idx = in->pad_idx;
425 sar = ist->st->sample_aspect_ratio.num ?
426 ist->st->sample_aspect_ratio :
427 ist->st->codec->sample_aspect_ratio;
428 snprintf(args, sizeof(args), "%d:%d:%d:%d:%d:%d:%d", ist->st->codec->width,
429 ist->st->codec->height, ist->st->codec->pix_fmt,
430 tb.num, tb.den, sar.num, sar.den);
431 snprintf(name, sizeof(name), "graph %d input from stream %d:%d", fg->index,
432 ist->file_index, ist->st->index);
434 if ((ret = avfilter_graph_create_filter(&ifilter->filter, filter, name,
435 args, NULL, fg->graph)) < 0)
438 if (ist->framerate.num) {
439 AVFilterContext *setpts;
441 snprintf(name, sizeof(name), "force CFR for input from stream %d:%d",
442 ist->file_index, ist->st->index);
443 if ((ret = avfilter_graph_create_filter(&setpts,
444 avfilter_get_by_name("setpts"),
449 if ((ret = avfilter_link(setpts, 0, first_filter, pad_idx)) < 0)
452 first_filter = setpts;
456 if ((ret = avfilter_link(ifilter->filter, 0, first_filter, pad_idx)) < 0)
461 static int configure_input_audio_filter(FilterGraph *fg, InputFilter *ifilter,
464 AVFilterContext *first_filter = in->filter_ctx;
465 AVFilter *filter = avfilter_get_by_name("abuffer");
466 InputStream *ist = ifilter->ist;
467 int pad_idx = in->pad_idx;
468 char args[255], name[255];
471 snprintf(args, sizeof(args), "time_base=%d/%d:sample_rate=%d:sample_fmt=%s"
472 ":channel_layout=0x%"PRIx64,
473 1, ist->st->codec->sample_rate,
474 ist->st->codec->sample_rate,
475 av_get_sample_fmt_name(ist->st->codec->sample_fmt),
476 ist->st->codec->channel_layout);
477 snprintf(name, sizeof(name), "graph %d input from stream %d:%d", fg->index,
478 ist->file_index, ist->st->index);
480 if ((ret = avfilter_graph_create_filter(&ifilter->filter, filter,
485 if (audio_sync_method > 0) {
486 AVFilterContext *async;
489 av_log(NULL, AV_LOG_WARNING, "-async has been deprecated. Used the "
490 "asyncts audio filter instead.\n");
492 if (audio_sync_method > 1)
493 len += snprintf(args + len, sizeof(args) - len, "compensate=1:"
494 "max_comp=%d:", audio_sync_method);
495 snprintf(args + len, sizeof(args) - len, "min_delta=%f",
496 audio_drift_threshold);
498 snprintf(name, sizeof(name), "graph %d audio sync for input stream %d:%d",
499 fg->index, ist->file_index, ist->st->index);
500 ret = avfilter_graph_create_filter(&async,
501 avfilter_get_by_name("asyncts"),
502 name, args, NULL, fg->graph);
506 ret = avfilter_link(async, 0, first_filter, pad_idx);
510 first_filter = async;
513 if (audio_volume != 256) {
514 AVFilterContext *volume;
516 av_log(NULL, AV_LOG_WARNING, "-vol has been deprecated. Use the volume "
517 "audio filter instead.\n");
519 snprintf(args, sizeof(args), "volume=%f", audio_volume / 256.0);
521 snprintf(name, sizeof(name), "graph %d volume for input stream %d:%d",
522 fg->index, ist->file_index, ist->st->index);
523 ret = avfilter_graph_create_filter(&volume,
524 avfilter_get_by_name("volume"),
525 name, args, NULL, fg->graph);
529 ret = avfilter_link(volume, 0, first_filter, pad_idx);
533 first_filter = volume;
536 if ((ret = avfilter_link(ifilter->filter, 0, first_filter, pad_idx)) < 0)
542 static int configure_input_filter(FilterGraph *fg, InputFilter *ifilter,
545 av_freep(&ifilter->name);
546 DESCRIBE_FILTER_LINK(ifilter, in, 1);
548 switch (avfilter_pad_get_type(in->filter_ctx->input_pads, in->pad_idx)) {
549 case AVMEDIA_TYPE_VIDEO: return configure_input_video_filter(fg, ifilter, in);
550 case AVMEDIA_TYPE_AUDIO: return configure_input_audio_filter(fg, ifilter, in);
551 default: av_assert0(0);
555 int configure_filtergraph(FilterGraph *fg)
557 AVFilterInOut *inputs, *outputs, *cur;
558 int ret, i, init = !fg->graph, simple = !fg->graph_desc;
559 const char *graph_desc = simple ? fg->outputs[0]->ost->avfilter :
562 avfilter_graph_free(&fg->graph);
563 if (!(fg->graph = avfilter_graph_alloc()))
564 return AVERROR(ENOMEM);
567 OutputStream *ost = fg->outputs[0]->ost;
569 AVDictionaryEntry *e = NULL;
571 snprintf(args, sizeof(args), "flags=0x%X", (unsigned)ost->sws_flags);
572 fg->graph->scale_sws_opts = av_strdup(args);
575 while ((e = av_dict_get(fg->outputs[0]->ost->resample_opts, "", e,
576 AV_DICT_IGNORE_SUFFIX))) {
577 av_strlcatf(args, sizeof(args), "%s=%s:", e->key, e->value);
580 args[strlen(args) - 1] = '\0';
581 fg->graph->resample_lavr_opts = av_strdup(args);
584 if ((ret = avfilter_graph_parse2(fg->graph, graph_desc, &inputs, &outputs)) < 0)
587 if (simple && (!inputs || inputs->next || !outputs || outputs->next)) {
588 av_log(NULL, AV_LOG_ERROR, "Simple filtergraph '%s' does not have "
589 "exactly one input and output.\n", graph_desc);
590 return AVERROR(EINVAL);
593 for (cur = inputs; !simple && init && cur; cur = cur->next)
594 init_input_filter(fg, cur);
596 for (cur = inputs, i = 0; cur; cur = cur->next, i++)
597 if ((ret = configure_input_filter(fg, fg->inputs[i], cur)) < 0)
599 avfilter_inout_free(&inputs);
601 if (!init || simple) {
602 /* we already know the mappings between lavfi outputs and output streams,
603 * so we can finish the setup */
604 for (cur = outputs, i = 0; cur; cur = cur->next, i++)
605 configure_output_filter(fg, fg->outputs[i], cur);
606 avfilter_inout_free(&outputs);
608 if ((ret = avfilter_graph_config(fg->graph, NULL)) < 0)
611 /* wait until output mappings are processed */
612 for (cur = outputs; cur;) {
613 GROW_ARRAY(fg->outputs, fg->nb_outputs);
614 if (!(fg->outputs[fg->nb_outputs - 1] = av_mallocz(sizeof(*fg->outputs[0]))))
616 fg->outputs[fg->nb_outputs - 1]->graph = fg;
617 fg->outputs[fg->nb_outputs - 1]->out_tmp = cur;
619 fg->outputs[fg->nb_outputs - 1]->out_tmp->next = NULL;
626 int ist_in_filtergraph(FilterGraph *fg, InputStream *ist)
629 for (i = 0; i < fg->nb_inputs; i++)
630 if (fg->inputs[i]->ist == ist)