doc/filters: add a signalstats example
authorDave Rice <dave@dericed.com>
Wed, 9 Jul 2014 03:41:47 +0000 (23:41 -0400)
committerPaul B Mahol <onemda@gmail.com>
Thu, 10 Jul 2014 09:34:37 +0000 (09:34 +0000)
Signed-off-by: Dave Rice <dave@dericed.com>
doc/filters.texi

index ada33a7..b736b3f 100644 (file)
@@ -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
+
+@item
+Playback video with signalstats metadata drawn over the frame.
+@example
+ffplay example.mov -vf signalstats=stat=brng+vrep+tout,drawtext=fontfile=FreeSerif.ttf:textfile=signalstat_drawtext.txt
+@end example
+
+The contents of signalstat_drawtext.txt used in the command are:
+@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@}
+
+@end example
 @end itemize
 
 @anchor{smartblur}