[FFmpeg-cvslog] doc/filters: add a signalstats example

[Dave Rice]

ffmpeg | branch: master | Dave Rice <dave at dericed.com> | Tue Jul  8 23:41:47 2014 -0400| [a15c5c44e262c115f5e5820b35447012aa214955] | committer: Paul B Mahol

doc/filters: add a signalstats example

Signed-off-by: Dave Rice <dave at dericed.com>

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

 doc/filters.texi |   16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/doc/filters.texi b/doc/filters.texi
index ada33a7..b736b3f 100644
--- a/doc/filters.texi
+++ b/doc/filters.texi
@@ -7746,6 +7746,22 @@ Playback video while highlighting pixels that are outside of broadcast range in
 @example
 ffplay example.mov -vf signalstats="out=brng:color=red"
 @end example
+
+ at item
+Playback video with signalstats metadata drawn over the frame.
+ at example
+ffplay example.mov -vf signalstats=stat=brng+vrep+tout,drawtext=fontfile=FreeSerif.ttf:textfile=signalstat_drawtext.txt
+ at end example
+
+The contents of signalstat_drawtext.txt used in the command are:
+ at example
+time %@{pts:hms@}
+Y (%@{metadata:lavfi.signalstats.YMIN@}-%@{metadata:lavfi.signalstats.YMAX@})
+U (%@{metadata:lavfi.signalstats.UMIN@}-%@{metadata:lavfi.signalstats.UMAX@})
+V (%@{metadata:lavfi.signalstats.VMIN@}-%@{metadata:lavfi.signalstats.VMAX@})
+saturation maximum: %@{metadata:lavfi.signalstats.SATMAX@}
+
+ at end example
 @end itemize
 
 @anchor{smartblur}