@@ -167,6 +167,8 @@ Complex filtergraphs are configured with the @option{-filter_complex} option. | |||||
Note that this option is global, since a complex filtergraph by its nature | Note that this option is global, since a complex filtergraph by its nature | ||||
cannot be unambiguously associated with a single stream or file. | cannot be unambiguously associated with a single stream or file. | ||||
The @option{-lavfi} option is equivalent to @option{-filter_complex}. | |||||
A trivial example of a complex filtergraph is the @code{overlay} filter, which | A trivial example of a complex filtergraph is the @code{overlay} filter, which | ||||
has two video inputs and one video output, containing one video overlaid on top | has two video inputs and one video output, containing one video overlaid on top | ||||
of the other. Its audio counterpart is the @code{amix} filter. | of the other. Its audio counterpart is the @code{amix} filter. | ||||
@@ -1032,6 +1034,11 @@ To generate 5 seconds of pure red video using lavfi @code{color} source: | |||||
@example | @example | ||||
ffmpeg -filter_complex 'color=c=red' -t 5 out.mkv | ffmpeg -filter_complex 'color=c=red' -t 5 out.mkv | ||||
@end example | @end example | ||||
@item -lavfi @var{filtergraph} (@emph{global}) | |||||
Define a complex filter graph, i.e. one with arbitrary number of inputs and/or | |||||
outputs. Equivalent to @option{-filter_complex}. | |||||
@end table | @end table | ||||
As a special exception, you can use a bitmap subtitle stream as input: it | As a special exception, you can use a bitmap subtitle stream as input: it | ||||
@@ -2603,6 +2603,8 @@ const OptionDef options[] = { | |||||
"reinit filtergraph on input parameter changes", "" }, | "reinit filtergraph on input parameter changes", "" }, | ||||
{ "filter_complex", HAS_ARG | OPT_EXPERT, { .func_arg = opt_filter_complex }, | { "filter_complex", HAS_ARG | OPT_EXPERT, { .func_arg = opt_filter_complex }, | ||||
"create a complex filtergraph", "graph_description" }, | "create a complex filtergraph", "graph_description" }, | ||||
{ "lavfi", HAS_ARG | OPT_EXPERT, { .func_arg = opt_filter_complex }, | |||||
"create a complex filtergraph", "graph_description" }, | |||||
{ "stats", OPT_BOOL, { &print_stats }, | { "stats", OPT_BOOL, { &print_stats }, | ||||
"print progress report during encoding", }, | "print progress report during encoding", }, | ||||
{ "attach", HAS_ARG | OPT_PERFILE | OPT_EXPERT | | { "attach", HAS_ARG | OPT_PERFILE | OPT_EXPERT | | ||||