doc/filters: document drawtext draw expression

1 files changed, 16 insertions, 0 deletions

diff --git a/doc/filters.texi b/doc/filters.texi
index 11122f91b9..9182704273 100644
--- a/doc/filters.texi
+++ b/doc/filters.texi
@@ -1273,6 +1273,16 @@ Either a string (e.g. "yellow") or in 0xRRGGBB[AA] format
 (e.g. "0xff00ff"), possibly followed by an alpha specifier.
 The default value of @var{boxcolor} is "white".
 
+@item draw
+Set an expression which specifies if the text should be drawn. If the
+expression evaluates to 0, the text is not drawn. This is useful for
+specifying that the text should be drawn only when specific conditions
+are met.
+
+Default value is "1".
+
+See below for the list of accepted constants and functions.
+
 @item fix_bounds
 If true, check and fix text coords to avoid clipping.
 
@@ -1491,6 +1501,12 @@ drawtext=fontsize=60:fontfile=FreeSerif.ttf:fontcolor=green:text=g:x=(w-max_glyp
 @end example
 
 @item
+Show text for 1 second every 3 seconds:
+@example
+drawtext="fontfile=FreeSerif.ttf:fontcolor=white:x=100:y=x/dar:draw=lt(mod(t\\,3)\\,1):text='blink'"
+@end example
+
+@item
 Use fontconfig to set the font. Note that the colons need to be escaped.
 @example
 drawtext='fontfile=Linux Libertine O-40\\:style=Semibold:text=FFmpeg'