doc/filters: add a signalstats example

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

1 files changed, 16 insertions, 0 deletions

diff --git a/doc/filters.texi b/doc/filters.texi
index ada33a78dd..b736b3fe31 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
+
+@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}