[FFmpeg-devel] [PATCH] doc/filters: document drawtext draw expression

[Stefano Sabatini]

---
 doc/filters.texi |   16 ++++++++++++++++
 1 files changed, 16 insertions(+), 0 deletions(-)

diff --git a/doc/filters.texi b/doc/filters.texi
index c529f00..bc0e2ae 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".
 
+ at 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 seconds every 3 seconds:
+ at example
+drawtext=fontfile=FreeSerif.ttf:fontcolor=white:x=100:y=x/dar:draw=lt(mod(t\\,3)\\,1):text='blink'"
+ at end example
+
+ at 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'
-- 
1.7.5.4