<!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>
<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-3" href="#Options-3">3. Options</a>
+ <li><a name="toc-Options-4" href="#Options-4">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-Advanced-options" href="#Advanced-options">3.3 Advanced options</a></li>
- <li><a name="toc-While-playing" href="#While-playing">3.4 While playing</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-Advanced-options" href="#Advanced-options">3.4 Advanced options</a></li>
+ <li><a name="toc-While-playing" href="#While-playing">3.5 While playing</a></li>
</ul></li>
<li><a name="toc-Expression-Evaluation" href="#Expression-Evaluation">4. Expression Evaluation</a></li>
<li><a name="toc-Decoders" href="#Decoders">5. Decoders</a></li>
<ul class="toc">
<li><a name="toc-rawvideo" href="#rawvideo">6.1 rawvideo</a>
<ul class="toc">
- <li><a name="toc-Options-1" href="#Options-1">6.1.1 Options</a></li>
+ <li><a name="toc-Options-3" href="#Options-3">6.1.1 Options</a></li>
</ul>
</li>
</ul></li>
<li><a name="toc-dv1394" href="#dv1394">9.3 dv1394</a></li>
<li><a name="toc-fbdev" href="#fbdev">9.4 fbdev</a></li>
<li><a name="toc-jack" href="#jack">9.5 jack</a></li>
- <li><a name="toc-libdc1394" href="#libdc1394">9.6 libdc1394</a></li>
- <li><a name="toc-openal" href="#openal">9.7 openal</a>
+ <li><a name="toc-lavfi" href="#lavfi">9.6 lavfi</a>
<ul class="toc">
- <li><a name="toc-Options" href="#Options">9.7.1 Options</a></li>
- <li><a name="toc-Examples" href="#Examples">9.7.2 Examples</a></li>
+ <li><a name="toc-Options" href="#Options">9.6.1 Options</a></li>
+ <li><a name="toc-Examples" href="#Examples">9.6.2 Examples</a></li>
</ul></li>
- <li><a name="toc-oss" href="#oss">9.8 oss</a></li>
- <li><a name="toc-sndio-1" href="#sndio-1">9.9 sndio</a></li>
- <li><a name="toc-video4linux-and-video4linux2" href="#video4linux-and-video4linux2">9.10 video4linux and video4linux2</a></li>
- <li><a name="toc-vfwcap" href="#vfwcap">9.11 vfwcap</a></li>
- <li><a name="toc-x11grab" href="#x11grab">9.12 x11grab</a></li>
+ <li><a name="toc-libdc1394" href="#libdc1394">9.7 libdc1394</a></li>
+ <li><a name="toc-openal" href="#openal">9.8 openal</a>
+ <ul class="toc">
+ <li><a name="toc-Options-1" href="#Options-1">9.8.1 Options</a></li>
+ <li><a name="toc-Examples-2" href="#Examples-2">9.8.2 Examples</a></li>
+ </ul></li>
+ <li><a name="toc-oss" href="#oss">9.9 oss</a></li>
+ <li><a name="toc-sndio-1" href="#sndio-1">9.10 sndio</a></li>
+ <li><a name="toc-video4linux-and-video4linux2" href="#video4linux-and-video4linux2">9.11 video4linux and video4linux2</a></li>
+ <li><a name="toc-vfwcap" href="#vfwcap">9.12 vfwcap</a></li>
+ <li><a name="toc-x11grab" href="#x11grab">9.13 x11grab</a>
+ <ul class="toc">
+ <li><a name="toc-follow_005fmouse-AVOption" href="#follow_005fmouse-AVOption">9.13.1 <var>follow_mouse</var> AVOption</a></li>
+ <li><a name="toc-show_005fregion-AVOption" href="#show_005fregion-AVOption">9.13.2 <var>show_region</var> AVOption</a></li>
+ </ul>
+</li>
</ul></li>
<li><a name="toc-Output-Devices" href="#Output-Devices">10. Output Devices</a>
<ul class="toc">
</ul></li>
<li><a name="toc-Audio-Filters" href="#Audio-Filters">13. Audio Filters</a>
<ul class="toc">
- <li><a name="toc-anull" href="#anull">13.1 anull</a></li>
+ <li><a name="toc-aformat" href="#aformat">13.1 aformat</a></li>
+ <li><a name="toc-anull" href="#anull">13.2 anull</a></li>
+ <li><a name="toc-aresample" href="#aresample">13.3 aresample</a></li>
+ <li><a name="toc-ashowinfo" href="#ashowinfo">13.4 ashowinfo</a></li>
</ul></li>
<li><a name="toc-Audio-Sources" href="#Audio-Sources">14. Audio Sources</a>
<ul class="toc">
- <li><a name="toc-anullsrc" href="#anullsrc">14.1 anullsrc</a></li>
+ <li><a name="toc-abuffer" href="#abuffer">14.1 abuffer</a></li>
+ <li><a name="toc-amovie" href="#amovie">14.2 amovie</a></li>
+ <li><a name="toc-anullsrc" href="#anullsrc">14.3 anullsrc</a></li>
</ul></li>
<li><a name="toc-Audio-Sinks" href="#Audio-Sinks">15. Audio Sinks</a>
<ul class="toc">
- <li><a name="toc-anullsink" href="#anullsink">15.1 anullsink</a></li>
+ <li><a name="toc-abuffersink" href="#abuffersink">15.1 abuffersink</a></li>
+ <li><a name="toc-anullsink" href="#anullsink">15.2 anullsink</a></li>
</ul></li>
<li><a name="toc-Video-Filters" href="#Video-Filters">16. Video Filters</a>
<ul class="toc">
<li><a name="toc-copy" href="#copy">16.3 copy</a></li>
<li><a name="toc-crop" href="#crop">16.4 crop</a></li>
<li><a name="toc-cropdetect" href="#cropdetect">16.5 cropdetect</a></li>
- <li><a name="toc-drawbox" href="#drawbox">16.6 drawbox</a></li>
- <li><a name="toc-drawtext" href="#drawtext">16.7 drawtext</a></li>
- <li><a name="toc-fade" href="#fade">16.8 fade</a></li>
- <li><a name="toc-fieldorder" href="#fieldorder">16.9 fieldorder</a></li>
- <li><a name="toc-fifo" href="#fifo">16.10 fifo</a></li>
- <li><a name="toc-format" href="#format">16.11 format</a></li>
- <li><a name="toc-frei0r-1" href="#frei0r-1">16.12 frei0r</a></li>
- <li><a name="toc-gradfun" href="#gradfun">16.13 gradfun</a></li>
- <li><a name="toc-hflip" href="#hflip">16.14 hflip</a></li>
- <li><a name="toc-hqdn3d" href="#hqdn3d">16.15 hqdn3d</a></li>
- <li><a name="toc-lut_002c-lutrgb_002c-lutyuv" href="#lut_002c-lutrgb_002c-lutyuv">16.16 lut, lutrgb, lutyuv</a></li>
- <li><a name="toc-mp" href="#mp">16.17 mp</a></li>
- <li><a name="toc-negate" href="#negate">16.18 negate</a></li>
- <li><a name="toc-noformat" href="#noformat">16.19 noformat</a></li>
- <li><a name="toc-null-1" href="#null-1">16.20 null</a></li>
- <li><a name="toc-ocv" href="#ocv">16.21 ocv</a>
+ <li><a name="toc-delogo" href="#delogo">16.6 delogo</a></li>
+ <li><a name="toc-drawbox" href="#drawbox">16.7 drawbox</a></li>
+ <li><a name="toc-drawtext" href="#drawtext">16.8 drawtext</a></li>
+ <li><a name="toc-fade" href="#fade">16.9 fade</a></li>
+ <li><a name="toc-fieldorder" href="#fieldorder">16.10 fieldorder</a></li>
+ <li><a name="toc-fifo" href="#fifo">16.11 fifo</a></li>
+ <li><a name="toc-format" href="#format">16.12 format</a></li>
+ <li><a name="toc-frei0r-1" href="#frei0r-1">16.13 frei0r</a></li>
+ <li><a name="toc-gradfun" href="#gradfun">16.14 gradfun</a></li>
+ <li><a name="toc-hflip" href="#hflip">16.15 hflip</a></li>
+ <li><a name="toc-hqdn3d" href="#hqdn3d">16.16 hqdn3d</a></li>
+ <li><a name="toc-lut_002c-lutrgb_002c-lutyuv" href="#lut_002c-lutrgb_002c-lutyuv">16.17 lut, lutrgb, lutyuv</a></li>
+ <li><a name="toc-mp" href="#mp">16.18 mp</a></li>
+ <li><a name="toc-negate" href="#negate">16.19 negate</a></li>
+ <li><a name="toc-noformat" href="#noformat">16.20 noformat</a></li>
+ <li><a name="toc-null-1" href="#null-1">16.21 null</a></li>
+ <li><a name="toc-ocv" href="#ocv">16.22 ocv</a>
<ul class="toc">
- <li><a name="toc-dilate-1" href="#dilate-1">16.21.1 dilate</a></li>
- <li><a name="toc-erode" href="#erode">16.21.2 erode</a></li>
- <li><a name="toc-smooth" href="#smooth">16.21.3 smooth</a></li>
+ <li><a name="toc-dilate-1" href="#dilate-1">16.22.1 dilate</a></li>
+ <li><a name="toc-erode" href="#erode">16.22.2 erode</a></li>
+ <li><a name="toc-smooth" href="#smooth">16.22.3 smooth</a></li>
</ul></li>
- <li><a name="toc-overlay" href="#overlay">16.22 overlay</a></li>
- <li><a name="toc-pad" href="#pad">16.23 pad</a></li>
- <li><a name="toc-pixdesctest" href="#pixdesctest">16.24 pixdesctest</a></li>
- <li><a name="toc-scale" href="#scale">16.25 scale</a></li>
- <li><a name="toc-select" href="#select">16.26 select</a></li>
- <li><a name="toc-setdar-1" href="#setdar-1">16.27 setdar</a></li>
- <li><a name="toc-setpts" href="#setpts">16.28 setpts</a></li>
- <li><a name="toc-setsar-1" href="#setsar-1">16.29 setsar</a></li>
- <li><a name="toc-settb" href="#settb">16.30 settb</a></li>
- <li><a name="toc-showinfo" href="#showinfo">16.31 showinfo</a></li>
- <li><a name="toc-slicify" href="#slicify">16.32 slicify</a></li>
- <li><a name="toc-split" href="#split">16.33 split</a></li>
- <li><a name="toc-transpose" href="#transpose">16.34 transpose</a></li>
- <li><a name="toc-unsharp" href="#unsharp">16.35 unsharp</a></li>
- <li><a name="toc-vflip" href="#vflip">16.36 vflip</a></li>
- <li><a name="toc-yadif" href="#yadif">16.37 yadif</a></li>
+ <li><a name="toc-overlay" href="#overlay">16.23 overlay</a></li>
+ <li><a name="toc-pad" href="#pad">16.24 pad</a></li>
+ <li><a name="toc-pixdesctest" href="#pixdesctest">16.25 pixdesctest</a></li>
+ <li><a name="toc-scale" href="#scale">16.26 scale</a></li>
+ <li><a name="toc-select" href="#select">16.27 select</a></li>
+ <li><a name="toc-setdar-1" href="#setdar-1">16.28 setdar</a></li>
+ <li><a name="toc-setpts" href="#setpts">16.29 setpts</a></li>
+ <li><a name="toc-setsar-1" href="#setsar-1">16.30 setsar</a></li>
+ <li><a name="toc-settb" href="#settb">16.31 settb</a></li>
+ <li><a name="toc-showinfo" href="#showinfo">16.32 showinfo</a></li>
+ <li><a name="toc-slicify" href="#slicify">16.33 slicify</a></li>
+ <li><a name="toc-split" href="#split">16.34 split</a></li>
+ <li><a name="toc-transpose" href="#transpose">16.35 transpose</a></li>
+ <li><a name="toc-unsharp" href="#unsharp">16.36 unsharp</a></li>
+ <li><a name="toc-vflip" href="#vflip">16.37 vflip</a></li>
+ <li><a name="toc-yadif" href="#yadif">16.38 yadif</a></li>
</ul></li>
<li><a name="toc-Video-Sources" href="#Video-Sources">17. Video Sources</a>
<ul class="toc">
<li><a name="toc-buffer" href="#buffer">17.1 buffer</a></li>
<li><a name="toc-color" href="#color">17.2 color</a></li>
<li><a name="toc-movie" href="#movie">17.3 movie</a></li>
- <li><a name="toc-nullsrc" href="#nullsrc">17.4 nullsrc</a></li>
- <li><a name="toc-frei0r_005fsrc" href="#frei0r_005fsrc">17.5 frei0r_src</a></li>
- <li><a name="toc-rgbtestsrc_002c-testsrc" href="#rgbtestsrc_002c-testsrc">17.6 rgbtestsrc, testsrc</a></li>
+ <li><a name="toc-mptestsrc" href="#mptestsrc">17.4 mptestsrc</a></li>
+ <li><a name="toc-nullsrc" href="#nullsrc">17.5 nullsrc</a></li>
+ <li><a name="toc-frei0r_005fsrc" href="#frei0r_005fsrc">17.6 frei0r_src</a></li>
+ <li><a name="toc-rgbtestsrc_002c-testsrc" href="#rgbtestsrc_002c-testsrc">17.7 rgbtestsrc, testsrc</a></li>
</ul></li>
<li><a name="toc-Video-Sinks" href="#Video-Sinks">18. Video Sinks</a>
<ul class="toc">
libraries and the SDL library. It is mostly used as a testbed for the
various FFmpeg APIs.
</p>
-<a name="Options-3"></a>
-<h1 class="chapter"><a href="ffplay.html#toc-Options-3">3. Options</a></h1>
+<a name="Options-4"></a>
+<h1 class="chapter"><a href="ffplay.html#toc-Options-4">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
</dd>
</dl>
+<a name="AVOptions"></a>
+<h2 class="section"><a href="ffplay.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
+‘<samp>-help</samp>’ option. They are separated into two categories:
+</p><dl compact="compact">
+<dt> ‘<samp>generic</samp>’</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> ‘<samp>private</samp>’</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 ‘<samp>id3v2_version</samp>’ private option of the MP3
+muxer:
+</p><table><tr><td> </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
+‘<samp>[:<var>stream_type</var>][:<var>stream_index</var>]</samp>’ to the option name.
+<var>stream_type</var> is ’v’ for video, ’a’ for audio and ’s’ for subtitle streams.
+<var>stream_index</var> is a global stream index when <var>stream_type</var> isn’t
+given, otherwise it counts streams of the given type only. As always, the index
+is zero-based. For example
+</p><table><tr><td> </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="ffplay.html#toc-Main-options">3.2 Main options</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-Main-options">3.3 Main options</a></h2>
<dl compact="compact">
<dt> ‘<samp>-x <var>width</var></samp>’</dt>
<dd><p>Force displayed height.
</p></dd>
<dt> ‘<samp>-s <var>size</var></samp>’</dt>
-<dd><p>This option has been removed. Use private format options for specifying the
-input video size.
+<dd><p>Set frame size (WxH or abbreviation), needed for videos which do
+not contain a header with the frame size like raw YUV. This option
+has been deprecated in favor of private options, try -video_size.
</p></dd>
<dt> ‘<samp>-an</samp>’</dt>
<dd><p>Disable audio.
</dl>
<a name="Advanced-options"></a>
-<h2 class="section"><a href="ffplay.html#toc-Advanced-options">3.3 Advanced options</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-Advanced-options">3.4 Advanced options</a></h2>
<dl compact="compact">
<dt> ‘<samp>-pix_fmt <var>format</var></samp>’</dt>
-<dd><p>This option has been removed. Use private options for specifying the
-input pixel format.
+<dd><p>Set pixel format.
+This option has been deprecated in favor of private options, try -pixel_format.
</p></dd>
<dt> ‘<samp>-stats</samp>’</dt>
<dd><p>Show the stream duration, the codec parameters, the current position in
</dl>
<a name="While-playing"></a>
-<h2 class="section"><a href="ffplay.html#toc-While-playing">3.4 While playing</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-While-playing">3.5 While playing</a></h2>
<dl compact="compact">
<dt> <q, ESC></dt>
</p>
<p>This decoder decodes rawvideo streams.
</p>
-<a name="Options-1"></a>
-<h3 class="subsection"><a href="ffplay.html#toc-Options-1">6.1.1 Options</a></h3>
+<a name="Options-3"></a>
+<h3 class="subsection"><a href="ffplay.html#toc-Options-3">6.1.1 Options</a></h3>
<dl compact="compact">
<dt> ‘<samp>top <var>top_field_first</var></samp>’</dt>
<p>For more information read:
<a href="http://jackaudio.org/">http://jackaudio.org/</a>
</p>
+<a name="lavfi"></a>
+<h2 class="section"><a href="ffplay.html#toc-lavfi">9.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 ‘<samp>graph</samp>’.
+</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="ffplay.html#toc-Options">9.6.1 Options</a></h3>
+
+<dl compact="compact">
+<dt> ‘<samp>graph</samp>’</dt>
+<dd><p>Specify the filtergraph to use as input. Each video open output must be
+labelled by a unique string of the form "out<var>N</var>", 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 "out0"
+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"></a>
+<h3 class="subsection"><a href="ffplay.html#toc-Examples">9.6.2 Examples</a></h3>
+
+<ul>
+<li>
+Create a color video stream and play it back with ‘<tt>ffplay</tt>’:
+<table><tr><td> </td><td><pre class="example">ffplay -f lavfi -graph "color=pink [out0]" dummy
+</pre></td></tr></table>
+
+</li><li>
+As the previous example, but use filename for specifying the graph
+description, and omit the "out0" label:
+<table><tr><td> </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> </td><td><pre class="example">ffplay -f lavfi -graph "testsrc [out0]; testsrc,hflip [out1]; testsrc,negate [out2]" test3
+</pre></td></tr></table>
+</li></ul>
+
<a name="libdc1394"></a>
-<h2 class="section"><a href="ffplay.html#toc-libdc1394">9.6 libdc1394</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-libdc1394">9.7 libdc1394</a></h2>
<p>IIDC1394 input device, based on libdc1394 and libraw1394.
</p>
<a name="openal"></a>
-<h2 class="section"><a href="ffplay.html#toc-openal">9.7 openal</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-openal">9.8 openal</a></h2>
<p>The OpenAL input device provides audio capture on all systems with a
working OpenAL 1.1 implementation.
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"></a>
-<h3 class="subsection"><a href="ffplay.html#toc-Options">9.7.1 Options</a></h3>
+<a name="Options-1"></a>
+<h3 class="subsection"><a href="ffplay.html#toc-Options-1">9.8.1 Options</a></h3>
<dl compact="compact">
<dt> ‘<samp>channels</samp>’</dt>
</dd>
</dl>
-<a name="Examples"></a>
-<h3 class="subsection"><a href="ffplay.html#toc-Examples">9.7.2 Examples</a></h3>
+<a name="Examples-2"></a>
+<h3 class="subsection"><a href="ffplay.html#toc-Examples-2">9.8.2 Examples</a></h3>
<p>Print the list of OpenAL supported devices and exit:
</p><table><tr><td> </td><td><pre class="example">$ ffmpeg -list_devices true -f openal -i dummy out.ogg
try the latest OpenAL Soft if the above does not work.
</p>
<a name="oss"></a>
-<h2 class="section"><a href="ffplay.html#toc-oss">9.8 oss</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-oss">9.9 oss</a></h2>
<p>Open Sound System input device.
</p>
<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="ffplay.html#toc-sndio-1">9.9 sndio</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-sndio-1">9.10 sndio</a></h2>
<p>sndio input device.
</p>
</pre></td></tr></table>
<a name="video4linux-and-video4linux2"></a>
-<h2 class="section"><a href="ffplay.html#toc-video4linux-and-video4linux2">9.10 video4linux and video4linux2</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-video4linux-and-video4linux2">9.11 video4linux and video4linux2</a></h2>
<p>Video4Linux and Video4Linux2 input video devices.
</p>
</pre></td></tr></table>
<a name="vfwcap"></a>
-<h2 class="section"><a href="ffplay.html#toc-vfwcap">9.11 vfwcap</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-vfwcap">9.12 vfwcap</a></h2>
<p>VfW (Video for Windows) capture input device.
</p>
other filename will be interpreted as device number 0.
</p>
<a name="x11grab"></a>
-<h2 class="section"><a href="ffplay.html#toc-x11grab">9.12 x11grab</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-x11grab">9.13 x11grab</a></h2>
<p>X11 video input device.
</p>
</p><table><tr><td> </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="ffplay.html#toc-follow_005fmouse-AVOption">9.13.1 <var>follow_mouse</var> AVOption</a></h3>
+
+<p>The syntax is:
+</p><table><tr><td> </td><td><pre class="example">-follow_mouse centered|<var>PIXELS</var>
+</pre></td></tr></table>
+
+<p>When it is specified with "centered", 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> </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="ffplay.html#toc-show_005fregion-AVOption">9.13.2 <var>show_region</var> AVOption</a></h3>
+
+<p>The syntax is:
+</p><table><tr><td> </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’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> </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>
<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
-‘<tt>libavfilter/avfiltergraph</tt>’.
+tools, and by the <code>avfilter_graph_parse()</code> function defined in
+‘<tt>libavfilter/avfiltergraph.h</tt>’.
</p>
<p>A filterchain consists of a sequence of connected filters, each one
connected to the previous one in the sequence. A filterchain is
</p>
<p>Below is a description of the currently available audio filters.
</p>
+<a name="aformat"></a>
+<h2 class="section"><a href="ffplay.html#toc-aformat">13.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 ":", in the form:
+"<var>sample_formats</var>:<var>channel_layouts</var>:<var>packing_formats</var>".
+</p>
+<p>Elements in each list are separated by "," which has to be escaped in the
+filtergraph specification.
+</p>
+<p>The special parameter "all", in place of a list of elements, signifies all
+supported formats.
+</p>
+<p>Some examples follow:
+</p><table><tr><td> </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="ffplay.html#toc-anull">13.1 anull</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-anull">13.2 anull</a></h2>
<p>Pass the audio source unchanged to the output.
</p>
+<a name="aresample"></a>
+<h2 class="section"><a href="ffplay.html#toc-aresample">13.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> </td><td><pre class="example">aresample=44100
+</pre></td></tr></table>
+
+<a name="ashowinfo"></a>
+<h2 class="section"><a href="ffplay.html#toc-ashowinfo">13.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> ‘<samp>n</samp>’</dt>
+<dd><p>sequential number of the input frame, starting from 0
+</p>
+</dd>
+<dt> ‘<samp>pts</samp>’</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> ‘<samp>pts_time</samp>’</dt>
+<dd><p>presentation TimeStamp of the input frame, expressed as a number of
+seconds
+</p>
+</dd>
+<dt> ‘<samp>pos</samp>’</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> ‘<samp>fmt</samp>’</dt>
+<dd><p>sample format name
+</p>
+</dd>
+<dt> ‘<samp>chlayout</samp>’</dt>
+<dd><p>channel layout description
+</p>
+</dd>
+<dt> ‘<samp>nb_samples</samp>’</dt>
+<dd><p>number of samples (per each channel) contained in the filtered frame
+</p>
+</dd>
+<dt> ‘<samp>rate</samp>’</dt>
+<dd><p>sample rate for the audio frame
+</p>
+</dd>
+<dt> ‘<samp>planar</samp>’</dt>
+<dd><p>if the packing format is planar, 0 if packed
+</p>
+</dd>
+<dt> ‘<samp>checksum</samp>’</dt>
+<dd><p>Adler-32 checksum of all the planes of the input frame
+</p>
+</dd>
+<dt> ‘<samp>plane_checksum</samp>’</dt>
+<dd><p>Adler-32 checksum for each input frame plane, expressed in the form
+"[<var>c0</var> <var>c1</var> <var>c2</var> <var>c3</var> <var>c4</var> <var>c5</var> <var>c6</var> <var>c7</var>]"
+</p></dd>
+</dl>
+
<a name="Audio-Sources"></a>
<h1 class="chapter"><a href="ffplay.html#toc-Audio-Sources">14. 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="ffplay.html#toc-abuffer">14.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 ‘<tt>libavfilter/asrc_abuffer.h</tt>’.
+</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> ‘<samp>sample_rate</samp>’</dt>
+<dd><p>The sample rate of the incoming audio buffers.
+</p>
+</dd>
+<dt> ‘<samp>sample_fmt</samp>’</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 ‘<tt>libavutil/samplefmt.h</tt>’
+</p>
+</dd>
+<dt> ‘<samp>channel_layout</samp>’</dt>
+<dd><p>The channel layout of the incoming audio buffers.
+Either a channel layout name from channel_layout_map in
+‘<tt>libavutil/audioconvert.c</tt>’ or its corresponding integer representation
+from the AV_CH_LAYOUT_* macros in ‘<tt>libavutil/audioconvert.h</tt>’
+</p>
+</dd>
+<dt> ‘<samp>packing</samp>’</dt>
+<dd><p>Either "packed" or "planar", or their integer representation: 0 or 1
+respectively.
+</p>
+</dd>
+</dl>
+
+<p>For example:
+</p><table><tr><td> </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 "s16" corresponds to the number
+1 and the "stereo" channel layout corresponds to the value 3, this is
+equivalent to:
+</p><table><tr><td> </td><td><pre class="example">abuffer=44100:1:3:1
+</pre></td></tr></table>
+
+<a name="amovie"></a>
+<h2 class="section"><a href="ffplay.html#toc-amovie">14.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 ":".
+</p>
+<p>The description of the accepted options follows.
+</p>
+<dl compact="compact">
+<dt> ‘<samp>format_name, f</samp>’</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> ‘<samp>seek_point, sp</samp>’</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 "0".
+</p>
+</dd>
+<dt> ‘<samp>stream_index, si</samp>’</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 "-1".
+</p>
+</dd>
+</dl>
+
<a name="anullsrc"></a>
-<h2 class="section"><a href="ffplay.html#toc-anullsrc">14.1 anullsrc</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-anullsrc">14.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.
<p>Below is a description of the currently available audio sinks.
</p>
+<a name="abuffersink"></a>
+<h2 class="section"><a href="ffplay.html#toc-abuffersink">15.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 ‘<tt>libavfilter/asink_abuffer.h</tt>’.
+</p>
+<p>It requires a pointer to a ABufferSinkContext structure, which defines the
+incoming buffers’ 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="ffplay.html#toc-anullsink">15.1 anullsink</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-anullsink">15.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
<dd><p>same as <var>out_w</var> and <var>out_h</var>
</p>
</dd>
+<dt> ‘<samp>a</samp>’</dt>
+<dd><p>same as <var>iw</var> / <var>ih</var>
+</p>
+</dd>
+<dt> ‘<samp>sar</samp>’</dt>
+<dd><p>input sample aspect ratio
+</p>
+</dd>
+<dt> ‘<samp>dar</samp>’</dt>
+<dd><p>input display aspect ratio, it is the same as (<var>iw</var> / <var>ih</var>) * <var>sar</var>
+</p>
+</dd>
+<dt> ‘<samp>hsub, vsub</samp>’</dt>
+<dd><p>horizontal and vertical chroma subsample values. For example for the
+pixel format "yuv422p" <var>hsub</var> is 2 and <var>vsub</var> is 1.
+</p>
+</dd>
<dt> ‘<samp>n</samp>’</dt>
<dd><p>the number of input frame, starting from 0
</p>
</p></dd>
</dl>
+<a name="delogo"></a>
+<h2 class="section"><a href="ffplay.html#toc-delogo">16.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
+"<var>x</var>:<var>y</var>:<var>w</var>:<var>h</var>:<var>band</var>", or as a list of
+<var>key</var>=<var>value</var> pairs, separated by ":".
+</p>
+<p>The description of the accepted parameters follows.
+</p>
+<dl compact="compact">
+<dt> ‘<samp>x, y</samp>’</dt>
+<dd><p>Specify the top left corner coordinates of the logo. They must be
+specified.
+</p>
+</dd>
+<dt> ‘<samp>w, h</samp>’</dt>
+<dd><p>Specify the width and height of the logo to clear. They must be
+specified.
+</p>
+</dd>
+<dt> ‘<samp>band, t</samp>’</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> ‘<samp>show</samp>’</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> </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> </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="ffplay.html#toc-drawbox">16.6 drawbox</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-drawbox">16.7 drawbox</a></h2>
<p>Draw a colored box on the input image.
</p>
</pre></td></tr></table>
<a name="drawtext"></a>
-<h2 class="section"><a href="ffplay.html#toc-drawtext">16.7 drawtext</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-drawtext">16.8 drawtext</a></h2>
<p>Draw text string or text from specified file on top of video using the
libfreetype library.
<a href="http://www.freetype.org/">http://www.freetype.org/</a>.
</p>
<a name="fade"></a>
-<h2 class="section"><a href="ffplay.html#toc-fade">16.8 fade</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-fade">16.9 fade</a></h2>
<p>Apply fade-in/out effect to input video.
</p>
</pre></td></tr></table>
<a name="fieldorder"></a>
-<h2 class="section"><a href="ffplay.html#toc-fieldorder">16.9 fieldorder</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-fieldorder">16.10 fieldorder</a></h2>
<p>Transform the field order of the input video.
</p>
</pre></td></tr></table>
<a name="fifo"></a>
-<h2 class="section"><a href="ffplay.html#toc-fifo">16.10 fifo</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-fifo">16.11 fifo</a></h2>
<p>Buffer input images and send them when they are requested.
</p>
<p>The filter does not take parameters.
</p>
<a name="format"></a>
-<h2 class="section"><a href="ffplay.html#toc-format">16.11 format</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-format">16.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
<p><a name="frei0r"></a>
</p><a name="frei0r-1"></a>
-<h2 class="section"><a href="ffplay.html#toc-frei0r-1">16.12 frei0r</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-frei0r-1">16.13 frei0r</a></h2>
<p>Apply a frei0r effect to the input video.
</p>
<a href="http://piksel.org/frei0r">http://piksel.org/frei0r</a>
</p>
<a name="gradfun"></a>
-<h2 class="section"><a href="ffplay.html#toc-gradfun">16.13 gradfun</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-gradfun">16.14 gradfun</a></h2>
<p>Fix the banding artifacts that are sometimes introduced into nearly flat
regions by truncation to 8bit colordepth.
</pre></td></tr></table>
<a name="hflip"></a>
-<h2 class="section"><a href="ffplay.html#toc-hflip">16.14 hflip</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-hflip">16.15 hflip</a></h2>
<p>Flip the input video horizontally.
</p>
</pre></td></tr></table>
<a name="hqdn3d"></a>
-<h2 class="section"><a href="ffplay.html#toc-hqdn3d">16.15 hqdn3d</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-hqdn3d">16.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
</dl>
<a name="lut_002c-lutrgb_002c-lutyuv"></a>
-<h2 class="section"><a href="ffplay.html#toc-lut_002c-lutrgb_002c-lutyuv">16.16 lut, lutrgb, lutyuv</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-lut_002c-lutrgb_002c-lutyuv">16.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.
</pre></td></tr></table>
<a name="mp"></a>
-<h2 class="section"><a href="ffplay.html#toc-mp">16.17 mp</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-mp">16.18 mp</a></h2>
<p>Apply an MPlayer filter to the input video.
</p>
</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>
<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>
<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>
<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="ffplay.html#toc-negate">16.18 negate</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-negate">16.19 negate</a></h2>
<p>Negate input video.
</p>
alpha component (if available). The default value in input is 0.
</p>
<a name="noformat"></a>
-<h2 class="section"><a href="ffplay.html#toc-noformat">16.19 noformat</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-noformat">16.20 noformat</a></h2>
<p>Force libavfilter not to use any of the specified pixel formats for the
input to the next filter.
</pre></td></tr></table>
<a name="null-1"></a>
-<h2 class="section"><a href="ffplay.html#toc-null-1">16.20 null</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-null-1">16.21 null</a></h2>
<p>Pass the video source unchanged to the output.
</p>
<a name="ocv"></a>
-<h2 class="section"><a href="ffplay.html#toc-ocv">16.21 ocv</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-ocv">16.22 ocv</a></h2>
<p>Apply video transform using libopencv.
</p>
</p>
<p><a name="dilate"></a>
</p><a name="dilate-1"></a>
-<h3 class="subsection"><a href="ffplay.html#toc-dilate-1">16.21.1 dilate</a></h3>
+<h3 class="subsection"><a href="ffplay.html#toc-dilate-1">16.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>.
</pre></td></tr></table>
<a name="erode"></a>
-<h3 class="subsection"><a href="ffplay.html#toc-erode">16.21.2 erode</a></h3>
+<h3 class="subsection"><a href="ffplay.html#toc-erode">16.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>.
with the same syntax and semantics as the <a href="#dilate">dilate</a> filter.
</p>
<a name="smooth"></a>
-<h3 class="subsection"><a href="ffplay.html#toc-smooth">16.21.3 smooth</a></h3>
+<h3 class="subsection"><a href="ffplay.html#toc-smooth">16.22.3 smooth</a></h3>
<p>Smooth the input video.
</p>
libopencv function <code>cvSmooth</code>.
</p>
<a name="overlay"></a>
-<h2 class="section"><a href="ffplay.html#toc-overlay">16.22 overlay</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-overlay">16.23 overlay</a></h2>
<p>Overlay one video on top of another.
</p>
approach is yet to be tested.
</p>
<a name="pad"></a>
-<h2 class="section"><a href="ffplay.html#toc-pad">16.23 pad</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-pad">16.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>.
expressions, or NAN if not yet specified
</p>
</dd>
-<dt> ‘<samp>dar, a</samp>’</dt>
-<dd><p>input display aspect ratio, same as <var>iw</var> / <var>ih</var>
+<dt> ‘<samp>a</samp>’</dt>
+<dd><p>same as <var>iw</var> / <var>ih</var>
</p>
</dd>
<dt> ‘<samp>sar</samp>’</dt>
<dd><p>input sample aspect ratio
</p>
</dd>
+<dt> ‘<samp>dar</samp>’</dt>
+<dd><p>input display aspect ratio, it is the same as (<var>iw</var> / <var>ih</var>) * <var>sar</var>
+</p>
+</dd>
<dt> ‘<samp>hsub, vsub</samp>’</dt>
<dd><p>horizontal and vertical chroma subsample values. For example for the
pixel format "yuv422p" <var>hsub</var> is 2 and <var>vsub</var> is 1.
# pad the input to get a final w/h ratio of 16:9
pad="ih*16/9:ih:(ow-iw)/2:(oh-ih)/2"
+# 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="ih*16/9/sar:ih:(ow-iw)/2:(oh-ih)/2"
+
# double output size and put the input video in the bottom-right
# corner of the output padded area
pad="2*iw:2*ih:ow-iw:oh-ih"
</pre></td></tr></table>
<a name="pixdesctest"></a>
-<h2 class="section"><a href="ffplay.html#toc-pixdesctest">16.24 pixdesctest</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-pixdesctest">16.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.
<p>can be used to test the monowhite pixel format descriptor definition.
</p>
<a name="scale"></a>
-<h2 class="section"><a href="ffplay.html#toc-scale">16.25 scale</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-scale">16.26 scale</a></h2>
<p>Scale the input video to <var>width</var>:<var>height</var> and/or convert the image format.
</p>
<dd><p>same as <var>out_w</var> and <var>out_h</var>
</p>
</dd>
-<dt> ‘<samp>dar, a</samp>’</dt>
-<dd><p>input display aspect ratio, same as <var>iw</var> / <var>ih</var>
+<dt> ‘<samp>a</samp>’</dt>
+<dd><p>same as <var>iw</var> / <var>ih</var>
</p>
</dd>
<dt> ‘<samp>sar</samp>’</dt>
<dd><p>input sample aspect ratio
</p>
</dd>
+<dt> ‘<samp>dar</samp>’</dt>
+<dd><p>input display aspect ratio, it is the same as (<var>iw</var> / <var>ih</var>) * <var>sar</var>
+</p>
+</dd>
<dt> ‘<samp>hsub, vsub</samp>’</dt>
<dd><p>horizontal and vertical chroma subsample values. For example for the
pixel format "yuv422p" <var>hsub</var> is 2 and <var>vsub</var> is 1.
</pre></td></tr></table>
<a name="select"></a>
-<h2 class="section"><a href="ffplay.html#toc-select">16.26 select</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-select">16.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
<p><a name="setdar"></a>
</p><a name="setdar-1"></a>
-<h2 class="section"><a href="ffplay.html#toc-setdar-1">16.27 setdar</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-setdar-1">16.28 setdar</a></h2>
<p>Set the Display Aspect Ratio for the filter output video.
</p>
<p>See also the <a href="#setsar">setsar</a> filter documentation.
</p>
<a name="setpts"></a>
-<h2 class="section"><a href="ffplay.html#toc-setpts">16.28 setpts</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-setpts">16.29 setpts</a></h2>
<p>Change the PTS (presentation timestamp) of the input video frames.
</p>
<p><a name="setsar"></a>
</p><a name="setsar-1"></a>
-<h2 class="section"><a href="ffplay.html#toc-setsar-1">16.29 setsar</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-setsar-1">16.30 setsar</a></h2>
<p>Set the Sample (aka Pixel) Aspect Ratio for the filter output video.
</p>
</pre></td></tr></table>
<a name="settb"></a>
-<h2 class="section"><a href="ffplay.html#toc-settb">16.30 settb</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-settb">16.31 settb</a></h2>
<p>Set the timebase to use for the output frames timestamps.
It is mainly useful for testing timebase configuration.
</pre></td></tr></table>
<a name="showinfo"></a>
-<h2 class="section"><a href="ffplay.html#toc-showinfo">16.31 showinfo</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-showinfo">16.32 showinfo</a></h2>
<p>Show a line containing various information for each input video frame.
The input video is not modified.
</dl>
<a name="slicify"></a>
-<h2 class="section"><a href="ffplay.html#toc-slicify">16.32 slicify</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-slicify">16.33 slicify</a></h2>
<p>Pass the images of input video on to next video filter as multiple
slices.
faster due to better use of the memory cache.
</p>
<a name="split"></a>
-<h2 class="section"><a href="ffplay.html#toc-split">16.33 split</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-split">16.34 split</a></h2>
<p>Pass on the input video to two outputs. Both outputs are identical to
the input video.
one padded.
</p>
<a name="transpose"></a>
-<h2 class="section"><a href="ffplay.html#toc-transpose">16.34 transpose</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-transpose">16.35 transpose</a></h2>
<p>Transpose rows with columns in the input video and optionally flip it.
</p>
</dl>
<a name="unsharp"></a>
-<h2 class="section"><a href="ffplay.html#toc-unsharp">16.35 unsharp</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-unsharp">16.36 unsharp</a></h2>
<p>Sharpen or blur the input video.
</p>
</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 ’5:5:1.0:0:0:0.0’.
+equivalent of the string ’5:5:1.0:5:5:0.0’.
</p>
<dl compact="compact">
<dt> ‘<samp>luma_msize_x</samp>’</dt>
</dd>
<dt> ‘<samp>chroma_msize_x</samp>’</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> ‘<samp>chroma_msize_y</samp>’</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> ‘<samp>luma_amount</samp>’</dt>
+<dt> ‘<samp>chroma_amount</samp>’</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>
</pre></td></tr></table>
<a name="vflip"></a>
-<h2 class="section"><a href="ffplay.html#toc-vflip">16.36 vflip</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-vflip">16.37 vflip</a></h2>
<p>Flip the input video vertically.
</p>
</pre></td></tr></table>
<a name="yadif"></a>
-<h2 class="section"><a href="ffplay.html#toc-yadif">16.37 yadif</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-yadif">16.38 yadif</a></h2>
<p>Deinterlace the input video ("yadif" means "yet another deinterlacing
filter").
</p>
<dl compact="compact">
<dt> ‘<samp>0</samp>’</dt>
-<dd><p>assume bottom field first
+<dd><p>assume top field first
</p></dd>
<dt> ‘<samp>1</samp>’</dt>
-<dd><p>assume top field first
+<dd><p>assume bottom field first
</p></dd>
<dt> ‘<samp>-1</samp>’</dt>
<dd><p>enable automatic detection
</pre></td></tr></table>
+<a name="mptestsrc"></a>
+<h2 class="section"><a href="ffplay.html#toc-mptestsrc">17.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 ":". The description of the accepted options follows.
+</p>
+<dl compact="compact">
+<dt> ‘<samp>rate, r</samp>’</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
+"25".
+</p>
+</dd>
+<dt> ‘<samp>duration, d</samp>’</dt>
+<dd><p>Set the video duration of the sourced video. The accepted syntax is:
+</p><table><tr><td> </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> ‘<samp>test, t</samp>’</dt>
+<dd>
+<p>Set the number or the name of the test to perform. Supported tests are:
+</p><dl compact="compact">
+<dt> ‘<samp>dc_luma</samp>’</dt>
+<dt> ‘<samp>dc_chroma</samp>’</dt>
+<dt> ‘<samp>freq_luma</samp>’</dt>
+<dt> ‘<samp>freq_chroma</samp>’</dt>
+<dt> ‘<samp>amp_luma</samp>’</dt>
+<dt> ‘<samp>amp_chroma</samp>’</dt>
+<dt> ‘<samp>cbp</samp>’</dt>
+<dt> ‘<samp>mv</samp>’</dt>
+<dt> ‘<samp>ring1</samp>’</dt>
+<dt> ‘<samp>ring2</samp>’</dt>
+<dt> ‘<samp>all</samp>’</dt>
+</dl>
+
+<p>Default value is "all", which will cycle through the list of all tests.
+</p></dd>
+</dl>
+
+<p>For example the following:
+</p><table><tr><td> </td><td><pre class="example">testsrc=t=dc_luma
+</pre></td></tr></table>
+
+<p>will generate a "dc_luma" test pattern.
+</p>
<a name="nullsrc"></a>
-<h2 class="section"><a href="ffplay.html#toc-nullsrc">17.4 nullsrc</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-nullsrc">17.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.
"AVTB" (the default timebase), and defaults to the value "AVTB".
</p>
<a name="frei0r_005fsrc"></a>
-<h2 class="section"><a href="ffplay.html#toc-frei0r_005fsrc">17.5 frei0r_src</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-frei0r_005fsrc">17.6 frei0r_src</a></h2>
<p>Provide a frei0r source.
</p>
</pre></td></tr></table>
<a name="rgbtestsrc_002c-testsrc"></a>
-<h2 class="section"><a href="ffplay.html#toc-rgbtestsrc_002c-testsrc">17.6 rgbtestsrc, testsrc</a></h2>
+<h2 class="section"><a href="ffplay.html#toc-rgbtestsrc_002c-testsrc">17.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
"25".
</p>
</dd>
+<dt> ‘<samp>sar</samp>’</dt>
+<dd><p>Set the sample aspect ratio of the sourced video.
+</p>
+</dd>
<dt> ‘<samp>duration</samp>’</dt>
<dd><p>Set the video duration of the sourced video. The accepted syntax is:
</p><table><tr><td> </td><td><pre class="example">[-]HH[:MM[:SS[.m...]]]
<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>
projects / casparcg / blobdiff