doc/filters: mentions that whitespaces are ignored in the filtergraph specification

Also provide example showing how to use this feature to improve filtergraph
readability.

Address issue:
http://trac.ffmpeg.org/ticket/8115
This commit is contained in:
Stefano Sabatini 2023-03-26 19:32:17 +02:00
parent 7792f53e5e
commit 5c13307989
1 changed files with 17 additions and 0 deletions

View File

@ -214,6 +214,23 @@ In a complete filterchain all the unlabelled filter input and output
pads must be connected. A filtergraph is considered valid if all the
filter input and output pads of all the filterchains are connected.
Leading and trailing whitespaces (space, tabs, or line feeds) separating tokens
in the filtergraph specification are ignored. This means that the filtergraph
can be expressed using empty lines and spaces to improve redability.
For example, the filtergraph:
@example
testsrc,split[L1],hflip[L2];[L1][L2] hstack
@end example
can be represented as:
@example
testsrc,
split [L1], hflip [L2];
[L1][L2] hstack
@end example
Libavfilter will automatically insert @ref{scale} filters where format
conversion is required. It is possible to specify swscale flags
for those automatically inserted scalers by prepending