3 * Copyright (c) 2008 Vitor Sessak
4 * Copyright (c) 2007 Bobby Bingham
6 * This file is part of FFmpeg.
8 * FFmpeg is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; either
11 * version 2.1 of the License, or (at your option) any later version.
13 * FFmpeg is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with FFmpeg; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
27 #include "libavutil/avassert.h"
28 #include "libavutil/avstring.h"
29 #include "libavutil/bprint.h"
30 #include "libavutil/channel_layout.h"
31 #include "libavutil/imgutils.h"
32 #include "libavutil/internal.h"
33 #include "libavutil/opt.h"
34 #include "libavutil/pixdesc.h"
36 #define FF_INTERNAL_FIELDS 1
37 #include "framequeue.h"
40 #include "buffersink.h"
45 #define OFFSET(x) offsetof(AVFilterGraph, x)
46 #define F AV_OPT_FLAG_FILTERING_PARAM
47 #define V AV_OPT_FLAG_VIDEO_PARAM
48 #define A AV_OPT_FLAG_AUDIO_PARAM
49 static const AVOption filtergraph_options[] = {
50 { "thread_type", "Allowed thread types", OFFSET(thread_type), AV_OPT_TYPE_FLAGS,
51 { .i64 = AVFILTER_THREAD_SLICE }, 0, INT_MAX, F|V|A, "thread_type" },
52 { "slice", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = AVFILTER_THREAD_SLICE }, .flags = F|V|A, .unit = "thread_type" },
53 { "threads", "Maximum number of threads", OFFSET(nb_threads),
54 AV_OPT_TYPE_INT, { .i64 = 0 }, 0, INT_MAX, F|V|A },
55 {"scale_sws_opts" , "default scale filter options" , OFFSET(scale_sws_opts) ,
56 AV_OPT_TYPE_STRING, {.str = NULL}, 0, 0, F|V },
57 {"aresample_swr_opts" , "default aresample filter options" , OFFSET(aresample_swr_opts) ,
58 AV_OPT_TYPE_STRING, {.str = NULL}, 0, 0, F|A },
62 static const AVClass filtergraph_class = {
63 .class_name = "AVFilterGraph",
64 .item_name = av_default_item_name,
65 .version = LIBAVUTIL_VERSION_INT,
66 .option = filtergraph_options,
67 .category = AV_CLASS_CATEGORY_FILTER,
71 void ff_graph_thread_free(AVFilterGraph *graph)
75 int ff_graph_thread_init(AVFilterGraph *graph)
77 graph->thread_type = 0;
78 graph->nb_threads = 1;
83 AVFilterGraph *avfilter_graph_alloc(void)
85 AVFilterGraph *ret = av_mallocz(sizeof(*ret));
89 ret->internal = av_mallocz(sizeof(*ret->internal));
95 ret->av_class = &filtergraph_class;
96 av_opt_set_defaults(ret);
97 ff_framequeue_global_init(&ret->internal->frame_queues);
102 void ff_filter_graph_remove_filter(AVFilterGraph *graph, AVFilterContext *filter)
105 for (i = 0; i < graph->nb_filters; i++) {
106 if (graph->filters[i] == filter) {
107 FFSWAP(AVFilterContext*, graph->filters[i],
108 graph->filters[graph->nb_filters - 1]);
110 filter->graph = NULL;
111 for (j = 0; j<filter->nb_outputs; j++)
112 if (filter->outputs[j])
113 filter->outputs[j]->graph = NULL;
120 void avfilter_graph_free(AVFilterGraph **graph)
125 while ((*graph)->nb_filters)
126 avfilter_free((*graph)->filters[0]);
128 ff_graph_thread_free(*graph);
130 av_freep(&(*graph)->sink_links);
132 av_freep(&(*graph)->scale_sws_opts);
133 av_freep(&(*graph)->aresample_swr_opts);
135 av_freep(&(*graph)->resample_lavr_opts);
137 av_freep(&(*graph)->filters);
138 av_freep(&(*graph)->internal);
142 int avfilter_graph_create_filter(AVFilterContext **filt_ctx, const AVFilter *filt,
143 const char *name, const char *args, void *opaque,
144 AVFilterGraph *graph_ctx)
148 *filt_ctx = avfilter_graph_alloc_filter(graph_ctx, filt, name);
150 return AVERROR(ENOMEM);
152 ret = avfilter_init_str(*filt_ctx, args);
160 avfilter_free(*filt_ctx);
165 void avfilter_graph_set_auto_convert(AVFilterGraph *graph, unsigned flags)
167 graph->disable_auto_convert = flags;
170 AVFilterContext *avfilter_graph_alloc_filter(AVFilterGraph *graph,
171 const AVFilter *filter,
174 AVFilterContext **filters, *s;
176 if (graph->thread_type && !graph->internal->thread_execute) {
177 if (graph->execute) {
178 graph->internal->thread_execute = graph->execute;
180 int ret = ff_graph_thread_init(graph);
182 av_log(graph, AV_LOG_ERROR, "Error initializing threading: %s.\n", av_err2str(ret));
188 s = ff_filter_alloc(filter, name);
192 filters = av_realloc(graph->filters, sizeof(*filters) * (graph->nb_filters + 1));
198 graph->filters = filters;
199 graph->filters[graph->nb_filters++] = s;
207 * Check for the validity of graph.
209 * A graph is considered valid if all its input and output pads are
212 * @return >= 0 in case of success, a negative value otherwise
214 static int graph_check_validity(AVFilterGraph *graph, AVClass *log_ctx)
216 AVFilterContext *filt;
219 for (i = 0; i < graph->nb_filters; i++) {
220 const AVFilterPad *pad;
221 filt = graph->filters[i];
223 for (j = 0; j < filt->nb_inputs; j++) {
224 if (!filt->inputs[j] || !filt->inputs[j]->src) {
225 pad = &filt->input_pads[j];
226 av_log(log_ctx, AV_LOG_ERROR,
227 "Input pad \"%s\" with type %s of the filter instance \"%s\" of %s not connected to any source\n",
228 pad->name, av_get_media_type_string(pad->type), filt->name, filt->filter->name);
229 return AVERROR(EINVAL);
233 for (j = 0; j < filt->nb_outputs; j++) {
234 if (!filt->outputs[j] || !filt->outputs[j]->dst) {
235 pad = &filt->output_pads[j];
236 av_log(log_ctx, AV_LOG_ERROR,
237 "Output pad \"%s\" with type %s of the filter instance \"%s\" of %s not connected to any destination\n",
238 pad->name, av_get_media_type_string(pad->type), filt->name, filt->filter->name);
239 return AVERROR(EINVAL);
248 * Configure all the links of graphctx.
250 * @return >= 0 in case of success, a negative value otherwise
252 static int graph_config_links(AVFilterGraph *graph, AVClass *log_ctx)
254 AVFilterContext *filt;
257 for (i = 0; i < graph->nb_filters; i++) {
258 filt = graph->filters[i];
260 if (!filt->nb_outputs) {
261 if ((ret = avfilter_config_links(filt)))
269 static int graph_check_links(AVFilterGraph *graph, AVClass *log_ctx)
276 for (i = 0; i < graph->nb_filters; i++) {
277 f = graph->filters[i];
278 for (j = 0; j < f->nb_outputs; j++) {
280 if (l->type == AVMEDIA_TYPE_VIDEO) {
281 ret = av_image_check_size2(l->w, l->h, INT64_MAX, l->format, 0, f);
290 AVFilterContext *avfilter_graph_get_filter(AVFilterGraph *graph, const char *name)
294 for (i = 0; i < graph->nb_filters; i++)
295 if (graph->filters[i]->name && !strcmp(name, graph->filters[i]->name))
296 return graph->filters[i];
301 static void sanitize_channel_layouts(void *log, AVFilterChannelLayouts *l)
305 if (l->nb_channel_layouts) {
306 if (l->all_layouts || l->all_counts)
307 av_log(log, AV_LOG_WARNING, "All layouts set on non-empty list\n");
308 l->all_layouts = l->all_counts = 0;
310 if (l->all_counts && !l->all_layouts)
311 av_log(log, AV_LOG_WARNING, "All counts without all layouts\n");
316 static int filter_link_check_formats(void *log, AVFilterLink *link, AVFilterFormatsConfig *cfg)
320 switch (link->type) {
322 case AVMEDIA_TYPE_VIDEO:
323 if ((ret = ff_formats_check_pixel_formats(log, cfg->formats)) < 0)
327 case AVMEDIA_TYPE_AUDIO:
328 if ((ret = ff_formats_check_sample_formats(log, cfg->formats)) < 0 ||
329 (ret = ff_formats_check_sample_rates(log, cfg->samplerates)) < 0 ||
330 (ret = ff_formats_check_channel_layouts(log, cfg->channel_layouts)) < 0)
335 av_assert0(!"reached");
341 * Check the validity of the formats / etc. lists set by query_formats().
343 * In particular, check they do not contain any redundant element.
345 static int filter_check_formats(AVFilterContext *ctx)
350 for (i = 0; i < ctx->nb_inputs; i++) {
351 ret = filter_link_check_formats(ctx, ctx->inputs[i], &ctx->inputs[i]->outcfg);
355 for (i = 0; i < ctx->nb_outputs; i++) {
356 ret = filter_link_check_formats(ctx, ctx->outputs[i], &ctx->outputs[i]->incfg);
363 static int filter_query_formats(AVFilterContext *ctx)
366 AVFilterFormats *formats;
367 AVFilterChannelLayouts *chlayouts;
368 AVFilterFormats *samplerates;
369 enum AVMediaType type = ctx->inputs && ctx->inputs [0] ? ctx->inputs [0]->type :
370 ctx->outputs && ctx->outputs[0] ? ctx->outputs[0]->type :
373 if ((ret = ctx->filter->query_formats(ctx)) < 0) {
374 if (ret != AVERROR(EAGAIN))
375 av_log(ctx, AV_LOG_ERROR, "Query format failed for '%s': %s\n",
376 ctx->name, av_err2str(ret));
379 ret = filter_check_formats(ctx);
383 for (i = 0; i < ctx->nb_inputs; i++)
384 sanitize_channel_layouts(ctx, ctx->inputs[i]->outcfg.channel_layouts);
385 for (i = 0; i < ctx->nb_outputs; i++)
386 sanitize_channel_layouts(ctx, ctx->outputs[i]->incfg.channel_layouts);
388 formats = ff_all_formats(type);
389 if ((ret = ff_set_common_formats(ctx, formats)) < 0)
391 if (type == AVMEDIA_TYPE_AUDIO) {
392 samplerates = ff_all_samplerates();
393 if ((ret = ff_set_common_samplerates(ctx, samplerates)) < 0)
395 chlayouts = ff_all_channel_layouts();
396 if ((ret = ff_set_common_channel_layouts(ctx, chlayouts)) < 0)
402 static int formats_declared(AVFilterContext *f)
406 for (i = 0; i < f->nb_inputs; i++) {
407 if (!f->inputs[i]->outcfg.formats)
409 if (f->inputs[i]->type == AVMEDIA_TYPE_AUDIO &&
410 !(f->inputs[i]->outcfg.samplerates &&
411 f->inputs[i]->outcfg.channel_layouts))
414 for (i = 0; i < f->nb_outputs; i++) {
415 if (!f->outputs[i]->incfg.formats)
417 if (f->outputs[i]->type == AVMEDIA_TYPE_AUDIO &&
418 !(f->outputs[i]->incfg.samplerates &&
419 f->outputs[i]->incfg.channel_layouts))
426 * Perform one round of query_formats() and merging formats lists on the
428 * @return >=0 if all links formats lists could be queried and merged;
429 * AVERROR(EAGAIN) some progress was made in the queries or merging
430 * and a later call may succeed;
431 * AVERROR(EIO) (may be changed) plus a log message if no progress
432 * was made and the negotiation is stuck;
433 * a negative error code if some other error happened
435 static int query_formats(AVFilterGraph *graph, AVClass *log_ctx)
438 int scaler_count = 0, resampler_count = 0;
439 int count_queried = 0; /* successful calls to query_formats() */
440 int count_merged = 0; /* successful merge of formats lists */
441 int count_already_merged = 0; /* lists already merged */
442 int count_delayed = 0; /* lists that need to be merged later */
444 for (i = 0; i < graph->nb_filters; i++) {
445 AVFilterContext *f = graph->filters[i];
446 if (formats_declared(f))
448 if (f->filter->query_formats)
449 ret = filter_query_formats(f);
451 ret = ff_default_query_formats(f);
452 if (ret < 0 && ret != AVERROR(EAGAIN))
454 /* note: EAGAIN could indicate a partial success, not counted yet */
455 count_queried += ret >= 0;
458 /* go through and merge as many format lists as possible */
459 for (i = 0; i < graph->nb_filters; i++) {
460 AVFilterContext *filter = graph->filters[i];
462 for (j = 0; j < filter->nb_inputs; j++) {
463 AVFilterLink *link = filter->inputs[j];
464 int convert_needed = 0;
469 if (link->incfg.formats != link->outcfg.formats
470 && link->incfg.formats && link->outcfg.formats)
471 if (!ff_can_merge_formats(link->incfg.formats, link->outcfg.formats,
474 if (link->type == AVMEDIA_TYPE_AUDIO) {
475 if (link->incfg.samplerates != link->outcfg.samplerates
476 && link->incfg.samplerates && link->outcfg.samplerates)
477 if (!ff_can_merge_samplerates(link->incfg.samplerates,
478 link->outcfg.samplerates))
482 #define CHECKED_MERGE(field, ...) ((ret = ff_merge_ ## field(__VA_ARGS__)) <= 0)
483 #define MERGE_DISPATCH(field, ...) \
484 if (!(link->incfg.field && link->outcfg.field)) { \
486 } else if (link->incfg.field == link->outcfg.field) { \
487 count_already_merged++; \
488 } else if (!convert_needed) { \
490 if (CHECKED_MERGE(field, __VA_ARGS__)) { \
493 convert_needed = 1; \
497 if (link->type == AVMEDIA_TYPE_AUDIO) {
498 MERGE_DISPATCH(channel_layouts, link->incfg.channel_layouts,
499 link->outcfg.channel_layouts)
500 MERGE_DISPATCH(samplerates, link->incfg.samplerates,
501 link->outcfg.samplerates)
503 MERGE_DISPATCH(formats, link->incfg.formats,
504 link->outcfg.formats, link->type)
505 #undef MERGE_DISPATCH
507 if (convert_needed) {
508 AVFilterContext *convert;
509 const AVFilter *filter;
510 AVFilterLink *inlink, *outlink;
513 if (graph->disable_auto_convert) {
514 av_log(log_ctx, AV_LOG_ERROR,
515 "The filters '%s' and '%s' do not have a common format "
516 "and automatic conversion is disabled.\n",
517 link->src->name, link->dst->name);
518 return AVERROR(EINVAL);
521 /* couldn't merge format lists. auto-insert conversion filter */
522 switch (link->type) {
523 case AVMEDIA_TYPE_VIDEO:
524 if (!(filter = avfilter_get_by_name("scale"))) {
525 av_log(log_ctx, AV_LOG_ERROR, "'scale' filter "
526 "not present, cannot convert pixel formats.\n");
527 return AVERROR(EINVAL);
530 snprintf(inst_name, sizeof(inst_name), "auto_scaler_%d",
533 if ((ret = avfilter_graph_create_filter(&convert, filter,
534 inst_name, graph->scale_sws_opts, NULL,
538 case AVMEDIA_TYPE_AUDIO:
539 if (!(filter = avfilter_get_by_name("aresample"))) {
540 av_log(log_ctx, AV_LOG_ERROR, "'aresample' filter "
541 "not present, cannot convert audio formats.\n");
542 return AVERROR(EINVAL);
545 snprintf(inst_name, sizeof(inst_name), "auto_resampler_%d",
547 if ((ret = avfilter_graph_create_filter(&convert, filter,
548 inst_name, graph->aresample_swr_opts,
553 return AVERROR(EINVAL);
556 if ((ret = avfilter_insert_filter(link, convert, 0, 0)) < 0)
559 if ((ret = filter_query_formats(convert)) < 0)
562 inlink = convert->inputs[0];
563 outlink = convert->outputs[0];
564 av_assert0( inlink->incfg.formats->refcount > 0);
565 av_assert0( inlink->outcfg.formats->refcount > 0);
566 av_assert0(outlink->incfg.formats->refcount > 0);
567 av_assert0(outlink->outcfg.formats->refcount > 0);
568 if (outlink->type == AVMEDIA_TYPE_AUDIO) {
569 av_assert0( inlink-> incfg.samplerates->refcount > 0);
570 av_assert0( inlink->outcfg.samplerates->refcount > 0);
571 av_assert0(outlink-> incfg.samplerates->refcount > 0);
572 av_assert0(outlink->outcfg.samplerates->refcount > 0);
573 av_assert0( inlink-> incfg.channel_layouts->refcount > 0);
574 av_assert0( inlink->outcfg.channel_layouts->refcount > 0);
575 av_assert0(outlink-> incfg.channel_layouts->refcount > 0);
576 av_assert0(outlink->outcfg.channel_layouts->refcount > 0);
578 if (CHECKED_MERGE(formats, inlink->incfg.formats,
579 inlink->outcfg.formats, inlink->type) ||
580 CHECKED_MERGE(formats, outlink->incfg.formats,
581 outlink->outcfg.formats, outlink->type) ||
582 inlink->type == AVMEDIA_TYPE_AUDIO &&
583 (CHECKED_MERGE(samplerates, inlink->incfg.samplerates,
584 inlink->outcfg.samplerates) ||
585 CHECKED_MERGE(channel_layouts, inlink->incfg.channel_layouts,
586 inlink->outcfg.channel_layouts)) ||
587 outlink->type == AVMEDIA_TYPE_AUDIO &&
588 (CHECKED_MERGE(samplerates, outlink->incfg.samplerates,
589 outlink->outcfg.samplerates) ||
590 CHECKED_MERGE(channel_layouts, outlink->incfg.channel_layouts,
591 outlink->outcfg.channel_layouts))) {
594 av_log(log_ctx, AV_LOG_ERROR,
595 "Impossible to convert between the formats supported by the filter "
596 "'%s' and the filter '%s'\n", link->src->name, link->dst->name);
597 return AVERROR(ENOSYS);
603 av_log(graph, AV_LOG_DEBUG, "query_formats: "
604 "%d queried, %d merged, %d already done, %d delayed\n",
605 count_queried, count_merged, count_already_merged, count_delayed);
609 /* if count_queried > 0, one filter at least did set its formats,
610 that will give additional information to its neighbour;
611 if count_merged > 0, one pair of formats lists at least was merged,
612 that will give additional information to all connected filters;
613 in both cases, progress was made and a new round must be done */
614 if (count_queried || count_merged)
615 return AVERROR(EAGAIN);
616 av_bprint_init(&bp, 0, AV_BPRINT_SIZE_AUTOMATIC);
617 for (i = 0; i < graph->nb_filters; i++)
618 if (!formats_declared(graph->filters[i]))
619 av_bprintf(&bp, "%s%s", bp.len ? ", " : "",
620 graph->filters[i]->name);
621 av_log(graph, AV_LOG_ERROR,
622 "The following filters could not choose their formats: %s\n"
623 "Consider inserting the (a)format filter near their input or "
624 "output.\n", bp.str);
630 static int get_fmt_score(enum AVSampleFormat dst_fmt, enum AVSampleFormat src_fmt)
634 if (av_sample_fmt_is_planar(dst_fmt) != av_sample_fmt_is_planar(src_fmt))
637 if (av_get_bytes_per_sample(dst_fmt) < av_get_bytes_per_sample(src_fmt)) {
638 score += 100 * (av_get_bytes_per_sample(src_fmt) - av_get_bytes_per_sample(dst_fmt));
640 score += 10 * (av_get_bytes_per_sample(dst_fmt) - av_get_bytes_per_sample(src_fmt));
642 if (av_get_packed_sample_fmt(dst_fmt) == AV_SAMPLE_FMT_S32 &&
643 av_get_packed_sample_fmt(src_fmt) == AV_SAMPLE_FMT_FLT)
646 if (av_get_packed_sample_fmt(dst_fmt) == AV_SAMPLE_FMT_FLT &&
647 av_get_packed_sample_fmt(src_fmt) == AV_SAMPLE_FMT_S32)
653 static enum AVSampleFormat find_best_sample_fmt_of_2(enum AVSampleFormat dst_fmt1, enum AVSampleFormat dst_fmt2,
654 enum AVSampleFormat src_fmt)
658 score1 = get_fmt_score(dst_fmt1, src_fmt);
659 score2 = get_fmt_score(dst_fmt2, src_fmt);
661 return score1 < score2 ? dst_fmt1 : dst_fmt2;
664 static int pick_format(AVFilterLink *link, AVFilterLink *ref)
666 if (!link || !link->incfg.formats)
669 if (link->type == AVMEDIA_TYPE_VIDEO) {
670 if(ref && ref->type == AVMEDIA_TYPE_VIDEO){
671 //FIXME: This should check for AV_PIX_FMT_FLAG_ALPHA after PAL8 pixel format without alpha is implemented
672 int has_alpha= av_pix_fmt_desc_get(ref->format)->nb_components % 2 == 0;
673 enum AVPixelFormat best= AV_PIX_FMT_NONE;
675 for (i = 0; i < link->incfg.formats->nb_formats; i++) {
676 enum AVPixelFormat p = link->incfg.formats->formats[i];
677 best= av_find_best_pix_fmt_of_2(best, p, ref->format, has_alpha, NULL);
679 av_log(link->src,AV_LOG_DEBUG, "picking %s out of %d ref:%s alpha:%d\n",
680 av_get_pix_fmt_name(best), link->incfg.formats->nb_formats,
681 av_get_pix_fmt_name(ref->format), has_alpha);
682 link->incfg.formats->formats[0] = best;
684 } else if (link->type == AVMEDIA_TYPE_AUDIO) {
685 if(ref && ref->type == AVMEDIA_TYPE_AUDIO){
686 enum AVSampleFormat best= AV_SAMPLE_FMT_NONE;
688 for (i = 0; i < link->incfg.formats->nb_formats; i++) {
689 enum AVSampleFormat p = link->incfg.formats->formats[i];
690 best = find_best_sample_fmt_of_2(best, p, ref->format);
692 av_log(link->src,AV_LOG_DEBUG, "picking %s out of %d ref:%s\n",
693 av_get_sample_fmt_name(best), link->incfg.formats->nb_formats,
694 av_get_sample_fmt_name(ref->format));
695 link->incfg.formats->formats[0] = best;
699 link->incfg.formats->nb_formats = 1;
700 link->format = link->incfg.formats->formats[0];
702 if (link->type == AVMEDIA_TYPE_AUDIO) {
703 if (!link->incfg.samplerates->nb_formats) {
704 av_log(link->src, AV_LOG_ERROR, "Cannot select sample rate for"
705 " the link between filters %s and %s.\n", link->src->name,
707 return AVERROR(EINVAL);
709 link->incfg.samplerates->nb_formats = 1;
710 link->sample_rate = link->incfg.samplerates->formats[0];
712 if (link->incfg.channel_layouts->all_layouts) {
713 av_log(link->src, AV_LOG_ERROR, "Cannot select channel layout for"
714 " the link between filters %s and %s.\n", link->src->name,
716 if (!link->incfg.channel_layouts->all_counts)
717 av_log(link->src, AV_LOG_ERROR, "Unknown channel layouts not "
718 "supported, try specifying a channel layout using "
719 "'aformat=channel_layouts=something'.\n");
720 return AVERROR(EINVAL);
722 link->incfg.channel_layouts->nb_channel_layouts = 1;
723 link->channel_layout = link->incfg.channel_layouts->channel_layouts[0];
724 if ((link->channels = FF_LAYOUT2COUNT(link->channel_layout)))
725 link->channel_layout = 0;
727 link->channels = av_get_channel_layout_nb_channels(link->channel_layout);
730 ff_formats_unref(&link->incfg.formats);
731 ff_formats_unref(&link->outcfg.formats);
732 ff_formats_unref(&link->incfg.samplerates);
733 ff_formats_unref(&link->outcfg.samplerates);
734 ff_channel_layouts_unref(&link->incfg.channel_layouts);
735 ff_channel_layouts_unref(&link->outcfg.channel_layouts);
740 #define REDUCE_FORMATS(fmt_type, list_type, list, var, nb, add_format) \
742 for (i = 0; i < filter->nb_inputs; i++) { \
743 AVFilterLink *link = filter->inputs[i]; \
746 if (!link->outcfg.list || link->outcfg.list->nb != 1) \
748 fmt = link->outcfg.list->var[0]; \
750 for (j = 0; j < filter->nb_outputs; j++) { \
751 AVFilterLink *out_link = filter->outputs[j]; \
754 if (link->type != out_link->type || \
755 out_link->incfg.list->nb == 1) \
757 fmts = out_link->incfg.list; \
759 if (!out_link->incfg.list->nb) { \
760 if ((ret = add_format(&out_link->incfg.list, fmt)) < 0)\
766 for (k = 0; k < out_link->incfg.list->nb; k++) \
767 if (fmts->var[k] == fmt) { \
768 fmts->var[0] = fmt; \
777 static int reduce_formats_on_filter(AVFilterContext *filter)
779 int i, j, k, ret = 0;
781 REDUCE_FORMATS(int, AVFilterFormats, formats, formats,
782 nb_formats, ff_add_format);
783 REDUCE_FORMATS(int, AVFilterFormats, samplerates, formats,
784 nb_formats, ff_add_format);
786 /* reduce channel layouts */
787 for (i = 0; i < filter->nb_inputs; i++) {
788 AVFilterLink *inlink = filter->inputs[i];
791 if (!inlink->outcfg.channel_layouts ||
792 inlink->outcfg.channel_layouts->nb_channel_layouts != 1)
794 fmt = inlink->outcfg.channel_layouts->channel_layouts[0];
796 for (j = 0; j < filter->nb_outputs; j++) {
797 AVFilterLink *outlink = filter->outputs[j];
798 AVFilterChannelLayouts *fmts;
800 fmts = outlink->incfg.channel_layouts;
801 if (inlink->type != outlink->type || fmts->nb_channel_layouts == 1)
804 if (fmts->all_layouts &&
805 (!FF_LAYOUT2COUNT(fmt) || fmts->all_counts)) {
806 /* Turn the infinite list into a singleton */
807 fmts->all_layouts = fmts->all_counts = 0;
808 if (ff_add_channel_layout(&outlink->incfg.channel_layouts, fmt) < 0)
813 for (k = 0; k < outlink->incfg.channel_layouts->nb_channel_layouts; k++) {
814 if (fmts->channel_layouts[k] == fmt) {
815 fmts->channel_layouts[0] = fmt;
816 fmts->nb_channel_layouts = 1;
827 static int reduce_formats(AVFilterGraph *graph)
834 for (i = 0; i < graph->nb_filters; i++) {
835 if ((ret = reduce_formats_on_filter(graph->filters[i])) < 0)
844 static void swap_samplerates_on_filter(AVFilterContext *filter)
846 AVFilterLink *link = NULL;
850 for (i = 0; i < filter->nb_inputs; i++) {
851 link = filter->inputs[i];
853 if (link->type == AVMEDIA_TYPE_AUDIO &&
854 link->outcfg.samplerates->nb_formats== 1)
857 if (i == filter->nb_inputs)
860 sample_rate = link->outcfg.samplerates->formats[0];
862 for (i = 0; i < filter->nb_outputs; i++) {
863 AVFilterLink *outlink = filter->outputs[i];
864 int best_idx, best_diff = INT_MAX;
866 if (outlink->type != AVMEDIA_TYPE_AUDIO ||
867 outlink->incfg.samplerates->nb_formats < 2)
870 for (j = 0; j < outlink->incfg.samplerates->nb_formats; j++) {
871 int diff = abs(sample_rate - outlink->incfg.samplerates->formats[j]);
873 av_assert0(diff < INT_MAX); // This would lead to the use of uninitialized best_diff but is only possible with invalid sample rates
875 if (diff < best_diff) {
880 FFSWAP(int, outlink->incfg.samplerates->formats[0],
881 outlink->incfg.samplerates->formats[best_idx]);
885 static void swap_samplerates(AVFilterGraph *graph)
889 for (i = 0; i < graph->nb_filters; i++)
890 swap_samplerates_on_filter(graph->filters[i]);
893 #define CH_CENTER_PAIR (AV_CH_FRONT_LEFT_OF_CENTER | AV_CH_FRONT_RIGHT_OF_CENTER)
894 #define CH_FRONT_PAIR (AV_CH_FRONT_LEFT | AV_CH_FRONT_RIGHT)
895 #define CH_STEREO_PAIR (AV_CH_STEREO_LEFT | AV_CH_STEREO_RIGHT)
896 #define CH_WIDE_PAIR (AV_CH_WIDE_LEFT | AV_CH_WIDE_RIGHT)
897 #define CH_SIDE_PAIR (AV_CH_SIDE_LEFT | AV_CH_SIDE_RIGHT)
898 #define CH_DIRECT_PAIR (AV_CH_SURROUND_DIRECT_LEFT | AV_CH_SURROUND_DIRECT_RIGHT)
899 #define CH_BACK_PAIR (AV_CH_BACK_LEFT | AV_CH_BACK_RIGHT)
901 /* allowable substitutions for channel pairs when comparing layouts,
902 * ordered by priority for both values */
903 static const uint64_t ch_subst[][2] = {
904 { CH_FRONT_PAIR, CH_CENTER_PAIR },
905 { CH_FRONT_PAIR, CH_WIDE_PAIR },
906 { CH_FRONT_PAIR, AV_CH_FRONT_CENTER },
907 { CH_CENTER_PAIR, CH_FRONT_PAIR },
908 { CH_CENTER_PAIR, CH_WIDE_PAIR },
909 { CH_CENTER_PAIR, AV_CH_FRONT_CENTER },
910 { CH_WIDE_PAIR, CH_FRONT_PAIR },
911 { CH_WIDE_PAIR, CH_CENTER_PAIR },
912 { CH_WIDE_PAIR, AV_CH_FRONT_CENTER },
913 { AV_CH_FRONT_CENTER, CH_FRONT_PAIR },
914 { AV_CH_FRONT_CENTER, CH_CENTER_PAIR },
915 { AV_CH_FRONT_CENTER, CH_WIDE_PAIR },
916 { CH_SIDE_PAIR, CH_DIRECT_PAIR },
917 { CH_SIDE_PAIR, CH_BACK_PAIR },
918 { CH_SIDE_PAIR, AV_CH_BACK_CENTER },
919 { CH_BACK_PAIR, CH_DIRECT_PAIR },
920 { CH_BACK_PAIR, CH_SIDE_PAIR },
921 { CH_BACK_PAIR, AV_CH_BACK_CENTER },
922 { AV_CH_BACK_CENTER, CH_BACK_PAIR },
923 { AV_CH_BACK_CENTER, CH_DIRECT_PAIR },
924 { AV_CH_BACK_CENTER, CH_SIDE_PAIR },
927 static void swap_channel_layouts_on_filter(AVFilterContext *filter)
929 AVFilterLink *link = NULL;
932 for (i = 0; i < filter->nb_inputs; i++) {
933 link = filter->inputs[i];
935 if (link->type == AVMEDIA_TYPE_AUDIO &&
936 link->outcfg.channel_layouts->nb_channel_layouts == 1)
939 if (i == filter->nb_inputs)
942 for (i = 0; i < filter->nb_outputs; i++) {
943 AVFilterLink *outlink = filter->outputs[i];
944 int best_idx = -1, best_score = INT_MIN, best_count_diff = INT_MAX;
946 if (outlink->type != AVMEDIA_TYPE_AUDIO ||
947 outlink->incfg.channel_layouts->nb_channel_layouts < 2)
950 for (j = 0; j < outlink->incfg.channel_layouts->nb_channel_layouts; j++) {
951 uint64_t in_chlayout = link->outcfg.channel_layouts->channel_layouts[0];
952 uint64_t out_chlayout = outlink->incfg.channel_layouts->channel_layouts[j];
953 int in_channels = av_get_channel_layout_nb_channels(in_chlayout);
954 int out_channels = av_get_channel_layout_nb_channels(out_chlayout);
955 int count_diff = out_channels - in_channels;
956 int matched_channels, extra_channels;
959 if (FF_LAYOUT2COUNT(in_chlayout) || FF_LAYOUT2COUNT(out_chlayout)) {
960 /* Compute score in case the input or output layout encodes
961 a channel count; in this case the score is not altered by
962 the computation afterwards, as in_chlayout and
963 out_chlayout have both been set to 0 */
964 if (FF_LAYOUT2COUNT(in_chlayout))
965 in_channels = FF_LAYOUT2COUNT(in_chlayout);
966 if (FF_LAYOUT2COUNT(out_chlayout))
967 out_channels = FF_LAYOUT2COUNT(out_chlayout);
968 score -= 10000 + FFABS(out_channels - in_channels) +
969 (in_channels > out_channels ? 10000 : 0);
970 in_chlayout = out_chlayout = 0;
971 /* Let the remaining computation run, even if the score
972 value is not altered */
975 /* channel substitution */
976 for (k = 0; k < FF_ARRAY_ELEMS(ch_subst); k++) {
977 uint64_t cmp0 = ch_subst[k][0];
978 uint64_t cmp1 = ch_subst[k][1];
979 if (( in_chlayout & cmp0) && (!(out_chlayout & cmp0)) &&
980 (out_chlayout & cmp1) && (!( in_chlayout & cmp1))) {
981 in_chlayout &= ~cmp0;
982 out_chlayout &= ~cmp1;
983 /* add score for channel match, minus a deduction for
984 having to do the substitution */
985 score += 10 * av_get_channel_layout_nb_channels(cmp1) - 2;
989 /* no penalty for LFE channel mismatch */
990 if ( (in_chlayout & AV_CH_LOW_FREQUENCY) &&
991 (out_chlayout & AV_CH_LOW_FREQUENCY))
993 in_chlayout &= ~AV_CH_LOW_FREQUENCY;
994 out_chlayout &= ~AV_CH_LOW_FREQUENCY;
996 matched_channels = av_get_channel_layout_nb_channels(in_chlayout &
998 extra_channels = av_get_channel_layout_nb_channels(out_chlayout &
1000 score += 10 * matched_channels - 5 * extra_channels;
1002 if (score > best_score ||
1003 (count_diff < best_count_diff && score == best_score)) {
1006 best_count_diff = count_diff;
1009 av_assert0(best_idx >= 0);
1010 FFSWAP(uint64_t, outlink->incfg.channel_layouts->channel_layouts[0],
1011 outlink->incfg.channel_layouts->channel_layouts[best_idx]);
1016 static void swap_channel_layouts(AVFilterGraph *graph)
1020 for (i = 0; i < graph->nb_filters; i++)
1021 swap_channel_layouts_on_filter(graph->filters[i]);
1024 static void swap_sample_fmts_on_filter(AVFilterContext *filter)
1026 AVFilterLink *link = NULL;
1030 for (i = 0; i < filter->nb_inputs; i++) {
1031 link = filter->inputs[i];
1033 if (link->type == AVMEDIA_TYPE_AUDIO &&
1034 link->outcfg.formats->nb_formats == 1)
1037 if (i == filter->nb_inputs)
1040 format = link->outcfg.formats->formats[0];
1041 bps = av_get_bytes_per_sample(format);
1043 for (i = 0; i < filter->nb_outputs; i++) {
1044 AVFilterLink *outlink = filter->outputs[i];
1045 int best_idx = -1, best_score = INT_MIN;
1047 if (outlink->type != AVMEDIA_TYPE_AUDIO ||
1048 outlink->incfg.formats->nb_formats < 2)
1051 for (j = 0; j < outlink->incfg.formats->nb_formats; j++) {
1052 int out_format = outlink->incfg.formats->formats[j];
1053 int out_bps = av_get_bytes_per_sample(out_format);
1056 if (av_get_packed_sample_fmt(out_format) == format ||
1057 av_get_planar_sample_fmt(out_format) == format) {
1062 /* for s32 and float prefer double to prevent loss of information */
1063 if (bps == 4 && out_bps == 8) {
1068 /* prefer closest higher or equal bps */
1069 score = -abs(out_bps - bps);
1073 if (score > best_score) {
1078 av_assert0(best_idx >= 0);
1079 FFSWAP(int, outlink->incfg.formats->formats[0],
1080 outlink->incfg.formats->formats[best_idx]);
1084 static void swap_sample_fmts(AVFilterGraph *graph)
1088 for (i = 0; i < graph->nb_filters; i++)
1089 swap_sample_fmts_on_filter(graph->filters[i]);
1093 static int pick_formats(AVFilterGraph *graph)
1100 for (i = 0; i < graph->nb_filters; i++) {
1101 AVFilterContext *filter = graph->filters[i];
1102 if (filter->nb_inputs){
1103 for (j = 0; j < filter->nb_inputs; j++){
1104 if (filter->inputs[j]->incfg.formats && filter->inputs[j]->incfg.formats->nb_formats == 1) {
1105 if ((ret = pick_format(filter->inputs[j], NULL)) < 0)
1111 if (filter->nb_outputs){
1112 for (j = 0; j < filter->nb_outputs; j++){
1113 if (filter->outputs[j]->incfg.formats && filter->outputs[j]->incfg.formats->nb_formats == 1) {
1114 if ((ret = pick_format(filter->outputs[j], NULL)) < 0)
1120 if (filter->nb_inputs && filter->nb_outputs && filter->inputs[0]->format>=0) {
1121 for (j = 0; j < filter->nb_outputs; j++) {
1122 if (filter->outputs[j]->format<0) {
1123 if ((ret = pick_format(filter->outputs[j], filter->inputs[0])) < 0)
1132 for (i = 0; i < graph->nb_filters; i++) {
1133 AVFilterContext *filter = graph->filters[i];
1135 for (j = 0; j < filter->nb_inputs; j++)
1136 if ((ret = pick_format(filter->inputs[j], NULL)) < 0)
1138 for (j = 0; j < filter->nb_outputs; j++)
1139 if ((ret = pick_format(filter->outputs[j], NULL)) < 0)
1146 * Configure the formats of all the links in the graph.
1148 static int graph_config_formats(AVFilterGraph *graph, AVClass *log_ctx)
1152 /* find supported formats from sub-filters, and merge along links */
1153 while ((ret = query_formats(graph, log_ctx)) == AVERROR(EAGAIN))
1154 av_log(graph, AV_LOG_DEBUG, "query_formats not finished\n");
1158 /* Once everything is merged, it's possible that we'll still have
1159 * multiple valid media format choices. We try to minimize the amount
1160 * of format conversion inside filters */
1161 if ((ret = reduce_formats(graph)) < 0)
1164 /* for audio filters, ensure the best format, sample rate and channel layout
1166 swap_sample_fmts(graph);
1167 swap_samplerates(graph);
1168 swap_channel_layouts(graph);
1170 if ((ret = pick_formats(graph)) < 0)
1176 static int graph_config_pointers(AVFilterGraph *graph,
1180 int sink_links_count = 0, n = 0;
1182 AVFilterLink **sinks;
1184 for (i = 0; i < graph->nb_filters; i++) {
1185 f = graph->filters[i];
1186 for (j = 0; j < f->nb_inputs; j++) {
1187 f->inputs[j]->graph = graph;
1188 f->inputs[j]->age_index = -1;
1190 for (j = 0; j < f->nb_outputs; j++) {
1191 f->outputs[j]->graph = graph;
1192 f->outputs[j]->age_index= -1;
1194 if (!f->nb_outputs) {
1195 if (f->nb_inputs > INT_MAX - sink_links_count)
1196 return AVERROR(EINVAL);
1197 sink_links_count += f->nb_inputs;
1200 sinks = av_calloc(sink_links_count, sizeof(*sinks));
1202 return AVERROR(ENOMEM);
1203 for (i = 0; i < graph->nb_filters; i++) {
1204 f = graph->filters[i];
1205 if (!f->nb_outputs) {
1206 for (j = 0; j < f->nb_inputs; j++) {
1207 sinks[n] = f->inputs[j];
1208 f->inputs[j]->age_index = n++;
1212 av_assert0(n == sink_links_count);
1213 graph->sink_links = sinks;
1214 graph->sink_links_count = sink_links_count;
1218 int avfilter_graph_config(AVFilterGraph *graphctx, void *log_ctx)
1222 if ((ret = graph_check_validity(graphctx, log_ctx)))
1224 if ((ret = graph_config_formats(graphctx, log_ctx)))
1226 if ((ret = graph_config_links(graphctx, log_ctx)))
1228 if ((ret = graph_check_links(graphctx, log_ctx)))
1230 if ((ret = graph_config_pointers(graphctx, log_ctx)))
1236 int avfilter_graph_send_command(AVFilterGraph *graph, const char *target, const char *cmd, const char *arg, char *res, int res_len, int flags)
1238 int i, r = AVERROR(ENOSYS);
1243 if ((flags & AVFILTER_CMD_FLAG_ONE) && !(flags & AVFILTER_CMD_FLAG_FAST)) {
1244 r = avfilter_graph_send_command(graph, target, cmd, arg, res, res_len, flags | AVFILTER_CMD_FLAG_FAST);
1245 if (r != AVERROR(ENOSYS))
1252 for (i = 0; i < graph->nb_filters; i++) {
1253 AVFilterContext *filter = graph->filters[i];
1254 if (!strcmp(target, "all") || (filter->name && !strcmp(target, filter->name)) || !strcmp(target, filter->filter->name)) {
1255 r = avfilter_process_command(filter, cmd, arg, res, res_len, flags);
1256 if (r != AVERROR(ENOSYS)) {
1257 if ((flags & AVFILTER_CMD_FLAG_ONE) || r < 0)
1266 int avfilter_graph_queue_command(AVFilterGraph *graph, const char *target, const char *command, const char *arg, int flags, double ts)
1273 for (i = 0; i < graph->nb_filters; i++) {
1274 AVFilterContext *filter = graph->filters[i];
1275 if(filter && (!strcmp(target, "all") || !strcmp(target, filter->name) || !strcmp(target, filter->filter->name))){
1276 AVFilterCommand **queue = &filter->command_queue, *next;
1277 while (*queue && (*queue)->time <= ts)
1278 queue = &(*queue)->next;
1280 *queue = av_mallocz(sizeof(AVFilterCommand));
1282 return AVERROR(ENOMEM);
1284 (*queue)->command = av_strdup(command);
1285 (*queue)->arg = av_strdup(arg);
1286 (*queue)->time = ts;
1287 (*queue)->flags = flags;
1288 (*queue)->next = next;
1289 if(flags & AVFILTER_CMD_FLAG_ONE)
1297 static void heap_bubble_up(AVFilterGraph *graph,
1298 AVFilterLink *link, int index)
1300 AVFilterLink **links = graph->sink_links;
1302 av_assert0(index >= 0);
1305 int parent = (index - 1) >> 1;
1306 if (links[parent]->current_pts_us >= link->current_pts_us)
1308 links[index] = links[parent];
1309 links[index]->age_index = index;
1312 links[index] = link;
1313 link->age_index = index;
1316 static void heap_bubble_down(AVFilterGraph *graph,
1317 AVFilterLink *link, int index)
1319 AVFilterLink **links = graph->sink_links;
1321 av_assert0(index >= 0);
1324 int child = 2 * index + 1;
1325 if (child >= graph->sink_links_count)
1327 if (child + 1 < graph->sink_links_count &&
1328 links[child + 1]->current_pts_us < links[child]->current_pts_us)
1330 if (link->current_pts_us < links[child]->current_pts_us)
1332 links[index] = links[child];
1333 links[index]->age_index = index;
1336 links[index] = link;
1337 link->age_index = index;
1340 void ff_avfilter_graph_update_heap(AVFilterGraph *graph, AVFilterLink *link)
1342 heap_bubble_up (graph, link, link->age_index);
1343 heap_bubble_down(graph, link, link->age_index);
1346 int avfilter_graph_request_oldest(AVFilterGraph *graph)
1348 AVFilterLink *oldest = graph->sink_links[0];
1349 int64_t frame_count;
1352 while (graph->sink_links_count) {
1353 oldest = graph->sink_links[0];
1354 if (oldest->dst->filter->activate) {
1355 /* For now, buffersink is the only filter implementing activate. */
1356 r = av_buffersink_get_frame_flags(oldest->dst, NULL,
1357 AV_BUFFERSINK_FLAG_PEEK);
1358 if (r != AVERROR_EOF)
1361 r = ff_request_frame(oldest);
1363 if (r != AVERROR_EOF)
1365 av_log(oldest->dst, AV_LOG_DEBUG, "EOF on sink link %s:%s.\n",
1366 oldest->dst ? oldest->dst->name : "unknown",
1367 oldest->dstpad ? oldest->dstpad->name : "unknown");
1368 /* EOF: remove the link from the heap */
1369 if (oldest->age_index < --graph->sink_links_count)
1370 heap_bubble_down(graph, graph->sink_links[graph->sink_links_count],
1372 oldest->age_index = -1;
1374 if (!graph->sink_links_count)
1376 av_assert1(!oldest->dst->filter->activate);
1377 av_assert1(oldest->age_index >= 0);
1378 frame_count = oldest->frame_count_out;
1379 while (frame_count == oldest->frame_count_out) {
1380 r = ff_filter_graph_run_once(graph);
1381 if (r == AVERROR(EAGAIN) &&
1382 !oldest->frame_wanted_out && !oldest->frame_blocked_in &&
1384 ff_request_frame(oldest);
1391 int ff_filter_graph_run_once(AVFilterGraph *graph)
1393 AVFilterContext *filter;
1396 av_assert0(graph->nb_filters);
1397 filter = graph->filters[0];
1398 for (i = 1; i < graph->nb_filters; i++)
1399 if (graph->filters[i]->ready > filter->ready)
1400 filter = graph->filters[i];
1402 return AVERROR(EAGAIN);
1403 return ff_filter_activate(filter);