From 162414cefee64eff114179a45abc45aca5133ed0 Mon Sep 17 00:00:00 2001 From: Muhammad Faiz Date: Wed, 17 May 2017 13:03:28 +0700 Subject: avfilter/graphparser: allow specifying filter@id as filter instance See http://lists.ffmpeg.org/pipermail/ffmpeg-user/2017-April/035975.html Parsed_filter_X could remain and user can override it with custom one. Example: ffplay -f lavfi "nullsrc=s=640x360, sendcmd='1 drawtext@top reinit text=Hello; 2 drawtext@bottom reinit text=World', drawtext@top=x=16:y=16:fontsize=20:fontcolor=Red:text='', drawtext@bottom=x=16:y=340:fontsize=16:fontcolor=Blue:text=''" Reviewed-by: Paul B Mahol Signed-off-by: Muhammad Faiz --- doc/filters.texi | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) (limited to 'doc') diff --git a/doc/filters.texi b/doc/filters.texi index 296a8dcd03..e29c4d940f 100644 --- a/doc/filters.texi +++ b/doc/filters.texi @@ -130,11 +130,11 @@ filterchains is represented by a list of ";"-separated filterchain descriptions. A filter is represented by a string of the form: -[@var{in_link_1}]...[@var{in_link_N}]@var{filter_name}=@var{arguments}[@var{out_link_1}]...[@var{out_link_M}] +[@var{in_link_1}]...[@var{in_link_N}]@var{filter_name}@@@var{id}=@var{arguments}[@var{out_link_1}]...[@var{out_link_M}] @var{filter_name} is the name of the filter class of which the described filter is an instance of, and has to be the name of one of -the filter classes registered in the program. +the filter classes registered in the program optionally followed by "@@@var{id}". The name of the filter class is optionally followed by a string "=@var{arguments}". @@ -212,10 +212,11 @@ to the filtergraph description. Here is a BNF description of the filtergraph syntax: @example @var{NAME} ::= sequence of alphanumeric characters and '_' +@var{FILTER_NAME} ::= @var{NAME}["@@"@var{NAME}] @var{LINKLABEL} ::= "[" @var{NAME} "]" @var{LINKLABELS} ::= @var{LINKLABEL} [@var{LINKLABELS}] @var{FILTER_ARGUMENTS} ::= sequence of chars (possibly quoted) -@var{FILTER} ::= [@var{LINKLABELS}] @var{NAME} ["=" @var{FILTER_ARGUMENTS}] [@var{LINKLABELS}] +@var{FILTER} ::= [@var{LINKLABELS}] @var{FILTER_NAME} ["=" @var{FILTER_ARGUMENTS}] [@var{LINKLABELS}] @var{FILTERCHAIN} ::= @var{FILTER} [,@var{FILTERCHAIN}] @var{FILTERGRAPH} ::= [sws_flags=@var{flags};] @var{FILTERCHAIN} [;@var{FILTERGRAPH}] @end example @@ -17246,6 +17247,12 @@ Specify audio tempo change at second 4: asendcmd=c='4.0 atempo tempo 1.5',atempo @end example +@item +Target a specific filter instance: +@example +asendcmd=c='4.0 atempo@@my tempo 1.5',atempo@@my +@end example + @item Specify a list of drawtext and hue commands in a file. @example -- cgit v1.2.3