[MPlayer-DOCS] r34190 - in trunk: Changelog DOCS/man/en/mplayer.1 Makefile configure libmpcodecs/vf.c libmpcodecs/vf_lavfi.c

[cigaes]

Author: cigaes
Date: Wed Oct 12 13:38:10 2011
New Revision: 34190

Log:
libmpcodec: add vf_lavfi.

This filter wraps a complete libavfilter filter graph.

As the API of libavfilter is not completely stable yet, the filter is not
enabled by default, so as not to let mplayer unbuildable.

Some strange behaviours may appear due to the very different model of buffer
allocation between mplayer and lavfi.

Modified:
   trunk/DOCS/man/en/mplayer.1

Changes in other areas also in this revision:
Added:
   trunk/libmpcodecs/vf_lavfi.c
Modified:
   trunk/Changelog
   trunk/Makefile
   trunk/configure
   trunk/libmpcodecs/vf.c

Modified: trunk/DOCS/man/en/mplayer.1
==============================================================================
--- trunk/DOCS/man/en/mplayer.1	Wed Oct 12 13:38:08 2011	(r34189)
+++ trunk/DOCS/man/en/mplayer.1	Wed Oct 12 13:38:10 2011	(r34190)
@@ -6991,6 +6991,26 @@ drop the frame (default: 0.15).
 FFmpeg deinterlacing filter, same as \-vf pp=fd
 .
 .TP
+.B lavfi=filtergraph
+FFmpeg libavfilter wrapper.
+\fIfiltergraph\fR defines a whole libavfilter graph with one input and one output.
+See http://www.ffmpeg.org/\:libavfilter.html#SEC4 for details.
+.sp 1
+As a special case, if \fIfiltergraph\fR is \fB$\fIword\fR then the value of
+the \fIword\fR environment variable is used; this is necessary if commas are
+present in the graph description, as mplayer uses them as a delimiter
+between filters.
+.sp 1
+.I NOTE:
+This filter is considered experimental, it may interact strangely with other
+filters.
+.sp 1
+.I EXAMPLE:
+.br
+overlay="movie=$small_video, scale=160:120 [ca]; [in] [ca] overlay=16:8"
+mplayer -vf lavfi='$overlay' $big_video
+.
+.TP
 .B kerndeint[=thresh[:map[:order[:sharp[:twoway]]]]]
 Donald Graft's adaptive kernel deinterlacer.
 Deinterlaces parts of a video if a configurable threshold is exceeded.