[FFmpeg-devel] [PATCH] mp: add filter description to filters.texi

[Stefano Sabatini]

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

diff --git a/doc/filters.texi b/doc/filters.texi
index 5681de4..6e38e4e 100644
--- a/doc/filters.texi
+++ b/doc/filters.texi
@@ -644,6 +644,104 @@ a float number which specifies chroma temporal strength, defaults to
 @var{luma_tmp}*@var{chroma_spatial}/@var{luma_spatial}
 @end table
 
+ at section mp
+
+Apply an MPlayer filter to the input video.
+
+This filter provides a wrapper around most of the filters of
+MPlayer/MEncoder.
+
+This wrapper is considered experimental, some of the wrapped filters
+may not work properly and we may drop support for them, as they will
+be implemented natively into FFmpeg. Thus you should avoid to depend
+on them when writing portable scripts.
+
+The filters accepts the parameters:
+ at var{filter_name}[:=]@var{filter_params}
+
+ at var{filter_name} is the name of a supported MPlayer filter,
+ at var{filter_params} is a string containing the parameters accepted by
+the named filter.
+
+Follow the list of the currently supported filters:
+ at table @var
+ at item 2xsai
+ at item blackframe
+ at item boxblur
+ at item cropdetect
+ at item decimate
+ at item delogo
+ at item denoise3d
+ at item detc
+ at item dint
+ at item divtc
+ at item down3dright
+ at item dsize
+ at item eq2
+ at item eq
+ at item field
+ at item fil
+ at item fixpts
+ at item framestep
+ at item fspp
+ at item geq
+ at item gradfun
+ at item harddup
+ at item hqdn3d
+ at item hue
+ at item il
+ at item ilpack
+ at item ivtc
+ at item kerndeint
+ at item mcdeint
+ at item mirror
+ at item noise
+ at item ow
+ at item palette
+ at item perspective
+ at item phase
+ at item pp7
+ at item pullup
+ at item qp
+ at item rectangle
+ at item remove_logo
+ at item rgbtest
+ at item rotate
+ at item sab
+ at item screenshot
+ at item smartblur
+ at item softpulldown
+ at item softskip
+ at item spp
+ at item swapuv
+ at item telecine
+ at item test
+ at item tile
+ at item tinterlace
+ at item unsharp
+ at item uspp
+ at item yuvcsp
+ at item yvu9
+ at end table
+
+The parameter syntax and semantics for the listed filters is the same
+of the corresponding MPlayer filters. For detailed instructions check
+the "VIDEO FILTERS" section in the MPlayer manual.
+
+Some examples follow:
+ at example
+# remove a logo by interpolating the surrounding pixels
+mp=delogo=200:200:80:20:1
+
+# adjust gamma, brightness, contrast
+mp=eq2=1.0:2:0.5
+
+# tweak hue and saturation
+mp=hue=100:-10
+ at end example
+
+See also mplayer(1), @url{http://www.mplayerhq.hu/}
+
 @section noformat
 
 Force libavfilter not to use any of the specified pixel formats for the
-- 
1.7.2.3