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

[Stefano Sabatini]

ffmpeg | branch: master | Stefano Sabatini <stefasab at gmail.com> | Tue May  1 13:26:05 2012 +0200| [4f19e50c2352a199cfe79820b1b4942c1d2d9d61] | committer: Stefano Sabatini

doc/filters: document drawtext draw expression

> http://git.videolan.org/gitweb.cgi/ffmpeg.git/?a=commit;h=4f19e50c2352a199cfe79820b1b4942c1d2d9d61
---

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

diff --git a/doc/filters.texi b/doc/filters.texi
index 11122f9..9182704 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 second 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'