<!DOCTYPE html>
<html>
-<!-- Created on December 14, 2013 by texi2html 1.82 -->
+<!-- Created on June 19, 2014 by texi2html 1.82 -->
<!--
texi2html was written by:
Lionel Cons <Lionel.Cons@cern.ch> (original author)
<ul class="toc">
<li><a name="toc-aconvert" href="#aconvert">6.1 aconvert</a>
<ul class="toc">
- <li><a name="toc-Examples-41" href="#Examples-41">6.1.1 Examples</a></li>
+ <li><a name="toc-Examples-48" href="#Examples-48">6.1.1 Examples</a></li>
</ul></li>
<li><a name="toc-adelay" href="#adelay">6.2 adelay</a>
<ul class="toc">
- <li><a name="toc-Examples-31" href="#Examples-31">6.2.1 Examples</a></li>
+ <li><a name="toc-Examples-26" href="#Examples-26">6.2.1 Examples</a></li>
</ul></li>
<li><a name="toc-aecho" href="#aecho">6.3 aecho</a>
<ul class="toc">
- <li><a name="toc-Examples-26" href="#Examples-26">6.3.1 Examples</a></li>
+ <li><a name="toc-Examples-57" href="#Examples-57">6.3.1 Examples</a></li>
</ul></li>
<li><a name="toc-aeval" href="#aeval">6.4 aeval</a>
<ul class="toc">
- <li><a name="toc-Examples-49" href="#Examples-49">6.4.1 Examples</a></li>
+ <li><a name="toc-Examples-64" href="#Examples-64">6.4.1 Examples</a></li>
</ul></li>
<li><a name="toc-afade" href="#afade">6.5 afade</a>
<ul class="toc">
- <li><a name="toc-Examples-38" href="#Examples-38">6.5.1 Examples</a></li>
+ <li><a name="toc-Examples-43" href="#Examples-43">6.5.1 Examples</a></li>
</ul></li>
<li><a name="toc-aformat-1" href="#aformat-1">6.6 aformat</a></li>
<li><a name="toc-allpass" href="#allpass">6.7 allpass</a></li>
<li><a name="toc-amerge" href="#amerge">6.8 amerge</a>
<ul class="toc">
- <li><a name="toc-Examples-5" href="#Examples-5">6.8.1 Examples</a></li>
+ <li><a name="toc-Examples-7" href="#Examples-7">6.8.1 Examples</a></li>
</ul></li>
<li><a name="toc-amix" href="#amix">6.9 amix</a></li>
<li><a name="toc-anull" href="#anull">6.10 anull</a></li>
<li><a name="toc-aphaser" href="#aphaser">6.12 aphaser</a></li>
<li><a name="toc-aresample-1" href="#aresample-1">6.13 aresample</a>
<ul class="toc">
- <li><a name="toc-Examples-62" href="#Examples-62">6.13.1 Examples</a></li>
+ <li><a name="toc-Examples-21" href="#Examples-21">6.13.1 Examples</a></li>
</ul></li>
<li><a name="toc-asetnsamples" href="#asetnsamples">6.14 asetnsamples</a></li>
<li><a name="toc-asetrate" href="#asetrate">6.15 asetrate</a></li>
<li><a name="toc-astats" href="#astats">6.17 astats</a></li>
<li><a name="toc-astreamsync" href="#astreamsync">6.18 astreamsync</a>
<ul class="toc">
- <li><a name="toc-Examples-68" href="#Examples-68">6.18.1 Examples</a></li>
+ <li><a name="toc-Examples-4" href="#Examples-4">6.18.1 Examples</a></li>
</ul></li>
<li><a name="toc-asyncts" href="#asyncts">6.19 asyncts</a></li>
<li><a name="toc-atempo" href="#atempo">6.20 atempo</a>
<ul class="toc">
- <li><a name="toc-Examples-71" href="#Examples-71">6.20.1 Examples</a></li>
+ <li><a name="toc-Examples-44" href="#Examples-44">6.20.1 Examples</a></li>
</ul></li>
<li><a name="toc-atrim" href="#atrim">6.21 atrim</a></li>
<li><a name="toc-bandpass" href="#bandpass">6.22 bandpass</a></li>
<li><a name="toc-channelsplit" href="#channelsplit">6.27 channelsplit</a></li>
<li><a name="toc-compand" href="#compand">6.28 compand</a>
<ul class="toc">
- <li><a name="toc-Examples-24" href="#Examples-24">6.28.1 Examples</a></li>
+ <li><a name="toc-Examples-59" href="#Examples-59">6.28.1 Examples</a></li>
</ul></li>
<li><a name="toc-earwax" href="#earwax">6.29 earwax</a></li>
- <li><a name="toc-equalizer" href="#equalizer">6.30 equalizer</a></li>
+ <li><a name="toc-equalizer" href="#equalizer">6.30 equalizer</a>
+ <ul class="toc">
+ <li><a name="toc-Examples-63" href="#Examples-63">6.30.1 Examples</a></li>
+ </ul></li>
<li><a name="toc-highpass" href="#highpass">6.31 highpass</a></li>
<li><a name="toc-join" href="#join">6.32 join</a></li>
<li><a name="toc-ladspa" href="#ladspa">6.33 ladspa</a>
<ul class="toc">
- <li><a name="toc-Examples-23" href="#Examples-23">6.33.1 Examples</a></li>
- <li><a name="toc-Commands-2" href="#Commands-2">6.33.2 Commands</a></li>
+ <li><a name="toc-Examples-12" href="#Examples-12">6.33.1 Examples</a></li>
+ <li><a name="toc-Commands-3" href="#Commands-3">6.33.2 Commands</a></li>
</ul></li>
<li><a name="toc-lowpass" href="#lowpass">6.34 lowpass</a></li>
<li><a name="toc-pan" href="#pan">6.35 pan</a>
<li><a name="toc-resample" href="#resample">6.37 resample</a></li>
<li><a name="toc-silencedetect" href="#silencedetect">6.38 silencedetect</a>
<ul class="toc">
- <li><a name="toc-Examples-66" href="#Examples-66">6.38.1 Examples</a></li>
+ <li><a name="toc-Examples-9" href="#Examples-9">6.38.1 Examples</a></li>
</ul></li>
<li><a name="toc-treble" href="#treble">6.39 treble</a></li>
<li><a name="toc-volume" href="#volume">6.40 volume</a>
<ul class="toc">
- <li><a name="toc-Examples-14" href="#Examples-14">6.40.1 Examples</a></li>
+ <li><a name="toc-Commands" href="#Commands">6.40.1 Commands</a></li>
+ <li><a name="toc-Examples-33" href="#Examples-33">6.40.2 Examples</a></li>
</ul></li>
<li><a name="toc-volumedetect" href="#volumedetect">6.41 volumedetect</a>
<ul class="toc">
- <li><a name="toc-Examples-8" href="#Examples-8">6.41.1 Examples</a></li>
+ <li><a name="toc-Examples-5" href="#Examples-5">6.41.1 Examples</a></li>
</ul>
</li>
</ul></li>
<ul class="toc">
<li><a name="toc-abuffer" href="#abuffer">7.1 abuffer</a>
<ul class="toc">
- <li><a name="toc-Examples-55" href="#Examples-55">7.1.1 Examples</a></li>
+ <li><a name="toc-Examples-30" href="#Examples-30">7.1.1 Examples</a></li>
</ul></li>
<li><a name="toc-aevalsrc" href="#aevalsrc">7.2 aevalsrc</a>
<ul class="toc">
- <li><a name="toc-Examples-1" href="#Examples-1">7.2.1 Examples</a></li>
+ <li><a name="toc-Examples-56" href="#Examples-56">7.2.1 Examples</a></li>
</ul></li>
<li><a name="toc-anullsrc" href="#anullsrc">7.3 anullsrc</a>
<ul class="toc">
- <li><a name="toc-Examples-39" href="#Examples-39">7.3.1 Examples</a></li>
+ <li><a name="toc-Examples" href="#Examples">7.3.1 Examples</a></li>
</ul></li>
<li><a name="toc-flite" href="#flite">7.4 flite</a>
<ul class="toc">
- <li><a name="toc-Examples-20" href="#Examples-20">7.4.1 Examples</a></li>
+ <li><a name="toc-Examples-27" href="#Examples-27">7.4.1 Examples</a></li>
</ul></li>
<li><a name="toc-sine" href="#sine">7.5 sine</a>
<ul class="toc">
- <li><a name="toc-Examples-58" href="#Examples-58">7.5.1 Examples</a></li>
+ <li><a name="toc-Examples-46" href="#Examples-46">7.5.1 Examples</a></li>
</ul>
</li>
</ul></li>
<li><a name="toc-blackframe" href="#blackframe">9.6 blackframe</a></li>
<li><a name="toc-blend" href="#blend">9.7 blend</a>
<ul class="toc">
- <li><a name="toc-Examples-21" href="#Examples-21">9.7.1 Examples</a></li>
+ <li><a name="toc-Examples-51" href="#Examples-51">9.7.1 Examples</a></li>
</ul></li>
<li><a name="toc-boxblur" href="#boxblur">9.8 boxblur</a>
<ul class="toc">
- <li><a name="toc-Examples-4" href="#Examples-4">9.8.1 Examples</a></li>
+ <li><a name="toc-Examples-66" href="#Examples-66">9.8.1 Examples</a></li>
</ul></li>
<li><a name="toc-colorbalance" href="#colorbalance">9.9 colorbalance</a>
<ul class="toc">
- <li><a name="toc-Examples-37" href="#Examples-37">9.9.1 Examples</a></li>
+ <li><a name="toc-Examples-29" href="#Examples-29">9.9.1 Examples</a></li>
</ul></li>
<li><a name="toc-colorchannelmixer" href="#colorchannelmixer">9.10 colorchannelmixer</a>
<ul class="toc">
- <li><a name="toc-Examples-35" href="#Examples-35">9.10.1 Examples</a></li>
+ <li><a name="toc-Examples-68" href="#Examples-68">9.10.1 Examples</a></li>
</ul></li>
<li><a name="toc-colormatrix" href="#colormatrix">9.11 colormatrix</a></li>
<li><a name="toc-copy" href="#copy">9.12 copy</a></li>
<li><a name="toc-crop" href="#crop">9.13 crop</a>
<ul class="toc">
- <li><a name="toc-Examples-36" href="#Examples-36">9.13.1 Examples</a></li>
+ <li><a name="toc-Examples-47" href="#Examples-47">9.13.1 Examples</a></li>
</ul></li>
<li><a name="toc-cropdetect" href="#cropdetect">9.14 cropdetect</a></li>
<li><a name="toc-curves-1" href="#curves-1">9.15 curves</a>
<ul class="toc">
- <li><a name="toc-Examples-2" href="#Examples-2">9.15.1 Examples</a></li>
+ <li><a name="toc-Examples-6" href="#Examples-6">9.15.1 Examples</a></li>
</ul></li>
<li><a name="toc-dctdnoiz" href="#dctdnoiz">9.16 dctdnoiz</a>
<ul class="toc">
- <li><a name="toc-Examples-22" href="#Examples-22">9.16.1 Examples</a></li>
+ <li><a name="toc-Examples-1" href="#Examples-1">9.16.1 Examples</a></li>
</ul></li>
<li><a name="toc-decimate-1" href="#decimate-1">9.17 decimate</a></li>
- <li><a name="toc-delogo" href="#delogo">9.18 delogo</a>
+ <li><a name="toc-dejudder" href="#dejudder">9.18 dejudder</a></li>
+ <li><a name="toc-delogo" href="#delogo">9.19 delogo</a>
<ul class="toc">
- <li><a name="toc-Examples-50" href="#Examples-50">9.18.1 Examples</a></li>
+ <li><a name="toc-Examples-22" href="#Examples-22">9.19.1 Examples</a></li>
</ul></li>
- <li><a name="toc-deshake" href="#deshake">9.19 deshake</a></li>
- <li><a name="toc-drawbox" href="#drawbox">9.20 drawbox</a>
+ <li><a name="toc-deshake" href="#deshake">9.20 deshake</a></li>
+ <li><a name="toc-drawbox" href="#drawbox">9.21 drawbox</a>
<ul class="toc">
- <li><a name="toc-Examples-60" href="#Examples-60">9.20.1 Examples</a></li>
+ <li><a name="toc-Examples-52" href="#Examples-52">9.21.1 Examples</a></li>
</ul></li>
- <li><a name="toc-drawgrid" href="#drawgrid">9.21 drawgrid</a>
+ <li><a name="toc-drawgrid" href="#drawgrid">9.22 drawgrid</a>
<ul class="toc">
- <li><a name="toc-Examples-28" href="#Examples-28">9.21.1 Examples</a></li>
+ <li><a name="toc-Examples-19" href="#Examples-19">9.22.1 Examples</a></li>
</ul></li>
- <li><a name="toc-drawtext-1" href="#drawtext-1">9.22 drawtext</a>
+ <li><a name="toc-drawtext-1" href="#drawtext-1">9.23 drawtext</a>
<ul class="toc">
- <li><a name="toc-Syntax" href="#Syntax">9.22.1 Syntax</a></li>
- <li><a name="toc-Text-expansion" href="#Text-expansion">9.22.2 Text expansion</a></li>
- <li><a name="toc-Examples-32" href="#Examples-32">9.22.3 Examples</a></li>
+ <li><a name="toc-Syntax" href="#Syntax">9.23.1 Syntax</a></li>
+ <li><a name="toc-Text-expansion" href="#Text-expansion">9.23.2 Text expansion</a></li>
+ <li><a name="toc-Examples-2" href="#Examples-2">9.23.3 Examples</a></li>
</ul></li>
- <li><a name="toc-edgedetect" href="#edgedetect">9.23 edgedetect</a></li>
- <li><a name="toc-extractplanes" href="#extractplanes">9.24 extractplanes</a>
+ <li><a name="toc-edgedetect" href="#edgedetect">9.24 edgedetect</a></li>
+ <li><a name="toc-extractplanes" href="#extractplanes">9.25 extractplanes</a>
<ul class="toc">
- <li><a name="toc-Examples-54" href="#Examples-54">9.24.1 Examples</a></li>
+ <li><a name="toc-Examples-71" href="#Examples-71">9.25.1 Examples</a></li>
</ul></li>
- <li><a name="toc-elbg" href="#elbg">9.25 elbg</a></li>
- <li><a name="toc-fade" href="#fade">9.26 fade</a>
+ <li><a name="toc-elbg" href="#elbg">9.26 elbg</a></li>
+ <li><a name="toc-fade" href="#fade">9.27 fade</a>
<ul class="toc">
- <li><a name="toc-Examples-47" href="#Examples-47">9.26.1 Examples</a></li>
+ <li><a name="toc-Examples-41" href="#Examples-41">9.27.1 Examples</a></li>
</ul></li>
- <li><a name="toc-field" href="#field">9.27 field</a></li>
- <li><a name="toc-fieldmatch" href="#fieldmatch">9.28 fieldmatch</a>
+ <li><a name="toc-field" href="#field">9.28 field</a></li>
+ <li><a name="toc-fieldmatch" href="#fieldmatch">9.29 fieldmatch</a>
<ul class="toc">
- <li><a name="toc-p_002fc_002fn_002fu_002fb-meaning-1" href="#p_002fc_002fn_002fu_002fb-meaning-1">9.28.1 p/c/n/u/b meaning</a>
+ <li><a name="toc-p_002fc_002fn_002fu_002fb-meaning-1" href="#p_002fc_002fn_002fu_002fb-meaning-1">9.29.1 p/c/n/u/b meaning</a>
<ul class="toc">
- <li><a name="toc-p_002fc_002fn" href="#p_002fc_002fn">9.28.1.1 p/c/n</a></li>
- <li><a name="toc-u_002fb" href="#u_002fb">9.28.1.2 u/b</a></li>
+ <li><a name="toc-p_002fc_002fn" href="#p_002fc_002fn">9.29.1.1 p/c/n</a></li>
+ <li><a name="toc-u_002fb" href="#u_002fb">9.29.1.2 u/b</a></li>
</ul></li>
- <li><a name="toc-Examples-10" href="#Examples-10">9.28.2 Examples</a></li>
+ <li><a name="toc-Examples-67" href="#Examples-67">9.29.2 Examples</a></li>
</ul></li>
- <li><a name="toc-fieldorder" href="#fieldorder">9.29 fieldorder</a></li>
- <li><a name="toc-fifo" href="#fifo">9.30 fifo</a></li>
- <li><a name="toc-format-1" href="#format-1">9.31 format</a>
+ <li><a name="toc-fieldorder" href="#fieldorder">9.30 fieldorder</a></li>
+ <li><a name="toc-fifo" href="#fifo">9.31 fifo</a></li>
+ <li><a name="toc-format-1" href="#format-1">9.32 format</a>
<ul class="toc">
- <li><a name="toc-Examples-65" href="#Examples-65">9.31.1 Examples</a></li>
+ <li><a name="toc-Examples-25" href="#Examples-25">9.32.1 Examples</a></li>
</ul></li>
- <li><a name="toc-fps-1" href="#fps-1">9.32 fps</a>
+ <li><a name="toc-fps-1" href="#fps-1">9.33 fps</a>
<ul class="toc">
- <li><a name="toc-Examples-72" href="#Examples-72">9.32.1 Examples</a></li>
+ <li><a name="toc-Examples-72" href="#Examples-72">9.33.1 Examples</a></li>
</ul></li>
- <li><a name="toc-framestep" href="#framestep">9.33 framestep</a></li>
- <li><a name="toc-frei0r-1" href="#frei0r-1">9.34 frei0r</a>
+ <li><a name="toc-framepack" href="#framepack">9.34 framepack</a></li>
+ <li><a name="toc-framestep" href="#framestep">9.35 framestep</a></li>
+ <li><a name="toc-frei0r-1" href="#frei0r-1">9.36 frei0r</a>
<ul class="toc">
- <li><a name="toc-Examples-42" href="#Examples-42">9.34.1 Examples</a></li>
+ <li><a name="toc-Examples-65" href="#Examples-65">9.36.1 Examples</a></li>
</ul></li>
- <li><a name="toc-geq" href="#geq">9.35 geq</a>
+ <li><a name="toc-geq" href="#geq">9.37 geq</a>
<ul class="toc">
- <li><a name="toc-Examples-7" href="#Examples-7">9.35.1 Examples</a></li>
+ <li><a name="toc-Examples-70" href="#Examples-70">9.37.1 Examples</a></li>
</ul></li>
- <li><a name="toc-gradfun" href="#gradfun">9.36 gradfun</a>
+ <li><a name="toc-gradfun" href="#gradfun">9.38 gradfun</a>
<ul class="toc">
- <li><a name="toc-Examples-11" href="#Examples-11">9.36.1 Examples</a></li>
+ <li><a name="toc-Examples-28" href="#Examples-28">9.38.1 Examples</a></li>
</ul></li>
- <li><a name="toc-haldclut-1" href="#haldclut-1">9.37 haldclut</a>
+ <li><a name="toc-haldclut-1" href="#haldclut-1">9.39 haldclut</a>
<ul class="toc">
- <li><a name="toc-Workflow-examples" href="#Workflow-examples">9.37.1 Workflow examples</a>
+ <li><a name="toc-Workflow-examples" href="#Workflow-examples">9.39.1 Workflow examples</a>
<ul class="toc">
- <li><a name="toc-Hald-CLUT-video-stream" href="#Hald-CLUT-video-stream">9.37.1.1 Hald CLUT video stream</a></li>
- <li><a name="toc-Hald-CLUT-with-preview" href="#Hald-CLUT-with-preview">9.37.1.2 Hald CLUT with preview</a></li>
+ <li><a name="toc-Hald-CLUT-video-stream" href="#Hald-CLUT-video-stream">9.39.1.1 Hald CLUT video stream</a></li>
+ <li><a name="toc-Hald-CLUT-with-preview" href="#Hald-CLUT-with-preview">9.39.1.2 Hald CLUT with preview</a></li>
</ul>
</li>
</ul></li>
- <li><a name="toc-hflip" href="#hflip">9.38 hflip</a></li>
- <li><a name="toc-histeq" href="#histeq">9.39 histeq</a></li>
- <li><a name="toc-histogram" href="#histogram">9.40 histogram</a>
+ <li><a name="toc-hflip" href="#hflip">9.40 hflip</a></li>
+ <li><a name="toc-histeq" href="#histeq">9.41 histeq</a></li>
+ <li><a name="toc-histogram" href="#histogram">9.42 histogram</a>
<ul class="toc">
- <li><a name="toc-Examples-45" href="#Examples-45">9.40.1 Examples</a></li>
+ <li><a name="toc-Examples-74" href="#Examples-74">9.42.1 Examples</a></li>
</ul></li>
- <li><a name="toc-hqdn3d-1" href="#hqdn3d-1">9.41 hqdn3d</a></li>
- <li><a name="toc-hue" href="#hue">9.42 hue</a>
+ <li><a name="toc-hqdn3d-1" href="#hqdn3d-1">9.43 hqdn3d</a></li>
+ <li><a name="toc-hue" href="#hue">9.44 hue</a>
<ul class="toc">
- <li><a name="toc-Examples-52" href="#Examples-52">9.42.1 Examples</a></li>
- <li><a name="toc-Commands" href="#Commands">9.42.2 Commands</a></li>
+ <li><a name="toc-Examples-8" href="#Examples-8">9.44.1 Examples</a></li>
+ <li><a name="toc-Commands-4" href="#Commands-4">9.44.2 Commands</a></li>
</ul></li>
- <li><a name="toc-idet" href="#idet">9.43 idet</a></li>
- <li><a name="toc-il" href="#il">9.44 il</a></li>
- <li><a name="toc-interlace" href="#interlace">9.45 interlace</a></li>
- <li><a name="toc-kerndeint" href="#kerndeint">9.46 kerndeint</a>
+ <li><a name="toc-idet" href="#idet">9.45 idet</a></li>
+ <li><a name="toc-il" href="#il">9.46 il</a></li>
+ <li><a name="toc-interlace" href="#interlace">9.47 interlace</a></li>
+ <li><a name="toc-kerndeint" href="#kerndeint">9.48 kerndeint</a>
<ul class="toc">
- <li><a name="toc-Examples-29" href="#Examples-29">9.46.1 Examples</a></li>
+ <li><a name="toc-Examples-18" href="#Examples-18">9.48.1 Examples</a></li>
</ul></li>
- <li><a name="toc-lut3d-1" href="#lut3d-1">9.47 lut3d</a></li>
- <li><a name="toc-lut_002c-lutrgb_002c-lutyuv" href="#lut_002c-lutrgb_002c-lutyuv">9.48 lut, lutrgb, lutyuv</a>
+ <li><a name="toc-lut3d-1" href="#lut3d-1">9.49 lut3d</a></li>
+ <li><a name="toc-lut_002c-lutrgb_002c-lutyuv" href="#lut_002c-lutrgb_002c-lutyuv">9.50 lut, lutrgb, lutyuv</a>
<ul class="toc">
- <li><a name="toc-Examples-40" href="#Examples-40">9.48.1 Examples</a></li>
+ <li><a name="toc-Examples-38" href="#Examples-38">9.50.1 Examples</a></li>
</ul></li>
- <li><a name="toc-mergeplanes" href="#mergeplanes">9.49 mergeplanes</a>
+ <li><a name="toc-mergeplanes" href="#mergeplanes">9.51 mergeplanes</a>
<ul class="toc">
- <li><a name="toc-Examples-34" href="#Examples-34">9.49.1 Examples</a></li>
+ <li><a name="toc-Examples-40" href="#Examples-40">9.51.1 Examples</a></li>
</ul></li>
- <li><a name="toc-mcdeint" href="#mcdeint">9.50 mcdeint</a></li>
- <li><a name="toc-mp" href="#mp">9.51 mp</a>
+ <li><a name="toc-mcdeint" href="#mcdeint">9.52 mcdeint</a></li>
+ <li><a name="toc-mp" href="#mp">9.53 mp</a>
<ul class="toc">
- <li><a name="toc-Examples-46" href="#Examples-46">9.51.1 Examples</a></li>
+ <li><a name="toc-Examples-73" href="#Examples-73">9.53.1 Examples</a></li>
</ul></li>
- <li><a name="toc-mpdecimate" href="#mpdecimate">9.52 mpdecimate</a></li>
- <li><a name="toc-negate" href="#negate">9.53 negate</a></li>
- <li><a name="toc-noformat" href="#noformat">9.54 noformat</a>
+ <li><a name="toc-mpdecimate" href="#mpdecimate">9.54 mpdecimate</a></li>
+ <li><a name="toc-negate" href="#negate">9.55 negate</a></li>
+ <li><a name="toc-noformat" href="#noformat">9.56 noformat</a>
<ul class="toc">
- <li><a name="toc-Examples-18" href="#Examples-18">9.54.1 Examples</a></li>
+ <li><a name="toc-Examples-16" href="#Examples-16">9.56.1 Examples</a></li>
</ul></li>
- <li><a name="toc-noise" href="#noise">9.55 noise</a>
+ <li><a name="toc-noise" href="#noise">9.57 noise</a>
<ul class="toc">
- <li><a name="toc-Examples-48" href="#Examples-48">9.55.1 Examples</a></li>
+ <li><a name="toc-Examples-32" href="#Examples-32">9.57.1 Examples</a></li>
</ul></li>
- <li><a name="toc-null" href="#null">9.56 null</a></li>
- <li><a name="toc-ocv" href="#ocv">9.57 ocv</a>
+ <li><a name="toc-null" href="#null">9.58 null</a></li>
+ <li><a name="toc-ocv" href="#ocv">9.59 ocv</a>
<ul class="toc">
- <li><a name="toc-dilate-1" href="#dilate-1">9.57.1 dilate</a></li>
- <li><a name="toc-erode" href="#erode">9.57.2 erode</a></li>
- <li><a name="toc-smooth" href="#smooth">9.57.3 smooth</a></li>
+ <li><a name="toc-dilate-1" href="#dilate-1">9.59.1 dilate</a></li>
+ <li><a name="toc-erode" href="#erode">9.59.2 erode</a></li>
+ <li><a name="toc-smooth" href="#smooth">9.59.3 smooth</a></li>
</ul></li>
- <li><a name="toc-overlay-1" href="#overlay-1">9.58 overlay</a>
+ <li><a name="toc-overlay-1" href="#overlay-1">9.60 overlay</a>
<ul class="toc">
- <li><a name="toc-Commands-1" href="#Commands-1">9.58.1 Commands</a></li>
- <li><a name="toc-Examples-30" href="#Examples-30">9.58.2 Examples</a></li>
+ <li><a name="toc-Commands-5" href="#Commands-5">9.60.1 Commands</a></li>
+ <li><a name="toc-Examples-69" href="#Examples-69">9.60.2 Examples</a></li>
</ul></li>
- <li><a name="toc-owdenoise" href="#owdenoise">9.59 owdenoise</a></li>
- <li><a name="toc-pad" href="#pad">9.60 pad</a>
+ <li><a name="toc-owdenoise" href="#owdenoise">9.61 owdenoise</a></li>
+ <li><a name="toc-pad" href="#pad">9.62 pad</a>
<ul class="toc">
- <li><a name="toc-Examples-59" href="#Examples-59">9.60.1 Examples</a></li>
+ <li><a name="toc-Examples-36" href="#Examples-36">9.62.1 Examples</a></li>
</ul></li>
- <li><a name="toc-perspective" href="#perspective">9.61 perspective</a></li>
- <li><a name="toc-phase" href="#phase">9.62 phase</a></li>
- <li><a name="toc-pixdesctest" href="#pixdesctest">9.63 pixdesctest</a></li>
- <li><a name="toc-pp" href="#pp">9.64 pp</a>
+ <li><a name="toc-perspective" href="#perspective">9.63 perspective</a></li>
+ <li><a name="toc-phase" href="#phase">9.64 phase</a></li>
+ <li><a name="toc-pixdesctest" href="#pixdesctest">9.65 pixdesctest</a></li>
+ <li><a name="toc-pp" href="#pp">9.66 pp</a>
<ul class="toc">
- <li><a name="toc-Examples-12" href="#Examples-12">9.64.1 Examples</a></li>
+ <li><a name="toc-Examples-14" href="#Examples-14">9.66.1 Examples</a></li>
</ul></li>
- <li><a name="toc-psnr" href="#psnr">9.65 psnr</a></li>
- <li><a name="toc-pullup" href="#pullup">9.66 pullup</a></li>
- <li><a name="toc-removelogo" href="#removelogo">9.67 removelogo</a></li>
- <li><a name="toc-rotate" href="#rotate">9.68 rotate</a>
+ <li><a name="toc-psnr" href="#psnr">9.67 psnr</a></li>
+ <li><a name="toc-pullup-1" href="#pullup-1">9.68 pullup</a></li>
+ <li><a name="toc-removelogo" href="#removelogo">9.69 removelogo</a></li>
+ <li><a name="toc-rotate" href="#rotate">9.70 rotate</a>
<ul class="toc">
- <li><a name="toc-Examples-33" href="#Examples-33">9.68.1 Examples</a></li>
- <li><a name="toc-Commands-4" href="#Commands-4">9.68.2 Commands</a></li>
+ <li><a name="toc-Examples-39" href="#Examples-39">9.70.1 Examples</a></li>
+ <li><a name="toc-Commands-2" href="#Commands-2">9.70.2 Commands</a></li>
</ul></li>
- <li><a name="toc-sab" href="#sab">9.69 sab</a></li>
- <li><a name="toc-scale-1" href="#scale-1">9.70 scale</a>
+ <li><a name="toc-sab" href="#sab">9.71 sab</a></li>
+ <li><a name="toc-scale-1" href="#scale-1">9.72 scale</a>
<ul class="toc">
- <li><a name="toc-Options" href="#Options">9.70.1 Options</a></li>
- <li><a name="toc-Examples-44" href="#Examples-44">9.70.2 Examples</a></li>
+ <li><a name="toc-Options" href="#Options">9.72.1 Options</a></li>
+ <li><a name="toc-Examples-3" href="#Examples-3">9.72.2 Examples</a></li>
</ul></li>
- <li><a name="toc-separatefields" href="#separatefields">9.71 separatefields</a></li>
- <li><a name="toc-setdar_002c-setsar" href="#setdar_002c-setsar">9.72 setdar, setsar</a>
+ <li><a name="toc-separatefields" href="#separatefields">9.73 separatefields</a></li>
+ <li><a name="toc-setdar_002c-setsar" href="#setdar_002c-setsar">9.74 setdar, setsar</a>
<ul class="toc">
- <li><a name="toc-Examples-16" href="#Examples-16">9.72.1 Examples</a></li>
+ <li><a name="toc-Examples-42" href="#Examples-42">9.74.1 Examples</a></li>
</ul></li>
- <li><a name="toc-setfield-1" href="#setfield-1">9.73 setfield</a></li>
- <li><a name="toc-showinfo" href="#showinfo">9.74 showinfo</a></li>
- <li><a name="toc-smartblur-1" href="#smartblur-1">9.75 smartblur</a></li>
- <li><a name="toc-stereo3d" href="#stereo3d">9.76 stereo3d</a>
+ <li><a name="toc-setfield-1" href="#setfield-1">9.75 setfield</a></li>
+ <li><a name="toc-showinfo" href="#showinfo">9.76 showinfo</a></li>
+ <li><a name="toc-smartblur-1" href="#smartblur-1">9.77 smartblur</a></li>
+ <li><a name="toc-stereo3d" href="#stereo3d">9.78 stereo3d</a>
<ul class="toc">
- <li><a name="toc-Examples-73" href="#Examples-73">9.76.1 Examples</a></li>
+ <li><a name="toc-Examples-11" href="#Examples-11">9.78.1 Examples</a></li>
</ul></li>
- <li><a name="toc-spp" href="#spp">9.77 spp</a></li>
- <li><a name="toc-subtitles-1" href="#subtitles-1">9.78 subtitles</a></li>
- <li><a name="toc-super2xsai" href="#super2xsai">9.79 super2xsai</a></li>
- <li><a name="toc-swapuv" href="#swapuv">9.80 swapuv</a></li>
- <li><a name="toc-telecine" href="#telecine">9.81 telecine</a></li>
- <li><a name="toc-thumbnail" href="#thumbnail">9.82 thumbnail</a>
+ <li><a name="toc-spp" href="#spp">9.79 spp</a></li>
+ <li><a name="toc-subtitles-1" href="#subtitles-1">9.80 subtitles</a></li>
+ <li><a name="toc-super2xsai" href="#super2xsai">9.81 super2xsai</a></li>
+ <li><a name="toc-swapuv" href="#swapuv">9.82 swapuv</a></li>
+ <li><a name="toc-telecine" href="#telecine">9.83 telecine</a></li>
+ <li><a name="toc-thumbnail" href="#thumbnail">9.84 thumbnail</a>
<ul class="toc">
- <li><a name="toc-Examples-53" href="#Examples-53">9.82.1 Examples</a></li>
+ <li><a name="toc-Examples-37" href="#Examples-37">9.84.1 Examples</a></li>
</ul></li>
- <li><a name="toc-tile" href="#tile">9.83 tile</a>
+ <li><a name="toc-tile" href="#tile">9.85 tile</a>
<ul class="toc">
- <li><a name="toc-Examples-67" href="#Examples-67">9.83.1 Examples</a></li>
+ <li><a name="toc-Examples-62" href="#Examples-62">9.85.1 Examples</a></li>
</ul></li>
- <li><a name="toc-tinterlace" href="#tinterlace">9.84 tinterlace</a></li>
- <li><a name="toc-transpose" href="#transpose">9.85 transpose</a></li>
- <li><a name="toc-trim" href="#trim">9.86 trim</a></li>
- <li><a name="toc-unsharp" href="#unsharp">9.87 unsharp</a>
+ <li><a name="toc-tinterlace" href="#tinterlace">9.86 tinterlace</a></li>
+ <li><a name="toc-transpose" href="#transpose">9.87 transpose</a></li>
+ <li><a name="toc-trim" href="#trim">9.88 trim</a></li>
+ <li><a name="toc-unsharp" href="#unsharp">9.89 unsharp</a>
<ul class="toc">
- <li><a name="toc-Examples-9" href="#Examples-9">9.87.1 Examples</a></li>
+ <li><a name="toc-Examples-20" href="#Examples-20">9.89.1 Examples</a></li>
</ul></li>
- <li><a name="toc-vidstabdetect-1" href="#vidstabdetect-1">9.88 vidstabdetect</a>
+ <li><a name="toc-vidstabdetect-1" href="#vidstabdetect-1">9.90 vidstabdetect</a>
<ul class="toc">
- <li><a name="toc-Examples-57" href="#Examples-57">9.88.1 Examples</a></li>
+ <li><a name="toc-Examples-61" href="#Examples-61">9.90.1 Examples</a></li>
</ul></li>
- <li><a name="toc-vidstabtransform-1" href="#vidstabtransform-1">9.89 vidstabtransform</a>
+ <li><a name="toc-vidstabtransform-1" href="#vidstabtransform-1">9.91 vidstabtransform</a>
<ul class="toc">
- <li><a name="toc-Examples-56" href="#Examples-56">9.89.1 Examples</a></li>
+ <li><a name="toc-Options-1" href="#Options-1">9.91.1 Options</a></li>
+ <li><a name="toc-Examples-50" href="#Examples-50">9.91.2 Examples</a></li>
</ul></li>
- <li><a name="toc-vflip" href="#vflip">9.90 vflip</a></li>
- <li><a name="toc-vignette" href="#vignette">9.91 vignette</a>
+ <li><a name="toc-vflip" href="#vflip">9.92 vflip</a></li>
+ <li><a name="toc-vignette" href="#vignette">9.93 vignette</a>
<ul class="toc">
- <li><a name="toc-Expressions" href="#Expressions">9.91.1 Expressions</a></li>
- <li><a name="toc-Examples-51" href="#Examples-51">9.91.2 Examples</a></li>
+ <li><a name="toc-Expressions" href="#Expressions">9.93.1 Expressions</a></li>
+ <li><a name="toc-Examples-53" href="#Examples-53">9.93.2 Examples</a></li>
</ul></li>
- <li><a name="toc-w3fdif" href="#w3fdif">9.92 w3fdif</a></li>
- <li><a name="toc-yadif-1" href="#yadif-1">9.93 yadif</a></li>
+ <li><a name="toc-w3fdif" href="#w3fdif">9.94 w3fdif</a></li>
+ <li><a name="toc-yadif-1" href="#yadif-1">9.95 yadif</a></li>
</ul></li>
<li><a name="toc-Video-Sources" href="#Video-Sources">10. Video Sources</a>
<ul class="toc">
<li><a name="toc-buffer" href="#buffer">10.1 buffer</a></li>
<li><a name="toc-cellauto" href="#cellauto">10.2 cellauto</a>
<ul class="toc">
- <li><a name="toc-Examples-70" href="#Examples-70">10.2.1 Examples</a></li>
+ <li><a name="toc-Examples-58" href="#Examples-58">10.2.1 Examples</a></li>
</ul></li>
<li><a name="toc-mandelbrot" href="#mandelbrot">10.3 mandelbrot</a></li>
<li><a name="toc-mptestsrc" href="#mptestsrc">10.4 mptestsrc</a></li>
<li><a name="toc-frei0r_005fsrc" href="#frei0r_005fsrc">10.5 frei0r_src</a></li>
<li><a name="toc-life" href="#life">10.6 life</a>
<ul class="toc">
- <li><a name="toc-Examples-6" href="#Examples-6">10.6.1 Examples</a></li>
+ <li><a name="toc-Examples-24" href="#Examples-24">10.6.1 Examples</a></li>
</ul></li>
<li><a name="toc-color_002c-haldclutsrc_002c-nullsrc_002c-rgbtestsrc_002c-smptebars_002c-smptehdbars_002c-testsrc" href="#color_002c-haldclutsrc_002c-nullsrc_002c-rgbtestsrc_002c-smptebars_002c-smptehdbars_002c-testsrc">10.7 color, haldclutsrc, nullsrc, rgbtestsrc, smptebars, smptehdbars, testsrc</a>
<ul class="toc">
- <li><a name="toc-Commands-3" href="#Commands-3">10.7.1 Commands</a></li>
+ <li><a name="toc-Commands-1" href="#Commands-1">10.7.1 Commands</a></li>
</ul>
</li>
</ul></li>
<ul class="toc">
<li><a name="toc-avectorscope" href="#avectorscope">12.1 avectorscope</a>
<ul class="toc">
- <li><a name="toc-Examples-69" href="#Examples-69">12.1.1 Examples</a></li>
+ <li><a name="toc-Examples-34" href="#Examples-34">12.1.1 Examples</a></li>
</ul></li>
<li><a name="toc-concat" href="#concat">12.2 concat</a>
<ul class="toc">
- <li><a name="toc-Examples-64" href="#Examples-64">12.2.1 Examples</a></li>
+ <li><a name="toc-Examples-23" href="#Examples-23">12.2.1 Examples</a></li>
</ul></li>
<li><a name="toc-ebur128" href="#ebur128">12.3 ebur128</a>
<ul class="toc">
- <li><a name="toc-Examples-25" href="#Examples-25">12.3.1 Examples</a></li>
+ <li><a name="toc-Examples-45" href="#Examples-45">12.3.1 Examples</a></li>
</ul></li>
<li><a name="toc-interleave_002c-ainterleave" href="#interleave_002c-ainterleave">12.4 interleave, ainterleave</a>
<ul class="toc">
- <li><a name="toc-Examples-19" href="#Examples-19">12.4.1 Examples</a></li>
+ <li><a name="toc-Examples-55" href="#Examples-55">12.4.1 Examples</a></li>
</ul></li>
<li><a name="toc-perms_002c-aperms" href="#perms_002c-aperms">12.5 perms, aperms</a></li>
<li><a name="toc-select_002c-aselect" href="#select_002c-aselect">12.6 select, aselect</a>
<ul class="toc">
- <li><a name="toc-Examples-43" href="#Examples-43">12.6.1 Examples</a></li>
+ <li><a name="toc-Examples-13" href="#Examples-13">12.6.1 Examples</a></li>
</ul></li>
<li><a name="toc-sendcmd_002c-asendcmd" href="#sendcmd_002c-asendcmd">12.7 sendcmd, asendcmd</a>
<ul class="toc">
<li><a name="toc-Commands-syntax" href="#Commands-syntax">12.7.1 Commands syntax</a></li>
- <li><a name="toc-Examples-13" href="#Examples-13">12.7.2 Examples</a></li>
+ <li><a name="toc-Examples-17" href="#Examples-17">12.7.2 Examples</a></li>
</ul></li>
<li><a name="toc-setpts_002c-asetpts" href="#setpts_002c-asetpts">12.8 setpts, asetpts</a>
<ul class="toc">
- <li><a name="toc-Examples-17" href="#Examples-17">12.8.1 Examples</a></li>
+ <li><a name="toc-Examples-60" href="#Examples-60">12.8.1 Examples</a></li>
</ul></li>
<li><a name="toc-settb_002c-asettb" href="#settb_002c-asettb">12.9 settb, asettb</a>
<ul class="toc">
- <li><a name="toc-Examples-15" href="#Examples-15">12.9.1 Examples</a></li>
+ <li><a name="toc-Examples-10" href="#Examples-10">12.9.1 Examples</a></li>
</ul></li>
<li><a name="toc-showspectrum" href="#showspectrum">12.10 showspectrum</a>
<ul class="toc">
- <li><a name="toc-Examples-63" href="#Examples-63">12.10.1 Examples</a></li>
+ <li><a name="toc-Examples-15" href="#Examples-15">12.10.1 Examples</a></li>
</ul></li>
<li><a name="toc-showwaves" href="#showwaves">12.11 showwaves</a>
<ul class="toc">
- <li><a name="toc-Examples-61" href="#Examples-61">12.11.1 Examples</a></li>
+ <li><a name="toc-Examples-35" href="#Examples-35">12.11.1 Examples</a></li>
</ul></li>
<li><a name="toc-split_002c-asplit" href="#split_002c-asplit">12.12 split, asplit</a>
<ul class="toc">
- <li><a name="toc-Examples-27" href="#Examples-27">12.12.1 Examples</a></li>
+ <li><a name="toc-Examples-31" href="#Examples-31">12.12.1 Examples</a></li>
</ul></li>
<li><a name="toc-zmq_002c-azmq" href="#zmq_002c-azmq">12.13 zmq, azmq</a>
<ul class="toc">
- <li><a name="toc-Examples-3" href="#Examples-3">12.13.1 Examples</a></li>
+ <li><a name="toc-Examples-54" href="#Examples-54">12.13.1 Examples</a></li>
</ul>
</li>
</ul></li>
<li><a name="toc-amovie" href="#amovie">13.1 amovie</a></li>
<li><a name="toc-movie-1" href="#movie-1">13.2 movie</a>
<ul class="toc">
- <li><a name="toc-Examples" href="#Examples">13.2.1 Examples</a></li>
+ <li><a name="toc-Examples-49" href="#Examples-49">13.2.1 Examples</a></li>
</ul>
</li>
</ul></li>
</p>
<p>The name and arguments of the filter are optionally preceded and
followed by a list of link labels.
-A link label allows to name a link and associate it to a filter output
+A link label allows one to name a link and associate it to a filter output
or input pad. The preceding labels <var>in_link_1</var>
... <var>in_link_N</var>, are associated to the filter input pads,
the following labels <var>out_link_1</var> ... <var>out_link_M</var>, are
<a name="Notes-on-filtergraph-escaping"></a>
<h2 class="section"><a href="ffmpeg-filters.html#toc-Notes-on-filtergraph-escaping">4.2 Notes on filtergraph escaping</a></h2>
-<p>Some filter arguments require the use of special characters, typically
-<code>:</code> to separate key=value pairs in a named options list. In this
-case the user should perform a first level escaping when specifying
-the filter arguments. For example, consider the following literal
-string to be embedded in the <a href="#drawtext">drawtext</a> filter arguments:
+<p>Filtergraph description composition entails several levels of
+escaping. See <a href="ffmpeg-utils.html#quoting_005fand_005fescaping">(ffmpeg-utils)quoting_and_escaping</a> for more
+information about the employed escaping procedure.
+</p>
+<p>A first level escaping affects the content of each filter option
+value, which may contain the special character <code>:</code> used to
+separate values, or one of the escaping characters <code>\'</code>.
+</p>
+<p>A second level escaping affects the whole filter description, which
+may contain the escaping characters <code>\'</code> or the special
+characters <code>[],;</code> used by the filtergraph description.
+</p>
+<p>Finally, when you specify a filtergraph on a shell commandline, you
+need to perform a third level escaping for the shell special
+characters contained within it.
+</p>
+<p>For example, consider the following string to be embedded in
+the <a href="#drawtext">drawtext</a> filter description ‘<samp>text</samp>’ value:
</p><table><tr><td> </td><td><pre class="example">this is a 'string': may contain one, or more, special characters
</pre></td></tr></table>
-<p>Since <code>:</code> is special for the filter arguments syntax, it needs to
-be escaped, so you get:
+<p>This string contains the <code>'</code> special escaping character, and the
+<code>:</code> special character, so it needs to be escaped in this way:
</p><table><tr><td> </td><td><pre class="example">text=this is a \'string\'\: may contain one, or more, special characters
</pre></td></tr></table>
<p>A second level of escaping is required when embedding the filter
-arguments in a filtergraph description, in order to escape all the
+description in a filtergraph description, in order to escape all the
filtergraph special characters. Thus the example above becomes:
</p><table><tr><td> </td><td><pre class="example">drawtext=text=this is a \\\'string\\\'\\: may contain one\, or more\, special characters
</pre></td></tr></table>
-
-<p>Finally an additional level of escaping may be needed when writing the
+<p>(note that in addition to the <code>\'</code> escaping special characters,
+also <code>,</code> needs to be escaped).
+</p>
+<p>Finally an additional level of escaping is needed when writing the
filtergraph description in a shell command, which depends on the
escaping rules of the adopted shell. For example, assuming that
<code>\</code> is special and needs to be escaped with another <code>\</code>, the
</p><table><tr><td> </td><td><pre class="example">-vf "drawtext=text=this is a \\\\\\'string\\\\\\'\\\\: may contain one\\, or more\\, special characters"
</pre></td></tr></table>
-<p>Sometimes, it might be more convenient to employ quoting in place of
-escaping. For example the string:
-</p><table><tr><td> </td><td><pre class="example">Caesar: tu quoque, Brute, fili mi
-</pre></td></tr></table>
-
-<p>Can be quoted in the filter arguments as:
-</p><table><tr><td> </td><td><pre class="example">text='Caesar: tu quoque, Brute, fili mi'
-</pre></td></tr></table>
-
-<p>And finally inserted in a filtergraph like:
-</p><table><tr><td> </td><td><pre class="example">drawtext=text=\'Caesar: tu quoque\, Brute\, fili mi\'
-</pre></td></tr></table>
-
-<p>See the “Quoting and escaping” section in the ffmpeg-utils manual
-for more information about the escaping and quoting rules adopted by
-FFmpeg.
-</p>
<a name="Timeline-editing"></a>
<h1 class="chapter"><a href="ffmpeg-filters.html#toc-Timeline-editing">5. Timeline editing</a></h1>
<p>The special parameter "auto", signifies that the filter will
automatically select the output format depending on the output filter.
</p>
-<a name="Examples-41"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-41">6.1.1 Examples</a></h3>
+<a name="Examples-48"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-48">6.1.1 Examples</a></h3>
<ul>
<li>
</p></dd>
</dl>
-<a name="Examples-31"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-31">6.2.1 Examples</a></h3>
+<a name="Examples-26"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-26">6.2.1 Examples</a></h3>
<ul>
<li>
</p></dd>
</dl>
-<a name="Examples-26"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-26">6.3.1 Examples</a></h3>
+<a name="Examples-57"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-57">6.3.1 Examples</a></h3>
<ul>
<li>
<p>Note: this filter is slow. For faster processing you should use a
dedicated filter.
</p>
-<a name="Examples-49"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-49">6.4.1 Examples</a></h3>
+<a name="Examples-64"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-64">6.4.1 Examples</a></h3>
<ul>
<li>
</dd>
</dl>
-<a name="Examples-38"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-38">6.5.1 Examples</a></h3>
+<a name="Examples-43"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-43">6.5.1 Examples</a></h3>
<ul>
<li>
<p>If inputs do not have the same duration, the output will stop with the
shortest.
</p>
-<a name="Examples-5"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-5">6.8.1 Examples</a></h3>
+<a name="Examples-7"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-7">6.8.1 Examples</a></h3>
<ul>
<li>
<var>key</var>=<var>value</var> pairs, separated by ":". See the
ffmpeg-resampler manual for the complete list of supported options.
</p>
-<a name="Examples-62"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-62">6.13.1 Examples</a></h3>
+<a name="Examples-21"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-21">6.13.1 Examples</a></h3>
<ul>
<li>
</p></dd>
</dl>
-<a name="Examples-68"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-68">6.18.1 Examples</a></h3>
+<a name="Examples-4"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-4">6.18.1 Examples</a></h3>
<p>Stress-test <code>amerge</code> by randomly sending buffers on the wrong
input, while avoiding too much of a desynchronization:
specified then the filter will assume nominal 1.0 tempo. Tempo must
be in the [0.5, 2.0] range.
</p>
-<a name="Examples-71"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-71">6.20.1 Examples</a></h3>
+<a name="Examples-44"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-44">6.20.1 Examples</a></h3>
<ul>
<li>
<a name="compand"></a>
<h2 class="section"><a href="ffmpeg-filters.html#toc-compand">6.28 compand</a></h2>
-
<p>Compress or expand audio dynamic range.
</p>
<p>A description of the accepted options follows.
<dl compact="compact">
<dt> ‘<samp>attacks</samp>’</dt>
<dt> ‘<samp>decays</samp>’</dt>
-<dd><p>Set list of times in seconds for each channel over which the instantaneous
-level of the input signal is averaged to determine its volume.
-‘<samp>attacks</samp>’ refers to increase of volume and ‘<samp>decays</samp>’ refers
-to decrease of volume.
-For most situations, the attack time (response to the audio getting louder)
-should be shorter than the decay time because the human ear is more sensitive
-to sudden loud audio than sudden soft audio.
-Typical value for attack is <code>0.3</code> seconds and for decay <code>0.8</code>
-seconds.
+<dd><p>Set list of times in seconds for each channel over which the instantaneous level
+of the input signal is averaged to determine its volume. <var>attacks</var> refers to
+increase of volume and <var>decays</var> refers to decrease of volume. For most
+situations, the attack time (response to the audio getting louder) should be
+shorter than the decay time because the human ear is more sensitive to sudden
+loud audio than sudden soft audio. A typical value for attack is 0.3 seconds and
+a typical value for decay is 0.8 seconds.
</p>
</dd>
<dt> ‘<samp>points</samp>’</dt>
-<dd><p>Set list of points for transfer function, specified in dB relative to maximum
-possible signal amplitude.
-Each key points list need to be defined using the following syntax:
-<code>x0/y0 x1/y1 x2/y2 ...</code>.
+<dd><p>Set list of points for the transfer function, specified in dB relative to the
+maximum possible signal amplitude. Each key points list must be defined using
+the following syntax: <code>x0/y0|x1/y1|x2/y2|....</code> or
+<code>x0/y0 x1/y1 x2/y2 ....</code>
</p>
-<p>The input values must be in strictly increasing order but the transfer
-function does not have to be monotonically rising.
-The point <code>0/0</code> is assumed but may be overridden (by <code>0/out-dBn</code>).
-Typical values for the transfer function are <code>-70/-70 -60/-20</code>.
+<p>The input values must be in strictly increasing order but the transfer function
+does not have to be monotonically rising. The point <code>0/0</code> is assumed but
+may be overridden (by <code>0/out-dBn</code>). Typical values for the transfer
+function are <code>-70/-70|-60/-20</code>.
</p>
</dd>
<dt> ‘<samp>soft-knee</samp>’</dt>
-<dd><p>Set amount for which the points at where adjacent line segments on the
-transfer function meet will be rounded. Defaults is <code>0.01</code>.
+<dd><p>Set the curve radius in dB for all joints. Defaults to 0.01.
</p>
</dd>
<dt> ‘<samp>gain</samp>’</dt>
-<dd><p>Set additional gain in dB to be applied at all points on the transfer function
-and allows easy adjustment of the overall gain.
-Default is <code>0</code>.
+<dd><p>Set additional gain in dB to be applied at all points on the transfer function.
+This allows easy adjustment of the overall gain. Defaults to 0.
</p>
</dd>
<dt> ‘<samp>volume</samp>’</dt>
<dd><p>Set initial volume in dB to be assumed for each channel when filtering starts.
-This permits the user to supply a nominal level initially, so that,
-for example, a very large gain is not applied to initial signal levels before
-the companding has begun to operate. A typical value for audio which is
-initially quiet is -90 dB. Default is <code>0</code>.
+This permits the user to supply a nominal level initially, so that, for
+example, a very large gain is not applied to initial signal levels before the
+companding has begun to operate. A typical value for audio which is initially
+quiet is -90 dB. Defaults to 0.
</p>
</dd>
<dt> ‘<samp>delay</samp>’</dt>
-<dd><p>Set delay in seconds. Default is <code>0</code>. The input audio
-is analysed immediately, but audio is delayed before being fed to the
-volume adjuster. Specifying a delay approximately equal to the attack/decay
-times allows the filter to effectively operate in predictive rather than
-reactive mode.
-</p></dd>
+<dd><p>Set delay in seconds. The input audio is analyzed immediately, but audio is
+delayed before being fed to the volume adjuster. Specifying a delay
+approximately equal to the attack/decay times allows the filter to effectively
+operate in predictive rather than reactive mode. Defaults to 0.
+</p>
+</dd>
</dl>
-<a name="Examples-24"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-24">6.28.1 Examples</a></h3>
+<a name="Examples-59"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-59">6.28.1 Examples</a></h3>
+
<ul>
<li>
-Make music with both quiet and loud passages suitable for listening
-in a noisy environment:
-<table><tr><td> </td><td><pre class="example">compand=.3 .3:1 1:-90/-60 -60/-40 -40/-30 -20/-20:6:0:-90:0.2
+Make music with both quiet and loud passages suitable for listening in a noisy
+environment:
+<table><tr><td> </td><td><pre class="example">compand=.3|.3:1|1:-90/-60|-60/-40|-40/-30|-20/-20:6:0:-90:0.2
</pre></td></tr></table>
</li><li>
-Noise-gate for when the noise is at a lower level than the signal:
-<table><tr><td> </td><td><pre class="example">compand=.1 .1:.2 .2:-900/-900 -50.1/-900 -50/-50:.01:0:-90:.1
+Noise gate for when the noise is at a lower level than the signal:
+<table><tr><td> </td><td><pre class="example">compand=.1|.1:.2|.2:-900/-900|-50.1/-900|-50/-50:.01:0:-90:.1
</pre></td></tr></table>
</li><li>
-Here is another noise-gate, this time for when the noise is at a higher level
+Here is another noise gate, this time for when the noise is at a higher level
than the signal (making it, in some ways, similar to squelch):
-<table><tr><td> </td><td><pre class="example">compand=.1 .1:.1 .1:-45.1/-45.1 -45/-900 0/-900:.01:45:-90:.1
+<table><tr><td> </td><td><pre class="example">compand=.1|.1:.1|.1:-45.1/-45.1|-45/-900|0/-900:.01:45:-90:.1
</pre></td></tr></table>
</li></ul>
</p></dd>
</dl>
+<a name="Examples-63"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-63">6.30.1 Examples</a></h3>
+<ul>
+<li>
+Attenuate 10 dB at 1000 Hz, with a bandwidth of 200 Hz:
+<table><tr><td> </td><td><pre class="example">equalizer=f=1000:width_type=h:width=200:g=-10
+</pre></td></tr></table>
+
+</li><li>
+Apply 2 dB gain at 1000 Hz with Q 1 and attenuate 5 dB at 100 Hz with Q 2:
+<table><tr><td> </td><td><pre class="example">equalizer=f=1000:width_type=q:width=1:g=2,equalizer=f=100:width_type=q:width=2:g=-5
+</pre></td></tr></table>
+</li></ul>
+
<a name="highpass"></a>
<h2 class="section"><a href="ffmpeg-filters.html#toc-highpass">6.31 highpass</a></h2>
</dd>
</dl>
-<a name="Examples-23"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-23">6.33.1 Examples</a></h3>
+<a name="Examples-12"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-12">6.33.1 Examples</a></h3>
<ul>
<li>
</pre></td></tr></table>
</li></ul>
-<a name="Commands-2"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Commands-2">6.33.2 Commands</a></h3>
+<a name="Commands-3"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Commands-3">6.33.2 Commands</a></h3>
<p>This filter supports the following commands:
</p><dl compact="compact">
</p></dd>
</dl>
-<a name="Examples-66"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-66">6.38.1 Examples</a></h3>
+<a name="Examples-9"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-9">6.38.1 Examples</a></h3>
<ul>
<li>
</p>
<dl compact="compact">
<dt> ‘<samp>volume</samp>’</dt>
-<dd><p>Expresses how the audio volume will be increased or decreased.
+<dd><p>Set audio volume expression.
</p>
<p>Output values are clipped to the maximum value.
</p>
</p><table><tr><td> </td><td><pre class="example"><var>output_volume</var> = <var>volume</var> * <var>input_volume</var>
</pre></td></tr></table>
-<p>Default value for <var>volume</var> is 1.0.
+<p>Default value for <var>volume</var> is "1.0".
</p>
</dd>
<dt> ‘<samp>precision</samp>’</dt>
<dd><p>64-bit floating-point; limits input sample format to DBL.
</p></dd>
</dl>
+
+</dd>
+<dt> ‘<samp>eval</samp>’</dt>
+<dd><p>Set when the volume expression is evaluated.
+</p>
+<p>It accepts the following values:
+</p><dl compact="compact">
+<dt> ‘<samp>once</samp>’</dt>
+<dd><p>only evaluate expression once during the filter initialization, or
+when the ‘<samp>volume</samp>’ command is sent
+</p>
</dd>
+<dt> ‘<samp>frame</samp>’</dt>
+<dd><p>evaluate expression for each incoming frame
+</p></dd>
</dl>
-<a name="Examples-14"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-14">6.40.1 Examples</a></h3>
+<p>Default value is ‘<samp>once</samp>’.
+</p></dd>
+</dl>
+
+<p>The volume expression can contain the following parameters.
+</p>
+<dl compact="compact">
+<dt> ‘<samp>n</samp>’</dt>
+<dd><p>frame number (starting at zero)
+</p></dd>
+<dt> ‘<samp>nb_channels</samp>’</dt>
+<dd><p>number of channels
+</p></dd>
+<dt> ‘<samp>nb_consumed_samples</samp>’</dt>
+<dd><p>number of samples consumed by the filter
+</p></dd>
+<dt> ‘<samp>nb_samples</samp>’</dt>
+<dd><p>number of samples in the current frame
+</p></dd>
+<dt> ‘<samp>pos</samp>’</dt>
+<dd><p>original frame position in the file
+</p></dd>
+<dt> ‘<samp>pts</samp>’</dt>
+<dd><p>frame PTS
+</p></dd>
+<dt> ‘<samp>sample_rate</samp>’</dt>
+<dd><p>sample rate
+</p></dd>
+<dt> ‘<samp>startpts</samp>’</dt>
+<dd><p>PTS at start of stream
+</p></dd>
+<dt> ‘<samp>startt</samp>’</dt>
+<dd><p>time at start of stream
+</p></dd>
+<dt> ‘<samp>t</samp>’</dt>
+<dd><p>frame time
+</p></dd>
+<dt> ‘<samp>tb</samp>’</dt>
+<dd><p>timestamp timebase
+</p></dd>
+<dt> ‘<samp>volume</samp>’</dt>
+<dd><p>last set volume value
+</p></dd>
+</dl>
+
+<p>Note that when ‘<samp>eval</samp>’ is set to ‘<samp>once</samp>’ only the
+<var>sample_rate</var> and <var>tb</var> variables are available, all other
+variables will evaluate to NAN.
+</p>
+<a name="Commands"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Commands">6.40.1 Commands</a></h3>
+
+<p>This filter supports the following commands:
+</p><dl compact="compact">
+<dt> ‘<samp>volume</samp>’</dt>
+<dd><p>Modify the volume expression.
+The command accepts the same syntax of the corresponding option.
+</p>
+<p>If the specified expression is not valid, it is kept at its current
+value.
+</p></dd>
+</dl>
+
+<a name="Examples-33"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-33">6.40.2 Examples</a></h3>
<ul>
<li>
Increase input audio power by 6 decibels using fixed-point precision:
<table><tr><td> </td><td><pre class="example">volume=volume=6dB:precision=fixed
</pre></td></tr></table>
+
+</li><li>
+Fade volume after time 10 with an annihilation period of 5 seconds:
+<table><tr><td> </td><td><pre class="example">volume='if(lt(t,10),1,max(1-(t-10)/5,0))':eval=frame
+</pre></td></tr></table>
</li></ul>
<a name="volumedetect"></a>
</p>
<p>All volumes are in decibels relative to the maximum PCM value.
</p>
-<a name="Examples-8"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-8">6.41.1 Examples</a></h3>
+<a name="Examples-5"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-5">6.41.1 Examples</a></h3>
<p>Here is an excerpt of the output:
</p><table><tr><td> </td><td><pre class="example">[Parsed_volumedetect_0 0xa23120] mean_volume: -27 dB
</dd>
</dl>
-<a name="Examples-55"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-55">7.1.1 Examples</a></h3>
+<a name="Examples-30"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-30">7.1.1 Examples</a></h3>
<table><tr><td> </td><td><pre class="example">abuffer=sample_rate=44100:sample_fmt=s16p:channel_layout=stereo
</pre></td></tr></table>
</dd>
</dl>
-<a name="Examples-1"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-1">7.2.1 Examples</a></h3>
+<a name="Examples-56"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-56">7.2.1 Examples</a></h3>
<ul>
<li>
</dd>
</dl>
-<a name="Examples-39"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-39">7.3.1 Examples</a></h3>
+<a name="Examples"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples">7.3.1 Examples</a></h3>
<ul>
<li>
</p></dd>
</dl>
-<a name="Examples-20"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-20">7.4.1 Examples</a></h3>
+<a name="Examples-27"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-27">7.4.1 Examples</a></h3>
<ul>
<li>
</p></dd>
</dl>
-<a name="Examples-58"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-58">7.5.1 Examples</a></h3>
+<a name="Examples-46"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-46">7.5.1 Examples</a></h3>
<ul>
<li>
</p></dd>
</dl>
-<a name="Examples-21"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-21">9.7.1 Examples</a></h3>
+<a name="Examples-51"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-51">9.7.1 Examples</a></h3>
<ul>
<li>
</p></dd>
</dl>
-<a name="Examples-4"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-4">9.8.1 Examples</a></h3>
+<a name="Examples-66"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-66">9.8.1 Examples</a></h3>
<ul>
<li>
</p></dd>
</dl>
-<a name="Examples-37"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-37">9.9.1 Examples</a></h3>
+<a name="Examples-29"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-29">9.9.1 Examples</a></h3>
<ul>
<li>
</p></dd>
</dl>
-<a name="Examples-35"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-35">9.10.1 Examples</a></h3>
+<a name="Examples-68"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-68">9.10.1 Examples</a></h3>
<ul>
<li>
<p>The expression for <var>x</var> may depend on <var>y</var>, and the expression
for <var>y</var> may depend on <var>x</var>.
</p>
-<a name="Examples-36"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-36">9.13.1 Examples</a></h3>
+<a name="Examples-47"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-47">9.13.1 Examples</a></h3>
<ul>
<li>
<p>To avoid some filtergraph syntax conflicts, each key points list need to be
defined using the following syntax: <code>x0/y0 x1/y1 x2/y2 ...</code>.
</p>
-<a name="Examples-2"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-2">9.15.1 Examples</a></h3>
+<a name="Examples-6"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-6">9.15.1 Examples</a></h3>
<ul>
<li>
</p></dd>
</dl>
-<a name="Examples-22"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-22">9.16.1 Examples</a></h3>
+<a name="Examples-1"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-1">9.16.1 Examples</a></h3>
<p>Apply a denoise with a ‘<samp>sigma</samp>’ of <code>4.5</code>:
</p><table><tr><td> </td><td><pre class="example">dctdnoiz=4.5
</p></dd>
</dl>
+<a name="dejudder"></a>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-dejudder">9.18 dejudder</a></h2>
+
+<p>Remove judder produced by partially interlaced telecined content.
+</p>
+<p>Judder can be introduced, for instance, by <a href="#pullup">pullup</a> filter. If the original
+source was partially telecined content then the output of <code>pullup,dejudder</code>
+will have a variable frame rate. May change the recorded frame rate of the
+container. Aside from that change, this filter will not affect constant frame
+rate video.
+</p>
+<p>The option available in this filter is:
+</p><dl compact="compact">
+<dt> ‘<samp>cycle</samp>’</dt>
+<dd><p>Specify the length of the window over which the judder repeats.
+</p>
+<p>Accepts any interger greater than 1. Useful values are:
+</p><dl compact="compact">
+<dt> ‘<samp>4</samp>’</dt>
+<dd><p>If the original was telecined from 24 to 30 fps (Film to NTSC).
+</p>
+</dd>
+<dt> ‘<samp>5</samp>’</dt>
+<dd><p>If the original was telecined from 25 to 30 fps (PAL to NTSC).
+</p>
+</dd>
+<dt> ‘<samp>20</samp>’</dt>
+<dd><p>If a mixture of the two.
+</p></dd>
+</dl>
+
+<p>The default is ‘<samp>4</samp>’.
+</p></dd>
+</dl>
+
<a name="delogo"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-delogo">9.18 delogo</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-delogo">9.19 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
</dd>
</dl>
-<a name="Examples-50"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-50">9.18.1 Examples</a></h3>
+<a name="Examples-22"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-22">9.19.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="deshake"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-deshake">9.19 deshake</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-deshake">9.20 deshake</a></h2>
<p>Attempt to fix small changes in horizontal and/or vertical shift. This
filter helps remove camera shake from hand-holding a camera, bumping a
</dl>
<a name="drawbox"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-drawbox">9.20 drawbox</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-drawbox">9.21 drawbox</a></h2>
<p>Draw a colored box on the input image.
</p>
</dd>
</dl>
-<a name="Examples-60"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-60">9.20.1 Examples</a></h3>
+<a name="Examples-52"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-52">9.21.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="drawgrid"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-drawgrid">9.21 drawgrid</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-drawgrid">9.22 drawgrid</a></h2>
<p>Draw a grid on the input image.
</p>
</dd>
</dl>
-<a name="Examples-28"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-28">9.21.1 Examples</a></h3>
+<a name="Examples-19"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-19">9.22.1 Examples</a></h3>
<ul>
<li>
<p><a name="drawtext"></a>
</p><a name="drawtext-1"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-drawtext-1">9.22 drawtext</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-drawtext-1">9.23 drawtext</a></h2>
<p>Draw text string or text from specified file on top of video using the
libfreetype library.
<code>--enable-libfreetype</code>.
</p>
<a name="Syntax"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Syntax">9.22.1 Syntax</a></h3>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Syntax">9.23.1 Syntax</a></h3>
<p>The description of the accepted parameters follows.
</p>
<p>The default value of <var>boxcolor</var> is "white".
</p>
</dd>
+<dt> ‘<samp>borderw</samp>’</dt>
+<dd><p>Set the width of the border to be drawn around the text using <var>bordercolor</var>.
+The default value of <var>borderw</var> is 0.
+</p>
+</dd>
+<dt> ‘<samp>bordercolor</samp>’</dt>
+<dd><p>Set the color to be used for drawing border around text. For the syntax of this
+option, check the "Color" section in the ffmpeg-utils manual.
+</p>
+<p>The default value of <var>bordercolor</var> is "black".
+</p>
+</dd>
<dt> ‘<samp>expansion</samp>’</dt>
<dd><p>Select how the <var>text</var> is expanded. Can be either <code>none</code>,
<code>strftime</code> (deprecated) or
<dt> <var>no_autohint</var></dt>
</dl>
-<p>Default value is "render".
+<p>Default value is "default".
</p>
<p>For more information consult the documentation for the FT_LOAD_*
libfreetype flags.
</p>
<p><a name="drawtext_005fexpansion"></a>
</p><a name="Text-expansion"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Text-expansion">9.22.2 Text expansion</a></h3>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Text-expansion">9.23.2 Text expansion</a></h3>
<p>If ‘<samp>expansion</samp>’ is set to <code>strftime</code>,
the filter recognizes strftime() sequences in the provided text and
</dd>
</dl>
-<a name="Examples-32"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-32">9.22.3 Examples</a></h3>
+<a name="Examples-2"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-2">9.23.3 Examples</a></h3>
<ul>
<li>
<a href="http://freedesktop.org/software/fontconfig/fontconfig-user.html">http://freedesktop.org/software/fontconfig/fontconfig-user.html</a>.
</p>
<a name="edgedetect"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-edgedetect">9.23 edgedetect</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-edgedetect">9.24 edgedetect</a></h2>
<p>Detect and draw edges. The filter uses the Canny Edge Detection algorithm.
</p>
connected through 8-connectivity with the "weak" edge pixels selected
by the low threshold.
</p>
-<p><var>low</var> and <var>high</var> threshold values must be choosen in the range
+<p><var>low</var> and <var>high</var> threshold values must be chosen in the range
[0,1], and <var>low</var> should be lesser or equal to <var>high</var>.
</p>
<p>Default value for <var>low</var> is <code>20/255</code>, and default value for <var>high</var>
</pre></td></tr></table>
<a name="extractplanes"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-extractplanes">9.24 extractplanes</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-extractplanes">9.25 extractplanes</a></h2>
<p>Extract color channel components from input video stream into
separate grayscale video streams.
</p></dd>
</dl>
-<a name="Examples-54"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-54">9.24.1 Examples</a></h3>
+<a name="Examples-71"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-71">9.25.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="elbg"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-elbg">9.25 elbg</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-elbg">9.26 elbg</a></h2>
<p>Apply a posterize effect using the ELBG (Enhanced LBG) algorithm.
</p>
</dl>
<a name="fade"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-fade">9.26 fade</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-fade">9.27 fade</a></h2>
<p>Apply fade-in/out effect to input video.
</p>
</p></dd>
</dl>
-<a name="Examples-47"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-47">9.26.1 Examples</a></h3>
+<a name="Examples-41"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-41">9.27.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="field"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-field">9.27 field</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-field">9.28 field</a></h2>
<p>Extract a single field from an interlaced image using stride
arithmetic to avoid wasting CPU time. The output frames are marked as
</dl>
<a name="fieldmatch"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-fieldmatch">9.28 fieldmatch</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-fieldmatch">9.29 fieldmatch</a></h2>
<p>Field matching filter for inverse telecine. It is meant to reconstruct the
progressive frames from a telecined stream. The filter does not drop duplicated
<p><a name="p_002fc_002fn_002fu_002fb-meaning"></a>
</p><a name="p_002fc_002fn_002fu_002fb-meaning-1"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-p_002fc_002fn_002fu_002fb-meaning-1">9.28.1 p/c/n/u/b meaning</a></h3>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-p_002fc_002fn_002fu_002fb-meaning-1">9.29.1 p/c/n/u/b meaning</a></h3>
<a name="p_002fc_002fn"></a>
-<h4 class="subsubsection"><a href="ffmpeg-filters.html#toc-p_002fc_002fn">9.28.1.1 p/c/n</a></h4>
+<h4 class="subsubsection"><a href="ffmpeg-filters.html#toc-p_002fc_002fn">9.29.1.1 p/c/n</a></h4>
<p>We assume the following telecined stream:
</p>
</li></ul>
<a name="u_002fb"></a>
-<h4 class="subsubsection"><a href="ffmpeg-filters.html#toc-u_002fb">9.28.1.2 u/b</a></h4>
+<h4 class="subsubsection"><a href="ffmpeg-filters.html#toc-u_002fb">9.29.1.2 u/b</a></h4>
<p>The <var>u</var> and <var>b</var> matching are a bit special in the sense that they match
from the opposite parity flag. In the following examples, we assume that we are
2 1 3 2 2
</pre></td></tr></table>
-<a name="Examples-10"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-10">9.28.2 Examples</a></h3>
+<a name="Examples-67"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-67">9.29.2 Examples</a></h3>
<p>Simple IVTC of a top field first telecined stream:
</p><table><tr><td> </td><td><pre class="example">fieldmatch=order=tff:combmatch=none, decimate
</pre></td></tr></table>
<a name="fieldorder"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-fieldorder">9.29 fieldorder</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-fieldorder">9.30 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="ffmpeg-filters.html#toc-fifo">9.30 fifo</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-fifo">9.31 fifo</a></h2>
<p>Buffer input images and send them when they are requested.
</p>
</p>
<p><a name="format"></a>
</p><a name="format-1"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-format-1">9.31 format</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-format-1">9.32 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
</dd>
</dl>
-<a name="Examples-65"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-65">9.31.1 Examples</a></h3>
+<a name="Examples-25"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-25">9.32.1 Examples</a></h3>
<ul>
<li>
<p><a name="fps"></a>
</p><a name="fps-1"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-fps-1">9.32 fps</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-fps-1">9.33 fps</a></h2>
<p>Convert the video to specified constant frame rate by duplicating or dropping
frames as necessary.
<p>See also the <a href="#setpts">setpts</a> filter.
</p>
<a name="Examples-72"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-72">9.32.1 Examples</a></h3>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-72">9.33.1 Examples</a></h3>
<ul>
<li>
</pre></td></tr></table>
</li></ul>
+<a name="framepack"></a>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-framepack">9.34 framepack</a></h2>
+
+<p>Pack two different video streams into a stereoscopic video, setting proper
+metadata on supported codecs. The two views should have the same size and
+framerate and processing will stop when the shorter video ends. Please note
+that you may conveniently adjust view properties with the <a href="#scale">scale</a> and
+<a href="#fps">fps</a> filters.
+</p>
+<p>This filter accepts the following named parameters:
+</p><dl compact="compact">
+<dt> ‘<samp>format</samp>’</dt>
+<dd><p>Desired packing format. Supported values are:
+</p>
+<dl compact="compact">
+<dt> ‘<samp>sbs</samp>’</dt>
+<dd><p>Views are next to each other (default).
+</p>
+</dd>
+<dt> ‘<samp>tab</samp>’</dt>
+<dd><p>Views are on top of each other.
+</p>
+</dd>
+<dt> ‘<samp>lines</samp>’</dt>
+<dd><p>Views are packed by line.
+</p>
+</dd>
+<dt> ‘<samp>columns</samp>’</dt>
+<dd><p>Views are eacked by column.
+</p>
+</dd>
+<dt> ‘<samp>frameseq</samp>’</dt>
+<dd><p>Views are temporally interleaved.
+</p>
+</dd>
+</dl>
+
+</dd>
+</dl>
+
+<p>Some examples follow:
+</p>
+<table><tr><td> </td><td><pre class="example"># Convert left and right views into a frame sequential video.
+ffmpeg -i LEFT -i RIGHT -filter_complex framepack=frameseq OUTPUT
+
+# Convert views into a side-by-side video with the same output resolution as the input.
+ffmpeg -i LEFT -i RIGHT -filter_complex [0:v]scale=w=iw/2[left],[1:v]scale=w=iw/2[right],[left][right]framepack=sbs OUTPUT
+</pre></td></tr></table>
+
<a name="framestep"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-framestep">9.33 framestep</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-framestep">9.35 framestep</a></h2>
<p>Select one frame every N-th frame.
</p>
<p><a name="frei0r"></a>
</p><a name="frei0r-1"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-frei0r-1">9.34 frei0r</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-frei0r-1">9.36 frei0r</a></h2>
<p>Apply a frei0r effect to the input video.
</p>
<p>The number and kind of parameters depend on the loaded effect. If an
effect parameter is not specified the default value is set.
</p>
-<a name="Examples-42"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-42">9.34.1 Examples</a></h3>
+<a name="Examples-65"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-65">9.36.1 Examples</a></h3>
<ul>
<li>
<a href="http://frei0r.dyne.org">http://frei0r.dyne.org</a>
</p>
<a name="geq"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-geq">9.35 geq</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-geq">9.37 geq</a></h2>
<p>The filter accepts the following options:
</p>
<p>For functions, if <var>x</var> and <var>y</var> are outside the area, the value will be
automatically clipped to the closer edge.
</p>
-<a name="Examples-7"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-7">9.35.1 Examples</a></h3>
+<a name="Examples-70"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-70">9.37.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="gradfun"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-gradfun">9.36 gradfun</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-gradfun">9.38 gradfun</a></h2>
<p>Fix the banding artifacts that are sometimes introduced into nearly flat
regions by truncation to 8bit color depth.
<p>Alternatively, the options can be specified as a flat string:
<var>strength</var>[:<var>radius</var>]
</p>
-<a name="Examples-11"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-11">9.36.1 Examples</a></h3>
+<a name="Examples-28"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-28">9.38.1 Examples</a></h3>
<ul>
<li>
<p><a name="haldclut"></a>
</p><a name="haldclut-1"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-haldclut-1">9.37 haldclut</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-haldclut-1">9.39 haldclut</a></h2>
<p>Apply a Hald CLUT to a video stream.
</p>
(Hald CLUT author) at <a href="http://www.quelsolaar.com/technology/clut.html">http://www.quelsolaar.com/technology/clut.html</a>.
</p>
<a name="Workflow-examples"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Workflow-examples">9.37.1 Workflow examples</a></h3>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Workflow-examples">9.39.1 Workflow examples</a></h3>
<a name="Hald-CLUT-video-stream"></a>
-<h4 class="subsubsection"><a href="ffmpeg-filters.html#toc-Hald-CLUT-video-stream">9.37.1.1 Hald CLUT video stream</a></h4>
+<h4 class="subsubsection"><a href="ffmpeg-filters.html#toc-Hald-CLUT-video-stream">9.39.1.1 Hald CLUT video stream</a></h4>
<p>Generate an identity Hald CLUT stream altered with various effects:
</p><table><tr><td> </td><td><pre class="example">ffmpeg -f lavfi -i <a href="#haldclutsrc">haldclutsrc</a>=8 -vf "hue=H=2*PI*t:s=sin(2*PI*t)+1, curves=cross_process" -t 10 -c:v ffv1 clut.nut
to the remaining frames of the <code>mandelbrot</code> stream.
</p>
<a name="Hald-CLUT-with-preview"></a>
-<h4 class="subsubsection"><a href="ffmpeg-filters.html#toc-Hald-CLUT-with-preview">9.37.1.2 Hald CLUT with preview</a></h4>
+<h4 class="subsubsection"><a href="ffmpeg-filters.html#toc-Hald-CLUT-with-preview">9.39.1.2 Hald CLUT with preview</a></h4>
<p>A Hald CLUT is supposed to be a squared image of <code>Level*Level*Level</code> by
<code>Level*Level*Level</code> pixels. For a given Hald CLUT, FFmpeg will select the
</pre></td></tr></table>
<a name="hflip"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-hflip">9.38 hflip</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-hflip">9.40 hflip</a></h2>
<p>Flip the input video horizontally.
</p>
</pre></td></tr></table>
<a name="histeq"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-histeq">9.39 histeq</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-histeq">9.41 histeq</a></h2>
<p>This filter applies a global color histogram equalization on a
per-frame basis.
</p>
</dl>
<a name="histogram"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-histogram">9.40 histogram</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-histogram">9.42 histogram</a></h2>
<p>Compute and draw a color distribution histogram for the input video.
</p>
-<p>The computed histogram is a representation of distribution of color components
-in an image.
+<p>The computed histogram is a representation of the color component
+distribution in an image.
</p>
<p>The filter accepts the following options:
</p>
<p>It accepts the following values:
</p><dl compact="compact">
<dt> ‘<samp>levels</samp>’</dt>
-<dd><p>standard histogram that display color components distribution in an image.
-Displays color graph for each color component. Shows distribution
-of the Y, U, V, A or R, G, B components, depending on input format,
-in current frame. Bellow each graph is color component scale meter.
+<dd><p>Standard histogram that displays the color components distribution in an
+image. Displays color graph for each color component. Shows distribution of
+the Y, U, V, A or R, G, B components, depending on input format, in the
+current frame. Below each graph a color component scale meter is shown.
</p>
</dd>
<dt> ‘<samp>color</samp>’</dt>
-<dd><p>chroma values in vectorscope, if brighter more such chroma values are
-distributed in an image.
-Displays chroma values (U/V color placement) in two dimensional graph
-(which is called a vectorscope). It can be used to read of the hue and
-saturation of the current frame. At a same time it is a histogram.
-The whiter a pixel in the vectorscope, the more pixels of the input frame
-correspond to that pixel (that is the more pixels have this chroma value).
-The V component is displayed on the horizontal (X) axis, with the leftmost
-side being V = 0 and the rightmost side being V = 255.
-The U component is displayed on the vertical (Y) axis, with the top
-representing U = 0 and the bottom representing U = 255.
-</p>
-<p>The position of a white pixel in the graph corresponds to the chroma value
-of a pixel of the input clip. So the graph can be used to read of the
-hue (color flavor) and the saturation (the dominance of the hue in the color).
-As the hue of a color changes, it moves around the square. At the center of
-the square, the saturation is zero, which means that the corresponding pixel
-has no color. If you increase the amount of a specific color, while leaving
-the other colors unchanged, the saturation increases, and you move towards
+<dd><p>Displays chroma values (U/V color placement) in a two dimensional
+graph (which is called a vectorscope). The brighter a pixel in the
+vectorscope, the more pixels of the input frame correspond to that pixel
+(i.e., more pixels have this chroma value). The V component is displayed on
+the horizontal (X) axis, with the leftmost side being V = 0 and the rightmost
+side being V = 255. The U component is displayed on the vertical (Y) axis,
+with the top representing U = 0 and the bottom representing U = 255.
+</p>
+<p>The position of a white pixel in the graph corresponds to the chroma value of
+a pixel of the input clip. The graph can therefore be used to read the hue
+(color flavor) and the saturation (the dominance of the hue in the color). As
+the hue of a color changes, it moves around the square. At the center of the
+square the saturation is zero, which means that the corresponding pixel has no
+color. If the amount of a specific color is increased (while leaving the other
+colors unchanged) the saturation increases, and the indicator moves towards
the edge of the square.
</p>
</dd>
<dt> ‘<samp>color2</samp>’</dt>
-<dd><p>chroma values in vectorscope, similar as <code>color</code> but actual chroma values
+<dd><p>Chroma values in vectorscope, similar as <code>color</code> but actual chroma values
are displayed.
</p>
</dd>
<dt> ‘<samp>waveform</samp>’</dt>
-<dd><p>per row/column color component graph. In row mode graph in the left side represents
-color component value 0 and right side represents value = 255. In column mode top
-side represents color component value = 0 and bottom side represents value = 255.
+<dd><p>Per row/column color component graph. In row mode, the graph on the left side
+represents color component value 0 and the right side represents value = 255.
+In column mode, the top side represents color component value = 0 and bottom
+side represents value = 255.
</p></dd>
</dl>
<p>Default value is <code>levels</code>.
</p>
</dd>
<dt> ‘<samp>step</samp>’</dt>
-<dd><p>Set step for <code>waveform</code> mode. Smaller values are useful to find out how much
-of same luminance values across input rows/columns are distributed.
+<dd><p>Set step for <code>waveform</code> mode. Smaller values are useful to find out how
+many values of the same luminance are distributed across input rows/columns.
Default value is <code>10</code>. Allowed range is [1, 255].
</p>
</dd>
</p><dl compact="compact">
<dt> ‘<samp>parade</samp>’</dt>
<dd><p>Display separate graph for the color components side by side in
-<code>row</code> waveform mode or one below other in <code>column</code> waveform mode
-for <code>waveform</code> histogram mode. For <code>levels</code> histogram mode
-per color component graphs are placed one bellow other.
+<code>row</code> waveform mode or one below the other in <code>column</code> waveform mode
+for <code>waveform</code> histogram mode. For <code>levels</code> histogram mode,
+per color component graphs are placed below each other.
</p>
-<p>This display mode in <code>waveform</code> histogram mode makes it easy to spot
-color casts in the highlights and shadows of an image, by comparing the
-contours of the top and the bottom of each waveform.
-Since whites, grays, and blacks are characterized by
-exactly equal amounts of red, green, and blue, neutral areas of the
-picture should display three waveforms of roughly equal width/height.
-If not, the correction is easy to make by making adjustments to level the
-three waveforms.
+<p>Using this display mode in <code>waveform</code> histogram mode makes it easy to
+spot color casts in the highlights and shadows of an image, by comparing the
+contours of the top and the bottom graphs of each waveform. Since whites,
+grays, and blacks are characterized by exactly equal amounts of red, green,
+and blue, neutral areas of the picture should display three waveforms of
+roughly equal width/height. If not, the correction is easy to perform by
+making level adjustments the three waveforms.
</p>
</dd>
<dt> ‘<samp>overlay</samp>’</dt>
-<dd><p>Presents information that’s identical to that in the <code>parade</code>, except
+<dd><p>Presents information identical to that in the <code>parade</code>, except
that the graphs representing color components are superimposed directly
over one another.
</p>
-<p>This display mode in <code>waveform</code> histogram mode can make it easier to spot
-the relative differences or similarities in overlapping areas of the color
+<p>This display mode in <code>waveform</code> histogram mode makes it easier to spot
+relative differences or similarities in overlapping areas of the color
components that are supposed to be identical, such as neutral whites, grays,
or blacks.
</p></dd>
</p></dd>
</dl>
-<a name="Examples-45"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-45">9.40.1 Examples</a></h3>
+<a name="Examples-74"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-74">9.42.1 Examples</a></h3>
<ul>
<li>
<p><a name="hqdn3d"></a>
</p><a name="hqdn3d-1"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-hqdn3d-1">9.41 hqdn3d</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-hqdn3d-1">9.43 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="hue"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-hue">9.42 hue</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-hue">9.44 hue</a></h2>
<p>Modify the hue and/or the saturation of the input.
</p>
</p></dd>
</dl>
-<a name="Examples-52"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-52">9.42.1 Examples</a></h3>
+<a name="Examples-8"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-8">9.44.1 Examples</a></h3>
<ul>
<li>
</li></ul>
-<a name="Commands"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Commands">9.42.2 Commands</a></h3>
+<a name="Commands-4"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Commands-4">9.44.2 Commands</a></h3>
<p>This filter supports the following commands:
</p><dl compact="compact">
</dl>
<a name="idet"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-idet">9.43 idet</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-idet">9.45 idet</a></h2>
<p>Detect video interlacing type.
</p>
</dl>
<a name="il"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-il">9.44 il</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-il">9.46 il</a></h2>
<p>Deinterleave or interleave fields.
</p>
-<p>This filter allows to process interlaced images fields without
+<p>This filter allows one to process interlaced images fields without
deinterlacing them. Deinterleaving splits the input frame into 2
fields (so called half pictures). Odd lines are moved to the top
half of the output image, even lines to the bottom half.
</dl>
<a name="interlace"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-interlace">9.45 interlace</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-interlace">9.47 interlace</a></h2>
<p>Simple interlacing filter from progressive contents. This interleaves upper (or
lower) lines from odd frames with lower (or upper) lines from even frames,
-halving the frame rate and preserving image height.
+halving the frame rate and preserving image height. A vertical lowpass filter
+is always applied in order to avoid twitter effects and reduce moiré patterns.
</p>
<table><tr><td> </td><td><pre class="example"> Original Original New Frame
Frame 'j' Frame 'j+1' (tff)
<dt> ‘<samp>scan</samp>’</dt>
<dd><p>determines whether the interlaced frame is taken from the even (tff - default)
or odd (bff) lines of the progressive frame.
-</p>
-</dd>
-<dt> ‘<samp>lowpass</samp>’</dt>
-<dd><p>Enable (default) or disable the vertical lowpass filter to avoid twitter
-interlacing and reduce moire patterns.
</p></dd>
</dl>
<a name="kerndeint"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-kerndeint">9.46 kerndeint</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-kerndeint">9.48 kerndeint</a></h2>
<p>Deinterlace input video by applying Donald Graft’s adaptive kernel
deinterling. Work on interlaced parts of a video to produce
</p></dd>
</dl>
-<a name="Examples-29"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-29">9.46.1 Examples</a></h3>
+<a name="Examples-18"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-18">9.48.1 Examples</a></h3>
<ul>
<li>
<p><a name="lut3d"></a>
</p><a name="lut3d-1"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-lut3d-1">9.47 lut3d</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-lut3d-1">9.49 lut3d</a></h2>
<p>Apply a 3D LUT to an input video.
</p>
</dl>
<a name="lut_002c-lutrgb_002c-lutyuv"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-lut_002c-lutrgb_002c-lutyuv">9.48 lut, lutrgb, lutyuv</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-lut_002c-lutrgb_002c-lutyuv">9.50 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.
<p>All expressions default to "val".
</p>
-<a name="Examples-40"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-40">9.48.1 Examples</a></h3>
+<a name="Examples-38"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-38">9.50.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="mergeplanes"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-mergeplanes">9.49 mergeplanes</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-mergeplanes">9.51 mergeplanes</a></h2>
<p>Merge color channel components from several video streams.
</p>
</p></dd>
</dl>
-<a name="Examples-34"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-34">9.49.1 Examples</a></h3>
+<a name="Examples-40"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-40">9.51.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="mcdeint"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-mcdeint">9.50 mcdeint</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-mcdeint">9.52 mcdeint</a></h2>
<p>Apply motion-compensation deinterlacing.
</p>
</dl>
<a name="mp"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-mp">9.51 mp</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-mp">9.53 mp</a></h2>
<p>Apply an MPlayer filter to the input video.
</p>
of the corresponding MPlayer filters. For detailed instructions check
the "VIDEO FILTERS" section in the MPlayer manual.
</p>
-<a name="Examples-46"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-46">9.51.1 Examples</a></h3>
+<a name="Examples-73"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-73">9.53.1 Examples</a></h3>
<ul>
<li>
<p>See also mplayer(1), <a href="http://www.mplayerhq.hu/">http://www.mplayerhq.hu/</a>.
</p>
<a name="mpdecimate"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-mpdecimate">9.52 mpdecimate</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-mpdecimate">9.54 mpdecimate</a></h2>
<p>Drop frames that do not differ greatly from the previous frame in
order to reduce frame rate.
<a name="negate"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-negate">9.53 negate</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-negate">9.55 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="ffmpeg-filters.html#toc-noformat">9.54 noformat</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-noformat">9.56 noformat</a></h2>
<p>Force libavfilter not to use any of the specified pixel formats for the
input to the next filter.
</dd>
</dl>
-<a name="Examples-18"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-18">9.54.1 Examples</a></h3>
+<a name="Examples-16"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-16">9.56.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="noise"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-noise">9.55 noise</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-noise">9.57 noise</a></h2>
<p>Add noise on video input frame.
</p>
</dd>
</dl>
-<a name="Examples-48"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-48">9.55.1 Examples</a></h3>
+<a name="Examples-32"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-32">9.57.1 Examples</a></h3>
<p>Add temporal and uniform noise to input video:
</p><table><tr><td> </td><td><pre class="example">noise=alls=20:allf=t+u
</pre></td></tr></table>
<a name="null"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-null">9.56 null</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-null">9.58 null</a></h2>
<p>Pass the video source unchanged to the output.
</p>
<a name="ocv"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-ocv">9.57 ocv</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-ocv">9.59 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="ffmpeg-filters.html#toc-dilate-1">9.57.1 dilate</a></h3>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-dilate-1">9.59.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="ffmpeg-filters.html#toc-erode">9.57.2 erode</a></h3>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-erode">9.59.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="ffmpeg-filters.html#toc-smooth">9.57.3 smooth</a></h3>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-smooth">9.59.3 smooth</a></h3>
<p>Smooth the input video.
</p>
</p>
<p><a name="overlay"></a>
</p><a name="overlay-1"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-overlay-1">9.58 overlay</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-overlay-1">9.60 overlay</a></h2>
<p>Overlay one video on top of another.
</p>
the expression is invalid, it is set to a huge value (meaning that the
overlay will not be displayed within the output visible area).
</p>
+</dd>
+<dt> ‘<samp>eof_action</samp>’</dt>
+<dd><p>The action to take when EOF is encountered on the secondary input, accepts one
+of the following values:
+</p>
+<dl compact="compact">
+<dt> ‘<samp>repeat</samp>’</dt>
+<dd><p>repeat the last frame (the default)
+</p></dd>
+<dt> ‘<samp>endall</samp>’</dt>
+<dd><p>end both streams
+</p></dd>
+<dt> ‘<samp>pass</samp>’</dt>
+<dd><p>pass through the main input
+</p></dd>
+</dl>
+
</dd>
<dt> ‘<samp>eval</samp>’</dt>
<dd><p>Set when the expressions for ‘<samp>x</samp>’, and ‘<samp>y</samp>’ are evaluated.
<dd><p>force YUV420 output
</p>
</dd>
+<dt> ‘<samp>yuv422</samp>’</dt>
+<dd><p>force YUV422 output
+</p>
+</dd>
<dt> ‘<samp>yuv444</samp>’</dt>
<dd><p>force YUV444 output
</p>
</dd>
<dt> ‘<samp>t</samp>’</dt>
<dd><p>timestamp expressed in seconds, NAN if the input timestamp is unknown
-</p></dd>
+</p>
+</dd>
</dl>
<p>Note that the <var>n</var>, <var>pos</var>, <var>t</var> variables are available only
<p>You can chain together more overlays but you should test the
efficiency of such approach.
</p>
-<a name="Commands-1"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Commands-1">9.58.1 Commands</a></h3>
+<a name="Commands-5"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Commands-5">9.60.1 Commands</a></h3>
<p>This filter supports the following commands:
</p><dl compact="compact">
</p></dd>
</dl>
-<a name="Examples-30"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-30">9.58.2 Examples</a></h3>
+<a name="Examples-69"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-69">9.60.2 Examples</a></h3>
<ul>
<li>
"
</pre></td></tr></table>
+</li><li>
+mask 10-20 seconds of a video by applying the delogo filter to a section
+<table><tr><td> </td><td><pre class="example">ffmpeg -i test.avi -codec:v:0 wmv2 -ar 11025 -b:v 9000k
+-vf '[in]split[split_main][split_delogo];[split_delogo]trim=start=360:end=371,delogo=0:0:640:480[delogoed];[split_main][delogoed]overlay=eof_action=pass[out]'
+masked.avi
+</pre></td></tr></table>
+
</li><li>
Chain several overlays in cascade:
<table><tr><td> </td><td><pre class="example">nullsrc=s=200x200 [bg];
</li></ul>
<a name="owdenoise"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-owdenoise">9.59 owdenoise</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-owdenoise">9.61 owdenoise</a></h2>
<p>Apply Overcomplete Wavelet denoiser.
</p>
</dl>
<a name="pad"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-pad">9.60 pad</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-pad">9.62 pad</a></h2>
<p>Add paddings to the input image, and place the original input at the
given coordinates <var>x</var>, <var>y</var>.
</p></dd>
</dl>
-<a name="Examples-59"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-59">9.60.1 Examples</a></h3>
+<a name="Examples-36"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-36">9.62.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="perspective"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-perspective">9.61 perspective</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-perspective">9.63 perspective</a></h2>
<p>Correct perspective of video not recorded perpendicular to the screen.
</p>
</dl>
<a name="phase"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-phase">9.62 phase</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-phase">9.64 phase</a></h2>
<p>Delay interlaced video by one field time so that the field order changes.
</p>
</dl>
<a name="pixdesctest"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-pixdesctest">9.63 pixdesctest</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-pixdesctest">9.65 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="pp"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-pp">9.64 pp</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-pp">9.66 pp</a></h2>
<p>Enable the specified chain of postprocessing subfilters using libpostproc. This
library should be automatically selected with a GPL build (<code>--enable-gpl</code>).
</p></dd>
</dl>
-<a name="Examples-12"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-12">9.64.1 Examples</a></h3>
+<a name="Examples-14"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-14">9.66.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="psnr"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-psnr">9.65 psnr</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-psnr">9.67 psnr</a></h2>
<p>Obtain the average, maximum and minimum PSNR (Peak Signal to Noise
Ratio) between two input videos.
reference file ‘<tt>ref_movie.mpg</tt>’. The PSNR of each individual frame
is stored in ‘<tt>stats.log</tt>’.
</p>
-<a name="pullup"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-pullup">9.66 pullup</a></h2>
+<p><a name="pullup"></a>
+</p><a name="pullup-1"></a>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-pullup-1">9.68 pullup</a></h2>
<p>Pulldown reversal (inverse telecine) filter, capable of handling mixed
hard-telecine, 24000/1001 fps progressive, and 30000/1001 fps progressive
</pre></td></tr></table>
<a name="removelogo"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-removelogo">9.67 removelogo</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-removelogo">9.69 removelogo</a></h2>
<p>Suppress a TV station logo, using an image file to determine which
pixels comprise the logo. It works by filling in the pixels that
pixels will slow things down on a large logo.
</p>
<a name="rotate"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-rotate">9.68 rotate</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-rotate">9.70 rotate</a></h2>
<p>Rotate video by an arbitrary angle expressed in radians.
</p>
</dd>
<dt> ‘<samp>in_w, iw</samp>’</dt>
<dt> ‘<samp>in_h, ih</samp>’</dt>
-<dd><p>the input video width and heigth
+<dd><p>the input video width and height
</p>
</dd>
<dt> ‘<samp>out_w, ow</samp>’</dt>
<dt> ‘<samp>out_h, oh</samp>’</dt>
-<dd><p>the output width and heigth, that is the size of the padded area as
+<dd><p>the output width and height, that is the size of the padded area as
specified by the <var>width</var> and <var>height</var> expressions
</p>
</dd>
</p></dd>
</dl>
-<a name="Examples-33"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-33">9.68.1 Examples</a></h3>
+<a name="Examples-39"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-39">9.70.1 Examples</a></h3>
<ul>
<li>
<table><tr><td> </td><td><pre class="example">rotate=-PI/6
</pre></td></tr></table>
+</li><li>
+Rotate the input by 45 degrees clockwise:
+<table><tr><td> </td><td><pre class="example">rotate=45*PI/180
+</pre></td></tr></table>
+
</li><li>
Apply a constant rotation with period T, starting from an angle of PI/3:
<table><tr><td> </td><td><pre class="example">rotate=PI/3+2*PI*t/T
</pre></td></tr></table>
</li><li>
-Rotate the video, output size is choosen so that the whole rotating
+Rotate the video, output size is chosen so that the whole rotating
input video is always completely contained in the output:
<table><tr><td> </td><td><pre class="example">rotate='2*PI*t:ow=hypot(iw,ih):oh=ow'
</pre></td></tr></table>
</pre></td></tr></table>
</li></ul>
-<a name="Commands-4"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Commands-4">9.68.2 Commands</a></h3>
+<a name="Commands-2"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Commands-2">9.70.2 Commands</a></h3>
<p>The filter supports the following commands:
</p>
</dl>
<a name="sab"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-sab">9.69 sab</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-sab">9.71 sab</a></h2>
<p>Apply Shape Adaptive Blur.
</p>
</p>
<p><a name="scale"></a>
</p><a name="scale-1"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-scale-1">9.70 scale</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-scale-1">9.72 scale</a></h2>
<p>Scale (resize) the input video, using the libswscale library.
</p>
requested format.
</p>
<a name="Options"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Options">9.70.1 Options</a></h3>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Options">9.72.1 Options</a></h3>
<p>The filter accepts the following options, or any of the options
supported by the libswscale scaler.
</p>
other specified dimension. If both of them are -1, the input size is
used
</p>
+<p>If one of the values is -n with n > 1, the scale filter will also use a value
+that maintains the aspect ratio of the input image, calculated from the other
+specified dimension. After that it will, however, make sure that the calculated
+dimension is divisible by n and adjust the value if necessary.
+</p>
<p>See below for the list of accepted constants for use in the dimension
expression.
</p>
<dt> ‘<samp>flags</samp>’</dt>
<dd><p>Set libswscale scaling flags. See
<a href="ffmpeg-scaler.html#sws_005fflags">(ffmpeg-scaler)sws_flags</a> for the
-complete list of values. If not explictly specified the filter applies
+complete list of values. If not explicitly specified the filter applies
the default flags.
</p>
</dd>
</p></dd>
</dl>
-<a name="Examples-44"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-44">9.70.2 Examples</a></h3>
+<a name="Examples-3"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-3">9.72.2 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="separatefields"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-separatefields">9.71 separatefields</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-separatefields">9.73 separatefields</a></h2>
<p>The <code>separatefields</code> takes a frame-based video input and splits
each frame into its components fields, producing a new half height clip
If it gets it wrong use <a href="#setfield">setfield</a> filter before <code>separatefields</code> filter.
</p>
<a name="setdar_002c-setsar"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-setdar_002c-setsar">9.72 setdar, setsar</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-setdar_002c-setsar">9.74 setdar, setsar</a></h2>
<p>The <code>setdar</code> filter sets the Display Aspect Ratio for the filter
output video.
</p></dd>
</dl>
-<a name="Examples-16"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-16">9.72.1 Examples</a></h3>
+<a name="Examples-42"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-42">9.74.1 Examples</a></h3>
<ul>
<li>
<p><a name="setfield"></a>
</p><a name="setfield-1"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-setfield-1">9.73 setfield</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-setfield-1">9.75 setfield</a></h2>
<p>Force field for the output video frame.
</p>
</dl>
<a name="showinfo"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-showinfo">9.74 showinfo</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-showinfo">9.76 showinfo</a></h2>
<p>Show a line containing various information for each input video frame.
The input video is not modified.
<p><a name="smartblur"></a>
</p><a name="smartblur-1"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-smartblur-1">9.75 smartblur</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-smartblur-1">9.77 smartblur</a></h2>
<p>Blur the input video without impacting the outlines.
</p>
is set.
</p>
<a name="stereo3d"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-stereo3d">9.76 stereo3d</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-stereo3d">9.78 stereo3d</a></h2>
<p>Convert between different stereoscopic image formats.
</p>
</p></dd>
</dl>
-<a name="Examples-73"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-73">9.76.1 Examples</a></h3>
+<a name="Examples-11"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-11">9.78.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="spp"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-spp">9.77 spp</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-spp">9.79 spp</a></h2>
<p>Apply a simple postprocessing filter that compresses and decompresses the image
at several (or - in the case of ‘<samp>quality</samp>’ level <code>6</code> - all) shifts
<p><a name="subtitles"></a>
</p><a name="subtitles-1"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-subtitles-1">9.78 subtitles</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-subtitles-1">9.80 subtitles</a></h2>
<p>Draw subtitles on top of input video using the libass library.
</p>
</pre></td></tr></table>
<a name="super2xsai"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-super2xsai">9.79 super2xsai</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-super2xsai">9.81 super2xsai</a></h2>
<p>Scale the input by 2x and smooth using the Super2xSaI (Scale and
Interpolate) pixel art scaling algorithm.
<p>Useful for enlarging pixel art images without reducing sharpness.
</p>
<a name="swapuv"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-swapuv">9.80 swapuv</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-swapuv">9.82 swapuv</a></h2>
<p>Swap U & V plane.
</p>
<a name="telecine"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-telecine">9.81 telecine</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-telecine">9.83 telecine</a></h2>
<p>Apply telecine process to the video.
</p>
</pre></td></tr></table>
<a name="thumbnail"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-thumbnail">9.82 thumbnail</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-thumbnail">9.84 thumbnail</a></h2>
<p>Select the most representative frame in a given sequence of consecutive frames.
</p>
<p>The filter accepts the following options:
<p>Since the filter keeps track of the whole frames sequence, a bigger <var>n</var>
value will result in a higher memory usage, so a high value is not recommended.
</p>
-<a name="Examples-53"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-53">9.82.1 Examples</a></h3>
+<a name="Examples-37"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-37">9.84.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="tile"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-tile">9.83 tile</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-tile">9.85 tile</a></h2>
<p>Tile several successive frames together.
</p>
</p></dd>
</dl>
-<a name="Examples-67"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-67">9.83.1 Examples</a></h3>
+<a name="Examples-62"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-62">9.85.1 Examples</a></h3>
<ul>
<li>
<table><tr><td> </td><td><pre class="example">ffmpeg -skip_frame nokey -i file.avi -vf 'scale=128:72,tile=8x8' -an -vsync 0 keyframes%03d.png
</pre></td></tr></table>
<p>The ‘<samp>-vsync 0</samp>’ is necessary to prevent <code>ffmpeg</code> from
-duplicating each output frame to accomodate the originally detected frame
+duplicating each output frame to accommodate the originally detected frame
rate.
</p>
</li><li>
</li></ul>
<a name="tinterlace"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-tinterlace">9.84 tinterlace</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-tinterlace">9.86 tinterlace</a></h2>
<p>Perform various types of temporal field interlacing.
</p>
</dl>
<a name="transpose"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-transpose">9.85 transpose</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-transpose">9.87 transpose</a></h2>
<p>Transpose rows with columns in the input video and optionally flip it.
</p>
</pre></td></tr></table>
<a name="trim"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-trim">9.86 trim</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-trim">9.88 trim</a></h2>
<p>Trim the input so that the output contains one continuous subpart of the input.
</p>
<p>This filter accepts the following options:
<a name="unsharp"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-unsharp">9.87 unsharp</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-unsharp">9.89 unsharp</a></h2>
<p>Sharpen or blur the input video.
</p>
<p>All parameters are optional and default to the equivalent of the
string ’5:5:1.0:5:5:0.0’.
</p>
-<a name="Examples-9"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-9">9.87.1 Examples</a></h3>
+<a name="Examples-20"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-20">9.89.1 Examples</a></h3>
<ul>
<li>
<p><a name="vidstabdetect"></a>
</p><a name="vidstabdetect-1"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-vidstabdetect-1">9.88 vidstabdetect</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-vidstabdetect-1">9.90 vidstabdetect</a></h2>
<p>Analyze video stabilization/deshaking. Perform pass 1 of 2, see
<a href="#vidstabtransform">vidstabtransform</a> for pass 2.
<dt> ‘<samp>accuracy</samp>’</dt>
<dd><p>Set the accuracy of the detection process. It must be a value in the
range 1-15. A value of 1 means low accuracy, a value of 15 means high
-accuracy. Default value is 9.
+accuracy. Default value is 15.
</p>
</dd>
<dt> ‘<samp>stepsize</samp>’</dt>
</p></dd>
</dl>
-<a name="Examples-57"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-57">9.88.1 Examples</a></h3>
+<a name="Examples-61"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-61">9.90.1 Examples</a></h3>
<ul>
<li>
<p><a name="vidstabtransform"></a>
</p><a name="vidstabtransform-1"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-vidstabtransform-1">9.89 vidstabtransform</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-vidstabtransform-1">9.91 vidstabtransform</a></h2>
<p>Video stabilization/deshaking: pass 2 of 2,
see <a href="#vidstabdetect">vidstabdetect</a> for pass 1.
<p>To enable compilation of this filter you need to configure FFmpeg with
<code>--enable-libvidstab</code>.
</p>
-<p>This filter accepts the following options:
-</p>
+<a name="Options-1"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Options-1">9.91.1 Options</a></h3>
+
<dl compact="compact">
<dt> ‘<samp>input</samp>’</dt>
-<dd><p>path to the file used to read the transforms (default: ‘<tt>transforms.trf</tt>’)
+<dd><p>Set path to the file used to read the transforms. Default value is
+‘<tt>transforms.trf</tt>’).
</p>
</dd>
<dt> ‘<samp>smoothing</samp>’</dt>
-<dd><p>number of frames (value*2 + 1) used for lowpass filtering the camera movements
-(default: 10). For example a number of 10 means that 21 frames are used
-(10 in the past and 10 in the future) to smoothen the motion in the
-video. A larger values leads to a smoother video, but limits the
-acceleration of the camera (pan/tilt movements).
+<dd><p>Set the number of frames (value*2 + 1) used for lowpass filtering the
+camera movements. Default value is 10.
+</p>
+<p>For example a number of 10 means that 21 frames are used (10 in the
+past and 10 in the future) to smoothen the motion in the video. A
+larger values leads to a smoother video, but limits the acceleration
+of the camera (pan/tilt movements). 0 is a special case where a
+static camera is simulated.
</p>
+</dd>
+<dt> ‘<samp>optalgo</samp>’</dt>
+<dd><p>Set the camera path optimization algorithm.
+</p>
+<p>Accepted values are:
+</p><dl compact="compact">
+<dt> ‘<samp>gauss</samp>’</dt>
+<dd><p>gaussian kernel low-pass filter on camera motion (default)
+</p></dd>
+<dt> ‘<samp>avg</samp>’</dt>
+<dd><p>averaging on transformations
+</p></dd>
+</dl>
+
</dd>
<dt> ‘<samp>maxshift</samp>’</dt>
-<dd><p>maximal number of pixels to translate frames (default: -1 no limit)
+<dd><p>Set maximal number of pixels to translate frames. Default value is -1,
+meaning no limit.
</p>
</dd>
<dt> ‘<samp>maxangle</samp>’</dt>
-<dd><p>maximal angle in radians (degree*PI/180) to rotate frames (default: -1
-no limit)
+<dd><p>Set maximal angle in radians (degree*PI/180) to rotate frames. Default
+value is -1, meaning no limit.
</p>
</dd>
<dt> ‘<samp>crop</samp>’</dt>
-<dd><p>How to deal with borders that may be visible due to movement
-compensation. Available values are:
+<dd><p>Specify how to deal with borders that may be visible due to movement
+compensation.
</p>
-<dl compact="compact">
+<p>Available values are:
+</p><dl compact="compact">
<dt> ‘<samp>keep</samp>’</dt>
<dd><p>keep image information from previous frame (default)
</p></dd>
</dd>
<dt> ‘<samp>invert</samp>’</dt>
-<dd><dl compact="compact">
-<dt> ‘<samp>0</samp>’</dt>
-<dd><p>keep transforms normal (default)
-</p></dd>
-<dt> ‘<samp>1</samp>’</dt>
-<dd><p>invert transforms
-</p></dd>
-</dl>
-
+<dd><p>Invert transforms if set to 1. Default value is 0.
+</p>
</dd>
<dt> ‘<samp>relative</samp>’</dt>
-<dd><p>consider transforms as
-</p><dl compact="compact">
-<dt> ‘<samp>0</samp>’</dt>
-<dd><p>absolute
-</p></dd>
-<dt> ‘<samp>1</samp>’</dt>
-<dd><p>relative to previous frame (default)
-</p></dd>
-</dl>
-
+<dd><p>Consider transforms as relative to previsou frame if set to 1,
+absolute if set to 0. Default value is 0.
+</p>
</dd>
<dt> ‘<samp>zoom</samp>’</dt>
-<dd><p>percentage to zoom (default: 0)
-</p><dl compact="compact">
-<dt> ‘<samp>>0</samp>’</dt>
-<dd><p>zoom in
-</p></dd>
-<dt> ‘<samp><0</samp>’</dt>
-<dd><p>zoom out
-</p></dd>
-</dl>
-
+<dd><p>Set percentage to zoom. A positive value will result in a zoom-in
+effect, a negative value in a zoom-out effect. Default value is 0 (no
+zoom).
+</p>
</dd>
<dt> ‘<samp>optzoom</samp>’</dt>
-<dd><p>set optimal zooming to avoid borders
+<dd><p>Set optimal zooming to avoid borders.
+</p>
+<p>Accepted values are:
</p><dl compact="compact">
<dt> ‘<samp>0</samp>’</dt>
<dd><p>disabled
</p></dd>
<dt> ‘<samp>1</samp>’</dt>
-<dd><p>optimal static zoom value is determined (only very strong movements will lead to visible borders) (default)
+<dd><p>optimal static zoom value is determined (only very strong movements
+will lead to visible borders) (default)
</p></dd>
<dt> ‘<samp>2</samp>’</dt>
-<dd><p>optimal adaptive zoom value is determined (no borders will be visible)
+<dd><p>optimal adaptive zoom value is determined (no borders will be
+visible), see ‘<samp>zoomspeed</samp>’
</p></dd>
</dl>
-<p>Note that the value given at zoom is added to the one calculated
-here.
+
+<p>Note that the value given at zoom is added to the one calculated here.
+</p>
+</dd>
+<dt> ‘<samp>zoomspeed</samp>’</dt>
+<dd><p>Set percent to zoom maximally each frame (enabled when
+‘<samp>optzoom</samp>’ is set to 2). Range is from 0 to 5, default value is
+0.25.
</p>
</dd>
<dt> ‘<samp>interpol</samp>’</dt>
-<dd><p>type of interpolation
+<dd><p>Specify type of interpolation.
</p>
<p>Available values are:
</p><dl compact="compact">
</dd>
<dt> ‘<samp>tripod</samp>’</dt>
-<dd><p>virtual tripod mode means that the video is stabilized such that the
-camera stays stationary. Use also <code>tripod</code> option of
-<a href="#vidstabdetect">vidstabdetect</a>.
-</p><dl compact="compact">
-<dt> ‘<samp>0</samp>’</dt>
-<dd><p>off (default)
-</p></dd>
-<dt> ‘<samp>1</samp>’</dt>
-<dd><p>virtual tripod mode: equivalent to <code>relative=0:smoothing=0</code>
-</p></dd>
-</dl>
-
+<dd><p>Enable virtual tripod mode if set to 1, which is equivalent to
+<code>relative=0:smoothing=0</code>. Default value is 0.
+</p>
+<p>Use also <code>tripod</code> option of <a href="#vidstabdetect">vidstabdetect</a>.
+</p>
</dd>
+<dt> ‘<samp>debug</samp>’</dt>
+<dd><p>Increase log verbosity if set to 1. Also the detected global motions
+are written to the temporary file ‘<tt>global_motions.trf</tt>’. Default
+value is 0.
+</p></dd>
</dl>
-<a name="Examples-56"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-56">9.89.1 Examples</a></h3>
+<a name="Examples-50"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-50">9.91.2 Examples</a></h3>
<ul>
<li>
-typical call with default default values:
- (note the unsharp filter which is always recommended)
+Use <code>ffmpeg</code> for a typical stabilization with default values:
<table><tr><td> </td><td><pre class="example">ffmpeg -i inp.mpeg -vf vidstabtransform,unsharp=5:5:0.8:3:3:0.4 inp_stabilized.mpeg
</pre></td></tr></table>
+<p>Note the use of the unsharp filter which is always recommended.
+</p>
</li><li>
-zoom in a bit more and load transform data from a given file
+Zoom in a bit more and load transform data from a given file:
<table><tr><td> </td><td><pre class="example">vidstabtransform=zoom=5:input="mytransforms.trf"
</pre></td></tr></table>
</li><li>
-smoothen the video even more
+Smoothen the video even more:
<table><tr><td> </td><td><pre class="example">vidstabtransform=smoothing=30
</pre></td></tr></table>
-
</li></ul>
<a name="vflip"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-vflip">9.90 vflip</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-vflip">9.92 vflip</a></h2>
<p>Flip the input video vertically.
</p>
</pre></td></tr></table>
<a name="vignette"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-vignette">9.91 vignette</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-vignette">9.93 vignette</a></h2>
<p>Make or reverse a natural vignetting effect.
</p>
</p>
</dd>
<dt> ‘<samp>aspect</samp>’</dt>
-<dd><p>Set vignette aspect. This setting allows to adjust the shape of the vignette.
+<dd><p>Set vignette aspect. This setting allows one to adjust the shape of the vignette.
Setting this value to the SAR of the input will make a rectangular vignetting
following the dimensions of the video.
</p>
</dl>
<a name="Expressions"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Expressions">9.91.1 Expressions</a></h3>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Expressions">9.93.1 Expressions</a></h3>
<p>The ‘<samp>alpha</samp>’, ‘<samp>x0</samp>’ and ‘<samp>y0</samp>’ expressions can contain the
following parameters.
</dl>
-<a name="Examples-51"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-51">9.91.2 Examples</a></h3>
+<a name="Examples-53"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-53">9.93.2 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="w3fdif"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-w3fdif">9.92 w3fdif</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-w3fdif">9.94 w3fdif</a></h2>
<p>Deinterlace the input video ("w3fdif" stands for "Weston 3 Field
Deinterlacing Filter").
<p><a name="yadif"></a>
</p><a name="yadif-1"></a>
-<h2 class="section"><a href="ffmpeg-filters.html#toc-yadif-1">9.93 yadif</a></h2>
+<h2 class="section"><a href="ffmpeg-filters.html#toc-yadif-1">9.95 yadif</a></h2>
<p>Deinterlace the input video ("yadif" means "yet another deinterlacing
filter").
</p></dd>
</dl>
-<a name="Examples-70"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-70">10.2.1 Examples</a></h3>
+<a name="Examples-58"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-58">10.2.1 Examples</a></h3>
<ul>
<li>
</p>
<p>At each interaction the grid evolves according to the adopted rule,
which specifies the number of neighbor alive cells which will make a
-cell stay alive or born. The ‘<samp>rule</samp>’ option allows to specify
+cell stay alive or born. The ‘<samp>rule</samp>’ option allows one to specify
the rule to adopt.
</p>
<p>This source accepts the following options:
</p></dd>
</dl>
-<a name="Examples-6"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-6">10.6.1 Examples</a></h3>
+<a name="Examples-24"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-24">10.6.1 Examples</a></h3>
<ul>
<li>
</p><table><tr><td> </td><td><pre class="example">nullsrc=s=256x256, geq=random(1)*255:128:128
</pre></td></tr></table>
-<a name="Commands-3"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Commands-3">10.7.1 Commands</a></h3>
+<a name="Commands-1"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Commands-1">10.7.1 Commands</a></h3>
<p>The <code>color</code> source supports the following commands:
</p>
</p></dd>
</dl>
-<a name="Examples-69"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-69">12.1.1 Examples</a></h3>
+<a name="Examples-34"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-34">12.1.1 Examples</a></h3>
<ul>
<li>
<p>Different frame rates are acceptable but will result in variable frame rate
at output; be sure to configure the output file to handle it.
</p>
-<a name="Examples-64"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-64">12.2.1 Examples</a></h3>
+<a name="Examples-23"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-23">12.2.1 Examples</a></h3>
<ul>
<li>
<p>By default, the logging level is set to <var>info</var>. If the ‘<samp>video</samp>’ or
the ‘<samp>metadata</samp>’ options are set, it switches to <var>verbose</var>.
+</p>
+</dd>
+<dt> ‘<samp>peak</samp>’</dt>
+<dd><p>Set peak mode(s).
+</p>
+<p>Available modes can be cumulated (the option is a <code>flag</code> type). Possible
+values are:
+</p><dl compact="compact">
+<dt> ‘<samp>none</samp>’</dt>
+<dd><p>Disable any peak mode (default).
+</p></dd>
+<dt> ‘<samp>sample</samp>’</dt>
+<dd><p>Enable sample-peak mode.
+</p>
+<p>Simple peak mode looking for the higher sample value. It logs a message
+for sample-peak (identified by <code>SPK</code>).
+</p></dd>
+<dt> ‘<samp>true</samp>’</dt>
+<dd><p>Enable true-peak mode.
+</p>
+<p>If enabled, the peak lookup is done on an over-sampled version of the input
+stream for better peak accuracy. It logs a message for true-peak.
+(identified by <code>TPK</code>) and true-peak per frame (identified by <code>FTPK</code>).
+This mode requires a build with <code>libswresample</code>.
</p></dd>
</dl>
-<a name="Examples-25"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-25">12.3.1 Examples</a></h3>
+</dd>
+</dl>
+
+<a name="Examples-45"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-45">12.3.1 Examples</a></h3>
<ul>
<li>
</p></dd>
</dl>
-<a name="Examples-19"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-19">12.4.1 Examples</a></h3>
+<a name="Examples-55"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-55">12.4.1 Examples</a></h3>
<ul>
<li>
<p>The default value of the select expression is "1".
</p>
-<a name="Examples-43"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-43">12.6.1 Examples</a></h3>
+<a name="Examples-13"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-13">12.6.1 Examples</a></h3>
<ul>
<li>
<var>INTERVALS</var> ::= <var>INTERVAL</var>[;<var>INTERVALS</var>]
</pre></td></tr></table>
-<a name="Examples-13"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-13">12.7.2 Examples</a></h3>
+<a name="Examples-17"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-17">12.7.2 Examples</a></h3>
<ul>
<li>
</dd>
</dl>
-<a name="Examples-17"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-17">12.8.1 Examples</a></h3>
+<a name="Examples-60"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-60">12.8.1 Examples</a></h3>
<ul>
<li>
timebase), "intb" (the input timebase) and "sr" (the sample rate,
audio only). Default value is "intb".
</p>
-<a name="Examples-15"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-15">12.9.1 Examples</a></h3>
+<a name="Examples-10"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-10">12.9.1 Examples</a></h3>
<ul>
<li>
<p>The usage is very similar to the showwaves filter; see the examples in that
section.
</p>
-<a name="Examples-63"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-63">12.10.1 Examples</a></h3>
+<a name="Examples-15"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-15">12.10.1 Examples</a></h3>
<ul>
<li>
</dd>
</dl>
-<a name="Examples-61"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-61">12.11.1 Examples</a></h3>
+<a name="Examples-35"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-35">12.11.1 Examples</a></h3>
<ul>
<li>
<p>The filter accepts a single parameter which specifies the number of outputs. If
unspecified, it defaults to 2.
</p>
-<a name="Examples-27"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-27">12.12.1 Examples</a></h3>
+<a name="Examples-31"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-31">12.12.1 Examples</a></h3>
<ul>
<li>
<p><var>MESSAGE</var> is optional.
</p>
-<a name="Examples-3"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-3">12.13.1 Examples</a></h3>
+<a name="Examples-54"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-54">12.13.1 Examples</a></h3>
<p>Look at ‘<tt>tools/zmqsend</tt>’ for an example of a zmq client which can
be used to send commands processed by these filters.
</p></dd>
</dl>
-<p>This filter allows to overlay a second video on top of main input of
+<p>This filter allows one to overlay a second video on top of main input of
a filtergraph as shown in this graph:
</p><table><tr><td> </td><td><pre class="example">input -----------> deltapts0 --> overlay --> output
^
movie --> scale--> deltapts1 -------+
</pre></td></tr></table>
-<a name="Examples"></a>
-<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples">13.2.1 Examples</a></h3>
+<a name="Examples-49"></a>
+<h3 class="subsection"><a href="ffmpeg-filters.html#toc-Examples-49">13.2.1 Examples</a></h3>
<ul>
<li>
</p>
<footer class="footer pagination-right">
-<span class="label label-info">This document was generated by <em>Kyle Schwarz</em> on <em>December 14, 2013</em> using <a href="http://www.nongnu.org/texi2html/"><em>texi2html 1.82</em></a>.</span></footer></div></div></body>
+<span class="label label-info">This document was generated by <em>Kyle Schwarz</em> on <em>June 19, 2014</em> using <a href="http://www.nongnu.org/texi2html/"><em>texi2html 1.82</em></a>.</span></footer></div></div></body>