]> git.sesse.net Git - casparcg/blobdiff - ffmpeg 0.8/doc/ffmpeg.html
2.0. new dlls.
[casparcg] / ffmpeg 0.8 / doc / ffmpeg.html
index 298a47fce5c37966e8b1b5a0cf6fd0f7c1bfc9ba..02dc3791cda20ee847fc09a30d1e42e91573c934 100644 (file)
@@ -1,6 +1,6 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd">
 <html>
-<!-- Created on July 23, 2011 by texi2html 1.82
+<!-- Created on September 2, 2011 by texi2html 1.82
 texi2html was written by: 
             Lionel Cons <Lionel.Cons@cern.ch> (original author)
             Karl Berry  <karl@freefriends.org>
@@ -51,18 +51,19 @@ ul.toc {list-style: none}
 <ul class="toc">
   <li><a name="toc-Synopsis" href="#Synopsis">1. Synopsis</a></li>
   <li><a name="toc-Description" href="#Description">2. Description</a></li>
-  <li><a name="toc-Options-5" href="#Options-5">3. Options</a>
+  <li><a name="toc-Options-6" href="#Options-6">3. Options</a>
   <ul class="toc">
     <li><a name="toc-Generic-options" href="#Generic-options">3.1 Generic options</a></li>
-    <li><a name="toc-Main-options" href="#Main-options">3.2 Main options</a></li>
-    <li><a name="toc-Video-Options" href="#Video-Options">3.3 Video Options</a></li>
-    <li><a name="toc-Advanced-Video-Options" href="#Advanced-Video-Options">3.4 Advanced Video Options</a></li>
-    <li><a name="toc-Audio-Options" href="#Audio-Options">3.5 Audio Options</a></li>
-    <li><a name="toc-Advanced-Audio-options_003a" href="#Advanced-Audio-options_003a">3.6 Advanced Audio options:</a></li>
-    <li><a name="toc-Subtitle-options_003a" href="#Subtitle-options_003a">3.7 Subtitle options:</a></li>
-    <li><a name="toc-Audio_002fVideo-grab-options" href="#Audio_002fVideo-grab-options">3.8 Audio/Video grab options</a></li>
-    <li><a name="toc-Advanced-options" href="#Advanced-options">3.9 Advanced options</a></li>
-    <li><a name="toc-Preset-files" href="#Preset-files">3.10 Preset files</a></li>
+    <li><a name="toc-AVOptions" href="#AVOptions">3.2 AVOptions</a></li>
+    <li><a name="toc-Main-options" href="#Main-options">3.3 Main options</a></li>
+    <li><a name="toc-Video-Options" href="#Video-Options">3.4 Video Options</a></li>
+    <li><a name="toc-Advanced-Video-Options" href="#Advanced-Video-Options">3.5 Advanced Video Options</a></li>
+    <li><a name="toc-Audio-Options" href="#Audio-Options">3.6 Audio Options</a></li>
+    <li><a name="toc-Advanced-Audio-options_003a" href="#Advanced-Audio-options_003a">3.7 Advanced Audio options:</a></li>
+    <li><a name="toc-Subtitle-options_003a" href="#Subtitle-options_003a">3.8 Subtitle options:</a></li>
+    <li><a name="toc-Audio_002fVideo-grab-options" href="#Audio_002fVideo-grab-options">3.9 Audio/Video grab options</a></li>
+    <li><a name="toc-Advanced-options" href="#Advanced-options">3.10 Advanced options</a></li>
+    <li><a name="toc-Preset-files" href="#Preset-files">3.11 Preset files</a></li>
   </ul></li>
   <li><a name="toc-Tips" href="#Tips">4. Tips</a></li>
   <li><a name="toc-Examples" href="#Examples">5. Examples</a>
@@ -77,7 +78,7 @@ ul.toc {list-style: none}
   <ul class="toc">
     <li><a name="toc-rawvideo" href="#rawvideo">8.1 rawvideo</a>
     <ul class="toc">
-      <li><a name="toc-Options-2" href="#Options-2">8.1.1 Options</a></li>
+      <li><a name="toc-Options-1" href="#Options-1">8.1.1 Options</a></li>
     </ul>
 </li>
   </ul></li>
@@ -107,18 +108,18 @@ ul.toc {list-style: none}
   <ul class="toc">
     <li><a name="toc-libvpx" href="#libvpx">11.1 libvpx</a>
     <ul class="toc">
-      <li><a name="toc-Options-3" href="#Options-3">11.1.1 Options</a></li>
+      <li><a name="toc-Options-4" href="#Options-4">11.1.1 Options</a></li>
     </ul></li>
     <li><a name="toc-libx264" href="#libx264">11.2 libx264</a>
     <ul class="toc">
-      <li><a name="toc-Options-4" href="#Options-4">11.2.1 Options</a></li>
+      <li><a name="toc-Options-5" href="#Options-5">11.2.1 Options</a></li>
     </ul>
 </li>
   </ul></li>
   <li><a name="toc-Demuxers" href="#Demuxers">12. Demuxers</a>
   <ul class="toc">
     <li><a name="toc-image2" href="#image2">12.1 image2</a></li>
-    <li><a name="toc-applehttp" href="#applehttp">12.2 applehttp</a></li>
+    <li><a name="toc-applehttp-1" href="#applehttp-1">12.2 applehttp</a></li>
   </ul></li>
   <li><a name="toc-Muxers" href="#Muxers">13. Muxers</a>
   <ul class="toc">
@@ -126,7 +127,7 @@ ul.toc {list-style: none}
     <li><a name="toc-framecrc-1" href="#framecrc-1">13.2 framecrc</a></li>
     <li><a name="toc-image2-1" href="#image2-1">13.3 image2</a></li>
     <li><a name="toc-mpegts" href="#mpegts">13.4 mpegts</a></li>
-    <li><a name="toc-null" href="#null">13.5 null</a></li>
+    <li><a name="toc-null-1" href="#null-1">13.5 null</a></li>
     <li><a name="toc-matroska" href="#matroska">13.6 matroska</a></li>
   </ul></li>
   <li><a name="toc-Input-Devices" href="#Input-Devices">14. Input Devices</a>
@@ -136,17 +137,27 @@ ul.toc {list-style: none}
     <li><a name="toc-dv1394" href="#dv1394">14.3 dv1394</a></li>
     <li><a name="toc-fbdev" href="#fbdev">14.4 fbdev</a></li>
     <li><a name="toc-jack" href="#jack">14.5 jack</a></li>
-    <li><a name="toc-libdc1394" href="#libdc1394">14.6 libdc1394</a></li>
-    <li><a name="toc-openal" href="#openal">14.7 openal</a>
+    <li><a name="toc-lavfi" href="#lavfi">14.6 lavfi</a>
     <ul class="toc">
-      <li><a name="toc-Options-1" href="#Options-1">14.7.1 Options</a></li>
-      <li><a name="toc-Examples-2" href="#Examples-2">14.7.2 Examples</a></li>
+      <li><a name="toc-Options" href="#Options">14.6.1 Options</a></li>
+      <li><a name="toc-Examples-3" href="#Examples-3">14.6.2 Examples</a></li>
     </ul></li>
-    <li><a name="toc-oss" href="#oss">14.8 oss</a></li>
-    <li><a name="toc-sndio-1" href="#sndio-1">14.9 sndio</a></li>
-    <li><a name="toc-video4linux-and-video4linux2" href="#video4linux-and-video4linux2">14.10 video4linux and video4linux2</a></li>
-    <li><a name="toc-vfwcap" href="#vfwcap">14.11 vfwcap</a></li>
-    <li><a name="toc-x11grab" href="#x11grab">14.12 x11grab</a></li>
+    <li><a name="toc-libdc1394" href="#libdc1394">14.7 libdc1394</a></li>
+    <li><a name="toc-openal" href="#openal">14.8 openal</a>
+    <ul class="toc">
+      <li><a name="toc-Options-3" href="#Options-3">14.8.1 Options</a></li>
+      <li><a name="toc-Examples-2" href="#Examples-2">14.8.2 Examples</a></li>
+    </ul></li>
+    <li><a name="toc-oss" href="#oss">14.9 oss</a></li>
+    <li><a name="toc-sndio" href="#sndio">14.10 sndio</a></li>
+    <li><a name="toc-video4linux-and-video4linux2" href="#video4linux-and-video4linux2">14.11 video4linux and video4linux2</a></li>
+    <li><a name="toc-vfwcap" href="#vfwcap">14.12 vfwcap</a></li>
+    <li><a name="toc-x11grab" href="#x11grab">14.13 x11grab</a>
+    <ul class="toc">
+      <li><a name="toc-follow_005fmouse-AVOption" href="#follow_005fmouse-AVOption">14.13.1 <var>follow_mouse</var> AVOption</a></li>
+      <li><a name="toc-show_005fregion-AVOption" href="#show_005fregion-AVOption">14.13.2 <var>show_region</var> AVOption</a></li>
+    </ul>
+</li>
   </ul></li>
   <li><a name="toc-Output-Devices" href="#Output-Devices">15. Output Devices</a>
   <ul class="toc">
@@ -154,14 +165,14 @@ ul.toc {list-style: none}
     <li><a name="toc-oss-1" href="#oss-1">15.2 oss</a></li>
     <li><a name="toc-sdl" href="#sdl">15.3 sdl</a>
     <ul class="toc">
-      <li><a name="toc-Options" href="#Options">15.3.1 Options</a></li>
+      <li><a name="toc-Options-2" href="#Options-2">15.3.1 Options</a></li>
       <li><a name="toc-Examples-1" href="#Examples-1">15.3.2 Examples</a></li>
     </ul></li>
-    <li><a name="toc-sndio" href="#sndio">15.4 sndio</a></li>
+    <li><a name="toc-sndio-1" href="#sndio-1">15.4 sndio</a></li>
   </ul></li>
   <li><a name="toc-Protocols" href="#Protocols">16. Protocols</a>
   <ul class="toc">
-    <li><a name="toc-applehttp-1" href="#applehttp-1">16.1 applehttp</a></li>
+    <li><a name="toc-applehttp" href="#applehttp">16.1 applehttp</a></li>
     <li><a name="toc-concat" href="#concat">16.2 concat</a></li>
     <li><a name="toc-file" href="#file">16.3 file</a></li>
     <li><a name="toc-gopher" href="#gopher">16.4 gopher</a></li>
@@ -203,15 +214,21 @@ ul.toc {list-style: none}
   </ul></li>
   <li><a name="toc-Audio-Filters" href="#Audio-Filters">19. Audio Filters</a>
   <ul class="toc">
-    <li><a name="toc-anull" href="#anull">19.1 anull</a></li>
+    <li><a name="toc-aformat" href="#aformat">19.1 aformat</a></li>
+    <li><a name="toc-anull" href="#anull">19.2 anull</a></li>
+    <li><a name="toc-aresample" href="#aresample">19.3 aresample</a></li>
+    <li><a name="toc-ashowinfo" href="#ashowinfo">19.4 ashowinfo</a></li>
   </ul></li>
   <li><a name="toc-Audio-Sources" href="#Audio-Sources">20. Audio Sources</a>
   <ul class="toc">
-    <li><a name="toc-anullsrc" href="#anullsrc">20.1 anullsrc</a></li>
+    <li><a name="toc-abuffer" href="#abuffer">20.1 abuffer</a></li>
+    <li><a name="toc-amovie" href="#amovie">20.2 amovie</a></li>
+    <li><a name="toc-anullsrc" href="#anullsrc">20.3 anullsrc</a></li>
   </ul></li>
   <li><a name="toc-Audio-Sinks" href="#Audio-Sinks">21. Audio Sinks</a>
   <ul class="toc">
-    <li><a name="toc-anullsink" href="#anullsink">21.1 anullsink</a></li>
+    <li><a name="toc-abuffersink" href="#abuffersink">21.1 abuffersink</a></li>
+    <li><a name="toc-anullsink" href="#anullsink">21.2 anullsink</a></li>
   </ul></li>
   <li><a name="toc-Video-Filters" href="#Video-Filters">22. Video Filters</a>
   <ul class="toc">
@@ -220,52 +237,54 @@ ul.toc {list-style: none}
     <li><a name="toc-copy" href="#copy">22.3 copy</a></li>
     <li><a name="toc-crop" href="#crop">22.4 crop</a></li>
     <li><a name="toc-cropdetect" href="#cropdetect">22.5 cropdetect</a></li>
-    <li><a name="toc-drawbox" href="#drawbox">22.6 drawbox</a></li>
-    <li><a name="toc-drawtext" href="#drawtext">22.7 drawtext</a></li>
-    <li><a name="toc-fade" href="#fade">22.8 fade</a></li>
-    <li><a name="toc-fieldorder" href="#fieldorder">22.9 fieldorder</a></li>
-    <li><a name="toc-fifo" href="#fifo">22.10 fifo</a></li>
-    <li><a name="toc-format" href="#format">22.11 format</a></li>
-    <li><a name="toc-frei0r-1" href="#frei0r-1">22.12 frei0r</a></li>
-    <li><a name="toc-gradfun" href="#gradfun">22.13 gradfun</a></li>
-    <li><a name="toc-hflip" href="#hflip">22.14 hflip</a></li>
-    <li><a name="toc-hqdn3d" href="#hqdn3d">22.15 hqdn3d</a></li>
-    <li><a name="toc-lut_002c-lutrgb_002c-lutyuv" href="#lut_002c-lutrgb_002c-lutyuv">22.16 lut, lutrgb, lutyuv</a></li>
-    <li><a name="toc-mp" href="#mp">22.17 mp</a></li>
-    <li><a name="toc-negate" href="#negate">22.18 negate</a></li>
-    <li><a name="toc-noformat" href="#noformat">22.19 noformat</a></li>
-    <li><a name="toc-null-1" href="#null-1">22.20 null</a></li>
-    <li><a name="toc-ocv" href="#ocv">22.21 ocv</a>
+    <li><a name="toc-delogo" href="#delogo">22.6 delogo</a></li>
+    <li><a name="toc-drawbox" href="#drawbox">22.7 drawbox</a></li>
+    <li><a name="toc-drawtext" href="#drawtext">22.8 drawtext</a></li>
+    <li><a name="toc-fade" href="#fade">22.9 fade</a></li>
+    <li><a name="toc-fieldorder" href="#fieldorder">22.10 fieldorder</a></li>
+    <li><a name="toc-fifo" href="#fifo">22.11 fifo</a></li>
+    <li><a name="toc-format" href="#format">22.12 format</a></li>
+    <li><a name="toc-frei0r-1" href="#frei0r-1">22.13 frei0r</a></li>
+    <li><a name="toc-gradfun" href="#gradfun">22.14 gradfun</a></li>
+    <li><a name="toc-hflip" href="#hflip">22.15 hflip</a></li>
+    <li><a name="toc-hqdn3d" href="#hqdn3d">22.16 hqdn3d</a></li>
+    <li><a name="toc-lut_002c-lutrgb_002c-lutyuv" href="#lut_002c-lutrgb_002c-lutyuv">22.17 lut, lutrgb, lutyuv</a></li>
+    <li><a name="toc-mp" href="#mp">22.18 mp</a></li>
+    <li><a name="toc-negate" href="#negate">22.19 negate</a></li>
+    <li><a name="toc-noformat" href="#noformat">22.20 noformat</a></li>
+    <li><a name="toc-null" href="#null">22.21 null</a></li>
+    <li><a name="toc-ocv" href="#ocv">22.22 ocv</a>
     <ul class="toc">
-      <li><a name="toc-dilate-1" href="#dilate-1">22.21.1 dilate</a></li>
-      <li><a name="toc-erode" href="#erode">22.21.2 erode</a></li>
-      <li><a name="toc-smooth" href="#smooth">22.21.3 smooth</a></li>
+      <li><a name="toc-dilate-1" href="#dilate-1">22.22.1 dilate</a></li>
+      <li><a name="toc-erode" href="#erode">22.22.2 erode</a></li>
+      <li><a name="toc-smooth" href="#smooth">22.22.3 smooth</a></li>
     </ul></li>
-    <li><a name="toc-overlay" href="#overlay">22.22 overlay</a></li>
-    <li><a name="toc-pad" href="#pad">22.23 pad</a></li>
-    <li><a name="toc-pixdesctest" href="#pixdesctest">22.24 pixdesctest</a></li>
-    <li><a name="toc-scale" href="#scale">22.25 scale</a></li>
-    <li><a name="toc-select" href="#select">22.26 select</a></li>
-    <li><a name="toc-setdar-1" href="#setdar-1">22.27 setdar</a></li>
-    <li><a name="toc-setpts" href="#setpts">22.28 setpts</a></li>
-    <li><a name="toc-setsar-1" href="#setsar-1">22.29 setsar</a></li>
-    <li><a name="toc-settb" href="#settb">22.30 settb</a></li>
-    <li><a name="toc-showinfo" href="#showinfo">22.31 showinfo</a></li>
-    <li><a name="toc-slicify" href="#slicify">22.32 slicify</a></li>
-    <li><a name="toc-split" href="#split">22.33 split</a></li>
-    <li><a name="toc-transpose" href="#transpose">22.34 transpose</a></li>
-    <li><a name="toc-unsharp" href="#unsharp">22.35 unsharp</a></li>
-    <li><a name="toc-vflip" href="#vflip">22.36 vflip</a></li>
-    <li><a name="toc-yadif" href="#yadif">22.37 yadif</a></li>
+    <li><a name="toc-overlay" href="#overlay">22.23 overlay</a></li>
+    <li><a name="toc-pad" href="#pad">22.24 pad</a></li>
+    <li><a name="toc-pixdesctest" href="#pixdesctest">22.25 pixdesctest</a></li>
+    <li><a name="toc-scale" href="#scale">22.26 scale</a></li>
+    <li><a name="toc-select" href="#select">22.27 select</a></li>
+    <li><a name="toc-setdar-1" href="#setdar-1">22.28 setdar</a></li>
+    <li><a name="toc-setpts" href="#setpts">22.29 setpts</a></li>
+    <li><a name="toc-setsar-1" href="#setsar-1">22.30 setsar</a></li>
+    <li><a name="toc-settb" href="#settb">22.31 settb</a></li>
+    <li><a name="toc-showinfo" href="#showinfo">22.32 showinfo</a></li>
+    <li><a name="toc-slicify" href="#slicify">22.33 slicify</a></li>
+    <li><a name="toc-split" href="#split">22.34 split</a></li>
+    <li><a name="toc-transpose" href="#transpose">22.35 transpose</a></li>
+    <li><a name="toc-unsharp" href="#unsharp">22.36 unsharp</a></li>
+    <li><a name="toc-vflip" href="#vflip">22.37 vflip</a></li>
+    <li><a name="toc-yadif" href="#yadif">22.38 yadif</a></li>
   </ul></li>
   <li><a name="toc-Video-Sources" href="#Video-Sources">23. Video Sources</a>
   <ul class="toc">
     <li><a name="toc-buffer" href="#buffer">23.1 buffer</a></li>
     <li><a name="toc-color" href="#color">23.2 color</a></li>
     <li><a name="toc-movie" href="#movie">23.3 movie</a></li>
-    <li><a name="toc-nullsrc" href="#nullsrc">23.4 nullsrc</a></li>
-    <li><a name="toc-frei0r_005fsrc" href="#frei0r_005fsrc">23.5 frei0r_src</a></li>
-    <li><a name="toc-rgbtestsrc_002c-testsrc" href="#rgbtestsrc_002c-testsrc">23.6 rgbtestsrc, testsrc</a></li>
+    <li><a name="toc-mptestsrc" href="#mptestsrc">23.4 mptestsrc</a></li>
+    <li><a name="toc-nullsrc" href="#nullsrc">23.5 nullsrc</a></li>
+    <li><a name="toc-frei0r_005fsrc" href="#frei0r_005fsrc">23.6 frei0r_src</a></li>
+    <li><a name="toc-rgbtestsrc_002c-testsrc" href="#rgbtestsrc_002c-testsrc">23.7 rgbtestsrc, testsrc</a></li>
   </ul></li>
   <li><a name="toc-Video-Sinks" href="#Video-Sinks">24. Video Sinks</a>
   <ul class="toc">
@@ -327,8 +346,8 @@ uses the same audio and video parameters for the outputs as the one
 specified for the inputs.
 </p>
 
-<a name="Options-5"></a>
-<h1 class="chapter"><a href="ffmpeg.html#toc-Options-5">3. Options</a></h1>
+<a name="Options-6"></a>
+<h1 class="chapter"><a href="ffmpeg.html#toc-Options-6">3. Options</a></h1>
 
 <p>All the numerical options, if not specified otherwise, accept in input
 a string representing a number, which may contain one of the
@@ -442,8 +461,51 @@ will be dropped in a following FFmpeg version.
 </dd>
 </dl>
 
+<a name="AVOptions"></a>
+<h2 class="section"><a href="ffmpeg.html#toc-AVOptions">3.2 AVOptions</a></h2>
+
+<p>These options are provided directly by the libavformat, libavdevice and
+libavcodec libraries. To see the list of available AVOptions, use the
+&lsquo;<samp>-help</samp>&rsquo; option. They are separated into two categories:
+</p><dl compact="compact">
+<dt> &lsquo;<samp>generic</samp>&rsquo;</dt>
+<dd><p>These options can be set for any container, codec or device. Generic options are
+listed under AVFormatContext options for containers/devices and under
+AVCodecContext options for codecs.
+</p></dd>
+<dt> &lsquo;<samp>private</samp>&rsquo;</dt>
+<dd><p>These options are specific to the given container, device or codec. Private
+options are listed under their corresponding containers/devices/codecs.
+</p></dd>
+</dl>
+
+<p>For example to write an ID3v2.3 header instead of a default ID3v2.4 to
+an MP3 file, use the &lsquo;<samp>id3v2_version</samp>&rsquo; private option of the MP3
+muxer:
+</p><table><tr><td>&nbsp;</td><td><pre class="example">ffmpeg -i input.flac -id3v2_version 3 out.mp3
+</pre></td></tr></table>
+
+<p>You can precisely specify which stream(s) should the codec AVOption apply to by
+appending a stream specifier of the form
+&lsquo;<samp>[:<var>stream_type</var>][:<var>stream_index</var>]</samp>&rsquo; to the option name.
+<var>stream_type</var> is &rsquo;v&rsquo; for video, &rsquo;a&rsquo; for audio and &rsquo;s&rsquo; for subtitle streams.
+<var>stream_index</var> is a global stream index when <var>stream_type</var> isn&rsquo;t
+given, otherwise it counts streams of the given type only. As always, the index
+is zero-based. For example
+</p><table><tr><td>&nbsp;</td><td><pre class="example">-foo -- applies to all applicable streams
+-foo:v -- applies to all video streams
+-foo:a:2 -- applies to the third audio stream
+-foo:0 -- applies to the first stream
+</pre></td></tr></table>
+
+<p>Note -nooption syntax cannot be used for boolean AVOptions, use -option
+0/-option 1.
+</p>
+<p>Note2 old undocumented way of specifying per-stream AVOptions by prepending
+v/a/s to the options name is now obsolete and will be removed soon.
+</p>
 <a name="Main-options"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-Main-options">3.2 Main options</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-Main-options">3.3 Main options</a></h2>
 
 <dl compact="compact">
 <dt> &lsquo;<samp>-f <var>fmt</var></samp>&rsquo;</dt>
@@ -540,7 +602,7 @@ they do not conflict with the standard, as in:
 </dl>
 
 <a name="Video-Options"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-Video-Options">3.3 Video Options</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-Video-Options">3.4 Video Options</a></h2>
 
 <dl compact="compact">
 <dt> &lsquo;<samp>-vframes <var>number</var></samp>&rsquo;</dt>
@@ -741,7 +803,7 @@ also sources and sinks).
 </dl>
 
 <a name="Advanced-Video-Options"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-Advanced-Video-Options">3.4 Advanced Video Options</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-Advanced-Video-Options">3.5 Advanced Video Options</a></h2>
 
 <dl compact="compact">
 <dt> &lsquo;<samp>-pix_fmt <var>format</var></samp>&rsquo;</dt>
@@ -951,7 +1013,7 @@ Available methods are (from lowest to best quality):
 <dd><p>FF_ER_AGGRESSIVE
 </p></dd>
 <dt> &lsquo;<samp>4</samp>&rsquo;</dt>
-<dd><p>FF_ER_VERY_AGGRESSIVE
+<dd><p>FF_ER_EXPLODE
 </p></dd>
 </dl>
 
@@ -1052,7 +1114,7 @@ The timestamps must be specified in ascending order.
 </dl>
 
 <a name="Audio-Options"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-Audio-Options">3.5 Audio Options</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-Audio-Options">3.6 Audio Options</a></h2>
 
 <dl compact="compact">
 <dt> &lsquo;<samp>-aframes <var>number</var></samp>&rsquo;</dt>
@@ -1098,7 +1160,7 @@ can override the mapping using <code>-map</code> as usual.
 </dl>
 
 <a name="Advanced-Audio-options_003a"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-Advanced-Audio-options_003a">3.6 Advanced Audio options:</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-Advanced-Audio-options_003a">3.7 Advanced Audio options:</a></h2>
 
 <dl compact="compact">
 <dt> &lsquo;<samp>-atag <var>fourcc/tag</var></samp>&rsquo;</dt>
@@ -1142,7 +1204,7 @@ can override the mapping using <code>-map</code> as usual.
 </dl>
 
 <a name="Subtitle-options_003a"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-Subtitle-options_003a">3.7 Subtitle options:</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-Subtitle-options_003a">3.8 Subtitle options:</a></h2>
 
 <dl compact="compact">
 <dt> &lsquo;<samp>-scodec <var>codec</var></samp>&rsquo;</dt>
@@ -1165,7 +1227,7 @@ can override the mapping using <code>-map</code> as usual.
 </dl>
 
 <a name="Audio_002fVideo-grab-options"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-Audio_002fVideo-grab-options">3.8 Audio/Video grab options</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-Audio_002fVideo-grab-options">3.9 Audio/Video grab options</a></h2>
 
 <dl compact="compact">
 <dt> &lsquo;<samp>-vc <var>channel</var></samp>&rsquo;</dt>
@@ -1180,7 +1242,7 @@ can override the mapping using <code>-map</code> as usual.
 </dl>
 
 <a name="Advanced-options"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-Advanced-options">3.9 Advanced options</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-Advanced-options">3.10 Advanced options</a></h2>
 
 <dl compact="compact">
 <dt> &lsquo;<samp>-map <var>input_file_id</var>.<var>input_stream_id</var>[:<var>sync_file_id</var>.<var>sync_stream_id</var>]</samp>&rsquo;</dt>
@@ -1274,7 +1336,7 @@ it will usually display as 0 if not supported.
 <dt> &lsquo;<samp>-loop_input</samp>&rsquo;</dt>
 <dd><p>Loop over the input stream. Currently it works only for image
 streams. This option is used for automatic FFserver testing.
-This option is deprecated, use -loop.
+This option is deprecated, use -loop 1.
 </p></dd>
 <dt> &lsquo;<samp>-loop_output <var>number_of_times</var></samp>&rsquo;</dt>
 <dd><p>Repeatedly loop output for formats that support looping such as animated GIF
@@ -1348,7 +1410,7 @@ an output mpegts file:
 </dl>
 
 <a name="Preset-files"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-Preset-files">3.10 Preset files</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-Preset-files">3.11 Preset files</a></h2>
 
 <p>A preset file contains a sequence of <var>option</var>=<var>value</var> pairs,
 one for each line, specifying a sequence of options which would be
@@ -1458,9 +1520,31 @@ the DISPLAY environment variable.
 <table><tr><td>&nbsp;</td><td><pre class="example">ffmpeg -f x11grab -s cif -r 25 -i :0.0+10,20 /tmp/out.mpg
 </pre></td></tr></table>
 
-<p>0.0 is display.screen number of your X11 server, same as the DISPLAY environment
-variable. 10 is the x-offset and 20 the y-offset for the grabbing.
+<p>10 is the x-offset and 20 the y-offset for the grabbing.
 </p>
+<table><tr><td>&nbsp;</td><td><pre class="example">ffmpeg -f x11grab -follow_mouse centered -s cif -r 25 -i :0.0 /tmp/out.mpg
+</pre></td></tr></table>
+
+<p>The grabbing region follows the mouse pointer, which stays at the center of
+region.
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">ffmpeg -f x11grab -follow_mouse 100 -s cif -r 25 -i :0.0 /tmp/out.mpg
+</pre></td></tr></table>
+
+<p>Only follows when mouse pointer reaches within 100 pixels to the edge of
+region.
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">ffmpeg -f x11grab -show_region 1 -s cif -r 25 -i :0.0+10,20 /tmp/out.mpg
+</pre></td></tr></table>
+
+<p>The grabbing region will be indicated on screen.
+</p>
+<table><tr><td>&nbsp;</td><td><pre class="example">ffmpeg -f x11grab -follow_mouse centered -show_region 1 -s cif -r 25 -i :0.0 /tmp/out.mpg
+</pre></td></tr></table>
+
+<p>The grabbing region indication will follow the mouse pointer.
+</p>
+
 <a name="Video-and-Audio-file-format-conversion"></a>
 <h2 class="section"><a href="ffmpeg.html#toc-Video-and-Audio-file-format-conversion">5.3 Video and Audio file format conversion</a></h2>
 
@@ -1803,8 +1887,8 @@ follows.
 </p>
 <p>This decoder decodes rawvideo streams.
 </p>
-<a name="Options-2"></a>
-<h3 class="subsection"><a href="ffmpeg.html#toc-Options-2">8.1.1 Options</a></h3>
+<a name="Options-1"></a>
+<h3 class="subsection"><a href="ffmpeg.html#toc-Options-1">8.1.1 Options</a></h3>
 
 <dl compact="compact">
 <dt> &lsquo;<samp>top <var>top_field_first</var></samp>&rsquo;</dt>
@@ -2334,8 +2418,8 @@ follows.
 <p>Requires the presence of the libvpx headers and library during configuration.
 You need to explicitly configure the build with <code>--enable-libvpx</code>.
 </p>
-<a name="Options-3"></a>
-<h3 class="subsection"><a href="ffmpeg.html#toc-Options-3">11.1.1 Options</a></h3>
+<a name="Options-4"></a>
+<h3 class="subsection"><a href="ffmpeg.html#toc-Options-4">11.1.1 Options</a></h3>
 
 <p>Mapping from FFmpeg to libvpx options with conversion notes in parentheses.
 </p>
@@ -2481,8 +2565,8 @@ libx264.
 configuration. You need to explicitly configure the build with
 <code>--enable-libx264</code>.
 </p>
-<a name="Options-4"></a>
-<h3 class="subsection"><a href="ffmpeg.html#toc-Options-4">11.2.1 Options</a></h3>
+<a name="Options-5"></a>
+<h3 class="subsection"><a href="ffmpeg.html#toc-Options-5">11.2.1 Options</a></h3>
 
 <dl compact="compact">
 <dt> &lsquo;<samp>preset <var>preset_name</var></samp>&rsquo;</dt>
@@ -2599,8 +2683,8 @@ second:
 </p><table><tr><td>&nbsp;</td><td><pre class="example">ffmpeg -f image2 -i img.jpeg img.png
 </pre></td></tr></table>
 
-<a name="applehttp"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-applehttp">12.2 applehttp</a></h2>
+<a name="applehttp-1"></a>
+<h2 class="section"><a href="ffmpeg.html#toc-applehttp-1">12.2 applehttp</a></h2>
 
 <p>Apple HTTP Live Streaming demuxer.
 </p>
@@ -2800,8 +2884,8 @@ and <code>service_name</code>. If they are not set the default for
      -y out.ts
 </pre></td></tr></table>
 
-<a name="null"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-null">13.5 null</a></h2>
+<a name="null-1"></a>
+<h2 class="section"><a href="ffmpeg.html#toc-null-1">13.5 null</a></h2>
 
 <p>Null muxer.
 </p>
@@ -3034,13 +3118,67 @@ $ jack_connect metro:120_bpm ffmpeg:input_1
 <p>For more information read:
 <a href="http://jackaudio.org/">http://jackaudio.org/</a>
 </p>
+<a name="lavfi"></a>
+<h2 class="section"><a href="ffmpeg.html#toc-lavfi">14.6 lavfi</a></h2>
+
+<p>Libavfilter input virtual device.
+</p>
+<p>This input device reads data from the open output pads of a libavfilter
+filtergraph.
+</p>
+<p>For each filtergraph open output, the input device will create a
+corresponding stream which is mapped to the generated output. Currently
+only video data is supported. The filtergraph is specified through the
+option &lsquo;<samp>graph</samp>&rsquo;.
+</p>
+<p>To enable this input device, you need to configure your build with
+<code>--enable-libavfilter</code>.
+</p>
+<a name="Options"></a>
+<h3 class="subsection"><a href="ffmpeg.html#toc-Options">14.6.1 Options</a></h3>
+
+<dl compact="compact">
+<dt> &lsquo;<samp>graph</samp>&rsquo;</dt>
+<dd><p>Specify the filtergraph to use as input. Each video open output must be
+labelled by a unique string of the form &quot;out<var>N</var>&quot;, where <var>N</var> is a
+number starting from 0 corresponding to the mapped input stream
+generated by the device.
+The first unlabelled output is automatically assigned to the &quot;out0&quot;
+label, but all the others need to be specified explicitely.
+</p>
+<p>If not specified defaults to the filename specified for the input
+device.
+</p></dd>
+</dl>
+
+<a name="Examples-3"></a>
+<h3 class="subsection"><a href="ffmpeg.html#toc-Examples-3">14.6.2 Examples</a></h3>
+
+<ul>
+<li>
+Create a color video stream and play it back with &lsquo;<tt>ffplay</tt>&rsquo;:
+<table><tr><td>&nbsp;</td><td><pre class="example">ffplay -f lavfi -graph &quot;color=pink [out0]&quot; dummy
+</pre></td></tr></table>
+
+</li><li>
+As the previous example, but use filename for specifying the graph
+description, and omit the &quot;out0&quot; label:
+<table><tr><td>&nbsp;</td><td><pre class="example">ffplay -f lavfi color=pink
+</pre></td></tr></table>
+
+</li><li>
+Create three different video test filtered sources and play them:
+<table><tr><td>&nbsp;</td><td><pre class="example">ffplay -f lavfi -graph &quot;testsrc [out0]; testsrc,hflip [out1]; testsrc,negate [out2]&quot; test3
+</pre></td></tr></table>
+</li></ul>
+
 <a name="libdc1394"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-libdc1394">14.6 libdc1394</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-libdc1394">14.7 libdc1394</a></h2>
 
 <p>IIDC1394 input device, based on libdc1394 and libraw1394.
 </p>
 <a name="openal"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-openal">14.7 openal</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-openal">14.8 openal</a></h2>
 
 <p>The OpenAL input device provides audio capture on all systems with a
 working OpenAL 1.1 implementation.
@@ -3083,8 +3221,8 @@ filename. If the empty string is provided, the device will
 automatically select the default device. You can get the list of the
 supported devices by using the option <var>list_devices</var>.
 </p>
-<a name="Options-1"></a>
-<h3 class="subsection"><a href="ffmpeg.html#toc-Options-1">14.7.1 Options</a></h3>
+<a name="Options-3"></a>
+<h3 class="subsection"><a href="ffmpeg.html#toc-Options-3">14.8.1 Options</a></h3>
 
 <dl compact="compact">
 <dt> &lsquo;<samp>channels</samp>&rsquo;</dt>
@@ -3112,7 +3250,7 @@ Defaults to &lsquo;<samp>false</samp>&rsquo;.
 </dl>
 
 <a name="Examples-2"></a>
-<h3 class="subsection"><a href="ffmpeg.html#toc-Examples-2">14.7.2 Examples</a></h3>
+<h3 class="subsection"><a href="ffmpeg.html#toc-Examples-2">14.8.2 Examples</a></h3>
 
 <p>Print the list of OpenAL supported devices and exit:
 </p><table><tr><td>&nbsp;</td><td><pre class="example">$ ffmpeg -list_devices true -f openal -i dummy out.ogg
@@ -3134,7 +3272,7 @@ within the same &lsquo;<tt>ffmpeg</tt>&rsquo; command:
 try the latest OpenAL Soft if the above does not work.
 </p>
 <a name="oss"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-oss">14.8 oss</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-oss">14.9 oss</a></h2>
 
 <p>Open Sound System input device.
 </p>
@@ -3150,8 +3288,8 @@ command:
 <p>For more information about OSS see:
 <a href="http://manuals.opensound.com/usersguide/dsp.html">http://manuals.opensound.com/usersguide/dsp.html</a>
 </p>
-<a name="sndio-1"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-sndio-1">14.9 sndio</a></h2>
+<a name="sndio"></a>
+<h2 class="section"><a href="ffmpeg.html#toc-sndio">14.10 sndio</a></h2>
 
 <p>sndio input device.
 </p>
@@ -3168,7 +3306,7 @@ command:
 </pre></td></tr></table>
 
 <a name="video4linux-and-video4linux2"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-video4linux-and-video4linux2">14.10 video4linux and video4linux2</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-video4linux-and-video4linux2">14.11 video4linux and video4linux2</a></h2>
 
 <p>Video4Linux and Video4Linux2 input video devices.
 </p>
@@ -3207,7 +3345,7 @@ ffmpeg -f video4linux2 -i /dev/video0 out.mpeg
 </pre></td></tr></table>
 
 <a name="vfwcap"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-vfwcap">14.11 vfwcap</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-vfwcap">14.12 vfwcap</a></h2>
 
 <p>VfW (Video for Windows) capture input device.
 </p>
@@ -3216,7 +3354,7 @@ ffmpeg -f video4linux2 -i /dev/video0 out.mpeg
 other filename will be interpreted as device number 0.
 </p>
 <a name="x11grab"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-x11grab">14.12 x11grab</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-x11grab">14.13 x11grab</a></h2>
 
 <p>X11 video input device.
 </p>
@@ -3244,7 +3382,44 @@ properties of your X11 display (e.g. grep for &quot;name&quot; or &quot;dimensio
 </p><table><tr><td>&nbsp;</td><td><pre class="example">ffmpeg -f x11grab -r 25 -s cif -i :0.0 out.mpg
 
 # Grab at position 10,20.
-ffmpeg -f x11grab -25 -s cif -i :0.0+10,20 out.mpg
+ffmpeg -f x11grab -r 25 -s cif -i :0.0+10,20 out.mpg
+</pre></td></tr></table>
+
+<a name="follow_005fmouse-AVOption"></a>
+<h3 class="subsection"><a href="ffmpeg.html#toc-follow_005fmouse-AVOption">14.13.1 <var>follow_mouse</var> AVOption</a></h3>
+
+<p>The syntax is:
+</p><table><tr><td>&nbsp;</td><td><pre class="example">-follow_mouse centered|<var>PIXELS</var>
+</pre></td></tr></table>
+
+<p>When it is specified with &quot;centered&quot;, the grabbing region follows the mouse
+pointer and keeps the pointer at the center of region; otherwise, the region
+follows only when the mouse pointer reaches within <var>PIXELS</var> (greater than
+zero) to the edge of region.
+</p>
+<p>For example:
+</p><table><tr><td>&nbsp;</td><td><pre class="example">ffmpeg -f x11grab -follow_mouse centered -r 25 -s cif -i :0.0 out.mpg
+
+# Follows only when the mouse pointer reaches within 100 pixels to edge
+ffmpeg -f x11grab -follow_mouse 100 -r 25 -s cif -i :0.0 out.mpg
+</pre></td></tr></table>
+
+<a name="show_005fregion-AVOption"></a>
+<h3 class="subsection"><a href="ffmpeg.html#toc-show_005fregion-AVOption">14.13.2 <var>show_region</var> AVOption</a></h3>
+
+<p>The syntax is:
+</p><table><tr><td>&nbsp;</td><td><pre class="example">-show_region 1
+</pre></td></tr></table>
+
+<p>If <var>show_region</var> AVOption is specified with <var>1</var>, then the grabbing
+region will be indicated on screen. With this option, it&rsquo;s easy to know what is
+being grabbed if only a portion of the screen is grabbed.
+</p>
+<p>For example:
+</p><table><tr><td>&nbsp;</td><td><pre class="example">ffmpeg -f x11grab -show_region 1 -r 25 -s cif -i :0.0+10,20 out.mpg
+
+# With follow_mouse
+ffmpeg -f x11grab -follow_mouse centered -show_region 1  -r 25 -s cif -i :0.0 out.mpg
 </pre></td></tr></table>
 
 <a name="Output-Devices"></a>
@@ -3292,8 +3467,8 @@ when configuring your build.
 <p>For more information about SDL, check:
 <a href="http://www.libsdl.org/">http://www.libsdl.org/</a>
 </p>
-<a name="Options"></a>
-<h3 class="subsection"><a href="ffmpeg.html#toc-Options">15.3.1 Options</a></h3>
+<a name="Options-2"></a>
+<h3 class="subsection"><a href="ffmpeg.html#toc-Options-2">15.3.1 Options</a></h3>
 
 <dl compact="compact">
 <dt> &lsquo;<samp>window_title</samp>&rsquo;</dt>
@@ -3321,8 +3496,8 @@ SDL window, forcing its size to the qcif format:
 </p><table><tr><td>&nbsp;</td><td><pre class="example">ffmpeg -i INPUT -vcodec rawvideo -pix_fmt yuv420p -window_size qcif -f sdl &quot;SDL output&quot;
 </pre></td></tr></table>
 
-<a name="sndio"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-sndio">15.4 sndio</a></h2>
+<a name="sndio-1"></a>
+<h2 class="section"><a href="ffmpeg.html#toc-sndio-1">15.4 sndio</a></h2>
 
 <p>sndio audio output device.
 </p>
@@ -3347,8 +3522,8 @@ supported protocols.
 </p>
 <p>A description of the currently available protocols follows.
 </p>
-<a name="applehttp-1"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-applehttp-1">16.1 applehttp</a></h2>
+<a name="applehttp"></a>
+<h2 class="section"><a href="ffmpeg.html#toc-applehttp">16.1 applehttp</a></h2>
 
 <p>Read Apple HTTP Live Streaming compliant segmented stream as
 a uniform one. The M3U8 playlists describing the segments can be
@@ -3914,8 +4089,8 @@ output pads is called a &quot;sink&quot;.
 
 <p>A filtergraph can be represented using a textual representation, which
 is recognized by the <code>-vf</code> and <code>-af</code> options of the ff*
-tools, and by the <code>av_parse_graph()</code> function defined in
-&lsquo;<tt>libavfilter/avfiltergraph</tt>&rsquo;.
+tools, and by the <code>avfilter_graph_parse()</code> function defined in
+&lsquo;<tt>libavfilter/avfiltergraph.h</tt>&rsquo;.
 </p>
 <p>A filterchain consists of a sequence of connected filters, each one
 connected to the previous one in the sequence. A filterchain is
@@ -3992,19 +4167,197 @@ build.
 </p>
 <p>Below is a description of the currently available audio filters.
 </p>
+<a name="aformat"></a>
+<h2 class="section"><a href="ffmpeg.html#toc-aformat">19.1 aformat</a></h2>
+
+<p>Convert the input audio to one of the specified formats. The framework will
+negotiate the most appropriate format to minimize conversions.
+</p>
+<p>The filter accepts three lists of formats, separated by &quot;:&quot;, in the form:
+&quot;<var>sample_formats</var>:<var>channel_layouts</var>:<var>packing_formats</var>&quot;.
+</p>
+<p>Elements in each list are separated by &quot;,&quot; which has to be escaped in the
+filtergraph specification.
+</p>
+<p>The special parameter &quot;all&quot;, in place of a list of elements, signifies all
+supported formats.
+</p>
+<p>Some examples follow:
+</p><table><tr><td>&nbsp;</td><td><pre class="example">aformat=u8\\,s16:mono:packed
+
+aformat=s16:mono\\,stereo:all
+</pre></td></tr></table>
+
 <a name="anull"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-anull">19.1 anull</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-anull">19.2 anull</a></h2>
 
 <p>Pass the audio source unchanged to the output.
 </p>
+<a name="aresample"></a>
+<h2 class="section"><a href="ffmpeg.html#toc-aresample">19.3 aresample</a></h2>
+
+<p>Resample the input audio to the specified sample rate.
+</p>
+<p>The filter accepts exactly one parameter, the output sample rate. If not
+specified then the filter will automatically convert between its input
+and output sample rates.
+</p>
+<p>For example, to resample the input audio to 44100Hz:
+</p><table><tr><td>&nbsp;</td><td><pre class="example">aresample=44100
+</pre></td></tr></table>
+
+<a name="ashowinfo"></a>
+<h2 class="section"><a href="ffmpeg.html#toc-ashowinfo">19.4 ashowinfo</a></h2>
+
+<p>Show a line containing various information for each input audio frame.
+The input audio is not modified.
+</p>
+<p>The shown line contains a sequence of key/value pairs of the form
+<var>key</var>:<var>value</var>.
+</p>
+<p>A description of each shown parameter follows:
+</p>
+<dl compact="compact">
+<dt> &lsquo;<samp>n</samp>&rsquo;</dt>
+<dd><p>sequential number of the input frame, starting from 0
+</p>
+</dd>
+<dt> &lsquo;<samp>pts</samp>&rsquo;</dt>
+<dd><p>presentation TimeStamp of the input frame, expressed as a number of
+time base units. The time base unit depends on the filter input pad, and
+is usually 1/<var>sample_rate</var>.
+</p>
+</dd>
+<dt> &lsquo;<samp>pts_time</samp>&rsquo;</dt>
+<dd><p>presentation TimeStamp of the input frame, expressed as a number of
+seconds
+</p>
+</dd>
+<dt> &lsquo;<samp>pos</samp>&rsquo;</dt>
+<dd><p>position of the frame in the input stream, -1 if this information in
+unavailable and/or meanigless (for example in case of synthetic audio)
+</p>
+</dd>
+<dt> &lsquo;<samp>fmt</samp>&rsquo;</dt>
+<dd><p>sample format name
+</p>
+</dd>
+<dt> &lsquo;<samp>chlayout</samp>&rsquo;</dt>
+<dd><p>channel layout description
+</p>
+</dd>
+<dt> &lsquo;<samp>nb_samples</samp>&rsquo;</dt>
+<dd><p>number of samples (per each channel) contained in the filtered frame
+</p>
+</dd>
+<dt> &lsquo;<samp>rate</samp>&rsquo;</dt>
+<dd><p>sample rate for the audio frame
+</p>
+</dd>
+<dt> &lsquo;<samp>planar</samp>&rsquo;</dt>
+<dd><p>if the packing format is planar, 0 if packed
+</p>
+</dd>
+<dt> &lsquo;<samp>checksum</samp>&rsquo;</dt>
+<dd><p>Adler-32 checksum of all the planes of the input frame
+</p>
+</dd>
+<dt> &lsquo;<samp>plane_checksum</samp>&rsquo;</dt>
+<dd><p>Adler-32 checksum for each input frame plane, expressed in the form
+&quot;[<var>c0</var> <var>c1</var> <var>c2</var> <var>c3</var> <var>c4</var> <var>c5</var> <var>c6</var> <var>c7</var>]&quot;
+</p></dd>
+</dl>
+
 
 <a name="Audio-Sources"></a>
 <h1 class="chapter"><a href="ffmpeg.html#toc-Audio-Sources">20. Audio Sources</a></h1>
 
 <p>Below is a description of the currently available audio sources.
 </p>
+<a name="abuffer"></a>
+<h2 class="section"><a href="ffmpeg.html#toc-abuffer">20.1 abuffer</a></h2>
+
+<p>Buffer audio frames, and make them available to the filter chain.
+</p>
+<p>This source is mainly intended for a programmatic use, in particular
+through the interface defined in &lsquo;<tt>libavfilter/asrc_abuffer.h</tt>&rsquo;.
+</p>
+<p>It accepts the following mandatory parameters:
+<var>sample_rate</var>:<var>sample_fmt</var>:<var>channel_layout</var>:<var>packing</var>
+</p>
+<dl compact="compact">
+<dt> &lsquo;<samp>sample_rate</samp>&rsquo;</dt>
+<dd><p>The sample rate of the incoming audio buffers.
+</p>
+</dd>
+<dt> &lsquo;<samp>sample_fmt</samp>&rsquo;</dt>
+<dd><p>The sample format of the incoming audio buffers.
+Either a sample format name or its corresponging integer representation from
+the enum AVSampleFormat in &lsquo;<tt>libavutil/samplefmt.h</tt>&rsquo;
+</p>
+</dd>
+<dt> &lsquo;<samp>channel_layout</samp>&rsquo;</dt>
+<dd><p>The channel layout of the incoming audio buffers.
+Either a channel layout name from channel_layout_map in
+&lsquo;<tt>libavutil/audioconvert.c</tt>&rsquo; or its corresponding integer representation
+from the AV_CH_LAYOUT_* macros in &lsquo;<tt>libavutil/audioconvert.h</tt>&rsquo;
+</p>
+</dd>
+<dt> &lsquo;<samp>packing</samp>&rsquo;</dt>
+<dd><p>Either &quot;packed&quot; or &quot;planar&quot;, or their integer representation: 0 or 1
+respectively.
+</p>
+</dd>
+</dl>
+
+<p>For example:
+</p><table><tr><td>&nbsp;</td><td><pre class="example">abuffer=44100:s16:stereo:planar
+</pre></td></tr></table>
+
+<p>will instruct the source to accept planar 16bit signed stereo at 44100Hz.
+Since the sample format with name &quot;s16&quot; corresponds to the number
+1 and the &quot;stereo&quot; channel layout corresponds to the value 3, this is
+equivalent to:
+</p><table><tr><td>&nbsp;</td><td><pre class="example">abuffer=44100:1:3:1
+</pre></td></tr></table>
+
+<a name="amovie"></a>
+<h2 class="section"><a href="ffmpeg.html#toc-amovie">20.2 amovie</a></h2>
+
+<p>Read an audio stream from a movie container.
+</p>
+<p>It accepts the syntax: <var>movie_name</var>[:<var>options</var>] where
+<var>movie_name</var> is the name of the resource to read (not necessarily
+a file but also a device or a stream accessed through some protocol),
+and <var>options</var> is an optional sequence of <var>key</var>=<var>value</var>
+pairs, separated by &quot;:&quot;.
+</p>
+<p>The description of the accepted options follows.
+</p>
+<dl compact="compact">
+<dt> &lsquo;<samp>format_name, f</samp>&rsquo;</dt>
+<dd><p>Specify the format assumed for the movie to read, and can be either
+the name of a container or an input device. If not specified the
+format is guessed from <var>movie_name</var> or by probing.
+</p>
+</dd>
+<dt> &lsquo;<samp>seek_point, sp</samp>&rsquo;</dt>
+<dd><p>Specify the seek point in seconds, the frames will be output
+starting from this seek point, the parameter is evaluated with
+<code>av_strtod</code> so the numerical value may be suffixed by an IS
+postfix. Default value is &quot;0&quot;.
+</p>
+</dd>
+<dt> &lsquo;<samp>stream_index, si</samp>&rsquo;</dt>
+<dd><p>Specify the index of the audio stream to read. If the value is -1,
+the best suited audio stream will be automatically selected. Default
+value is &quot;-1&quot;.
+</p>
+</dd>
+</dl>
+
 <a name="anullsrc"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-anullsrc">20.1 anullsrc</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-anullsrc">20.3 anullsrc</a></h2>
 
 <p>Null audio source, never return audio frames. It is mainly useful as a
 template and to be employed in analysis / debugging tools.
@@ -4036,8 +4389,20 @@ anullsrc=48000:mono
 
 <p>Below is a description of the currently available audio sinks.
 </p>
+<a name="abuffersink"></a>
+<h2 class="section"><a href="ffmpeg.html#toc-abuffersink">21.1 abuffersink</a></h2>
+
+<p>Buffer audio frames, and make them available to the end of filter chain.
+</p>
+<p>This sink is mainly intended for programmatic use, in particular
+through the interface defined in &lsquo;<tt>libavfilter/asink_abuffer.h</tt>&rsquo;.
+</p>
+<p>It requires a pointer to a ABufferSinkContext structure, which defines the
+incoming buffers&rsquo; format, to be passed as the opaque parameter to
+<code>avfilter_init_filter</code> for initialization.
+</p>
 <a name="anullsink"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-anullsink">21.1 anullsink</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-anullsink">21.2 anullsink</a></h2>
 
 <p>Null audio sink, do absolutely nothing with the input audio. It is
 mainly useful as a template and to be employed in analysis / debugging
@@ -4175,6 +4540,23 @@ each new frame.
 <dd><p>same as <var>out_w</var> and <var>out_h</var>
 </p>
 </dd>
+<dt> &lsquo;<samp>a</samp>&rsquo;</dt>
+<dd><p>same as <var>iw</var> / <var>ih</var>
+</p>
+</dd>
+<dt> &lsquo;<samp>sar</samp>&rsquo;</dt>
+<dd><p>input sample aspect ratio
+</p>
+</dd>
+<dt> &lsquo;<samp>dar</samp>&rsquo;</dt>
+<dd><p>input display aspect ratio, it is the same as (<var>iw</var> / <var>ih</var>) * <var>sar</var>
+</p>
+</dd>
+<dt> &lsquo;<samp>hsub, vsub</samp>&rsquo;</dt>
+<dd><p>horizontal and vertical chroma subsample values. For example for the
+pixel format &quot;yuv422p&quot; <var>hsub</var> is 2 and <var>vsub</var> is 1.
+</p>
+</dd>
 <dt> &lsquo;<samp>n</samp>&rsquo;</dt>
 <dd><p>the number of input frame, starting from 0
 </p>
@@ -4285,8 +4667,61 @@ playback.
 </p></dd>
 </dl>
 
+<a name="delogo"></a>
+<h2 class="section"><a href="ffmpeg.html#toc-delogo">22.6 delogo</a></h2>
+
+<p>Suppress a TV station logo by a simple interpolation of the surrounding
+pixels. Just set a rectangle covering the logo and watch it disappear
+(and sometimes something even uglier appear - your mileage may vary).
+</p>
+<p>The filter accepts parameters as a string of the form
+&quot;<var>x</var>:<var>y</var>:<var>w</var>:<var>h</var>:<var>band</var>&quot;, or as a list of
+<var>key</var>=<var>value</var> pairs, separated by &quot;:&quot;.
+</p>
+<p>The description of the accepted parameters follows.
+</p>
+<dl compact="compact">
+<dt> &lsquo;<samp>x, y</samp>&rsquo;</dt>
+<dd><p>Specify the top left corner coordinates of the logo. They must be
+specified.
+</p>
+</dd>
+<dt> &lsquo;<samp>w, h</samp>&rsquo;</dt>
+<dd><p>Specify the width and height of the logo to clear. They must be
+specified.
+</p>
+</dd>
+<dt> &lsquo;<samp>band, t</samp>&rsquo;</dt>
+<dd><p>Specify the thickness of the fuzzy edge of the rectangle (added to
+<var>w</var> and <var>h</var>). The default value is 4.
+</p>
+</dd>
+<dt> &lsquo;<samp>show</samp>&rsquo;</dt>
+<dd><p>When set to 1, a green rectangle is drawn on the screen to simplify
+finding the right <var>x</var>, <var>y</var>, <var>w</var>, <var>h</var> parameters, and
+<var>band</var> is set to 4. The default value is 0.
+</p>
+</dd>
+</dl>
+
+<p>Some examples follow.
+</p>
+<ul>
+<li>
+Set a rectangle covering the area with top left corner coordinates 0,0
+and size 100x77, setting a band of size 10:
+<table><tr><td>&nbsp;</td><td><pre class="example">delogo=0:0:100:77:10
+</pre></td></tr></table>
+
+</li><li>
+As the previous example, but use named options:
+<table><tr><td>&nbsp;</td><td><pre class="example">delogo=x=0:y=0:w=100:h=77:band=10
+</pre></td></tr></table>
+
+</li></ul>
+
 <a name="drawbox"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-drawbox">22.6 drawbox</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-drawbox">22.7 drawbox</a></h2>
 
 <p>Draw a colored box on the input image.
 </p>
@@ -4319,7 +4754,7 @@ drawbox=10:20:200:60:red@0.5&quot;
 </pre></td></tr></table>
 
 <a name="drawtext"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-drawtext">22.7 drawtext</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-drawtext">22.8 drawtext</a></h2>
 
 <p>Draw text string or text from specified file on top of video using the
 libfreetype library.
@@ -4463,7 +4898,7 @@ within the parameter list.
 <a href="http://www.freetype.org/">http://www.freetype.org/</a>.
 </p>
 <a name="fade"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-fade">22.8 fade</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-fade">22.9 fade</a></h2>
 
 <p>Apply fade-in/out effect to input video.
 </p>
@@ -4496,7 +4931,7 @@ fade=in:5:20
 </pre></td></tr></table>
 
 <a name="fieldorder"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-fieldorder">22.9 fieldorder</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-fieldorder">22.10 fieldorder</a></h2>
 
 <p>Transform the field order of the input video.
 </p>
@@ -4531,7 +4966,7 @@ which is bottom field first.
 </pre></td></tr></table>
 
 <a name="fifo"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-fifo">22.10 fifo</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-fifo">22.11 fifo</a></h2>
 
 <p>Buffer input images and send them when they are requested.
 </p>
@@ -4541,7 +4976,7 @@ framework.
 <p>The filter does not take parameters.
 </p>
 <a name="format"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-format">22.11 format</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-format">22.12 format</a></h2>
 
 <p>Convert the input video to one of the specified pixel formats.
 Libavfilter will try to pick one that is supported for the input to
@@ -4560,7 +4995,7 @@ format=yuv420p:yuv444p:yuv410p
 
 <p><a name="frei0r"></a>
 </p><a name="frei0r-1"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-frei0r-1">22.12 frei0r</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-frei0r-1">22.13 frei0r</a></h2>
 
 <p>Apply a frei0r effect to the input video.
 </p>
@@ -4609,7 +5044,7 @@ frei0r=perspective:0.2/0.2:0.8/0.2
 <a href="http://piksel.org/frei0r">http://piksel.org/frei0r</a>
 </p>
 <a name="gradfun"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-gradfun">22.13 gradfun</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-gradfun">22.14 gradfun</a></h2>
 
 <p>Fix the banding artifacts that are sometimes introduced into nearly flat
 regions by truncation to 8bit colordepth.
@@ -4642,7 +5077,7 @@ gradfun=1.2
 </pre></td></tr></table>
 
 <a name="hflip"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-hflip">22.14 hflip</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-hflip">22.15 hflip</a></h2>
 
 <p>Flip the input video horizontally.
 </p>
@@ -4652,7 +5087,7 @@ gradfun=1.2
 </pre></td></tr></table>
 
 <a name="hqdn3d"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-hqdn3d">22.15 hqdn3d</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-hqdn3d">22.16 hqdn3d</a></h2>
 
 <p>High precision/quality 3d denoise filter. This filter aims to reduce
 image noise producing smooth images and making still images really
@@ -4684,7 +5119,7 @@ defaults to 3.0*<var>luma_spatial</var>/4.0
 </dl>
 
 <a name="lut_002c-lutrgb_002c-lutyuv"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-lut_002c-lutrgb_002c-lutyuv">22.16 lut, lutrgb, lutyuv</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-lut_002c-lutrgb_002c-lutyuv">22.17 lut, lutrgb, lutyuv</a></h2>
 
 <p>Compute a look-up table for binding each pixel component input value
 to an output value, and apply it to input video.
@@ -4808,7 +5243,7 @@ lutyuv=y=gammaval(0.5)
 </pre></td></tr></table>
 
 <a name="mp"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-mp">22.17 mp</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-mp">22.18 mp</a></h2>
 
 <p>Apply an MPlayer filter to the input video.
 </p>
@@ -4831,7 +5266,6 @@ the named filter.
 </p><dl compact="compact">
 <dt> <var>2xsai</var></dt>
 <dt> <var>decimate</var></dt>
-<dt> <var>delogo</var></dt>
 <dt> <var>denoise3d</var></dt>
 <dt> <var>detc</var></dt>
 <dt> <var>dint</var></dt>
@@ -4846,7 +5280,6 @@ the named filter.
 <dt> <var>framestep</var></dt>
 <dt> <var>fspp</var></dt>
 <dt> <var>geq</var></dt>
-<dt> <var>gradfun</var></dt>
 <dt> <var>harddup</var></dt>
 <dt> <var>hqdn3d</var></dt>
 <dt> <var>hue</var></dt>
@@ -4875,7 +5308,6 @@ the named filter.
 <dt> <var>spp</var></dt>
 <dt> <var>swapuv</var></dt>
 <dt> <var>telecine</var></dt>
-<dt> <var>test</var></dt>
 <dt> <var>tile</var></dt>
 <dt> <var>tinterlace</var></dt>
 <dt> <var>unsharp</var></dt>
@@ -4902,7 +5334,7 @@ mp=hue=100:-10
 <p>See also mplayer(1), <a href="http://www.mplayerhq.hu/">http://www.mplayerhq.hu/</a>.
 </p>
 <a name="negate"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-negate">22.18 negate</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-negate">22.19 negate</a></h2>
 
 <p>Negate input video.
 </p>
@@ -4910,7 +5342,7 @@ mp=hue=100:-10
 alpha component (if available). The default value in input is 0.
 </p>
 <a name="noformat"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-noformat">22.19 noformat</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-noformat">22.20 noformat</a></h2>
 
 <p>Force libavfilter not to use any of the specified pixel formats for the
 input to the next filter.
@@ -4927,13 +5359,13 @@ noformat=yuv420p,vflip
 noformat=yuv420p:yuv444p:yuv410p
 </pre></td></tr></table>
 
-<a name="null-1"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-null-1">22.20 null</a></h2>
+<a name="null"></a>
+<h2 class="section"><a href="ffmpeg.html#toc-null">22.21 null</a></h2>
 
 <p>Pass the video source unchanged to the output.
 </p>
 <a name="ocv"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-ocv">22.21 ocv</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-ocv">22.22 ocv</a></h2>
 
 <p>Apply video transform using libopencv.
 </p>
@@ -4955,7 +5387,7 @@ informations:
 </p>
 <p><a name="dilate"></a>
 </p><a name="dilate-1"></a>
-<h3 class="subsection"><a href="ffmpeg.html#toc-dilate-1">22.21.1 dilate</a></h3>
+<h3 class="subsection"><a href="ffmpeg.html#toc-dilate-1">22.22.1 dilate</a></h3>
 
 <p>Dilate an image by using a specific structuring element.
 This filter corresponds to the libopencv function <code>cvDilate</code>.
@@ -5001,7 +5433,7 @@ ocv=0x0+2x2/custom=diamond.shape:2
 </pre></td></tr></table>
 
 <a name="erode"></a>
-<h3 class="subsection"><a href="ffmpeg.html#toc-erode">22.21.2 erode</a></h3>
+<h3 class="subsection"><a href="ffmpeg.html#toc-erode">22.22.2 erode</a></h3>
 
 <p>Erode an image by using a specific structuring element.
 This filter corresponds to the libopencv function <code>cvErode</code>.
@@ -5010,7 +5442,7 @@ This filter corresponds to the libopencv function <code>cvErode</code>.
 with the same syntax and semantics as the <a href="#dilate">dilate</a> filter.
 </p>
 <a name="smooth"></a>
-<h3 class="subsection"><a href="ffmpeg.html#toc-smooth">22.21.3 smooth</a></h3>
+<h3 class="subsection"><a href="ffmpeg.html#toc-smooth">22.22.3 smooth</a></h3>
 
 <p>Smooth the input video.
 </p>
@@ -5033,7 +5465,7 @@ other parameters is 0.
 libopencv function <code>cvSmooth</code>.
 </p>
 <a name="overlay"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-overlay">22.22 overlay</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-overlay">22.23 overlay</a></h2>
 
 <p>Overlay one video on top of another.
 </p>
@@ -5095,7 +5527,7 @@ color=red.3:WxH [over]; [in][over] overlay [out]
 approach is yet to be tested.
 </p>
 <a name="pad"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-pad">22.23 pad</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-pad">22.24 pad</a></h2>
 
 <p>Add paddings to the input image, and places the original input at the
 given coordinates <var>x</var>, <var>y</var>.
@@ -5134,14 +5566,18 @@ specified by the <var>width</var> and <var>height</var> expressions
 expressions, or NAN if not yet specified
 </p>
 </dd>
-<dt> &lsquo;<samp>dar, a</samp>&rsquo;</dt>
-<dd><p>input display aspect ratio, same as <var>iw</var> / <var>ih</var>
+<dt> &lsquo;<samp>a</samp>&rsquo;</dt>
+<dd><p>same as <var>iw</var> / <var>ih</var>
 </p>
 </dd>
 <dt> &lsquo;<samp>sar</samp>&rsquo;</dt>
 <dd><p>input sample aspect ratio
 </p>
 </dd>
+<dt> &lsquo;<samp>dar</samp>&rsquo;</dt>
+<dd><p>input display aspect ratio, it is the same as (<var>iw</var> / <var>ih</var>) * <var>sar</var>
+</p>
+</dd>
 <dt> &lsquo;<samp>hsub, vsub</samp>&rsquo;</dt>
 <dd><p>horizontal and vertical chroma subsample values. For example for the
 pixel format &quot;yuv422p&quot; <var>hsub</var> is 2 and <var>vsub</var> is 1.
@@ -5203,13 +5639,19 @@ pad=&quot;max(iw\,ih):ow:(ow-iw)/2:(oh-ih)/2&quot;
 # pad the input to get a final w/h ratio of 16:9
 pad=&quot;ih*16/9:ih:(ow-iw)/2:(oh-ih)/2&quot;
 
+# for anamorphic video, in order to set the output display aspect ratio,
+# it is necessary to use sar in the expression, according to the relation:
+# (ih * X / ih) * sar = output_dar
+# X = output_dar / sar
+pad=&quot;ih*16/9/sar:ih:(ow-iw)/2:(oh-ih)/2&quot;
+
 # double output size and put the input video in the bottom-right
 # corner of the output padded area
 pad=&quot;2*iw:2*ih:ow-iw:oh-ih&quot;
 </pre></td></tr></table>
 
 <a name="pixdesctest"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-pixdesctest">22.24 pixdesctest</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-pixdesctest">22.25 pixdesctest</a></h2>
 
 <p>Pixel format descriptor test filter, mainly useful for internal
 testing. The output video should be equal to the input video.
@@ -5221,7 +5663,7 @@ testing. The output video should be equal to the input video.
 <p>can be used to test the monowhite pixel format descriptor definition.
 </p>
 <a name="scale"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-scale">22.25 scale</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-scale">22.26 scale</a></h2>
 
 <p>Scale the input video to <var>width</var>:<var>height</var> and/or convert the image format.
 </p>
@@ -5250,14 +5692,18 @@ the following constants:
 <dd><p>same as <var>out_w</var> and <var>out_h</var>
 </p>
 </dd>
-<dt> &lsquo;<samp>dar, a</samp>&rsquo;</dt>
-<dd><p>input display aspect ratio, same as <var>iw</var> / <var>ih</var>
+<dt> &lsquo;<samp>a</samp>&rsquo;</dt>
+<dd><p>same as <var>iw</var> / <var>ih</var>
 </p>
 </dd>
 <dt> &lsquo;<samp>sar</samp>&rsquo;</dt>
 <dd><p>input sample aspect ratio
 </p>
 </dd>
+<dt> &lsquo;<samp>dar</samp>&rsquo;</dt>
+<dd><p>input display aspect ratio, it is the same as (<var>iw</var> / <var>ih</var>) * <var>sar</var>
+</p>
+</dd>
 <dt> &lsquo;<samp>hsub, vsub</samp>&rsquo;</dt>
 <dd><p>horizontal and vertical chroma subsample values. For example for the
 pixel format &quot;yuv422p&quot; <var>hsub</var> is 2 and <var>vsub</var> is 1.
@@ -5307,7 +5753,7 @@ scale='min(500\, iw*3/2):-1'
 </pre></td></tr></table>
 
 <a name="select"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-select">22.26 select</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-select">22.27 select</a></h2>
 <p>Select frames to pass in output.
 </p>
 <p>It accepts in input an expression, which is evaluated for each input
@@ -5445,7 +5891,7 @@ select='isnan(prev_selected_t)+gte(t-prev_selected_t\,10)'
 
 <p><a name="setdar"></a>
 </p><a name="setdar-1"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-setdar-1">22.27 setdar</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-setdar-1">22.28 setdar</a></h2>
 
 <p>Set the Display Aspect Ratio for the filter output video.
 </p>
@@ -5474,7 +5920,7 @@ setdar=1.77777
 <p>See also the <a href="#setsar">setsar</a> filter documentation.
 </p>
 <a name="setpts"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-setpts">22.28 setpts</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-setpts">22.29 setpts</a></h2>
 
 <p>Change the PTS (presentation timestamp) of the input video frames.
 </p>
@@ -5545,7 +5991,7 @@ setpts='1/(25*TB) * (N + 0.05 * sin(N*2*PI/25))'
 
 <p><a name="setsar"></a>
 </p><a name="setsar-1"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-setsar-1">22.29 setsar</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-setsar-1">22.30 setsar</a></h2>
 
 <p>Set the Sample (aka Pixel) Aspect Ratio for the filter output video.
 </p>
@@ -5570,7 +6016,7 @@ If the parameter is not specified, it is assumed the value &quot;0:1&quot;.
 </pre></td></tr></table>
 
 <a name="settb"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-settb">22.30 settb</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-settb">22.31 settb</a></h2>
 
 <p>Set the timebase to use for the output frames timestamps.
 It is mainly useful for testing timebase configuration.
@@ -5600,7 +6046,7 @@ settb=AVTB
 </pre></td></tr></table>
 
 <a name="showinfo"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-showinfo">22.31 showinfo</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-showinfo">22.32 showinfo</a></h2>
 
 <p>Show a line containing various information for each input video frame.
 The input video is not modified.
@@ -5672,7 +6118,7 @@ the <code>av_get_picture_type_char</code> function defined in
 </dl>
 
 <a name="slicify"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-slicify">22.32 slicify</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-slicify">22.33 slicify</a></h2>
 
 <p>Pass the images of input video on to next video filter as multiple
 slices.
@@ -5687,7 +6133,7 @@ not specified it will use the default value of 16.
 faster due to better use of the memory cache.
 </p>
 <a name="split"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-split">22.33 split</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-split">22.34 split</a></h2>
 
 <p>Pass on the input video to two outputs. Both outputs are identical to
 the input video.
@@ -5702,7 +6148,7 @@ the input video.
 one padded.
 </p>
 <a name="transpose"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-transpose">22.34 transpose</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-transpose">22.35 transpose</a></h2>
 
 <p>Transpose rows with columns in the input video and optionally flip it.
 </p>
@@ -5744,7 +6190,7 @@ l.r     l.L
 </dl>
 
 <a name="unsharp"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-unsharp">22.35 unsharp</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-unsharp">22.36 unsharp</a></h2>
 
 <p>Sharpen or blur the input video.
 </p>
@@ -5753,7 +6199,7 @@ l.r     l.L
 </p>
 <p>Negative values for the amount will blur the input video, while positive
 values will sharpen. All parameters are optional and default to the
-equivalent of the string &rsquo;5:5:1.0:0:0:0.0&rsquo;.
+equivalent of the string &rsquo;5:5:1.0:5:5:0.0&rsquo;.
 </p>
 <dl compact="compact">
 <dt> &lsquo;<samp>luma_msize_x</samp>&rsquo;</dt>
@@ -5773,15 +6219,15 @@ and 5.0, default value is 1.0.
 </dd>
 <dt> &lsquo;<samp>chroma_msize_x</samp>&rsquo;</dt>
 <dd><p>Set the chroma matrix horizontal size. It can be an integer between 3
-and 13, default value is 0.
+and 13, default value is 5.
 </p>
 </dd>
 <dt> &lsquo;<samp>chroma_msize_y</samp>&rsquo;</dt>
 <dd><p>Set the chroma matrix vertical size. It can be an integer between 3
-and 13, default value is 0.
+and 13, default value is 5.
 </p>
 </dd>
-<dt> &lsquo;<samp>luma_amount</samp>&rsquo;</dt>
+<dt> &lsquo;<samp>chroma_amount</samp>&rsquo;</dt>
 <dd><p>Set the chroma effect strength. It can be a float number between -2.0
 and 5.0, default value is 0.0.
 </p>
@@ -5799,7 +6245,7 @@ unsharp=7:7:-2:7:7:-2
 </pre></td></tr></table>
 
 <a name="vflip"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-vflip">22.36 vflip</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-vflip">22.37 vflip</a></h2>
 
 <p>Flip the input video vertically.
 </p>
@@ -5807,7 +6253,7 @@ unsharp=7:7:-2:7:7:-2
 </pre></td></tr></table>
 
 <a name="yadif"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-yadif">22.37 yadif</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-yadif">22.38 yadif</a></h2>
 
 <p>Deinterlace the input video (&quot;yadif&quot; means &quot;yet another deinterlacing
 filter&quot;).
@@ -5839,10 +6285,10 @@ interlaced video, accepts one of the following values:
 </p>
 <dl compact="compact">
 <dt> &lsquo;<samp>0</samp>&rsquo;</dt>
-<dd><p>assume bottom field first
+<dd><p>assume top field first
 </p></dd>
 <dt> &lsquo;<samp>1</samp>&rsquo;</dt>
-<dd><p>assume top field first
+<dd><p>assume bottom field first
 </p></dd>
 <dt> &lsquo;<samp>-1</samp>&rsquo;</dt>
 <dd><p>enable automatic detection
@@ -6027,8 +6473,66 @@ movie=/dev/video0:f=video4linux2, scale=180:-1, setpts=PTS-STARTPTS [movie];
 
 </pre></td></tr></table>
 
+<a name="mptestsrc"></a>
+<h2 class="section"><a href="ffmpeg.html#toc-mptestsrc">23.4 mptestsrc</a></h2>
+
+<p>Generate various test patterns, as generated by the MPlayer test filter.
+</p>
+<p>The size of the generated video is fixed, and is 256x256.
+This source is useful in particular for testing encoding features.
+</p>
+<p>This source accepts an optional sequence of <var>key</var>=<var>value</var> pairs,
+separated by &quot;:&quot;. The description of the accepted options follows.
+</p>
+<dl compact="compact">
+<dt> &lsquo;<samp>rate, r</samp>&rsquo;</dt>
+<dd><p>Specify the frame rate of the sourced video, as the number of frames
+generated per second. It has to be a string in the format
+<var>frame_rate_num</var>/<var>frame_rate_den</var>, an integer number, a float
+number or a valid video frame rate abbreviation. The default value is
+&quot;25&quot;.
+</p>
+</dd>
+<dt> &lsquo;<samp>duration, d</samp>&rsquo;</dt>
+<dd><p>Set the video duration of the sourced video. The accepted syntax is:
+</p><table><tr><td>&nbsp;</td><td><pre class="example">[-]HH[:MM[:SS[.m...]]]
+[-]S+[.m...]
+</pre></td></tr></table>
+<p>See also the function <code>av_parse_time()</code>.
+</p>
+<p>If not specified, or the expressed duration is negative, the video is
+supposed to be generated forever.
+</p>
+</dd>
+<dt> &lsquo;<samp>test, t</samp>&rsquo;</dt>
+<dd>
+<p>Set the number or the name of the test to perform. Supported tests are:
+</p><dl compact="compact">
+<dt> &lsquo;<samp>dc_luma</samp>&rsquo;</dt>
+<dt> &lsquo;<samp>dc_chroma</samp>&rsquo;</dt>
+<dt> &lsquo;<samp>freq_luma</samp>&rsquo;</dt>
+<dt> &lsquo;<samp>freq_chroma</samp>&rsquo;</dt>
+<dt> &lsquo;<samp>amp_luma</samp>&rsquo;</dt>
+<dt> &lsquo;<samp>amp_chroma</samp>&rsquo;</dt>
+<dt> &lsquo;<samp>cbp</samp>&rsquo;</dt>
+<dt> &lsquo;<samp>mv</samp>&rsquo;</dt>
+<dt> &lsquo;<samp>ring1</samp>&rsquo;</dt>
+<dt> &lsquo;<samp>ring2</samp>&rsquo;</dt>
+<dt> &lsquo;<samp>all</samp>&rsquo;</dt>
+</dl>
+
+<p>Default value is &quot;all&quot;, which will cycle through the list of all tests.
+</p></dd>
+</dl>
+
+<p>For example the following:
+</p><table><tr><td>&nbsp;</td><td><pre class="example">testsrc=t=dc_luma
+</pre></td></tr></table>
+
+<p>will generate a &quot;dc_luma&quot; test pattern.
+</p>
 <a name="nullsrc"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-nullsrc">23.4 nullsrc</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-nullsrc">23.5 nullsrc</a></h2>
 
 <p>Null video source, never return images. It is mainly useful as a
 template and to be employed in analysis / debugging tools.
@@ -6045,7 +6549,7 @@ timebase. The expression can contain the constants &quot;PI&quot;, &quot;E&quot;
 &quot;AVTB&quot; (the default timebase), and defaults to the value &quot;AVTB&quot;.
 </p>
 <a name="frei0r_005fsrc"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-frei0r_005fsrc">23.5 frei0r_src</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-frei0r_005fsrc">23.6 frei0r_src</a></h2>
 
 <p>Provide a frei0r source.
 </p>
@@ -6071,7 +6575,7 @@ frei0r_src=200x200:10:partik0l=1234 [overlay]; [in][overlay] overlay
 </pre></td></tr></table>
 
 <a name="rgbtestsrc_002c-testsrc"></a>
-<h2 class="section"><a href="ffmpeg.html#toc-rgbtestsrc_002c-testsrc">23.6 rgbtestsrc, testsrc</a></h2>
+<h2 class="section"><a href="ffmpeg.html#toc-rgbtestsrc_002c-testsrc">23.7 rgbtestsrc, testsrc</a></h2>
 
 <p>The <code>rgbtestsrc</code> source generates an RGB test pattern useful for
 detecting RGB vs BGR issues. You should see a red, green and blue
@@ -6099,6 +6603,10 @@ number or a valid video frame rate abbreviation. The default value is
 &quot;25&quot;.
 </p>
 </dd>
+<dt> &lsquo;<samp>sar</samp>&rsquo;</dt>
+<dd><p>Set the sample aspect ratio of the sourced video.
+</p>
+</dd>
 <dt> &lsquo;<samp>duration</samp>&rsquo;</dt>
 <dd><p>Set the video duration of the sourced video. The accepted syntax is:
 </p><table><tr><td>&nbsp;</td><td><pre class="example">[-]HH[:MM[:SS[.m...]]]
@@ -6216,7 +6724,7 @@ line
 <hr size="1">
 <p>
  <font size="-1">
-  This document was generated by <em>Kyle Schwarz</em> on <em>July 23, 2011</em> using <a href="http://www.nongnu.org/texi2html/"><em>texi2html 1.82</em></a>.
+  This document was generated by <em>Kyle Schwarz</em> on <em>September 2, 2011</em> using <a href="http://www.nongnu.org/texi2html/"><em>texi2html 1.82</em></a>.
  </font>
  <br>