<!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-Synopsis" href="#Synopsis">1. Synopsis</a></li>
<li><a name="toc-Description" href="#Description">2. Description</a></li>
- <li><a name="toc-Options-25" href="#Options-25">3. Options</a>
+ <li><a name="toc-Options-4" href="#Options-4">3. Options</a>
<ul class="toc">
<li><a name="toc-Stream-specifiers-1" href="#Stream-specifiers-1">3.1 Stream specifiers</a></li>
<li><a name="toc-Generic-options" href="#Generic-options">3.2 Generic options</a></li>
<li><a name="toc-Advanced-options" href="#Advanced-options">3.5 Advanced options</a></li>
<li><a name="toc-While-playing" href="#While-playing">3.6 While playing</a></li>
</ul></li>
- <li><a name="toc-Syntax-2" href="#Syntax-2">4. Syntax</a>
+ <li><a name="toc-Syntax" href="#Syntax">4. Syntax</a>
<ul class="toc">
<li><a name="toc-Quoting-and-escaping" href="#Quoting-and-escaping">4.1 Quoting and escaping</a>
<ul class="toc">
- <li><a name="toc-Examples-13" href="#Examples-13">4.1.1 Examples</a></li>
+ <li><a name="toc-Examples-4" href="#Examples-4">4.1.1 Examples</a></li>
</ul></li>
<li><a name="toc-Date" href="#Date">4.2 Date</a></li>
<li><a name="toc-Time-duration" href="#Time-duration">4.3 Time duration</a>
<ul class="toc">
- <li><a name="toc-Examples-31" href="#Examples-31">4.3.1 Examples</a></li>
+ <li><a name="toc-Examples-66" href="#Examples-66">4.3.1 Examples</a></li>
</ul></li>
<li><a name="toc-Video-size" href="#Video-size">4.4 Video size</a></li>
<li><a name="toc-Video-rate" href="#Video-rate">4.5 Video rate</a></li>
<ul class="toc">
<li><a name="toc-rawvideo-1" href="#rawvideo-1">9.1 rawvideo</a>
<ul class="toc">
- <li><a name="toc-Options-9" href="#Options-9">9.1.1 Options</a></li>
+ <li><a name="toc-Options-7" href="#Options-7">9.1.1 Options</a></li>
</ul>
</li>
</ul></li>
<li><a name="toc-Audio-Decoders" href="#Audio-Decoders">10. Audio Decoders</a>
<ul class="toc">
- <li><a name="toc-ffwavesynth" href="#ffwavesynth">10.1 ffwavesynth</a></li>
- <li><a name="toc-libcelt" href="#libcelt">10.2 libcelt</a></li>
- <li><a name="toc-libgsm" href="#libgsm">10.3 libgsm</a></li>
- <li><a name="toc-libilbc" href="#libilbc">10.4 libilbc</a>
+ <li><a name="toc-ac3" href="#ac3">10.1 ac3</a>
<ul class="toc">
- <li><a name="toc-Options" href="#Options">10.4.1 Options</a></li>
+ <li><a name="toc-AC_002d3-Decoder-Options" href="#AC_002d3-Decoder-Options">10.1.1 AC-3 Decoder Options</a></li>
</ul></li>
- <li><a name="toc-libopencore_002damrnb-1" href="#libopencore_002damrnb-1">10.5 libopencore-amrnb</a></li>
- <li><a name="toc-libopencore_002damrwb" href="#libopencore_002damrwb">10.6 libopencore-amrwb</a></li>
- <li><a name="toc-libopus" href="#libopus">10.7 libopus</a></li>
+ <li><a name="toc-ffwavesynth" href="#ffwavesynth">10.2 ffwavesynth</a></li>
+ <li><a name="toc-libcelt" href="#libcelt">10.3 libcelt</a></li>
+ <li><a name="toc-libgsm" href="#libgsm">10.4 libgsm</a></li>
+ <li><a name="toc-libilbc" href="#libilbc">10.5 libilbc</a>
+ <ul class="toc">
+ <li><a name="toc-Options-11" href="#Options-11">10.5.1 Options</a></li>
+ </ul></li>
+ <li><a name="toc-libopencore_002damrnb" href="#libopencore_002damrnb">10.6 libopencore-amrnb</a></li>
+ <li><a name="toc-libopencore_002damrwb" href="#libopencore_002damrwb">10.7 libopencore-amrwb</a></li>
+ <li><a name="toc-libopus" href="#libopus">10.8 libopus</a></li>
</ul></li>
<li><a name="toc-Subtitles-Decoders" href="#Subtitles-Decoders">11. Subtitles Decoders</a>
<ul class="toc">
<li><a name="toc-dvdsub" href="#dvdsub">11.1 dvdsub</a>
<ul class="toc">
- <li><a name="toc-Options-24" href="#Options-24">11.1.1 Options</a></li>
+ <li><a name="toc-Options-10" href="#Options-10">11.1.1 Options</a></li>
</ul></li>
<li><a name="toc-libzvbi_002dteletext" href="#libzvbi_002dteletext">11.2 libzvbi-teletext</a>
<ul class="toc">
- <li><a name="toc-Options-7" href="#Options-7">11.2.1 Options</a></li>
- </ul>
-</li>
- </ul></li>
- <li><a name="toc-Encoders" href="#Encoders">12. Encoders</a></li>
- <li><a name="toc-Audio-Encoders" href="#Audio-Encoders">13. Audio Encoders</a>
- <ul class="toc">
- <li><a name="toc-aac" href="#aac">13.1 aac</a>
- <ul class="toc">
- <li><a name="toc-Options-27" href="#Options-27">13.1.1 Options</a></li>
- </ul></li>
- <li><a name="toc-ac3-and-ac3_005ffixed" href="#ac3-and-ac3_005ffixed">13.2 ac3 and ac3_fixed</a>
- <ul class="toc">
- <li><a name="toc-AC_002d3-Metadata" href="#AC_002d3-Metadata">13.2.1 AC-3 Metadata</a>
- <ul class="toc">
- <li><a name="toc-Metadata-Control-Options" href="#Metadata-Control-Options">13.2.1.1 Metadata Control Options</a></li>
- <li><a name="toc-Downmix-Levels" href="#Downmix-Levels">13.2.1.2 Downmix Levels</a></li>
- <li><a name="toc-Audio-Production-Information" href="#Audio-Production-Information">13.2.1.3 Audio Production Information</a></li>
- <li><a name="toc-Other-Metadata-Options" href="#Other-Metadata-Options">13.2.1.4 Other Metadata Options</a></li>
- </ul></li>
- <li><a name="toc-Extended-Bitstream-Information" href="#Extended-Bitstream-Information">13.2.2 Extended Bitstream Information</a>
- <ul class="toc">
- <li><a name="toc-Extended-Bitstream-Information-_002d-Part-1" href="#Extended-Bitstream-Information-_002d-Part-1">13.2.2.1 Extended Bitstream Information - Part 1</a></li>
- <li><a name="toc-Extended-Bitstream-Information-_002d-Part-2" href="#Extended-Bitstream-Information-_002d-Part-2">13.2.2.2 Extended Bitstream Information - Part 2</a></li>
- </ul></li>
- <li><a name="toc-Other-AC_002d3-Encoding-Options" href="#Other-AC_002d3-Encoding-Options">13.2.3 Other AC-3 Encoding Options</a></li>
- <li><a name="toc-Floating_002dPoint_002dOnly-AC_002d3-Encoding-Options" href="#Floating_002dPoint_002dOnly-AC_002d3-Encoding-Options">13.2.4 Floating-Point-Only AC-3 Encoding Options</a></li>
- </ul></li>
- <li><a name="toc-libfaac-1" href="#libfaac-1">13.3 libfaac</a>
- <ul class="toc">
- <li><a name="toc-Options-28" href="#Options-28">13.3.1 Options</a></li>
- <li><a name="toc-Examples-43" href="#Examples-43">13.3.2 Examples</a></li>
- </ul></li>
- <li><a name="toc-libfdk_005faac" href="#libfdk_005faac">13.4 libfdk_aac</a>
- <ul class="toc">
- <li><a name="toc-Options-8" href="#Options-8">13.4.1 Options</a></li>
- <li><a name="toc-Examples-59" href="#Examples-59">13.4.2 Examples</a></li>
- </ul></li>
- <li><a name="toc-libmp3lame-1" href="#libmp3lame-1">13.5 libmp3lame</a>
- <ul class="toc">
- <li><a name="toc-Options-17" href="#Options-17">13.5.1 Options</a></li>
- </ul></li>
- <li><a name="toc-libopencore_002damrnb" href="#libopencore_002damrnb">13.6 libopencore-amrnb</a>
- <ul class="toc">
- <li><a name="toc-Options-29" href="#Options-29">13.6.1 Options</a></li>
- </ul></li>
- <li><a name="toc-libshine-1" href="#libshine-1">13.7 libshine</a>
- <ul class="toc">
- <li><a name="toc-Options-16" href="#Options-16">13.7.1 Options</a></li>
- </ul></li>
- <li><a name="toc-libtwolame" href="#libtwolame">13.8 libtwolame</a>
- <ul class="toc">
- <li><a name="toc-Options-22" href="#Options-22">13.8.1 Options</a></li>
- </ul></li>
- <li><a name="toc-libvo_002daacenc-1" href="#libvo_002daacenc-1">13.9 libvo-aacenc</a>
- <ul class="toc">
- <li><a name="toc-Options-11" href="#Options-11">13.9.1 Options</a></li>
- </ul></li>
- <li><a name="toc-libvo_002damrwbenc" href="#libvo_002damrwbenc">13.10 libvo-amrwbenc</a>
- <ul class="toc">
- <li><a name="toc-Options-23" href="#Options-23">13.10.1 Options</a></li>
- </ul></li>
- <li><a name="toc-libopus-1" href="#libopus-1">13.11 libopus</a>
- <ul class="toc">
- <li><a name="toc-Option-Mapping" href="#Option-Mapping">13.11.1 Option Mapping</a></li>
- </ul></li>
- <li><a name="toc-libvorbis" href="#libvorbis">13.12 libvorbis</a>
- <ul class="toc">
- <li><a name="toc-Options-32" href="#Options-32">13.12.1 Options</a></li>
- </ul></li>
- <li><a name="toc-libwavpack" href="#libwavpack">13.13 libwavpack</a></li>
- </ul></li>
- <li><a name="toc-Video-Encoders" href="#Video-Encoders">14. Video Encoders</a>
- <ul class="toc">
- <li><a name="toc-libtheora" href="#libtheora">14.1 libtheora</a>
- <ul class="toc">
- <li><a name="toc-Options-19" href="#Options-19">14.1.1 Options</a></li>
- <li><a name="toc-Examples-28" href="#Examples-28">14.1.2 Examples</a></li>
- </ul></li>
- <li><a name="toc-libvpx" href="#libvpx">14.2 libvpx</a>
- <ul class="toc">
- <li><a name="toc-Options-1" href="#Options-1">14.2.1 Options</a></li>
- </ul></li>
- <li><a name="toc-libx264" href="#libx264">14.3 libx264</a>
- <ul class="toc">
- <li><a name="toc-Options-10" href="#Options-10">14.3.1 Options</a></li>
- </ul></li>
- <li><a name="toc-libxvid" href="#libxvid">14.4 libxvid</a>
- <ul class="toc">
- <li><a name="toc-Options-14" href="#Options-14">14.4.1 Options</a></li>
- </ul></li>
- <li><a name="toc-png" href="#png">14.5 png</a>
- <ul class="toc">
- <li><a name="toc-Private-options" href="#Private-options">14.5.1 Private options</a></li>
- </ul></li>
- <li><a name="toc-ProRes" href="#ProRes">14.6 ProRes</a>
- <ul class="toc">
- <li><a name="toc-Private-Options-for-prores_002dks" href="#Private-Options-for-prores_002dks">14.6.1 Private Options for prores-ks</a></li>
- <li><a name="toc-Speed-considerations" href="#Speed-considerations">14.6.2 Speed considerations</a></li>
+ <li><a name="toc-Options-3" href="#Options-3">11.2.1 Options</a></li>
</ul>
</li>
</ul></li>
- <li><a name="toc-Bitstream-Filters" href="#Bitstream-Filters">15. Bitstream Filters</a>
- <ul class="toc">
- <li><a name="toc-aac_005fadtstoasc" href="#aac_005fadtstoasc">15.1 aac_adtstoasc</a></li>
- <li><a name="toc-chomp" href="#chomp">15.2 chomp</a></li>
- <li><a name="toc-dump_005fextra" href="#dump_005fextra">15.3 dump_extra</a></li>
- <li><a name="toc-h264_005fmp4toannexb" href="#h264_005fmp4toannexb">15.4 h264_mp4toannexb</a></li>
- <li><a name="toc-imx_005fdump_005fheader" href="#imx_005fdump_005fheader">15.5 imx_dump_header</a></li>
- <li><a name="toc-mjpeg2jpeg" href="#mjpeg2jpeg">15.6 mjpeg2jpeg</a></li>
- <li><a name="toc-mjpega_005fdump_005fheader" href="#mjpega_005fdump_005fheader">15.7 mjpega_dump_header</a></li>
- <li><a name="toc-movsub" href="#movsub">15.8 movsub</a></li>
- <li><a name="toc-mp3_005fheader_005fdecompress" href="#mp3_005fheader_005fdecompress">15.9 mp3_header_decompress</a></li>
- <li><a name="toc-noise-1" href="#noise-1">15.10 noise</a></li>
- <li><a name="toc-remove_005fextra" href="#remove_005fextra">15.11 remove_extra</a></li>
- </ul></li>
- <li><a name="toc-Format-Options" href="#Format-Options">16. Format Options</a>
- <ul class="toc">
- <li><a name="toc-Format-stream-specifiers-1" href="#Format-stream-specifiers-1">16.1 Format stream specifiers</a></li>
- </ul></li>
- <li><a name="toc-Demuxers" href="#Demuxers">17. Demuxers</a>
+ <li><a name="toc-Bitstream-Filters" href="#Bitstream-Filters">12. Bitstream Filters</a>
<ul class="toc">
- <li><a name="toc-applehttp" href="#applehttp">17.1 applehttp</a></li>
- <li><a name="toc-asf" href="#asf">17.2 asf</a></li>
- <li><a name="toc-concat-3" href="#concat-3">17.3 concat</a>
- <ul class="toc">
- <li><a name="toc-Syntax-1" href="#Syntax-1">17.3.1 Syntax</a></li>
- <li><a name="toc-Options-13" href="#Options-13">17.3.2 Options</a></li>
- </ul></li>
- <li><a name="toc-flv" href="#flv">17.4 flv</a></li>
- <li><a name="toc-libgme" href="#libgme">17.5 libgme</a></li>
- <li><a name="toc-libquvi" href="#libquvi">17.6 libquvi</a></li>
- <li><a name="toc-image2-2" href="#image2-2">17.7 image2</a>
- <ul class="toc">
- <li><a name="toc-Examples-88" href="#Examples-88">17.7.1 Examples</a></li>
- </ul></li>
- <li><a name="toc-mpegts-1" href="#mpegts-1">17.8 mpegts</a></li>
- <li><a name="toc-rawvideo" href="#rawvideo">17.9 rawvideo</a></li>
- <li><a name="toc-sbg" href="#sbg">17.10 sbg</a></li>
- <li><a name="toc-tedcaptions" href="#tedcaptions">17.11 tedcaptions</a></li>
+ <li><a name="toc-aac_005fadtstoasc" href="#aac_005fadtstoasc">12.1 aac_adtstoasc</a></li>
+ <li><a name="toc-chomp" href="#chomp">12.2 chomp</a></li>
+ <li><a name="toc-dump_005fextra" href="#dump_005fextra">12.3 dump_extra</a></li>
+ <li><a name="toc-h264_005fmp4toannexb" href="#h264_005fmp4toannexb">12.4 h264_mp4toannexb</a></li>
+ <li><a name="toc-imx_005fdump_005fheader" href="#imx_005fdump_005fheader">12.5 imx_dump_header</a></li>
+ <li><a name="toc-mjpeg2jpeg" href="#mjpeg2jpeg">12.6 mjpeg2jpeg</a></li>
+ <li><a name="toc-mjpega_005fdump_005fheader" href="#mjpega_005fdump_005fheader">12.7 mjpega_dump_header</a></li>
+ <li><a name="toc-movsub" href="#movsub">12.8 movsub</a></li>
+ <li><a name="toc-mp3_005fheader_005fdecompress" href="#mp3_005fheader_005fdecompress">12.9 mp3_header_decompress</a></li>
+ <li><a name="toc-noise" href="#noise">12.10 noise</a></li>
+ <li><a name="toc-remove_005fextra" href="#remove_005fextra">12.11 remove_extra</a></li>
</ul></li>
- <li><a name="toc-Muxers" href="#Muxers">18. Muxers</a>
+ <li><a name="toc-Format-Options" href="#Format-Options">13. Format Options</a>
<ul class="toc">
- <li><a name="toc-aiff-1" href="#aiff-1">18.1 aiff</a></li>
- <li><a name="toc-crc-1" href="#crc-1">18.2 crc</a></li>
- <li><a name="toc-framecrc-1" href="#framecrc-1">18.3 framecrc</a></li>
- <li><a name="toc-framemd5-1" href="#framemd5-1">18.4 framemd5</a></li>
- <li><a name="toc-gif-1" href="#gif-1">18.5 gif</a></li>
- <li><a name="toc-hls-1" href="#hls-1">18.6 hls</a></li>
- <li><a name="toc-ico-1" href="#ico-1">18.7 ico</a></li>
- <li><a name="toc-image2-1" href="#image2-1">18.8 image2</a></li>
- <li><a name="toc-matroska" href="#matroska">18.9 matroska</a></li>
- <li><a name="toc-md5-1" href="#md5-1">18.10 md5</a></li>
- <li><a name="toc-mov_002fmp4_002fismv" href="#mov_002fmp4_002fismv">18.11 mov/mp4/ismv</a></li>
- <li><a name="toc-mp3" href="#mp3">18.12 mp3</a></li>
- <li><a name="toc-mpegts" href="#mpegts">18.13 mpegts</a></li>
- <li><a name="toc-null-1" href="#null-1">18.14 null</a></li>
- <li><a name="toc-ogg" href="#ogg">18.15 ogg</a></li>
- <li><a name="toc-segment_002c-stream_005fsegment_002c-ssegment" href="#segment_002c-stream_005fsegment_002c-ssegment">18.16 segment, stream_segment, ssegment</a>
- <ul class="toc">
- <li><a name="toc-Examples-81" href="#Examples-81">18.16.1 Examples</a></li>
- </ul></li>
- <li><a name="toc-tee" href="#tee">18.17 tee</a></li>
+ <li><a name="toc-Format-stream-specifiers-1" href="#Format-stream-specifiers-1">13.1 Format stream specifiers</a></li>
</ul></li>
- <li><a name="toc-Metadata" href="#Metadata">19. Metadata</a></li>
- <li><a name="toc-Protocols" href="#Protocols">20. Protocols</a>
+ <li><a name="toc-Demuxers" href="#Demuxers">14. Demuxers</a>
<ul class="toc">
- <li><a name="toc-bluray" href="#bluray">20.1 bluray</a></li>
- <li><a name="toc-cache" href="#cache">20.2 cache</a></li>
- <li><a name="toc-concat-1" href="#concat-1">20.3 concat</a></li>
- <li><a name="toc-crypto" href="#crypto">20.4 crypto</a></li>
- <li><a name="toc-data" href="#data">20.5 data</a></li>
- <li><a name="toc-file" href="#file">20.6 file</a></li>
- <li><a name="toc-ftp" href="#ftp">20.7 ftp</a></li>
- <li><a name="toc-gopher" href="#gopher">20.8 gopher</a></li>
- <li><a name="toc-hls-2" href="#hls-2">20.9 hls</a></li>
- <li><a name="toc-http" href="#http">20.10 http</a>
+ <li><a name="toc-applehttp" href="#applehttp">14.1 applehttp</a></li>
+ <li><a name="toc-asf" href="#asf">14.2 asf</a></li>
+ <li><a name="toc-concat-1" href="#concat-1">14.3 concat</a>
<ul class="toc">
- <li><a name="toc-HTTP-Cookies" href="#HTTP-Cookies">20.10.1 HTTP Cookies</a></li>
+ <li><a name="toc-Syntax-1" href="#Syntax-1">14.3.1 Syntax</a></li>
+ <li><a name="toc-Options-2" href="#Options-2">14.3.2 Options</a></li>
</ul></li>
- <li><a name="toc-mmst" href="#mmst">20.11 mmst</a></li>
- <li><a name="toc-mmsh" href="#mmsh">20.12 mmsh</a></li>
- <li><a name="toc-md5-2" href="#md5-2">20.13 md5</a></li>
- <li><a name="toc-pipe" href="#pipe">20.14 pipe</a></li>
- <li><a name="toc-rtmp" href="#rtmp">20.15 rtmp</a></li>
- <li><a name="toc-rtmpe" href="#rtmpe">20.16 rtmpe</a></li>
- <li><a name="toc-rtmps" href="#rtmps">20.17 rtmps</a></li>
- <li><a name="toc-rtmpt" href="#rtmpt">20.18 rtmpt</a></li>
- <li><a name="toc-rtmpte" href="#rtmpte">20.19 rtmpte</a></li>
- <li><a name="toc-rtmpts" href="#rtmpts">20.20 rtmpts</a></li>
- <li><a name="toc-libssh" href="#libssh">20.21 libssh</a></li>
- <li><a name="toc-librtmp-rtmp_002c-rtmpe_002c-rtmps_002c-rtmpt_002c-rtmpte" href="#librtmp-rtmp_002c-rtmpe_002c-rtmps_002c-rtmpt_002c-rtmpte">20.22 librtmp rtmp, rtmpe, rtmps, rtmpt, rtmpte</a></li>
- <li><a name="toc-rtp" href="#rtp">20.23 rtp</a></li>
- <li><a name="toc-rtsp" href="#rtsp">20.24 rtsp</a></li>
- <li><a name="toc-sap" href="#sap">20.25 sap</a>
+ <li><a name="toc-flv" href="#flv">14.4 flv</a></li>
+ <li><a name="toc-libgme" href="#libgme">14.5 libgme</a></li>
+ <li><a name="toc-libquvi" href="#libquvi">14.6 libquvi</a></li>
+ <li><a name="toc-image2" href="#image2">14.7 image2</a>
<ul class="toc">
- <li><a name="toc-Muxer" href="#Muxer">20.25.1 Muxer</a></li>
- <li><a name="toc-Demuxer" href="#Demuxer">20.25.2 Demuxer</a></li>
+ <li><a name="toc-Examples-75" href="#Examples-75">14.7.1 Examples</a></li>
</ul></li>
- <li><a name="toc-sctp" href="#sctp">20.26 sctp</a></li>
- <li><a name="toc-srtp" href="#srtp">20.27 srtp</a></li>
- <li><a name="toc-tcp" href="#tcp">20.28 tcp</a></li>
- <li><a name="toc-tls" href="#tls">20.29 tls</a></li>
- <li><a name="toc-udp" href="#udp">20.30 udp</a></li>
- <li><a name="toc-unix" href="#unix">20.31 unix</a></li>
+ <li><a name="toc-mpegts" href="#mpegts">14.8 mpegts</a></li>
+ <li><a name="toc-rawvideo" href="#rawvideo">14.9 rawvideo</a></li>
+ <li><a name="toc-sbg" href="#sbg">14.10 sbg</a></li>
+ <li><a name="toc-tedcaptions" href="#tedcaptions">14.11 tedcaptions</a></li>
</ul></li>
- <li><a name="toc-Device-Options" href="#Device-Options">21. Device Options</a></li>
- <li><a name="toc-Input-Devices" href="#Input-Devices">22. Input Devices</a>
+ <li><a name="toc-Metadata" href="#Metadata">15. Metadata</a></li>
+ <li><a name="toc-Protocols" href="#Protocols">16. Protocols</a>
<ul class="toc">
- <li><a name="toc-alsa-1" href="#alsa-1">22.1 alsa</a></li>
- <li><a name="toc-bktr" href="#bktr">22.2 bktr</a></li>
- <li><a name="toc-dshow" href="#dshow">22.3 dshow</a>
- <ul class="toc">
- <li><a name="toc-Options-18" href="#Options-18">22.3.1 Options</a></li>
- <li><a name="toc-Examples-71" href="#Examples-71">22.3.2 Examples</a></li>
- </ul></li>
- <li><a name="toc-dv1394" href="#dv1394">22.4 dv1394</a></li>
- <li><a name="toc-fbdev-1" href="#fbdev-1">22.5 fbdev</a></li>
- <li><a name="toc-iec61883" href="#iec61883">22.6 iec61883</a>
- <ul class="toc">
- <li><a name="toc-Options-5" href="#Options-5">22.6.1 Options</a></li>
- <li><a name="toc-Examples-37" href="#Examples-37">22.6.2 Examples</a></li>
- </ul></li>
- <li><a name="toc-jack" href="#jack">22.7 jack</a></li>
- <li><a name="toc-lavfi" href="#lavfi">22.8 lavfi</a>
+ <li><a name="toc-bluray" href="#bluray">16.1 bluray</a></li>
+ <li><a name="toc-cache" href="#cache">16.2 cache</a></li>
+ <li><a name="toc-concat-3" href="#concat-3">16.3 concat</a></li>
+ <li><a name="toc-crypto" href="#crypto">16.4 crypto</a></li>
+ <li><a name="toc-data" href="#data">16.5 data</a></li>
+ <li><a name="toc-file" href="#file">16.6 file</a></li>
+ <li><a name="toc-ftp" href="#ftp">16.7 ftp</a></li>
+ <li><a name="toc-gopher" href="#gopher">16.8 gopher</a></li>
+ <li><a name="toc-hls" href="#hls">16.9 hls</a></li>
+ <li><a name="toc-http" href="#http">16.10 http</a>
<ul class="toc">
- <li><a name="toc-Options-31" href="#Options-31">22.8.1 Options</a></li>
- <li><a name="toc-Examples-87" href="#Examples-87">22.8.2 Examples</a></li>
+ <li><a name="toc-HTTP-Cookies" href="#HTTP-Cookies">16.10.1 HTTP Cookies</a></li>
</ul></li>
- <li><a name="toc-libdc1394" href="#libdc1394">22.9 libdc1394</a></li>
- <li><a name="toc-openal" href="#openal">22.10 openal</a>
+ <li><a name="toc-mmst" href="#mmst">16.11 mmst</a></li>
+ <li><a name="toc-mmsh" href="#mmsh">16.12 mmsh</a></li>
+ <li><a name="toc-md5" href="#md5">16.13 md5</a></li>
+ <li><a name="toc-pipe" href="#pipe">16.14 pipe</a></li>
+ <li><a name="toc-rtmp" href="#rtmp">16.15 rtmp</a></li>
+ <li><a name="toc-rtmpe" href="#rtmpe">16.16 rtmpe</a></li>
+ <li><a name="toc-rtmps" href="#rtmps">16.17 rtmps</a></li>
+ <li><a name="toc-rtmpt" href="#rtmpt">16.18 rtmpt</a></li>
+ <li><a name="toc-rtmpte" href="#rtmpte">16.19 rtmpte</a></li>
+ <li><a name="toc-rtmpts" href="#rtmpts">16.20 rtmpts</a></li>
+ <li><a name="toc-libssh" href="#libssh">16.21 libssh</a></li>
+ <li><a name="toc-librtmp-rtmp_002c-rtmpe_002c-rtmps_002c-rtmpt_002c-rtmpte" href="#librtmp-rtmp_002c-rtmpe_002c-rtmps_002c-rtmpt_002c-rtmpte">16.22 librtmp rtmp, rtmpe, rtmps, rtmpt, rtmpte</a></li>
+ <li><a name="toc-rtp" href="#rtp">16.23 rtp</a></li>
+ <li><a name="toc-rtsp" href="#rtsp">16.24 rtsp</a>
<ul class="toc">
- <li><a name="toc-Options-26" href="#Options-26">22.10.1 Options</a></li>
- <li><a name="toc-Examples-74" href="#Examples-74">22.10.2 Examples</a></li>
+ <li><a name="toc-Examples-78" href="#Examples-78">16.24.1 Examples</a></li>
</ul></li>
- <li><a name="toc-oss" href="#oss">22.11 oss</a></li>
- <li><a name="toc-pulse-1" href="#pulse-1">22.12 pulse</a>
+ <li><a name="toc-sap" href="#sap">16.25 sap</a>
<ul class="toc">
- <li><a name="toc-Options-30" href="#Options-30">22.12.1 Options</a></li>
- <li><a name="toc-Examples-49" href="#Examples-49">22.12.2 Examples</a></li>
+ <li><a name="toc-Muxer" href="#Muxer">16.25.1 Muxer</a></li>
+ <li><a name="toc-Demuxer" href="#Demuxer">16.25.2 Demuxer</a></li>
</ul></li>
- <li><a name="toc-sndio-1" href="#sndio-1">22.13 sndio</a></li>
- <li><a name="toc-video4linux2_002c-v4l2" href="#video4linux2_002c-v4l2">22.14 video4linux2, v4l2</a>
+ <li><a name="toc-sctp" href="#sctp">16.26 sctp</a></li>
+ <li><a name="toc-srtp" href="#srtp">16.27 srtp</a></li>
+ <li><a name="toc-tcp" href="#tcp">16.28 tcp</a></li>
+ <li><a name="toc-tls" href="#tls">16.29 tls</a></li>
+ <li><a name="toc-udp" href="#udp">16.30 udp</a>
<ul class="toc">
- <li><a name="toc-Options-2" href="#Options-2">22.14.1 Options</a></li>
+ <li><a name="toc-Examples-53" href="#Examples-53">16.30.1 Examples</a></li>
</ul></li>
- <li><a name="toc-vfwcap" href="#vfwcap">22.15 vfwcap</a></li>
- <li><a name="toc-x11grab" href="#x11grab">22.16 x11grab</a>
- <ul class="toc">
- <li><a name="toc-Options-20" href="#Options-20">22.16.1 Options</a></li>
- </ul>
-</li>
+ <li><a name="toc-unix" href="#unix">16.31 unix</a></li>
</ul></li>
- <li><a name="toc-Output-Devices" href="#Output-Devices">23. Output Devices</a>
+ <li><a name="toc-Device-Options" href="#Device-Options">17. Device Options</a></li>
+ <li><a name="toc-Input-Devices" href="#Input-Devices">18. Input Devices</a>
<ul class="toc">
- <li><a name="toc-alsa" href="#alsa">23.1 alsa</a>
+ <li><a name="toc-alsa" href="#alsa">18.1 alsa</a></li>
+ <li><a name="toc-bktr" href="#bktr">18.2 bktr</a></li>
+ <li><a name="toc-dshow" href="#dshow">18.3 dshow</a>
<ul class="toc">
- <li><a name="toc-Examples-33" href="#Examples-33">23.1.1 Examples</a></li>
+ <li><a name="toc-Options-1" href="#Options-1">18.3.1 Options</a></li>
+ <li><a name="toc-Examples-23" href="#Examples-23">18.3.2 Examples</a></li>
</ul></li>
- <li><a name="toc-caca" href="#caca">23.2 caca</a>
+ <li><a name="toc-dv1394" href="#dv1394">18.4 dv1394</a></li>
+ <li><a name="toc-fbdev" href="#fbdev">18.5 fbdev</a></li>
+ <li><a name="toc-iec61883" href="#iec61883">18.6 iec61883</a>
<ul class="toc">
- <li><a name="toc-Options-4" href="#Options-4">23.2.1 Options</a></li>
- <li><a name="toc-Examples-56" href="#Examples-56">23.2.2 Examples</a></li>
+ <li><a name="toc-Options-12" href="#Options-12">18.6.1 Options</a></li>
+ <li><a name="toc-Examples-26" href="#Examples-26">18.6.2 Examples</a></li>
</ul></li>
- <li><a name="toc-fbdev" href="#fbdev">23.3 fbdev</a>
+ <li><a name="toc-jack" href="#jack">18.7 jack</a></li>
+ <li><a name="toc-lavfi" href="#lavfi">18.8 lavfi</a>
<ul class="toc">
- <li><a name="toc-Options-15" href="#Options-15">23.3.1 Options</a></li>
- <li><a name="toc-Examples-66" href="#Examples-66">23.3.2 Examples</a></li>
+ <li><a name="toc-Options-13" href="#Options-13">18.8.1 Options</a></li>
+ <li><a name="toc-Examples-27" href="#Examples-27">18.8.2 Examples</a></li>
</ul></li>
- <li><a name="toc-oss-1" href="#oss-1">23.4 oss</a></li>
- <li><a name="toc-pulse" href="#pulse">23.5 pulse</a>
+ <li><a name="toc-libdc1394" href="#libdc1394">18.9 libdc1394</a></li>
+ <li><a name="toc-openal" href="#openal">18.10 openal</a>
<ul class="toc">
- <li><a name="toc-Options-6" href="#Options-6">23.5.1 Options</a></li>
- <li><a name="toc-Examples-23" href="#Examples-23">23.5.2 Examples</a></li>
+ <li><a name="toc-Options-14" href="#Options-14">18.10.1 Options</a></li>
+ <li><a name="toc-Examples-42" href="#Examples-42">18.10.2 Examples</a></li>
</ul></li>
- <li><a name="toc-sdl" href="#sdl">23.6 sdl</a>
+ <li><a name="toc-oss" href="#oss">18.11 oss</a></li>
+ <li><a name="toc-pulse" href="#pulse">18.12 pulse</a>
<ul class="toc">
- <li><a name="toc-Options-12" href="#Options-12">23.6.1 Options</a></li>
- <li><a name="toc-Interactive-commands" href="#Interactive-commands">23.6.2 Interactive commands</a></li>
- <li><a name="toc-Examples-82" href="#Examples-82">23.6.3 Examples</a></li>
+ <li><a name="toc-Options" href="#Options">18.12.1 Options</a></li>
+ <li><a name="toc-Examples-71" href="#Examples-71">18.12.2 Examples</a></li>
</ul></li>
- <li><a name="toc-sndio" href="#sndio">23.7 sndio</a></li>
- <li><a name="toc-xv" href="#xv">23.8 xv</a>
+ <li><a name="toc-sndio" href="#sndio">18.13 sndio</a></li>
+ <li><a name="toc-video4linux2_002c-v4l2" href="#video4linux2_002c-v4l2">18.14 video4linux2, v4l2</a>
<ul class="toc">
- <li><a name="toc-Options-3" href="#Options-3">23.8.1 Options</a></li>
- <li><a name="toc-Examples-48" href="#Examples-48">23.8.2 Examples</a></li>
+ <li><a name="toc-Options-9" href="#Options-9">18.14.1 Options</a></li>
+ </ul></li>
+ <li><a name="toc-vfwcap" href="#vfwcap">18.15 vfwcap</a></li>
+ <li><a name="toc-x11grab" href="#x11grab">18.16 x11grab</a>
+ <ul class="toc">
+ <li><a name="toc-Options-8" href="#Options-8">18.16.1 Options</a></li>
</ul>
</li>
</ul></li>
- <li><a name="toc-Resampler-Options" href="#Resampler-Options">24. Resampler Options</a></li>
- <li><a name="toc-Scaler-Options" href="#Scaler-Options">25. Scaler Options</a></li>
- <li><a name="toc-Filtering-Introduction" href="#Filtering-Introduction">26. Filtering Introduction</a></li>
- <li><a name="toc-graph2dot" href="#graph2dot">27. graph2dot</a></li>
- <li><a name="toc-Filtergraph-description" href="#Filtergraph-description">28. Filtergraph description</a>
+ <li><a name="toc-Resampler-Options" href="#Resampler-Options">19. Resampler Options</a></li>
+ <li><a name="toc-Scaler-Options" href="#Scaler-Options">20. Scaler Options</a></li>
+ <li><a name="toc-Filtering-Introduction" href="#Filtering-Introduction">21. Filtering Introduction</a></li>
+ <li><a name="toc-graph2dot" href="#graph2dot">22. graph2dot</a></li>
+ <li><a name="toc-Filtergraph-description" href="#Filtergraph-description">23. Filtergraph description</a>
<ul class="toc">
- <li><a name="toc-Filtergraph-syntax-1" href="#Filtergraph-syntax-1">28.1 Filtergraph syntax</a></li>
- <li><a name="toc-Notes-on-filtergraph-escaping" href="#Notes-on-filtergraph-escaping">28.2 Notes on filtergraph escaping</a></li>
+ <li><a name="toc-Filtergraph-syntax-1" href="#Filtergraph-syntax-1">23.1 Filtergraph syntax</a></li>
+ <li><a name="toc-Notes-on-filtergraph-escaping" href="#Notes-on-filtergraph-escaping">23.2 Notes on filtergraph escaping</a></li>
</ul></li>
- <li><a name="toc-Timeline-editing" href="#Timeline-editing">29. Timeline editing</a></li>
- <li><a name="toc-Audio-Filters" href="#Audio-Filters">30. Audio Filters</a>
+ <li><a name="toc-Timeline-editing" href="#Timeline-editing">24. Timeline editing</a></li>
+ <li><a name="toc-Audio-Filters" href="#Audio-Filters">25. Audio Filters</a>
<ul class="toc">
- <li><a name="toc-aconvert" href="#aconvert">30.1 aconvert</a>
+ <li><a name="toc-aconvert" href="#aconvert">25.1 aconvert</a>
+ <ul class="toc">
+ <li><a name="toc-Examples-18" href="#Examples-18">25.1.1 Examples</a></li>
+ </ul></li>
+ <li><a name="toc-adelay" href="#adelay">25.2 adelay</a>
<ul class="toc">
- <li><a name="toc-Examples-47" href="#Examples-47">30.1.1 Examples</a></li>
+ <li><a name="toc-Examples-30" href="#Examples-30">25.2.1 Examples</a></li>
</ul></li>
- <li><a name="toc-adelay" href="#adelay">30.2 adelay</a>
+ <li><a name="toc-aecho" href="#aecho">25.3 aecho</a>
<ul class="toc">
- <li><a name="toc-Examples-41" href="#Examples-41">30.2.1 Examples</a></li>
+ <li><a name="toc-Examples-41" href="#Examples-41">25.3.1 Examples</a></li>
</ul></li>
- <li><a name="toc-aecho" href="#aecho">30.3 aecho</a>
+ <li><a name="toc-aeval" href="#aeval">25.4 aeval</a>
<ul class="toc">
- <li><a name="toc-Examples-19" href="#Examples-19">30.3.1 Examples</a></li>
+ <li><a name="toc-Examples-21" href="#Examples-21">25.4.1 Examples</a></li>
</ul></li>
- <li><a name="toc-aeval" href="#aeval">30.4 aeval</a>
+ <li><a name="toc-afade" href="#afade">25.5 afade</a>
<ul class="toc">
- <li><a name="toc-Examples-34" href="#Examples-34">30.4.1 Examples</a></li>
+ <li><a name="toc-Examples-72" href="#Examples-72">25.5.1 Examples</a></li>
</ul></li>
- <li><a name="toc-afade" href="#afade">30.5 afade</a>
+ <li><a name="toc-aformat-1" href="#aformat-1">25.6 aformat</a></li>
+ <li><a name="toc-allpass" href="#allpass">25.7 allpass</a></li>
+ <li><a name="toc-amerge" href="#amerge">25.8 amerge</a>
<ul class="toc">
- <li><a name="toc-Examples-24" href="#Examples-24">30.5.1 Examples</a></li>
+ <li><a name="toc-Examples-28" href="#Examples-28">25.8.1 Examples</a></li>
</ul></li>
- <li><a name="toc-aformat-1" href="#aformat-1">30.6 aformat</a></li>
- <li><a name="toc-allpass" href="#allpass">30.7 allpass</a></li>
- <li><a name="toc-amerge" href="#amerge">30.8 amerge</a>
+ <li><a name="toc-amix" href="#amix">25.9 amix</a></li>
+ <li><a name="toc-anull" href="#anull">25.10 anull</a></li>
+ <li><a name="toc-apad" href="#apad">25.11 apad</a></li>
+ <li><a name="toc-aphaser" href="#aphaser">25.12 aphaser</a></li>
+ <li><a name="toc-aresample-1" href="#aresample-1">25.13 aresample</a>
<ul class="toc">
- <li><a name="toc-Examples-62" href="#Examples-62">30.8.1 Examples</a></li>
+ <li><a name="toc-Examples-84" href="#Examples-84">25.13.1 Examples</a></li>
</ul></li>
- <li><a name="toc-amix" href="#amix">30.9 amix</a></li>
- <li><a name="toc-anull" href="#anull">30.10 anull</a></li>
- <li><a name="toc-apad" href="#apad">30.11 apad</a></li>
- <li><a name="toc-aphaser" href="#aphaser">30.12 aphaser</a></li>
- <li><a name="toc-aresample-1" href="#aresample-1">30.13 aresample</a>
+ <li><a name="toc-asetnsamples" href="#asetnsamples">25.14 asetnsamples</a></li>
+ <li><a name="toc-asetrate" href="#asetrate">25.15 asetrate</a></li>
+ <li><a name="toc-ashowinfo" href="#ashowinfo">25.16 ashowinfo</a></li>
+ <li><a name="toc-astats" href="#astats">25.17 astats</a></li>
+ <li><a name="toc-astreamsync" href="#astreamsync">25.18 astreamsync</a>
<ul class="toc">
- <li><a name="toc-Examples-22" href="#Examples-22">30.13.1 Examples</a></li>
+ <li><a name="toc-Examples-35" href="#Examples-35">25.18.1 Examples</a></li>
</ul></li>
- <li><a name="toc-asetnsamples" href="#asetnsamples">30.14 asetnsamples</a></li>
- <li><a name="toc-asetrate" href="#asetrate">30.15 asetrate</a></li>
- <li><a name="toc-ashowinfo" href="#ashowinfo">30.16 ashowinfo</a></li>
- <li><a name="toc-astats" href="#astats">30.17 astats</a></li>
- <li><a name="toc-astreamsync" href="#astreamsync">30.18 astreamsync</a>
+ <li><a name="toc-asyncts" href="#asyncts">25.19 asyncts</a></li>
+ <li><a name="toc-atempo" href="#atempo">25.20 atempo</a>
<ul class="toc">
- <li><a name="toc-Examples-46" href="#Examples-46">30.18.1 Examples</a></li>
+ <li><a name="toc-Examples-57" href="#Examples-57">25.20.1 Examples</a></li>
</ul></li>
- <li><a name="toc-asyncts" href="#asyncts">30.19 asyncts</a></li>
- <li><a name="toc-atempo" href="#atempo">30.20 atempo</a>
+ <li><a name="toc-atrim" href="#atrim">25.21 atrim</a></li>
+ <li><a name="toc-bandpass" href="#bandpass">25.22 bandpass</a></li>
+ <li><a name="toc-bandreject" href="#bandreject">25.23 bandreject</a></li>
+ <li><a name="toc-bass" href="#bass">25.24 bass</a></li>
+ <li><a name="toc-biquad" href="#biquad">25.25 biquad</a></li>
+ <li><a name="toc-channelmap" href="#channelmap">25.26 channelmap</a></li>
+ <li><a name="toc-channelsplit" href="#channelsplit">25.27 channelsplit</a></li>
+ <li><a name="toc-compand" href="#compand">25.28 compand</a>
<ul class="toc">
- <li><a name="toc-Examples-60" href="#Examples-60">30.20.1 Examples</a></li>
+ <li><a name="toc-Examples-37" href="#Examples-37">25.28.1 Examples</a></li>
</ul></li>
- <li><a name="toc-atrim" href="#atrim">30.21 atrim</a></li>
- <li><a name="toc-bandpass" href="#bandpass">30.22 bandpass</a></li>
- <li><a name="toc-bandreject" href="#bandreject">30.23 bandreject</a></li>
- <li><a name="toc-bass" href="#bass">30.24 bass</a></li>
- <li><a name="toc-biquad" href="#biquad">30.25 biquad</a></li>
- <li><a name="toc-channelmap" href="#channelmap">30.26 channelmap</a></li>
- <li><a name="toc-channelsplit" href="#channelsplit">30.27 channelsplit</a></li>
- <li><a name="toc-compand" href="#compand">30.28 compand</a>
+ <li><a name="toc-earwax" href="#earwax">25.29 earwax</a></li>
+ <li><a name="toc-equalizer" href="#equalizer">25.30 equalizer</a>
<ul class="toc">
- <li><a name="toc-Examples-15" href="#Examples-15">30.28.1 Examples</a></li>
+ <li><a name="toc-Examples-69" href="#Examples-69">25.30.1 Examples</a></li>
</ul></li>
- <li><a name="toc-earwax" href="#earwax">30.29 earwax</a></li>
- <li><a name="toc-equalizer" href="#equalizer">30.30 equalizer</a></li>
- <li><a name="toc-highpass" href="#highpass">30.31 highpass</a></li>
- <li><a name="toc-join" href="#join">30.32 join</a></li>
- <li><a name="toc-ladspa" href="#ladspa">30.33 ladspa</a>
+ <li><a name="toc-highpass" href="#highpass">25.31 highpass</a></li>
+ <li><a name="toc-join" href="#join">25.32 join</a></li>
+ <li><a name="toc-ladspa" href="#ladspa">25.33 ladspa</a>
<ul class="toc">
- <li><a name="toc-Examples-9" href="#Examples-9">30.33.1 Examples</a></li>
- <li><a name="toc-Commands-3" href="#Commands-3">30.33.2 Commands</a></li>
+ <li><a name="toc-Examples-54" href="#Examples-54">25.33.1 Examples</a></li>
+ <li><a name="toc-Commands-1" href="#Commands-1">25.33.2 Commands</a></li>
</ul></li>
- <li><a name="toc-lowpass" href="#lowpass">30.34 lowpass</a></li>
- <li><a name="toc-pan" href="#pan">30.35 pan</a>
+ <li><a name="toc-lowpass" href="#lowpass">25.34 lowpass</a></li>
+ <li><a name="toc-pan" href="#pan">25.35 pan</a>
<ul class="toc">
- <li><a name="toc-Mixing-examples" href="#Mixing-examples">30.35.1 Mixing examples</a></li>
- <li><a name="toc-Remapping-examples" href="#Remapping-examples">30.35.2 Remapping examples</a></li>
+ <li><a name="toc-Mixing-examples" href="#Mixing-examples">25.35.1 Mixing examples</a></li>
+ <li><a name="toc-Remapping-examples" href="#Remapping-examples">25.35.2 Remapping examples</a></li>
</ul></li>
- <li><a name="toc-replaygain" href="#replaygain">30.36 replaygain</a></li>
- <li><a name="toc-resample" href="#resample">30.37 resample</a></li>
- <li><a name="toc-silencedetect" href="#silencedetect">30.38 silencedetect</a>
+ <li><a name="toc-replaygain" href="#replaygain">25.36 replaygain</a></li>
+ <li><a name="toc-resample" href="#resample">25.37 resample</a></li>
+ <li><a name="toc-silencedetect" href="#silencedetect">25.38 silencedetect</a>
<ul class="toc">
- <li><a name="toc-Examples-64" href="#Examples-64">30.38.1 Examples</a></li>
+ <li><a name="toc-Examples-14" href="#Examples-14">25.38.1 Examples</a></li>
</ul></li>
- <li><a name="toc-treble" href="#treble">30.39 treble</a></li>
- <li><a name="toc-volume" href="#volume">30.40 volume</a>
+ <li><a name="toc-treble" href="#treble">25.39 treble</a></li>
+ <li><a name="toc-volume" href="#volume">25.40 volume</a>
<ul class="toc">
- <li><a name="toc-Examples-80" href="#Examples-80">30.40.1 Examples</a></li>
+ <li><a name="toc-Commands-3" href="#Commands-3">25.40.1 Commands</a></li>
+ <li><a name="toc-Examples-51" href="#Examples-51">25.40.2 Examples</a></li>
</ul></li>
- <li><a name="toc-volumedetect" href="#volumedetect">30.41 volumedetect</a>
+ <li><a name="toc-volumedetect" href="#volumedetect">25.41 volumedetect</a>
<ul class="toc">
- <li><a name="toc-Examples-55" href="#Examples-55">30.41.1 Examples</a></li>
+ <li><a name="toc-Examples-63" href="#Examples-63">25.41.1 Examples</a></li>
</ul>
</li>
</ul></li>
- <li><a name="toc-Audio-Sources" href="#Audio-Sources">31. Audio Sources</a>
+ <li><a name="toc-Audio-Sources" href="#Audio-Sources">26. Audio Sources</a>
<ul class="toc">
- <li><a name="toc-abuffer" href="#abuffer">31.1 abuffer</a>
+ <li><a name="toc-abuffer" href="#abuffer">26.1 abuffer</a>
<ul class="toc">
- <li><a name="toc-Examples-27" href="#Examples-27">31.1.1 Examples</a></li>
+ <li><a name="toc-Examples-6" href="#Examples-6">26.1.1 Examples</a></li>
</ul></li>
- <li><a name="toc-aevalsrc" href="#aevalsrc">31.2 aevalsrc</a>
+ <li><a name="toc-aevalsrc" href="#aevalsrc">26.2 aevalsrc</a>
<ul class="toc">
- <li><a name="toc-Examples-78" href="#Examples-78">31.2.1 Examples</a></li>
+ <li><a name="toc-Examples-56" href="#Examples-56">26.2.1 Examples</a></li>
</ul></li>
- <li><a name="toc-anullsrc" href="#anullsrc">31.3 anullsrc</a>
+ <li><a name="toc-anullsrc" href="#anullsrc">26.3 anullsrc</a>
<ul class="toc">
- <li><a name="toc-Examples-84" href="#Examples-84">31.3.1 Examples</a></li>
+ <li><a name="toc-Examples-38" href="#Examples-38">26.3.1 Examples</a></li>
</ul></li>
- <li><a name="toc-flite" href="#flite">31.4 flite</a>
+ <li><a name="toc-flite" href="#flite">26.4 flite</a>
<ul class="toc">
- <li><a name="toc-Examples-85" href="#Examples-85">31.4.1 Examples</a></li>
+ <li><a name="toc-Examples-80" href="#Examples-80">26.4.1 Examples</a></li>
</ul></li>
- <li><a name="toc-sine" href="#sine">31.5 sine</a>
+ <li><a name="toc-sine" href="#sine">26.5 sine</a>
<ul class="toc">
- <li><a name="toc-Examples-32" href="#Examples-32">31.5.1 Examples</a></li>
+ <li><a name="toc-Examples-50" href="#Examples-50">26.5.1 Examples</a></li>
</ul>
</li>
</ul></li>
- <li><a name="toc-Audio-Sinks" href="#Audio-Sinks">32. Audio Sinks</a>
+ <li><a name="toc-Audio-Sinks" href="#Audio-Sinks">27. Audio Sinks</a>
<ul class="toc">
- <li><a name="toc-abuffersink" href="#abuffersink">32.1 abuffersink</a></li>
- <li><a name="toc-anullsink" href="#anullsink">32.2 anullsink</a></li>
+ <li><a name="toc-abuffersink" href="#abuffersink">27.1 abuffersink</a></li>
+ <li><a name="toc-anullsink" href="#anullsink">27.2 anullsink</a></li>
</ul></li>
- <li><a name="toc-Video-Filters" href="#Video-Filters">33. Video Filters</a>
+ <li><a name="toc-Video-Filters" href="#Video-Filters">28. Video Filters</a>
<ul class="toc">
- <li><a name="toc-alphaextract" href="#alphaextract">33.1 alphaextract</a></li>
- <li><a name="toc-alphamerge" href="#alphamerge">33.2 alphamerge</a></li>
- <li><a name="toc-ass" href="#ass">33.3 ass</a></li>
- <li><a name="toc-bbox" href="#bbox">33.4 bbox</a></li>
- <li><a name="toc-blackdetect" href="#blackdetect">33.5 blackdetect</a></li>
- <li><a name="toc-blackframe" href="#blackframe">33.6 blackframe</a></li>
- <li><a name="toc-blend" href="#blend">33.7 blend</a>
+ <li><a name="toc-alphaextract" href="#alphaextract">28.1 alphaextract</a></li>
+ <li><a name="toc-alphamerge" href="#alphamerge">28.2 alphamerge</a></li>
+ <li><a name="toc-ass" href="#ass">28.3 ass</a></li>
+ <li><a name="toc-bbox" href="#bbox">28.4 bbox</a></li>
+ <li><a name="toc-blackdetect" href="#blackdetect">28.5 blackdetect</a></li>
+ <li><a name="toc-blackframe" href="#blackframe">28.6 blackframe</a></li>
+ <li><a name="toc-blend" href="#blend">28.7 blend</a>
<ul class="toc">
- <li><a name="toc-Examples-54" href="#Examples-54">33.7.1 Examples</a></li>
+ <li><a name="toc-Examples-62" href="#Examples-62">28.7.1 Examples</a></li>
</ul></li>
- <li><a name="toc-boxblur" href="#boxblur">33.8 boxblur</a>
+ <li><a name="toc-boxblur" href="#boxblur">28.8 boxblur</a>
<ul class="toc">
- <li><a name="toc-Examples-4" href="#Examples-4">33.8.1 Examples</a></li>
+ <li><a name="toc-Examples-12" href="#Examples-12">28.8.1 Examples</a></li>
</ul></li>
- <li><a name="toc-colorbalance" href="#colorbalance">33.9 colorbalance</a>
+ <li><a name="toc-colorbalance" href="#colorbalance">28.9 colorbalance</a>
<ul class="toc">
- <li><a name="toc-Examples-89" href="#Examples-89">33.9.1 Examples</a></li>
+ <li><a name="toc-Examples-68" href="#Examples-68">28.9.1 Examples</a></li>
</ul></li>
- <li><a name="toc-colorchannelmixer" href="#colorchannelmixer">33.10 colorchannelmixer</a>
+ <li><a name="toc-colorchannelmixer" href="#colorchannelmixer">28.10 colorchannelmixer</a>
<ul class="toc">
- <li><a name="toc-Examples-65" href="#Examples-65">33.10.1 Examples</a></li>
+ <li><a name="toc-Examples-33" href="#Examples-33">28.10.1 Examples</a></li>
</ul></li>
- <li><a name="toc-colormatrix" href="#colormatrix">33.11 colormatrix</a></li>
- <li><a name="toc-copy" href="#copy">33.12 copy</a></li>
- <li><a name="toc-crop" href="#crop">33.13 crop</a>
+ <li><a name="toc-colormatrix" href="#colormatrix">28.11 colormatrix</a></li>
+ <li><a name="toc-copy" href="#copy">28.12 copy</a></li>
+ <li><a name="toc-crop" href="#crop">28.13 crop</a>
<ul class="toc">
- <li><a name="toc-Examples-8" href="#Examples-8">33.13.1 Examples</a></li>
+ <li><a name="toc-Examples-64" href="#Examples-64">28.13.1 Examples</a></li>
</ul></li>
- <li><a name="toc-cropdetect" href="#cropdetect">33.14 cropdetect</a></li>
- <li><a name="toc-curves-1" href="#curves-1">33.15 curves</a>
+ <li><a name="toc-cropdetect" href="#cropdetect">28.14 cropdetect</a></li>
+ <li><a name="toc-curves-1" href="#curves-1">28.15 curves</a>
<ul class="toc">
- <li><a name="toc-Examples-75" href="#Examples-75">33.15.1 Examples</a></li>
+ <li><a name="toc-Examples-77" href="#Examples-77">28.15.1 Examples</a></li>
</ul></li>
- <li><a name="toc-dctdnoiz" href="#dctdnoiz">33.16 dctdnoiz</a>
+ <li><a name="toc-dctdnoiz" href="#dctdnoiz">28.16 dctdnoiz</a>
<ul class="toc">
- <li><a name="toc-Examples-20" href="#Examples-20">33.16.1 Examples</a></li>
+ <li><a name="toc-Examples-22" href="#Examples-22">28.16.1 Examples</a></li>
</ul></li>
- <li><a name="toc-decimate-1" href="#decimate-1">33.17 decimate</a></li>
- <li><a name="toc-delogo" href="#delogo">33.18 delogo</a>
+ <li><a name="toc-decimate-1" href="#decimate-1">28.17 decimate</a></li>
+ <li><a name="toc-dejudder" href="#dejudder">28.18 dejudder</a></li>
+ <li><a name="toc-delogo" href="#delogo">28.19 delogo</a>
<ul class="toc">
- <li><a name="toc-Examples-44" href="#Examples-44">33.18.1 Examples</a></li>
+ <li><a name="toc-Examples-32" href="#Examples-32">28.19.1 Examples</a></li>
</ul></li>
- <li><a name="toc-deshake" href="#deshake">33.19 deshake</a></li>
- <li><a name="toc-drawbox" href="#drawbox">33.20 drawbox</a>
+ <li><a name="toc-deshake" href="#deshake">28.20 deshake</a></li>
+ <li><a name="toc-drawbox" href="#drawbox">28.21 drawbox</a>
<ul class="toc">
- <li><a name="toc-Examples-86" href="#Examples-86">33.20.1 Examples</a></li>
+ <li><a name="toc-Examples-19" href="#Examples-19">28.21.1 Examples</a></li>
</ul></li>
- <li><a name="toc-drawgrid" href="#drawgrid">33.21 drawgrid</a>
+ <li><a name="toc-drawgrid" href="#drawgrid">28.22 drawgrid</a>
<ul class="toc">
- <li><a name="toc-Examples-36" href="#Examples-36">33.21.1 Examples</a></li>
+ <li><a name="toc-Examples-40" href="#Examples-40">28.22.1 Examples</a></li>
</ul></li>
- <li><a name="toc-drawtext-1" href="#drawtext-1">33.22 drawtext</a>
+ <li><a name="toc-drawtext-1" href="#drawtext-1">28.23 drawtext</a>
<ul class="toc">
- <li><a name="toc-Syntax" href="#Syntax">33.22.1 Syntax</a></li>
- <li><a name="toc-Text-expansion" href="#Text-expansion">33.22.2 Text expansion</a></li>
- <li><a name="toc-Examples-58" href="#Examples-58">33.22.3 Examples</a></li>
+ <li><a name="toc-Syntax-2" href="#Syntax-2">28.23.1 Syntax</a></li>
+ <li><a name="toc-Text-expansion" href="#Text-expansion">28.23.2 Text expansion</a></li>
+ <li><a name="toc-Examples-44" href="#Examples-44">28.23.3 Examples</a></li>
</ul></li>
- <li><a name="toc-edgedetect" href="#edgedetect">33.23 edgedetect</a></li>
- <li><a name="toc-extractplanes" href="#extractplanes">33.24 extractplanes</a>
+ <li><a name="toc-edgedetect" href="#edgedetect">28.24 edgedetect</a></li>
+ <li><a name="toc-extractplanes" href="#extractplanes">28.25 extractplanes</a>
<ul class="toc">
- <li><a name="toc-Examples-70" href="#Examples-70">33.24.1 Examples</a></li>
+ <li><a name="toc-Examples-43" href="#Examples-43">28.25.1 Examples</a></li>
</ul></li>
- <li><a name="toc-elbg" href="#elbg">33.25 elbg</a></li>
- <li><a name="toc-fade" href="#fade">33.26 fade</a>
+ <li><a name="toc-elbg" href="#elbg">28.26 elbg</a></li>
+ <li><a name="toc-fade" href="#fade">28.27 fade</a>
<ul class="toc">
- <li><a name="toc-Examples-3" href="#Examples-3">33.26.1 Examples</a></li>
+ <li><a name="toc-Examples-34" href="#Examples-34">28.27.1 Examples</a></li>
</ul></li>
- <li><a name="toc-field" href="#field">33.27 field</a></li>
- <li><a name="toc-fieldmatch" href="#fieldmatch">33.28 fieldmatch</a>
+ <li><a name="toc-field" href="#field">28.28 field</a></li>
+ <li><a name="toc-fieldmatch" href="#fieldmatch">28.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">33.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">28.29.1 p/c/n/u/b meaning</a>
<ul class="toc">
- <li><a name="toc-p_002fc_002fn" href="#p_002fc_002fn">33.28.1.1 p/c/n</a></li>
- <li><a name="toc-u_002fb" href="#u_002fb">33.28.1.2 u/b</a></li>
+ <li><a name="toc-p_002fc_002fn" href="#p_002fc_002fn">28.29.1.1 p/c/n</a></li>
+ <li><a name="toc-u_002fb" href="#u_002fb">28.29.1.2 u/b</a></li>
</ul></li>
- <li><a name="toc-Examples-52" href="#Examples-52">33.28.2 Examples</a></li>
+ <li><a name="toc-Examples-55" href="#Examples-55">28.29.2 Examples</a></li>
</ul></li>
- <li><a name="toc-fieldorder" href="#fieldorder">33.29 fieldorder</a></li>
- <li><a name="toc-fifo" href="#fifo">33.30 fifo</a></li>
- <li><a name="toc-format-1" href="#format-1">33.31 format</a>
+ <li><a name="toc-fieldorder" href="#fieldorder">28.30 fieldorder</a></li>
+ <li><a name="toc-fifo" href="#fifo">28.31 fifo</a></li>
+ <li><a name="toc-format-1" href="#format-1">28.32 format</a>
<ul class="toc">
- <li><a name="toc-Examples-57" href="#Examples-57">33.31.1 Examples</a></li>
+ <li><a name="toc-Examples-17" href="#Examples-17">28.32.1 Examples</a></li>
</ul></li>
- <li><a name="toc-fps-1" href="#fps-1">33.32 fps</a>
+ <li><a name="toc-fps-1" href="#fps-1">28.33 fps</a>
<ul class="toc">
- <li><a name="toc-Examples-25" href="#Examples-25">33.32.1 Examples</a></li>
+ <li><a name="toc-Examples-60" href="#Examples-60">28.33.1 Examples</a></li>
</ul></li>
- <li><a name="toc-framestep" href="#framestep">33.33 framestep</a></li>
- <li><a name="toc-frei0r-1" href="#frei0r-1">33.34 frei0r</a>
+ <li><a name="toc-framepack" href="#framepack">28.34 framepack</a></li>
+ <li><a name="toc-framestep" href="#framestep">28.35 framestep</a></li>
+ <li><a name="toc-frei0r-1" href="#frei0r-1">28.36 frei0r</a>
<ul class="toc">
- <li><a name="toc-Examples-12" href="#Examples-12">33.34.1 Examples</a></li>
+ <li><a name="toc-Examples-1" href="#Examples-1">28.36.1 Examples</a></li>
</ul></li>
- <li><a name="toc-geq" href="#geq">33.35 geq</a>
+ <li><a name="toc-geq" href="#geq">28.37 geq</a>
<ul class="toc">
- <li><a name="toc-Examples-79" href="#Examples-79">33.35.1 Examples</a></li>
+ <li><a name="toc-Examples-82" href="#Examples-82">28.37.1 Examples</a></li>
</ul></li>
- <li><a name="toc-gradfun" href="#gradfun">33.36 gradfun</a>
+ <li><a name="toc-gradfun" href="#gradfun">28.38 gradfun</a>
<ul class="toc">
- <li><a name="toc-Examples-72" href="#Examples-72">33.36.1 Examples</a></li>
+ <li><a name="toc-Examples" href="#Examples">28.38.1 Examples</a></li>
</ul></li>
- <li><a name="toc-haldclut-1" href="#haldclut-1">33.37 haldclut</a>
+ <li><a name="toc-haldclut-1" href="#haldclut-1">28.39 haldclut</a>
<ul class="toc">
- <li><a name="toc-Workflow-examples" href="#Workflow-examples">33.37.1 Workflow examples</a>
+ <li><a name="toc-Workflow-examples" href="#Workflow-examples">28.39.1 Workflow examples</a>
<ul class="toc">
- <li><a name="toc-Hald-CLUT-video-stream" href="#Hald-CLUT-video-stream">33.37.1.1 Hald CLUT video stream</a></li>
- <li><a name="toc-Hald-CLUT-with-preview" href="#Hald-CLUT-with-preview">33.37.1.2 Hald CLUT with preview</a></li>
+ <li><a name="toc-Hald-CLUT-video-stream" href="#Hald-CLUT-video-stream">28.39.1.1 Hald CLUT video stream</a></li>
+ <li><a name="toc-Hald-CLUT-with-preview" href="#Hald-CLUT-with-preview">28.39.1.2 Hald CLUT with preview</a></li>
</ul>
</li>
</ul></li>
- <li><a name="toc-hflip" href="#hflip">33.38 hflip</a></li>
- <li><a name="toc-histeq" href="#histeq">33.39 histeq</a></li>
- <li><a name="toc-histogram" href="#histogram">33.40 histogram</a>
+ <li><a name="toc-hflip" href="#hflip">28.40 hflip</a></li>
+ <li><a name="toc-histeq" href="#histeq">28.41 histeq</a></li>
+ <li><a name="toc-histogram" href="#histogram">28.42 histogram</a>
<ul class="toc">
- <li><a name="toc-Examples-16" href="#Examples-16">33.40.1 Examples</a></li>
+ <li><a name="toc-Examples-74" href="#Examples-74">28.42.1 Examples</a></li>
</ul></li>
- <li><a name="toc-hqdn3d-1" href="#hqdn3d-1">33.41 hqdn3d</a></li>
- <li><a name="toc-hue" href="#hue">33.42 hue</a>
+ <li><a name="toc-hqdn3d-1" href="#hqdn3d-1">28.43 hqdn3d</a></li>
+ <li><a name="toc-hue" href="#hue">28.44 hue</a>
<ul class="toc">
- <li><a name="toc-Examples-51" href="#Examples-51">33.42.1 Examples</a></li>
- <li><a name="toc-Commands" href="#Commands">33.42.2 Commands</a></li>
+ <li><a name="toc-Examples-39" href="#Examples-39">28.44.1 Examples</a></li>
+ <li><a name="toc-Commands" href="#Commands">28.44.2 Commands</a></li>
</ul></li>
- <li><a name="toc-idet" href="#idet">33.43 idet</a></li>
- <li><a name="toc-il" href="#il">33.44 il</a></li>
- <li><a name="toc-interlace" href="#interlace">33.45 interlace</a></li>
- <li><a name="toc-kerndeint" href="#kerndeint">33.46 kerndeint</a>
+ <li><a name="toc-idet" href="#idet">28.45 idet</a></li>
+ <li><a name="toc-il" href="#il">28.46 il</a></li>
+ <li><a name="toc-interlace" href="#interlace">28.47 interlace</a></li>
+ <li><a name="toc-kerndeint" href="#kerndeint">28.48 kerndeint</a>
<ul class="toc">
- <li><a name="toc-Examples-50" href="#Examples-50">33.46.1 Examples</a></li>
+ <li><a name="toc-Examples-45" href="#Examples-45">28.48.1 Examples</a></li>
</ul></li>
- <li><a name="toc-lut3d-1" href="#lut3d-1">33.47 lut3d</a></li>
- <li><a name="toc-lut_002c-lutrgb_002c-lutyuv" href="#lut_002c-lutrgb_002c-lutyuv">33.48 lut, lutrgb, lutyuv</a>
+ <li><a name="toc-lut3d-1" href="#lut3d-1">28.49 lut3d</a></li>
+ <li><a name="toc-lut_002c-lutrgb_002c-lutyuv" href="#lut_002c-lutrgb_002c-lutyuv">28.50 lut, lutrgb, lutyuv</a>
<ul class="toc">
- <li><a name="toc-Examples-14" href="#Examples-14">33.48.1 Examples</a></li>
+ <li><a name="toc-Examples-5" href="#Examples-5">28.50.1 Examples</a></li>
</ul></li>
- <li><a name="toc-mergeplanes" href="#mergeplanes">33.49 mergeplanes</a>
+ <li><a name="toc-mergeplanes" href="#mergeplanes">28.51 mergeplanes</a>
<ul class="toc">
- <li><a name="toc-Examples-67" href="#Examples-67">33.49.1 Examples</a></li>
+ <li><a name="toc-Examples-3" href="#Examples-3">28.51.1 Examples</a></li>
</ul></li>
- <li><a name="toc-mcdeint" href="#mcdeint">33.50 mcdeint</a></li>
- <li><a name="toc-mp" href="#mp">33.51 mp</a>
+ <li><a name="toc-mcdeint" href="#mcdeint">28.52 mcdeint</a></li>
+ <li><a name="toc-mp" href="#mp">28.53 mp</a>
<ul class="toc">
- <li><a name="toc-Examples-7" href="#Examples-7">33.51.1 Examples</a></li>
+ <li><a name="toc-Examples-10" href="#Examples-10">28.53.1 Examples</a></li>
</ul></li>
- <li><a name="toc-mpdecimate" href="#mpdecimate">33.52 mpdecimate</a></li>
- <li><a name="toc-negate" href="#negate">33.53 negate</a></li>
- <li><a name="toc-noformat" href="#noformat">33.54 noformat</a>
+ <li><a name="toc-mpdecimate" href="#mpdecimate">28.54 mpdecimate</a></li>
+ <li><a name="toc-negate" href="#negate">28.55 negate</a></li>
+ <li><a name="toc-noformat" href="#noformat">28.56 noformat</a>
<ul class="toc">
- <li><a name="toc-Examples-53" href="#Examples-53">33.54.1 Examples</a></li>
+ <li><a name="toc-Examples-65" href="#Examples-65">28.56.1 Examples</a></li>
</ul></li>
- <li><a name="toc-noise" href="#noise">33.55 noise</a>
+ <li><a name="toc-noise-1" href="#noise-1">28.57 noise</a>
<ul class="toc">
- <li><a name="toc-Examples-17" href="#Examples-17">33.55.1 Examples</a></li>
+ <li><a name="toc-Examples-58" href="#Examples-58">28.57.1 Examples</a></li>
</ul></li>
- <li><a name="toc-null" href="#null">33.56 null</a></li>
- <li><a name="toc-ocv" href="#ocv">33.57 ocv</a>
+ <li><a name="toc-null" href="#null">28.58 null</a></li>
+ <li><a name="toc-ocv" href="#ocv">28.59 ocv</a>
<ul class="toc">
- <li><a name="toc-dilate-1" href="#dilate-1">33.57.1 dilate</a></li>
- <li><a name="toc-erode" href="#erode">33.57.2 erode</a></li>
- <li><a name="toc-smooth" href="#smooth">33.57.3 smooth</a></li>
+ <li><a name="toc-dilate-1" href="#dilate-1">28.59.1 dilate</a></li>
+ <li><a name="toc-erode" href="#erode">28.59.2 erode</a></li>
+ <li><a name="toc-smooth" href="#smooth">28.59.3 smooth</a></li>
</ul></li>
- <li><a name="toc-overlay-1" href="#overlay-1">33.58 overlay</a>
+ <li><a name="toc-overlay-1" href="#overlay-1">28.60 overlay</a>
<ul class="toc">
- <li><a name="toc-Commands-2" href="#Commands-2">33.58.1 Commands</a></li>
- <li><a name="toc-Examples-73" href="#Examples-73">33.58.2 Examples</a></li>
+ <li><a name="toc-Commands-4" href="#Commands-4">28.60.1 Commands</a></li>
+ <li><a name="toc-Examples-15" href="#Examples-15">28.60.2 Examples</a></li>
</ul></li>
- <li><a name="toc-owdenoise" href="#owdenoise">33.59 owdenoise</a></li>
- <li><a name="toc-pad" href="#pad">33.60 pad</a>
+ <li><a name="toc-owdenoise" href="#owdenoise">28.61 owdenoise</a></li>
+ <li><a name="toc-pad" href="#pad">28.62 pad</a>
<ul class="toc">
- <li><a name="toc-Examples-63" href="#Examples-63">33.60.1 Examples</a></li>
+ <li><a name="toc-Examples-52" href="#Examples-52">28.62.1 Examples</a></li>
</ul></li>
- <li><a name="toc-perspective" href="#perspective">33.61 perspective</a></li>
- <li><a name="toc-phase" href="#phase">33.62 phase</a></li>
- <li><a name="toc-pixdesctest" href="#pixdesctest">33.63 pixdesctest</a></li>
- <li><a name="toc-pp" href="#pp">33.64 pp</a>
+ <li><a name="toc-perspective" href="#perspective">28.63 perspective</a></li>
+ <li><a name="toc-phase" href="#phase">28.64 phase</a></li>
+ <li><a name="toc-pixdesctest" href="#pixdesctest">28.65 pixdesctest</a></li>
+ <li><a name="toc-pp" href="#pp">28.66 pp</a>
<ul class="toc">
- <li><a name="toc-Examples-26" href="#Examples-26">33.64.1 Examples</a></li>
+ <li><a name="toc-Examples-11" href="#Examples-11">28.66.1 Examples</a></li>
</ul></li>
- <li><a name="toc-psnr" href="#psnr">33.65 psnr</a></li>
- <li><a name="toc-pullup" href="#pullup">33.66 pullup</a></li>
- <li><a name="toc-removelogo" href="#removelogo">33.67 removelogo</a></li>
- <li><a name="toc-rotate" href="#rotate">33.68 rotate</a>
+ <li><a name="toc-psnr" href="#psnr">28.67 psnr</a></li>
+ <li><a name="toc-pullup-1" href="#pullup-1">28.68 pullup</a></li>
+ <li><a name="toc-removelogo" href="#removelogo">28.69 removelogo</a></li>
+ <li><a name="toc-rotate" href="#rotate">28.70 rotate</a>
<ul class="toc">
- <li><a name="toc-Examples-61" href="#Examples-61">33.68.1 Examples</a></li>
- <li><a name="toc-Commands-1" href="#Commands-1">33.68.2 Commands</a></li>
+ <li><a name="toc-Examples-79" href="#Examples-79">28.70.1 Examples</a></li>
+ <li><a name="toc-Commands-5" href="#Commands-5">28.70.2 Commands</a></li>
</ul></li>
- <li><a name="toc-sab" href="#sab">33.69 sab</a></li>
- <li><a name="toc-scale-1" href="#scale-1">33.70 scale</a>
+ <li><a name="toc-sab" href="#sab">28.71 sab</a></li>
+ <li><a name="toc-scale-1" href="#scale-1">28.72 scale</a>
<ul class="toc">
- <li><a name="toc-Options-21" href="#Options-21">33.70.1 Options</a></li>
- <li><a name="toc-Examples-1" href="#Examples-1">33.70.2 Examples</a></li>
+ <li><a name="toc-Options-6" href="#Options-6">28.72.1 Options</a></li>
+ <li><a name="toc-Examples-47" href="#Examples-47">28.72.2 Examples</a></li>
</ul></li>
- <li><a name="toc-separatefields" href="#separatefields">33.71 separatefields</a></li>
- <li><a name="toc-setdar_002c-setsar" href="#setdar_002c-setsar">33.72 setdar, setsar</a>
+ <li><a name="toc-separatefields" href="#separatefields">28.73 separatefields</a></li>
+ <li><a name="toc-setdar_002c-setsar" href="#setdar_002c-setsar">28.74 setdar, setsar</a>
<ul class="toc">
- <li><a name="toc-Examples-91" href="#Examples-91">33.72.1 Examples</a></li>
+ <li><a name="toc-Examples-76" href="#Examples-76">28.74.1 Examples</a></li>
</ul></li>
- <li><a name="toc-setfield-1" href="#setfield-1">33.73 setfield</a></li>
- <li><a name="toc-showinfo" href="#showinfo">33.74 showinfo</a></li>
- <li><a name="toc-smartblur-1" href="#smartblur-1">33.75 smartblur</a></li>
- <li><a name="toc-stereo3d" href="#stereo3d">33.76 stereo3d</a>
+ <li><a name="toc-setfield-1" href="#setfield-1">28.75 setfield</a></li>
+ <li><a name="toc-showinfo" href="#showinfo">28.76 showinfo</a></li>
+ <li><a name="toc-smartblur-1" href="#smartblur-1">28.77 smartblur</a></li>
+ <li><a name="toc-stereo3d" href="#stereo3d">28.78 stereo3d</a>
<ul class="toc">
- <li><a name="toc-Examples-77" href="#Examples-77">33.76.1 Examples</a></li>
+ <li><a name="toc-Examples-2" href="#Examples-2">28.78.1 Examples</a></li>
</ul></li>
- <li><a name="toc-spp" href="#spp">33.77 spp</a></li>
- <li><a name="toc-subtitles-1" href="#subtitles-1">33.78 subtitles</a></li>
- <li><a name="toc-super2xsai" href="#super2xsai">33.79 super2xsai</a></li>
- <li><a name="toc-swapuv" href="#swapuv">33.80 swapuv</a></li>
- <li><a name="toc-telecine" href="#telecine">33.81 telecine</a></li>
- <li><a name="toc-thumbnail" href="#thumbnail">33.82 thumbnail</a>
+ <li><a name="toc-spp" href="#spp">28.79 spp</a></li>
+ <li><a name="toc-subtitles-1" href="#subtitles-1">28.80 subtitles</a></li>
+ <li><a name="toc-super2xsai" href="#super2xsai">28.81 super2xsai</a></li>
+ <li><a name="toc-swapuv" href="#swapuv">28.82 swapuv</a></li>
+ <li><a name="toc-telecine" href="#telecine">28.83 telecine</a></li>
+ <li><a name="toc-thumbnail" href="#thumbnail">28.84 thumbnail</a>
<ul class="toc">
- <li><a name="toc-Examples-30" href="#Examples-30">33.82.1 Examples</a></li>
+ <li><a name="toc-Examples-9" href="#Examples-9">28.84.1 Examples</a></li>
</ul></li>
- <li><a name="toc-tile" href="#tile">33.83 tile</a>
+ <li><a name="toc-tile" href="#tile">28.85 tile</a>
<ul class="toc">
- <li><a name="toc-Examples-11" href="#Examples-11">33.83.1 Examples</a></li>
+ <li><a name="toc-Examples-70" href="#Examples-70">28.85.1 Examples</a></li>
</ul></li>
- <li><a name="toc-tinterlace" href="#tinterlace">33.84 tinterlace</a></li>
- <li><a name="toc-transpose" href="#transpose">33.85 transpose</a></li>
- <li><a name="toc-trim" href="#trim">33.86 trim</a></li>
- <li><a name="toc-unsharp" href="#unsharp">33.87 unsharp</a>
+ <li><a name="toc-tinterlace" href="#tinterlace">28.86 tinterlace</a></li>
+ <li><a name="toc-transpose" href="#transpose">28.87 transpose</a></li>
+ <li><a name="toc-trim" href="#trim">28.88 trim</a></li>
+ <li><a name="toc-unsharp" href="#unsharp">28.89 unsharp</a>
<ul class="toc">
- <li><a name="toc-Examples-6" href="#Examples-6">33.87.1 Examples</a></li>
+ <li><a name="toc-Examples-81" href="#Examples-81">28.89.1 Examples</a></li>
</ul></li>
- <li><a name="toc-vidstabdetect-1" href="#vidstabdetect-1">33.88 vidstabdetect</a>
+ <li><a name="toc-vidstabdetect-1" href="#vidstabdetect-1">28.90 vidstabdetect</a>
<ul class="toc">
- <li><a name="toc-Examples-5" href="#Examples-5">33.88.1 Examples</a></li>
+ <li><a name="toc-Examples-29" href="#Examples-29">28.90.1 Examples</a></li>
</ul></li>
- <li><a name="toc-vidstabtransform-1" href="#vidstabtransform-1">33.89 vidstabtransform</a>
+ <li><a name="toc-vidstabtransform-1" href="#vidstabtransform-1">28.91 vidstabtransform</a>
<ul class="toc">
- <li><a name="toc-Examples-10" href="#Examples-10">33.89.1 Examples</a></li>
+ <li><a name="toc-Options-5" href="#Options-5">28.91.1 Options</a></li>
+ <li><a name="toc-Examples-25" href="#Examples-25">28.91.2 Examples</a></li>
</ul></li>
- <li><a name="toc-vflip" href="#vflip">33.90 vflip</a></li>
- <li><a name="toc-vignette" href="#vignette">33.91 vignette</a>
+ <li><a name="toc-vflip" href="#vflip">28.92 vflip</a></li>
+ <li><a name="toc-vignette" href="#vignette">28.93 vignette</a>
<ul class="toc">
- <li><a name="toc-Expressions" href="#Expressions">33.91.1 Expressions</a></li>
- <li><a name="toc-Examples-45" href="#Examples-45">33.91.2 Examples</a></li>
+ <li><a name="toc-Expressions" href="#Expressions">28.93.1 Expressions</a></li>
+ <li><a name="toc-Examples-49" href="#Examples-49">28.93.2 Examples</a></li>
</ul></li>
- <li><a name="toc-w3fdif" href="#w3fdif">33.92 w3fdif</a></li>
- <li><a name="toc-yadif-1" href="#yadif-1">33.93 yadif</a></li>
+ <li><a name="toc-w3fdif" href="#w3fdif">28.94 w3fdif</a></li>
+ <li><a name="toc-yadif-1" href="#yadif-1">28.95 yadif</a></li>
</ul></li>
- <li><a name="toc-Video-Sources" href="#Video-Sources">34. Video Sources</a>
+ <li><a name="toc-Video-Sources" href="#Video-Sources">29. Video Sources</a>
<ul class="toc">
- <li><a name="toc-buffer" href="#buffer">34.1 buffer</a></li>
- <li><a name="toc-cellauto" href="#cellauto">34.2 cellauto</a>
+ <li><a name="toc-buffer" href="#buffer">29.1 buffer</a></li>
+ <li><a name="toc-cellauto" href="#cellauto">29.2 cellauto</a>
<ul class="toc">
- <li><a name="toc-Examples-38" href="#Examples-38">34.2.1 Examples</a></li>
+ <li><a name="toc-Examples-16" href="#Examples-16">29.2.1 Examples</a></li>
</ul></li>
- <li><a name="toc-mandelbrot" href="#mandelbrot">34.3 mandelbrot</a></li>
- <li><a name="toc-mptestsrc" href="#mptestsrc">34.4 mptestsrc</a></li>
- <li><a name="toc-frei0r_005fsrc" href="#frei0r_005fsrc">34.5 frei0r_src</a></li>
- <li><a name="toc-life" href="#life">34.6 life</a>
+ <li><a name="toc-mandelbrot" href="#mandelbrot">29.3 mandelbrot</a></li>
+ <li><a name="toc-mptestsrc" href="#mptestsrc">29.4 mptestsrc</a></li>
+ <li><a name="toc-frei0r_005fsrc" href="#frei0r_005fsrc">29.5 frei0r_src</a></li>
+ <li><a name="toc-life" href="#life">29.6 life</a>
<ul class="toc">
- <li><a name="toc-Examples-21" href="#Examples-21">34.6.1 Examples</a></li>
+ <li><a name="toc-Examples-73" href="#Examples-73">29.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">34.7 color, haldclutsrc, nullsrc, rgbtestsrc, smptebars, smptehdbars, testsrc</a>
+ <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">29.7 color, haldclutsrc, nullsrc, rgbtestsrc, smptebars, smptehdbars, testsrc</a>
<ul class="toc">
- <li><a name="toc-Commands-4" href="#Commands-4">34.7.1 Commands</a></li>
+ <li><a name="toc-Commands-2" href="#Commands-2">29.7.1 Commands</a></li>
</ul>
</li>
</ul></li>
- <li><a name="toc-Video-Sinks" href="#Video-Sinks">35. Video Sinks</a>
+ <li><a name="toc-Video-Sinks" href="#Video-Sinks">30. Video Sinks</a>
<ul class="toc">
- <li><a name="toc-buffersink" href="#buffersink">35.1 buffersink</a></li>
- <li><a name="toc-nullsink" href="#nullsink">35.2 nullsink</a></li>
+ <li><a name="toc-buffersink" href="#buffersink">30.1 buffersink</a></li>
+ <li><a name="toc-nullsink" href="#nullsink">30.2 nullsink</a></li>
</ul></li>
- <li><a name="toc-Multimedia-Filters" href="#Multimedia-Filters">36. Multimedia Filters</a>
+ <li><a name="toc-Multimedia-Filters" href="#Multimedia-Filters">31. Multimedia Filters</a>
<ul class="toc">
- <li><a name="toc-avectorscope" href="#avectorscope">36.1 avectorscope</a>
+ <li><a name="toc-avectorscope" href="#avectorscope">31.1 avectorscope</a>
<ul class="toc">
- <li><a name="toc-Examples" href="#Examples">36.1.1 Examples</a></li>
+ <li><a name="toc-Examples-48" href="#Examples-48">31.1.1 Examples</a></li>
</ul></li>
- <li><a name="toc-concat-2" href="#concat-2">36.2 concat</a>
+ <li><a name="toc-concat-2" href="#concat-2">31.2 concat</a>
<ul class="toc">
- <li><a name="toc-Examples-40" href="#Examples-40">36.2.1 Examples</a></li>
+ <li><a name="toc-Examples-24" href="#Examples-24">31.2.1 Examples</a></li>
</ul></li>
- <li><a name="toc-ebur128" href="#ebur128">36.3 ebur128</a>
+ <li><a name="toc-ebur128" href="#ebur128">31.3 ebur128</a>
<ul class="toc">
- <li><a name="toc-Examples-18" href="#Examples-18">36.3.1 Examples</a></li>
+ <li><a name="toc-Examples-13" href="#Examples-13">31.3.1 Examples</a></li>
</ul></li>
- <li><a name="toc-interleave_002c-ainterleave" href="#interleave_002c-ainterleave">36.4 interleave, ainterleave</a>
+ <li><a name="toc-interleave_002c-ainterleave" href="#interleave_002c-ainterleave">31.4 interleave, ainterleave</a>
<ul class="toc">
- <li><a name="toc-Examples-35" href="#Examples-35">36.4.1 Examples</a></li>
+ <li><a name="toc-Examples-7" href="#Examples-7">31.4.1 Examples</a></li>
</ul></li>
- <li><a name="toc-perms_002c-aperms" href="#perms_002c-aperms">36.5 perms, aperms</a></li>
- <li><a name="toc-select_002c-aselect" href="#select_002c-aselect">36.6 select, aselect</a>
+ <li><a name="toc-perms_002c-aperms" href="#perms_002c-aperms">31.5 perms, aperms</a></li>
+ <li><a name="toc-select_002c-aselect" href="#select_002c-aselect">31.6 select, aselect</a>
<ul class="toc">
- <li><a name="toc-Examples-76" href="#Examples-76">36.6.1 Examples</a></li>
+ <li><a name="toc-Examples-20" href="#Examples-20">31.6.1 Examples</a></li>
</ul></li>
- <li><a name="toc-sendcmd_002c-asendcmd" href="#sendcmd_002c-asendcmd">36.7 sendcmd, asendcmd</a>
+ <li><a name="toc-sendcmd_002c-asendcmd" href="#sendcmd_002c-asendcmd">31.7 sendcmd, asendcmd</a>
<ul class="toc">
- <li><a name="toc-Commands-syntax" href="#Commands-syntax">36.7.1 Commands syntax</a></li>
- <li><a name="toc-Examples-39" href="#Examples-39">36.7.2 Examples</a></li>
+ <li><a name="toc-Commands-syntax" href="#Commands-syntax">31.7.1 Commands syntax</a></li>
+ <li><a name="toc-Examples-36" href="#Examples-36">31.7.2 Examples</a></li>
</ul></li>
- <li><a name="toc-setpts_002c-asetpts" href="#setpts_002c-asetpts">36.8 setpts, asetpts</a>
+ <li><a name="toc-setpts_002c-asetpts" href="#setpts_002c-asetpts">31.8 setpts, asetpts</a>
<ul class="toc">
- <li><a name="toc-Examples-42" href="#Examples-42">36.8.1 Examples</a></li>
+ <li><a name="toc-Examples-59" href="#Examples-59">31.8.1 Examples</a></li>
</ul></li>
- <li><a name="toc-settb_002c-asettb" href="#settb_002c-asettb">36.9 settb, asettb</a>
+ <li><a name="toc-settb_002c-asettb" href="#settb_002c-asettb">31.9 settb, asettb</a>
<ul class="toc">
- <li><a name="toc-Examples-68" href="#Examples-68">36.9.1 Examples</a></li>
+ <li><a name="toc-Examples-8" href="#Examples-8">31.9.1 Examples</a></li>
</ul></li>
- <li><a name="toc-showspectrum" href="#showspectrum">36.10 showspectrum</a>
+ <li><a name="toc-showspectrum" href="#showspectrum">31.10 showspectrum</a>
<ul class="toc">
- <li><a name="toc-Examples-2" href="#Examples-2">36.10.1 Examples</a></li>
+ <li><a name="toc-Examples-67" href="#Examples-67">31.10.1 Examples</a></li>
</ul></li>
- <li><a name="toc-showwaves" href="#showwaves">36.11 showwaves</a>
+ <li><a name="toc-showwaves" href="#showwaves">31.11 showwaves</a>
<ul class="toc">
- <li><a name="toc-Examples-90" href="#Examples-90">36.11.1 Examples</a></li>
+ <li><a name="toc-Examples-83" href="#Examples-83">31.11.1 Examples</a></li>
</ul></li>
- <li><a name="toc-split_002c-asplit" href="#split_002c-asplit">36.12 split, asplit</a>
+ <li><a name="toc-split_002c-asplit" href="#split_002c-asplit">31.12 split, asplit</a>
<ul class="toc">
- <li><a name="toc-Examples-83" href="#Examples-83">36.12.1 Examples</a></li>
+ <li><a name="toc-Examples-46" href="#Examples-46">31.12.1 Examples</a></li>
</ul></li>
- <li><a name="toc-zmq_002c-azmq" href="#zmq_002c-azmq">36.13 zmq, azmq</a>
+ <li><a name="toc-zmq_002c-azmq" href="#zmq_002c-azmq">31.13 zmq, azmq</a>
<ul class="toc">
- <li><a name="toc-Examples-29" href="#Examples-29">36.13.1 Examples</a></li>
+ <li><a name="toc-Examples-31" href="#Examples-31">31.13.1 Examples</a></li>
</ul>
</li>
</ul></li>
- <li><a name="toc-Multimedia-Sources" href="#Multimedia-Sources">37. Multimedia Sources</a>
+ <li><a name="toc-Multimedia-Sources" href="#Multimedia-Sources">32. Multimedia Sources</a>
<ul class="toc">
- <li><a name="toc-amovie" href="#amovie">37.1 amovie</a></li>
- <li><a name="toc-movie-1" href="#movie-1">37.2 movie</a>
+ <li><a name="toc-amovie" href="#amovie">32.1 amovie</a></li>
+ <li><a name="toc-movie-1" href="#movie-1">32.2 movie</a>
<ul class="toc">
- <li><a name="toc-Examples-69" href="#Examples-69">37.2.1 Examples</a></li>
+ <li><a name="toc-Examples-61" href="#Examples-61">32.2.1 Examples</a></li>
</ul>
</li>
</ul></li>
- <li><a name="toc-See-Also" href="#See-Also">38. See Also</a></li>
- <li><a name="toc-Authors" href="#Authors">39. Authors</a></li>
+ <li><a name="toc-See-Also" href="#See-Also">33. See Also</a></li>
+ <li><a name="toc-Authors" href="#Authors">34. Authors</a></li>
</ul>
</div>
libraries and the SDL library. It is mostly used as a testbed for the
various FFmpeg APIs.
</p>
-<a name="Options-25"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-Options-25">3. Options</a></h1>
+<a name="Options-4"></a>
+<h1 class="chapter"><a href="ffplay-all.html#toc-Options-4">3. Options</a></h1>
<p>All the numerical options, if not specified otherwise, accept a string
representing a number as input, which may be followed by one of the SI
appear in the report.
</p>
</dd>
+<dt> ‘<samp>-hide_banner</samp>’</dt>
+<dd><p>Suppress printing banner.
+</p>
+<p>All FFmpeg tools will normally show a copyright notice, build options
+and library versions. This option can be used to suppress printing
+this information.
+</p>
+</dd>
<dt> ‘<samp>-cpuflags flags (<em>global</em>)</samp>’</dt>
<dd><p>Allows setting and clearing cpu flags. This option is intended
for testing. Do not use it unless you know what you’re doing.
<dd><p>Show audio waves.
</p>
</dd>
+<dt> <s></dt>
+<dd><p>Step to the next frame.
+</p>
+<p>Pause if the stream is not already paused, step to the next video
+frame, and pause.
+</p>
+</dd>
<dt> <left/right></dt>
<dd><p>Seek backward/forward 10 seconds.
</p>
</p>
</dd>
<dt> <page down/page up></dt>
-<dd><p>Seek backward/forward 10 minutes.
+<dd><p>Seek to the previous/next chapter.
+or if there are no chapters
+Seek backward/forward 10 minutes.
</p>
</dd>
<dt> <mouse click></dt>
</dl>
-<a name="Syntax-2"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-Syntax-2">4. Syntax</a></h1>
+<a name="Syntax"></a>
+<h1 class="chapter"><a href="ffplay-all.html#toc-Syntax">4. Syntax</a></h1>
<p>This section documents the syntax and formats employed by the FFmpeg
libraries and tools.
<p>The tool ‘<tt>tools/ffescape</tt>’ in the FFmpeg source tree can be used
to automatically quote or escape a string in a script.
</p>
-<a name="Examples-13"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-13">4.1.1 Examples</a></h3>
+<a name="Examples-4"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-4">4.1.1 Examples</a></h3>
<ul>
<li>
</p>
<p>In both expressions, the optional ‘<samp>-</samp>’ indicates negative duration.
</p>
-<a name="Examples-31"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-31">4.3.1 Examples</a></h3>
+<a name="Examples-66"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-66">4.3.1 Examples</a></h3>
<p>The following examples are all valid time duration:
</p>
<dt> ‘<samp>device_idx</samp>’</dt>
<dd><p>Select the index of the device used to run OpenCL code.
</p>
-<p>The specifed index must be one of the indexes in the device list which
+<p>The specified index must be one of the indexes in the device list which
can be obtained with <code>ffmpeg -opencl_bench</code> or <code>av_opencl_get_device_list()</code>.
</p>
</dd>
</dd>
<dt> ‘<samp>skip_exp <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
<dd><p>Set frame skip exponent.
+Negative values behave identical to the corresponding positive ones, except
+that the score is normalized.
+Positive values exist primarly for compatibility reasons and are not so useful.
</p>
</dd>
<dt> ‘<samp>skipcmp <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
with the options <code>--enable-decoder=<var>DECODER</var></code> /
<code>--disable-decoder=<var>DECODER</var></code>.
</p>
-<p>The option <code>-codecs</code> of the ff* tools will display the list of
+<p>The option <code>-decoders</code> of the ff* tools will display the list of
enabled decoders.
</p>
</p>
<p>This decoder decodes rawvideo streams.
</p>
-<a name="Options-9"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-9">9.1.1 Options</a></h3>
+<a name="Options-7"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Options-7">9.1.1 Options</a></h3>
<dl compact="compact">
<dt> ‘<samp>top <var>top_field_first</var></samp>’</dt>
<a name="Audio-Decoders"></a>
<h1 class="chapter"><a href="ffplay-all.html#toc-Audio-Decoders">10. Audio Decoders</a></h1>
+<p>A description of some of the currently available audio decoders
+follows.
+</p>
+<a name="ac3"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-ac3">10.1 ac3</a></h2>
+
+<p>AC-3 audio decoder.
+</p>
+<p>This decoder implements part of ATSC A/52:2010 and ETSI TS 102 366, as well as
+the undocumented RealAudio 3 (a.k.a. dnet).
+</p>
+<a name="AC_002d3-Decoder-Options"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-AC_002d3-Decoder-Options">10.1.1 AC-3 Decoder Options</a></h3>
+
+<dl compact="compact">
+<dt> ‘<samp>-drc_scale <var>value</var></samp>’</dt>
+<dd><p>Dynamic Range Scale Factor. The factor to apply to dynamic range values
+from the AC-3 stream. This factor is applied exponentially.
+There are 3 notable scale factor ranges:
+</p><dl compact="compact">
+<dt> ‘<samp>drc_scale == 0</samp>’</dt>
+<dd><p>DRC disabled. Produces full range audio.
+</p></dd>
+<dt> ‘<samp>0 < drc_scale <= 1</samp>’</dt>
+<dd><p>DRC enabled. Applies a fraction of the stream DRC value.
+Audio reproduction is between full range and full compression.
+</p></dd>
+<dt> ‘<samp>drc_scale > 1</samp>’</dt>
+<dd><p>DRC enabled. Applies drc_scale asymmetrically.
+Loud sounds are fully compressed. Soft sounds are enhanced.
+</p></dd>
+</dl>
+
+</dd>
+</dl>
+
<a name="ffwavesynth"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-ffwavesynth">10.1 ffwavesynth</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-ffwavesynth">10.2 ffwavesynth</a></h2>
<p>Internal wave synthetizer.
</p>
documented.
</p>
<a name="libcelt"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-libcelt">10.2 libcelt</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-libcelt">10.3 libcelt</a></h2>
<p>libcelt decoder wrapper.
</p>
You need to explicitly configure the build with <code>--enable-libcelt</code>.
</p>
<a name="libgsm"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-libgsm">10.3 libgsm</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-libgsm">10.4 libgsm</a></h2>
<p>libgsm decoder wrapper.
</p>
<p>This decoder supports both the ordinary GSM and the Microsoft variant.
</p>
<a name="libilbc"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-libilbc">10.4 libilbc</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-libilbc">10.5 libilbc</a></h2>
<p>libilbc decoder wrapper.
</p>
configuration. You need to explicitly configure the build with
<code>--enable-libilbc</code>.
</p>
-<a name="Options"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options">10.4.1 Options</a></h3>
+<a name="Options-11"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Options-11">10.5.1 Options</a></h3>
<p>The following option is supported by the libilbc wrapper.
</p>
</dd>
</dl>
-<a name="libopencore_002damrnb-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-libopencore_002damrnb-1">10.5 libopencore-amrnb</a></h2>
+<a name="libopencore_002damrnb"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-libopencore_002damrnb">10.6 libopencore-amrnb</a></h2>
<p>libopencore-amrnb decoder wrapper.
</p>
without this library.
</p>
<a name="libopencore_002damrwb"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-libopencore_002damrwb">10.6 libopencore-amrwb</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-libopencore_002damrwb">10.7 libopencore-amrwb</a></h2>
<p>libopencore-amrwb decoder wrapper.
</p>
without this library.
</p>
<a name="libopus"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-libopus">10.7 libopus</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-libopus">10.8 libopus</a></h2>
<p>libopus decoder wrapper.
</p>
<p>This codec decodes the bitmap subtitles used in DVDs; the same subtitles can
also be found in VobSub file pairs and in some Matroska files.
</p>
-<a name="Options-24"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-24">11.1.1 Options</a></h3>
+<a name="Options-10"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Options-10">11.1.1 Options</a></h3>
<dl compact="compact">
<dt> ‘<samp>palette</samp>’</dt>
configuration. You need to explicitly configure the build with
<code>--enable-libzvbi</code>.
</p>
-<a name="Options-7"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-7">11.2.1 Options</a></h3>
+<a name="Options-3"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Options-3">11.2.1 Options</a></h3>
<dl compact="compact">
<dt> ‘<samp>txt_page</samp>’</dt>
</p></dd>
</dl>
-<a name="Encoders"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-Encoders">12. Encoders</a></h1>
+<a name="Bitstream-Filters"></a>
+<h1 class="chapter"><a href="ffplay-all.html#toc-Bitstream-Filters">12. Bitstream Filters</a></h1>
-<p>Encoders are configured elements in FFmpeg which allow the encoding of
-multimedia streams.
-</p>
-<p>When you configure your FFmpeg build, all the supported native encoders
-are enabled by default. Encoders requiring an external library must be enabled
-manually via the corresponding <code>--enable-lib</code> option. You can list all
-available encoders using the configure option <code>--list-encoders</code>.
+<p>When you configure your FFmpeg build, all the supported bitstream
+filters are enabled by default. You can list all available ones using
+the configure option <code>--list-bsfs</code>.
</p>
-<p>You can disable all the encoders with the configure option
-<code>--disable-encoders</code> and selectively enable / disable single encoders
-with the options <code>--enable-encoder=<var>ENCODER</var></code> /
-<code>--disable-encoder=<var>ENCODER</var></code>.
+<p>You can disable all the bitstream filters using the configure option
+<code>--disable-bsfs</code>, and selectively enable any bitstream filter using
+the option <code>--enable-bsf=BSF</code>, or you can disable a particular
+bitstream filter using the option <code>--disable-bsf=BSF</code>.
</p>
-<p>The option <code>-codecs</code> of the ff* tools will display the list of
-enabled encoders.
+<p>The option <code>-bsfs</code> of the ff* tools will display the list of
+all the supported bitstream filters included in your build.
</p>
-
-<a name="Audio-Encoders"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-Audio-Encoders">13. Audio Encoders</a></h1>
-
-<p>A description of some of the currently available audio encoders
-follows.
+<p>Below is a description of the currently available bitstream filters.
</p>
-<p><a name="aacenc"></a>
-</p><a name="aac"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-aac">13.1 aac</a></h2>
+<a name="aac_005fadtstoasc"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-aac_005fadtstoasc">12.1 aac_adtstoasc</a></h2>
-<p>Advanced Audio Coding (AAC) encoder.
-</p>
-<p>This encoder is an experimental FFmpeg-native AAC encoder. Currently only the
-low complexity (AAC-LC) profile is supported. To use this encoder, you must set
-‘<samp>strict</samp>’ option to ‘<samp>experimental</samp>’ or lower.
+<p>Convert MPEG-2/4 AAC ADTS to MPEG-4 Audio Specific Configuration
+bitstream filter.
</p>
-<p>As this encoder is experimental, unexpected behavior may exist from time to
-time. For a more stable AAC encoder, see <a href="#libvo_002daacenc">libvo-aacenc</a>. However, be warned
-that it has a worse quality reported by some users.
+<p>This filter creates an MPEG-4 AudioSpecificConfig from an MPEG-2/4
+ADTS header and removes the ADTS header.
</p>
-<p>See also <a href="#libfdk_002daac_002denc">libfdk_aac</a> and <a href="#libfaac">libfaac</a>.
+<p>This is required for example when copying an AAC stream from a raw
+ADTS AAC container to a FLV or a MOV/MP4 file.
</p>
-<a name="Options-27"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-27">13.1.1 Options</a></h3>
+<a name="chomp"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-chomp">12.2 chomp</a></h2>
-<dl compact="compact">
-<dt> ‘<samp>b</samp>’</dt>
-<dd><p>Set bit rate in bits/s. Setting this automatically activates constant bit rate
-(CBR) mode.
-</p>
-</dd>
-<dt> ‘<samp>q</samp>’</dt>
-<dd><p>Set quality for variable bit rate (VBR) mode. This option is valid only using
-the <code>ffmpeg</code> command-line tool. For library interface users, use
-‘<samp>global_quality</samp>’.
+<p>Remove zero padding at the end of a packet.
</p>
-</dd>
-<dt> ‘<samp>stereo_mode</samp>’</dt>
-<dd><p>Set stereo encoding mode. Possible values:
+<a name="dump_005fextra"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-dump_005fextra">12.3 dump_extra</a></h2>
+
+<p>Add extradata to the beginning of the filtered packets.
</p>
-<dl compact="compact">
-<dt> ‘<samp>auto</samp>’</dt>
-<dd><p>Automatically selected by the encoder.
+<p>The additional argument specifies which packets should be filtered.
+It accepts the values:
+</p><dl compact="compact">
+<dt> ‘<samp>a</samp>’</dt>
+<dd><p>add extradata to all key packets, but only if <var>local_header</var> is
+set in the ‘<samp>flags2</samp>’ codec context field
</p>
</dd>
-<dt> ‘<samp>ms_off</samp>’</dt>
-<dd><p>Disable middle/side encoding. This is the default.
+<dt> ‘<samp>k</samp>’</dt>
+<dd><p>add extradata to all key packets
</p>
</dd>
-<dt> ‘<samp>ms_force</samp>’</dt>
-<dd><p>Force middle/side encoding.
+<dt> ‘<samp>e</samp>’</dt>
+<dd><p>add extradata to all packets
</p></dd>
</dl>
-</dd>
-<dt> ‘<samp>aac_coder</samp>’</dt>
-<dd><p>Set AAC encoder coding method. Possible values:
-</p>
-<dl compact="compact">
-<dt> ‘<samp>faac</samp>’</dt>
-<dd><p>FAAC-inspired method.
-</p>
-<p>This method is a simplified reimplementation of the method used in FAAC, which
-sets thresholds proportional to the band energies, and then decreases all the
-thresholds with quantizer steps to find the appropriate quantization with
-distortion below threshold band by band.
+<p>If not specified it is assumed ‘<samp>k</samp>’.
</p>
-<p>The quality of this method is comparable to the two loop searching method
-descibed below, but somewhat a little better and slower.
+<p>For example the following <code>ffmpeg</code> command forces a global
+header (thus disabling individual packet headers) in the H.264 packets
+generated by the <code>libx264</code> encoder, but corrects them by adding
+the header stored in extradata to the key packets:
+</p><table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT -map 0 -flags:v +global_header -c:v libx264 -bsf:v dump_extra out.ts
+</pre></td></tr></table>
+
+<a name="h264_005fmp4toannexb"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-h264_005fmp4toannexb">12.4 h264_mp4toannexb</a></h2>
+
+<p>Convert an H.264 bitstream from length prefixed mode to start code
+prefixed mode (as defined in the Annex B of the ITU-T H.264
+specification).
</p>
-</dd>
-<dt> ‘<samp>anmr</samp>’</dt>
-<dd><p>Average noise to mask ratio (ANMR) trellis-based solution.
+<p>This is required by some streaming formats, typically the MPEG-2
+transport stream format ("mpegts").
</p>
-<p>This has a theoretic best quality out of all the coding methods, but at the
-cost of the slowest speed.
+<p>For example to remux an MP4 file containing an H.264 stream to mpegts
+format with <code>ffmpeg</code>, you can use the command:
</p>
-</dd>
-<dt> ‘<samp>twoloop</samp>’</dt>
-<dd><p>Two loop searching (TLS) method.
+<table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT.mp4 -codec copy -bsf:v h264_mp4toannexb OUTPUT.ts
+</pre></td></tr></table>
+
+<a name="imx_005fdump_005fheader"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-imx_005fdump_005fheader">12.5 imx_dump_header</a></h2>
+
+<a name="mjpeg2jpeg"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-mjpeg2jpeg">12.6 mjpeg2jpeg</a></h2>
+
+<p>Convert MJPEG/AVI1 packets to full JPEG/JFIF packets.
</p>
-<p>This method first sets quantizers depending on band thresholds and then tries
-to find an optimal combination by adding or subtracting a specific value from
-all quantizers and adjusting some individual quantizer a little.
+<p>MJPEG is a video codec wherein each video frame is essentially a
+JPEG image. The individual frames can be extracted without loss,
+e.g. by
</p>
-<p>This method produces similar quality with the FAAC method and is the default.
+<table><tr><td> </td><td><pre class="example">ffmpeg -i ../some_mjpeg.avi -c:v copy frames_%d.jpg
+</pre></td></tr></table>
+
+<p>Unfortunately, these chunks are incomplete JPEG images, because
+they lack the DHT segment required for decoding. Quoting from
+<a href="http://www.digitalpreservation.gov/formats/fdd/fdd000063.shtml">http://www.digitalpreservation.gov/formats/fdd/fdd000063.shtml</a>:
</p>
-</dd>
-<dt> ‘<samp>fast</samp>’</dt>
-<dd><p>Constant quantizer method.
+<p>Avery Lee, writing in the rec.video.desktop newsgroup in 2001,
+commented that "MJPEG, or at least the MJPEG in AVIs having the
+MJPG fourcc, is restricted JPEG with a fixed – and *omitted* –
+Huffman table. The JPEG must be YCbCr colorspace, it must be 4:2:2,
+and it must use basic Huffman encoding, not arithmetic or
+progressive. . . . You can indeed extract the MJPEG frames and
+decode them with a regular JPEG decoder, but you have to prepend
+the DHT segment to them, or else the decoder won’t have any idea
+how to decompress the data. The exact table necessary is given in
+the OpenDML spec."
</p>
-<p>This method sets a constant quantizer for all bands. This is the fastest of all
-the methods, yet produces the worst quality.
+<p>This bitstream filter patches the header of frames extracted from an MJPEG
+stream (carrying the AVI1 header ID and lacking a DHT segment) to
+produce fully qualified JPEG images.
</p>
-</dd>
-</dl>
-
-</dd>
-</dl>
+<table><tr><td> </td><td><pre class="example">ffmpeg -i mjpeg-movie.avi -c:v copy -bsf:v mjpeg2jpeg frame_%d.jpg
+exiftran -i -9 frame*.jpg
+ffmpeg -i frame_%d.jpg -c:v copy rotated.avi
+</pre></td></tr></table>
-<a name="ac3-and-ac3_005ffixed"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-ac3-and-ac3_005ffixed">13.2 ac3 and ac3_fixed</a></h2>
+<a name="mjpega_005fdump_005fheader"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-mjpega_005fdump_005fheader">12.7 mjpega_dump_header</a></h2>
-<p>AC-3 audio encoders.
-</p>
-<p>These encoders implement part of ATSC A/52:2010 and ETSI TS 102 366, as well as
-the undocumented RealAudio 3 (a.k.a. dnet).
-</p>
-<p>The <var>ac3</var> encoder uses floating-point math, while the <var>ac3_fixed</var>
-encoder only uses fixed-point integer math. This does not mean that one is
-always faster, just that one or the other may be better suited to a
-particular system. The floating-point encoder will generally produce better
-quality audio for a given bitrate. The <var>ac3_fixed</var> encoder is not the
-default codec for any of the output formats, so it must be specified explicitly
-using the option <code>-acodec ac3_fixed</code> in order to use it.
-</p>
-<a name="AC_002d3-Metadata"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-AC_002d3-Metadata">13.2.1 AC-3 Metadata</a></h3>
-
-<p>The AC-3 metadata options are used to set parameters that describe the audio,
-but in most cases do not affect the audio encoding itself. Some of the options
-do directly affect or influence the decoding and playback of the resulting
-bitstream, while others are just for informational purposes. A few of the
-options will add bits to the output stream that could otherwise be used for
-audio data, and will thus affect the quality of the output. Those will be
-indicated accordingly with a note in the option list below.
-</p>
-<p>These parameters are described in detail in several publicly-available
-documents.
-</p><ul>
-<li> <a href="http://www.atsc.org/cms/standards/a_52-2010.pdf">A/52:2010 - Digital Audio Compression (AC-3) (E-AC-3) Standard</a>
-</li><li> <a href="http://www.atsc.org/cms/standards/a_54a_with_corr_1.pdf">A/54 - Guide to the Use of the ATSC Digital Television Standard</a>
-</li><li> <a href="http://www.dolby.com/uploadedFiles/zz-_Shared_Assets/English_PDFs/Professional/18_Metadata.Guide.pdf">Dolby Metadata Guide</a>
-</li><li> <a href="http://www.dolby.com/uploadedFiles/zz-_Shared_Assets/English_PDFs/Professional/46_DDEncodingGuidelines.pdf">Dolby Digital Professional Encoding Guidelines</a>
-</li></ul>
+<a name="movsub"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-movsub">12.8 movsub</a></h2>
-<a name="Metadata-Control-Options"></a>
-<h4 class="subsubsection"><a href="ffplay-all.html#toc-Metadata-Control-Options">13.2.1.1 Metadata Control Options</a></h4>
+<a name="mp3_005fheader_005fdecompress"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-mp3_005fheader_005fdecompress">12.9 mp3_header_decompress</a></h2>
-<dl compact="compact">
-<dt> ‘<samp>-per_frame_metadata <var>boolean</var></samp>’</dt>
-<dd><p>Allow Per-Frame Metadata. Specifies if the encoder should check for changing
-metadata for each frame.
-</p><dl compact="compact">
-<dt> ‘<samp>0</samp>’</dt>
-<dd><p>The metadata values set at initialization will be used for every frame in the
-stream. (default)
-</p></dd>
-<dt> ‘<samp>1</samp>’</dt>
-<dd><p>Metadata values can be changed before encoding each frame.
-</p></dd>
-</dl>
+<a name="noise"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-noise">12.10 noise</a></h2>
-</dd>
-</dl>
+<a name="remove_005fextra"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-remove_005fextra">12.11 remove_extra</a></h2>
-<a name="Downmix-Levels"></a>
-<h4 class="subsubsection"><a href="ffplay-all.html#toc-Downmix-Levels">13.2.1.2 Downmix Levels</a></h4>
+<a name="Format-Options"></a>
+<h1 class="chapter"><a href="ffplay-all.html#toc-Format-Options">13. Format Options</a></h1>
+<p>The libavformat library provides some generic global options, which
+can be set on all the muxers and demuxers. In addition each muxer or
+demuxer may support so-called private options, which are specific for
+that component.
+</p>
+<p>Options may be set by specifying -<var>option</var> <var>value</var> in the
+FFmpeg tools, or by setting the value explicitly in the
+<code>AVFormatContext</code> options or using the ‘<tt>libavutil/opt.h</tt>’ API
+for programmatic use.
+</p>
+<p>The list of supported options follows:
+</p>
<dl compact="compact">
-<dt> ‘<samp>-center_mixlev <var>level</var></samp>’</dt>
-<dd><p>Center Mix Level. The amount of gain the decoder should apply to the center
-channel when downmixing to stereo. This field will only be written to the
-bitstream if a center channel is present. The value is specified as a scale
-factor. There are 3 valid values:
+<dt> ‘<samp>avioflags <var>flags</var> (<em>input/output</em>)</samp>’</dt>
+<dd><p>Possible values:
</p><dl compact="compact">
-<dt> ‘<samp>0.707</samp>’</dt>
-<dd><p>Apply -3dB gain
-</p></dd>
-<dt> ‘<samp>0.595</samp>’</dt>
-<dd><p>Apply -4.5dB gain (default)
-</p></dd>
-<dt> ‘<samp>0.500</samp>’</dt>
-<dd><p>Apply -6dB gain
+<dt> ‘<samp>direct</samp>’</dt>
+<dd><p>Reduce buffering.
</p></dd>
</dl>
</dd>
-<dt> ‘<samp>-surround_mixlev <var>level</var></samp>’</dt>
-<dd><p>Surround Mix Level. The amount of gain the decoder should apply to the surround
-channel(s) when downmixing to stereo. This field will only be written to the
-bitstream if one or more surround channels are present. The value is specified
-as a scale factor. There are 3 valid values:
-</p><dl compact="compact">
-<dt> ‘<samp>0.707</samp>’</dt>
-<dd><p>Apply -3dB gain
-</p></dd>
-<dt> ‘<samp>0.500</samp>’</dt>
-<dd><p>Apply -6dB gain (default)
-</p></dd>
-<dt> ‘<samp>0.000</samp>’</dt>
-<dd><p>Silence Surround Channel(s)
-</p></dd>
-</dl>
-
-</dd>
-</dl>
-
-<a name="Audio-Production-Information"></a>
-<h4 class="subsubsection"><a href="ffplay-all.html#toc-Audio-Production-Information">13.2.1.3 Audio Production Information</a></h4>
-<p>Audio Production Information is optional information describing the mixing
-environment. Either none or both of the fields are written to the bitstream.
+<dt> ‘<samp>probesize <var>integer</var> (<em>input</em>)</samp>’</dt>
+<dd><p>Set probing size in bytes, i.e. the size of the data to analyze to get
+stream information. A higher value will allow to detect more
+information in case it is dispersed into the stream, but will increase
+latency. Must be an integer not lesser than 32. It is 5000000 by default.
</p>
-<dl compact="compact">
-<dt> ‘<samp>-mixing_level <var>number</var></samp>’</dt>
-<dd><p>Mixing Level. Specifies peak sound pressure level (SPL) in the production
-environment when the mix was mastered. Valid values are 80 to 111, or -1 for
-unknown or not indicated. The default value is -1, but that value cannot be
-used if the Audio Production Information is written to the bitstream. Therefore,
-if the <code>room_type</code> option is not the default value, the <code>mixing_level</code>
-option must not be -1.
-</p>
-</dd>
-<dt> ‘<samp>-room_type <var>type</var></samp>’</dt>
-<dd><p>Room Type. Describes the equalization used during the final mixing session at
-the studio or on the dubbing stage. A large room is a dubbing stage with the
-industry standard X-curve equalization; a small room has flat equalization.
-This field will not be written to the bitstream if both the <code>mixing_level</code>
-option and the <code>room_type</code> option have the default values.
-</p><dl compact="compact">
-<dt> ‘<samp>0</samp>’</dt>
-<dt> ‘<samp>notindicated</samp>’</dt>
-<dd><p>Not Indicated (default)
-</p></dd>
-<dt> ‘<samp>1</samp>’</dt>
-<dt> ‘<samp>large</samp>’</dt>
-<dd><p>Large Room
-</p></dd>
-<dt> ‘<samp>2</samp>’</dt>
-<dt> ‘<samp>small</samp>’</dt>
-<dd><p>Small Room
-</p></dd>
-</dl>
-
-</dd>
-</dl>
-
-<a name="Other-Metadata-Options"></a>
-<h4 class="subsubsection"><a href="ffplay-all.html#toc-Other-Metadata-Options">13.2.1.4 Other Metadata Options</a></h4>
-
-<dl compact="compact">
-<dt> ‘<samp>-copyright <var>boolean</var></samp>’</dt>
-<dd><p>Copyright Indicator. Specifies whether a copyright exists for this audio.
-</p><dl compact="compact">
-<dt> ‘<samp>0</samp>’</dt>
-<dt> ‘<samp>off</samp>’</dt>
-<dd><p>No Copyright Exists (default)
-</p></dd>
-<dt> ‘<samp>1</samp>’</dt>
-<dt> ‘<samp>on</samp>’</dt>
-<dd><p>Copyright Exists
-</p></dd>
-</dl>
-
</dd>
-<dt> ‘<samp>-dialnorm <var>value</var></samp>’</dt>
-<dd><p>Dialogue Normalization. Indicates how far the average dialogue level of the
-program is below digital 100% full scale (0 dBFS). This parameter determines a
-level shift during audio reproduction that sets the average volume of the
-dialogue to a preset level. The goal is to match volume level between program
-sources. A value of -31dB will result in no volume level change, relative to
-the source volume, during audio reproduction. Valid values are whole numbers in
-the range -31 to -1, with -31 being the default.
+<dt> ‘<samp>packetsize <var>integer</var> (<em>output</em>)</samp>’</dt>
+<dd><p>Set packet size.
</p>
</dd>
-<dt> ‘<samp>-dsur_mode <var>mode</var></samp>’</dt>
-<dd><p>Dolby Surround Mode. Specifies whether the stereo signal uses Dolby Surround
-(Pro Logic). This field will only be written to the bitstream if the audio
-stream is stereo. Using this option does <b>NOT</b> mean the encoder will actually
-apply Dolby Surround processing.
-</p><dl compact="compact">
-<dt> ‘<samp>0</samp>’</dt>
-<dt> ‘<samp>notindicated</samp>’</dt>
-<dd><p>Not Indicated (default)
-</p></dd>
-<dt> ‘<samp>1</samp>’</dt>
-<dt> ‘<samp>off</samp>’</dt>
-<dd><p>Not Dolby Surround Encoded
-</p></dd>
-<dt> ‘<samp>2</samp>’</dt>
-<dt> ‘<samp>on</samp>’</dt>
-<dd><p>Dolby Surround Encoded
-</p></dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>-original <var>boolean</var></samp>’</dt>
-<dd><p>Original Bit Stream Indicator. Specifies whether this audio is from the
-original source and not a copy.
-</p><dl compact="compact">
-<dt> ‘<samp>0</samp>’</dt>
-<dt> ‘<samp>off</samp>’</dt>
-<dd><p>Not Original Source
-</p></dd>
-<dt> ‘<samp>1</samp>’</dt>
-<dt> ‘<samp>on</samp>’</dt>
-<dd><p>Original Source (default)
-</p></dd>
-</dl>
-
-</dd>
-</dl>
-
-<a name="Extended-Bitstream-Information"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Extended-Bitstream-Information">13.2.2 Extended Bitstream Information</a></h3>
-<p>The extended bitstream options are part of the Alternate Bit Stream Syntax as
-specified in Annex D of the A/52:2010 standard. It is grouped into 2 parts.
-If any one parameter in a group is specified, all values in that group will be
-written to the bitstream. Default values are used for those that are written
-but have not been specified. If the mixing levels are written, the decoder
-will use these values instead of the ones specified in the <code>center_mixlev</code>
-and <code>surround_mixlev</code> options if it supports the Alternate Bit Stream
-Syntax.
+<dt> ‘<samp>fflags <var>flags</var> (<em>input/output</em>)</samp>’</dt>
+<dd><p>Set format flags.
</p>
-<a name="Extended-Bitstream-Information-_002d-Part-1"></a>
-<h4 class="subsubsection"><a href="ffplay-all.html#toc-Extended-Bitstream-Information-_002d-Part-1">13.2.2.1 Extended Bitstream Information - Part 1</a></h4>
-
-<dl compact="compact">
-<dt> ‘<samp>-dmix_mode <var>mode</var></samp>’</dt>
-<dd><p>Preferred Stereo Downmix Mode. Allows the user to select either Lt/Rt
-(Dolby Surround) or Lo/Ro (normal stereo) as the preferred stereo downmix mode.
+<p>Possible values:
</p><dl compact="compact">
-<dt> ‘<samp>0</samp>’</dt>
-<dt> ‘<samp>notindicated</samp>’</dt>
-<dd><p>Not Indicated (default)
-</p></dd>
-<dt> ‘<samp>1</samp>’</dt>
-<dt> ‘<samp>ltrt</samp>’</dt>
-<dd><p>Lt/Rt Downmix Preferred
+<dt> ‘<samp>ignidx</samp>’</dt>
+<dd><p>Ignore index.
</p></dd>
-<dt> ‘<samp>2</samp>’</dt>
-<dt> ‘<samp>loro</samp>’</dt>
-<dd><p>Lo/Ro Downmix Preferred
+<dt> ‘<samp>genpts</samp>’</dt>
+<dd><p>Generate PTS.
</p></dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>-ltrt_cmixlev <var>level</var></samp>’</dt>
-<dd><p>Lt/Rt Center Mix Level. The amount of gain the decoder should apply to the
-center channel when downmixing to stereo in Lt/Rt mode.
-</p><dl compact="compact">
-<dt> ‘<samp>1.414</samp>’</dt>
-<dd><p>Apply +3dB gain
+<dt> ‘<samp>nofillin</samp>’</dt>
+<dd><p>Do not fill in missing values that can be exactly calculated.
</p></dd>
-<dt> ‘<samp>1.189</samp>’</dt>
-<dd><p>Apply +1.5dB gain
+<dt> ‘<samp>noparse</samp>’</dt>
+<dd><p>Disable AVParsers, this needs <code>+nofillin</code> too.
</p></dd>
-<dt> ‘<samp>1.000</samp>’</dt>
-<dd><p>Apply 0dB gain
+<dt> ‘<samp>igndts</samp>’</dt>
+<dd><p>Ignore DTS.
</p></dd>
-<dt> ‘<samp>0.841</samp>’</dt>
-<dd><p>Apply -1.5dB gain
+<dt> ‘<samp>discardcorrupt</samp>’</dt>
+<dd><p>Discard corrupted frames.
</p></dd>
-<dt> ‘<samp>0.707</samp>’</dt>
-<dd><p>Apply -3.0dB gain
+<dt> ‘<samp>sortdts</samp>’</dt>
+<dd><p>Try to interleave output packets by DTS.
</p></dd>
-<dt> ‘<samp>0.595</samp>’</dt>
-<dd><p>Apply -4.5dB gain (default)
+<dt> ‘<samp>keepside</samp>’</dt>
+<dd><p>Do not merge side data.
</p></dd>
-<dt> ‘<samp>0.500</samp>’</dt>
-<dd><p>Apply -6.0dB gain
+<dt> ‘<samp>latm</samp>’</dt>
+<dd><p>Enable RTP MP4A-LATM payload.
</p></dd>
-<dt> ‘<samp>0.000</samp>’</dt>
-<dd><p>Silence Center Channel
+<dt> ‘<samp>nobuffer</samp>’</dt>
+<dd><p>Reduce the latency introduced by optional buffering
</p></dd>
</dl>
</dd>
-<dt> ‘<samp>-ltrt_surmixlev <var>level</var></samp>’</dt>
-<dd><p>Lt/Rt Surround Mix Level. The amount of gain the decoder should apply to the
-surround channel(s) when downmixing to stereo in Lt/Rt mode.
-</p><dl compact="compact">
-<dt> ‘<samp>0.841</samp>’</dt>
-<dd><p>Apply -1.5dB gain
-</p></dd>
-<dt> ‘<samp>0.707</samp>’</dt>
-<dd><p>Apply -3.0dB gain
-</p></dd>
-<dt> ‘<samp>0.595</samp>’</dt>
-<dd><p>Apply -4.5dB gain
-</p></dd>
-<dt> ‘<samp>0.500</samp>’</dt>
-<dd><p>Apply -6.0dB gain (default)
-</p></dd>
-<dt> ‘<samp>0.000</samp>’</dt>
-<dd><p>Silence Surround Channel(s)
-</p></dd>
-</dl>
-
+<dt> ‘<samp>seek2any <var>integer</var> (<em>input</em>)</samp>’</dt>
+<dd><p>Allow seeking to non-keyframes on demuxer level when supported if set to 1.
+Default is 0.
+</p>
</dd>
-<dt> ‘<samp>-loro_cmixlev <var>level</var></samp>’</dt>
-<dd><p>Lo/Ro Center Mix Level. The amount of gain the decoder should apply to the
-center channel when downmixing to stereo in Lo/Ro mode.
-</p><dl compact="compact">
-<dt> ‘<samp>1.414</samp>’</dt>
-<dd><p>Apply +3dB gain
-</p></dd>
-<dt> ‘<samp>1.189</samp>’</dt>
-<dd><p>Apply +1.5dB gain
-</p></dd>
-<dt> ‘<samp>1.000</samp>’</dt>
-<dd><p>Apply 0dB gain
-</p></dd>
-<dt> ‘<samp>0.841</samp>’</dt>
-<dd><p>Apply -1.5dB gain
-</p></dd>
-<dt> ‘<samp>0.707</samp>’</dt>
-<dd><p>Apply -3.0dB gain
-</p></dd>
-<dt> ‘<samp>0.595</samp>’</dt>
-<dd><p>Apply -4.5dB gain (default)
-</p></dd>
-<dt> ‘<samp>0.500</samp>’</dt>
-<dd><p>Apply -6.0dB gain
-</p></dd>
-<dt> ‘<samp>0.000</samp>’</dt>
-<dd><p>Silence Center Channel
-</p></dd>
-</dl>
-
+<dt> ‘<samp>analyzeduration <var>integer</var> (<em>input</em>)</samp>’</dt>
+<dd><p>Specify how many microseconds are analyzed to probe the input. A
+higher value will allow to detect more accurate information, but will
+increase latency. It defaults to 5,000,000 microseconds = 5 seconds.
+</p>
+</dd>
+<dt> ‘<samp>cryptokey <var>hexadecimal string</var> (<em>input</em>)</samp>’</dt>
+<dd><p>Set decryption key.
+</p>
+</dd>
+<dt> ‘<samp>indexmem <var>integer</var> (<em>input</em>)</samp>’</dt>
+<dd><p>Set max memory used for timestamp index (per stream).
+</p>
+</dd>
+<dt> ‘<samp>rtbufsize <var>integer</var> (<em>input</em>)</samp>’</dt>
+<dd><p>Set max memory used for buffering real-time frames.
+</p>
</dd>
-<dt> ‘<samp>-loro_surmixlev <var>level</var></samp>’</dt>
-<dd><p>Lo/Ro Surround Mix Level. The amount of gain the decoder should apply to the
-surround channel(s) when downmixing to stereo in Lo/Ro mode.
+<dt> ‘<samp>fdebug <var>flags</var> (<em>input/output</em>)</samp>’</dt>
+<dd><p>Print specific debug info.
+</p>
+<p>Possible values:
</p><dl compact="compact">
-<dt> ‘<samp>0.841</samp>’</dt>
-<dd><p>Apply -1.5dB gain
-</p></dd>
-<dt> ‘<samp>0.707</samp>’</dt>
-<dd><p>Apply -3.0dB gain
-</p></dd>
-<dt> ‘<samp>0.595</samp>’</dt>
-<dd><p>Apply -4.5dB gain
-</p></dd>
-<dt> ‘<samp>0.500</samp>’</dt>
-<dd><p>Apply -6.0dB gain (default)
-</p></dd>
-<dt> ‘<samp>0.000</samp>’</dt>
-<dd><p>Silence Surround Channel(s)
-</p></dd>
+<dt> ‘<samp>ts</samp>’</dt>
</dl>
</dd>
-</dl>
-
-<a name="Extended-Bitstream-Information-_002d-Part-2"></a>
-<h4 class="subsubsection"><a href="ffplay-all.html#toc-Extended-Bitstream-Information-_002d-Part-2">13.2.2.2 Extended Bitstream Information - Part 2</a></h4>
-
-<dl compact="compact">
-<dt> ‘<samp>-dsurex_mode <var>mode</var></samp>’</dt>
-<dd><p>Dolby Surround EX Mode. Indicates whether the stream uses Dolby Surround EX
-(7.1 matrixed to 5.1). Using this option does <b>NOT</b> mean the encoder will actually
-apply Dolby Surround EX processing.
+<dt> ‘<samp>max_delay <var>integer</var> (<em>input/output</em>)</samp>’</dt>
+<dd><p>Set maximum muxing or demuxing delay in microseconds.
+</p>
+</dd>
+<dt> ‘<samp>fpsprobesize <var>integer</var> (<em>input</em>)</samp>’</dt>
+<dd><p>Set number of frames used to probe fps.
+</p>
+</dd>
+<dt> ‘<samp>audio_preload <var>integer</var> (<em>output</em>)</samp>’</dt>
+<dd><p>Set microseconds by which audio packets should be interleaved earlier.
+</p>
+</dd>
+<dt> ‘<samp>chunk_duration <var>integer</var> (<em>output</em>)</samp>’</dt>
+<dd><p>Set microseconds for each chunk.
+</p>
+</dd>
+<dt> ‘<samp>chunk_size <var>integer</var> (<em>output</em>)</samp>’</dt>
+<dd><p>Set size in bytes for each chunk.
+</p>
+</dd>
+<dt> ‘<samp>err_detect, f_err_detect <var>flags</var> (<em>input</em>)</samp>’</dt>
+<dd><p>Set error detection flags. <code>f_err_detect</code> is deprecated and
+should be used only via the <code>ffmpeg</code> tool.
+</p>
+<p>Possible values:
</p><dl compact="compact">
-<dt> ‘<samp>0</samp>’</dt>
-<dt> ‘<samp>notindicated</samp>’</dt>
-<dd><p>Not Indicated (default)
-</p></dd>
-<dt> ‘<samp>1</samp>’</dt>
-<dt> ‘<samp>on</samp>’</dt>
-<dd><p>Dolby Surround EX Off
+<dt> ‘<samp>crccheck</samp>’</dt>
+<dd><p>Verify embedded CRCs.
</p></dd>
-<dt> ‘<samp>2</samp>’</dt>
-<dt> ‘<samp>off</samp>’</dt>
-<dd><p>Dolby Surround EX On
+<dt> ‘<samp>bitstream</samp>’</dt>
+<dd><p>Detect bitstream specification deviations.
</p></dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>-dheadphone_mode <var>mode</var></samp>’</dt>
-<dd><p>Dolby Headphone Mode. Indicates whether the stream uses Dolby Headphone
-encoding (multi-channel matrixed to 2.0 for use with headphones). Using this
-option does <b>NOT</b> mean the encoder will actually apply Dolby Headphone
-processing.
-</p><dl compact="compact">
-<dt> ‘<samp>0</samp>’</dt>
-<dt> ‘<samp>notindicated</samp>’</dt>
-<dd><p>Not Indicated (default)
+<dt> ‘<samp>buffer</samp>’</dt>
+<dd><p>Detect improper bitstream length.
</p></dd>
-<dt> ‘<samp>1</samp>’</dt>
-<dt> ‘<samp>on</samp>’</dt>
-<dd><p>Dolby Headphone Off
+<dt> ‘<samp>explode</samp>’</dt>
+<dd><p>Abort decoding on minor error detection.
</p></dd>
-<dt> ‘<samp>2</samp>’</dt>
-<dt> ‘<samp>off</samp>’</dt>
-<dd><p>Dolby Headphone On
+<dt> ‘<samp>careful</samp>’</dt>
+<dd><p>Consider things that violate the spec and have not been seen in the
+wild as errors.
</p></dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>-ad_conv_type <var>type</var></samp>’</dt>
-<dd><p>A/D Converter Type. Indicates whether the audio has passed through HDCD A/D
-conversion.
-</p><dl compact="compact">
-<dt> ‘<samp>0</samp>’</dt>
-<dt> ‘<samp>standard</samp>’</dt>
-<dd><p>Standard A/D Converter (default)
+<dt> ‘<samp>compliant</samp>’</dt>
+<dd><p>Consider all spec non compliancies as errors.
</p></dd>
-<dt> ‘<samp>1</samp>’</dt>
-<dt> ‘<samp>hdcd</samp>’</dt>
-<dd><p>HDCD A/D Converter
+<dt> ‘<samp>aggressive</samp>’</dt>
+<dd><p>Consider things that a sane encoder should not do as an error.
</p></dd>
</dl>
</dd>
-</dl>
-
-<a name="Other-AC_002d3-Encoding-Options"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Other-AC_002d3-Encoding-Options">13.2.3 Other AC-3 Encoding Options</a></h3>
-
-<dl compact="compact">
-<dt> ‘<samp>-stereo_rematrixing <var>boolean</var></samp>’</dt>
-<dd><p>Stereo Rematrixing. Enables/Disables use of rematrixing for stereo input. This
-is an optional AC-3 feature that increases quality by selectively encoding
-the left/right channels as mid/side. This option is enabled by default, and it
-is highly recommended that it be left as enabled except for testing purposes.
+<dt> ‘<samp>use_wallclock_as_timestamps <var>integer</var> (<em>input</em>)</samp>’</dt>
+<dd><p>Use wallclock as timestamps.
</p>
</dd>
-</dl>
-
-<a name="Floating_002dPoint_002dOnly-AC_002d3-Encoding-Options"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Floating_002dPoint_002dOnly-AC_002d3-Encoding-Options">13.2.4 Floating-Point-Only AC-3 Encoding Options</a></h3>
-
-<p>These options are only valid for the floating-point encoder and do not exist
-for the fixed-point encoder due to the corresponding features not being
-implemented in fixed-point.
-</p>
-<dl compact="compact">
-<dt> ‘<samp>-channel_coupling <var>boolean</var></samp>’</dt>
-<dd><p>Enables/Disables use of channel coupling, which is an optional AC-3 feature
-that increases quality by combining high frequency information from multiple
-channels into a single channel. The per-channel high frequency information is
-sent with less accuracy in both the frequency and time domains. This allows
-more bits to be used for lower frequencies while preserving enough information
-to reconstruct the high frequencies. This option is enabled by default for the
-floating-point encoder and should generally be left as enabled except for
-testing purposes or to increase encoding speed.
+<dt> ‘<samp>avoid_negative_ts <var>integer</var> (<em>output</em>)</samp>’</dt>
+<dd>
+<p>Possible values:
</p><dl compact="compact">
-<dt> ‘<samp>-1</samp>’</dt>
-<dt> ‘<samp>auto</samp>’</dt>
-<dd><p>Selected by Encoder (default)
+<dt> ‘<samp>make_non_negative</samp>’</dt>
+<dd><p>Shift timestamps to make them non-negative.
+Also note that this affects only leading negative timestamps, and not
+non-monotonic negative timestamps.
</p></dd>
-<dt> ‘<samp>0</samp>’</dt>
-<dt> ‘<samp>off</samp>’</dt>
-<dd><p>Disable Channel Coupling
+<dt> ‘<samp>make_zero</samp>’</dt>
+<dd><p>Shift timestamps so that the first timestamp is 0.
</p></dd>
-<dt> ‘<samp>1</samp>’</dt>
-<dt> ‘<samp>on</samp>’</dt>
-<dd><p>Enable Channel Coupling
+<dt> ‘<samp>auto (default)</samp>’</dt>
+<dd><p>Enables shifting when required by the target format.
</p></dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>-cpl_start_band <var>number</var></samp>’</dt>
-<dd><p>Coupling Start Band. Sets the channel coupling start band, from 1 to 15. If a
-value higher than the bandwidth is used, it will be reduced to 1 less than the
-coupling end band. If <var>auto</var> is used, the start band will be determined by
-the encoder based on the bit rate, sample rate, and channel layout. This option
-has no effect if channel coupling is disabled.
-</p><dl compact="compact">
-<dt> ‘<samp>-1</samp>’</dt>
-<dt> ‘<samp>auto</samp>’</dt>
-<dd><p>Selected by Encoder (default)
+<dt> ‘<samp>disabled</samp>’</dt>
+<dd><p>Disables shifting of timestamp.
</p></dd>
</dl>
-</dd>
-</dl>
-
-<p><a name="libfaac"></a>
-</p><a name="libfaac-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-libfaac-1">13.3 libfaac</a></h2>
-
-<p>libfaac AAC (Advanced Audio Coding) encoder wrapper.
-</p>
-<p>Requires the presence of the libfaac headers and library during
-configuration. You need to explicitly configure the build with
-<code>--enable-libfaac --enable-nonfree</code>.
-</p>
-<p>This encoder is considered to be of higher quality with respect to the
-<a href="#aacenc">the native experimental FFmpeg AAC encoder</a>.
-</p>
-<p>For more information see the libfaac project at
-<a href="http://www.audiocoding.com/faac.html/">http://www.audiocoding.com/faac.html/</a>.
-</p>
-<a name="Options-28"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-28">13.3.1 Options</a></h3>
-
-<p>The following shared FFmpeg codec options are recognized.
-</p>
-<p>The following options are supported by the libfaac wrapper. The
-<code>faac</code>-equivalent of the options are listed in parentheses.
-</p>
-<dl compact="compact">
-<dt> ‘<samp>b (<em>-b</em>)</samp>’</dt>
-<dd><p>Set bit rate in bits/s for ABR (Average Bit Rate) mode. If the bit rate
-is not explicitly specified, it is automatically set to a suitable
-value depending on the selected profile. <code>faac</code> bitrate is
-expressed in kilobits/s.
-</p>
-<p>Note that libfaac does not support CBR (Constant Bit Rate) but only
-ABR (Average Bit Rate).
-</p>
-<p>If VBR mode is enabled this option is ignored.
+<p>When shifting is enabled, all output timestamps are shifted by the
+same amount. Audio, video, and subtitles desynching and relative
+timestamp differences are preserved compared to how they would have
+been without shifting.
</p>
</dd>
-<dt> ‘<samp>ar (<em>-R</em>)</samp>’</dt>
-<dd><p>Set audio sampling rate (in Hz).
+<dt> ‘<samp>skip_initial_bytes <var>integer</var> (<em>input</em>)</samp>’</dt>
+<dd><p>Set number of bytes to skip before reading header and frames if set to 1.
+Default is 0.
</p>
</dd>
-<dt> ‘<samp>ac (<em>-c</em>)</samp>’</dt>
-<dd><p>Set the number of audio channels.
+<dt> ‘<samp>correct_ts_overflow <var>integer</var> (<em>input</em>)</samp>’</dt>
+<dd><p>Correct single timestamp overflows if set to 1. Default is 1.
</p>
</dd>
-<dt> ‘<samp>cutoff (<em>-C</em>)</samp>’</dt>
-<dd><p>Set cutoff frequency. If not specified (or explicitly set to 0) it
-will use a value automatically computed by the library. Default value
-is 0.
-</p>
-</dd>
-<dt> ‘<samp>profile</samp>’</dt>
-<dd><p>Set audio profile.
-</p>
-<p>The following profiles are recognized:
-</p><dl compact="compact">
-<dt> ‘<samp>aac_main</samp>’</dt>
-<dd><p>Main AAC (Main)
-</p>
-</dd>
-<dt> ‘<samp>aac_low</samp>’</dt>
-<dd><p>Low Complexity AAC (LC)
-</p>
-</dd>
-<dt> ‘<samp>aac_ssr</samp>’</dt>
-<dd><p>Scalable Sample Rate (SSR)
-</p>
-</dd>
-<dt> ‘<samp>aac_ltp</samp>’</dt>
-<dd><p>Long Term Prediction (LTP)
-</p></dd>
-</dl>
-
-<p>If not specified it is set to ‘<samp>aac_low</samp>’.
-</p>
-</dd>
-<dt> ‘<samp>flags +qscale</samp>’</dt>
-<dd><p>Set constant quality VBR (Variable Bit Rate) mode.
-</p>
-</dd>
-<dt> ‘<samp>global_quality</samp>’</dt>
-<dd><p>Set quality in VBR mode as an integer number of lambda units.
-</p>
-<p>Only relevant when VBR mode is enabled with <code>flags +qscale</code>. The
-value is converted to QP units by dividing it by <code>FF_QP2LAMBDA</code>,
-and used to set the quality value used by libfaac. A reasonable range
-for the option value in QP units is [10-500], the higher the value the
-higher the quality.
-</p>
-</dd>
-<dt> ‘<samp>q (<em>-q</em>)</samp>’</dt>
-<dd><p>Enable VBR mode when set to a non-negative value, and set constant
-quality value as a double floating point value in QP units.
-</p>
-<p>The value sets the quality value used by libfaac. A reasonable range
-for the option value is [10-500], the higher the value the higher the
-quality.
-</p>
-<p>This option is valid only using the <code>ffmpeg</code> command-line
-tool. For library interface users, use ‘<samp>global_quality</samp>’.
-</p></dd>
-</dl>
-
-<a name="Examples-43"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-43">13.3.2 Examples</a></h3>
-
-<ul>
-<li>
-Use <code>ffmpeg</code> to convert an audio file to ABR 128 kbps AAC in an M4A (MP4)
-container:
-<table><tr><td> </td><td><pre class="example">ffmpeg -i input.wav -codec:a libfaac -b:a 128k -output.m4a
-</pre></td></tr></table>
-
-</li><li>
-Use <code>ffmpeg</code> to convert an audio file to VBR AAC, using the
-LTP AAC profile:
-<table><tr><td> </td><td><pre class="example">ffmpeg -i input.wav -c:a libfaac -profile:a aac_ltp -q:a 100 output.m4a
-</pre></td></tr></table>
-</li></ul>
-
-<p><a name="libfdk_002daac_002denc"></a>
-</p><a name="libfdk_005faac"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-libfdk_005faac">13.4 libfdk_aac</a></h2>
-
-<p>libfdk-aac AAC (Advanced Audio Coding) encoder wrapper.
-</p>
-<p>The libfdk-aac library is based on the Fraunhofer FDK AAC code from
-the Android project.
-</p>
-<p>Requires the presence of the libfdk-aac headers and library during
-configuration. You need to explicitly configure the build with
-<code>--enable-libfdk-aac</code>. The library is also incompatible with GPL,
-so if you allow the use of GPL, you should configure with
-<code>--enable-gpl --enable-nonfree --enable-libfdk-aac</code>.
-</p>
-<p>This encoder is considered to be of higher quality with respect to
-both <a href="#aacenc">the native experimental FFmpeg AAC encoder</a> and
-<a href="#libfaac">libfaac</a>.
-</p>
-<p>VBR encoding, enabled through the ‘<samp>vbr</samp>’ or ‘<samp>flags
-+qscale</samp>’ options, is experimental and only works with some
-combinations of parameters.
-</p>
-<p>For more information see the fdk-aac project at
-<a href="http://sourceforge.net/p/opencore-amr/fdk-aac/">http://sourceforge.net/p/opencore-amr/fdk-aac/</a>.
-</p>
-<a name="Options-8"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-8">13.4.1 Options</a></h3>
-
-<p>The following options are mapped on the shared FFmpeg codec options.
-</p>
-<dl compact="compact">
-<dt> ‘<samp>b</samp>’</dt>
-<dd><p>Set bit rate in bits/s. If the bitrate is not explicitly specified, it
-is automatically set to a suitable value depending on the selected
-profile.
-</p>
-<p>In case VBR mode is enabled the option is ignored.
-</p>
-</dd>
-<dt> ‘<samp>ar</samp>’</dt>
-<dd><p>Set audio sampling rate (in Hz).
-</p>
-</dd>
-<dt> ‘<samp>channels</samp>’</dt>
-<dd><p>Set the number of audio channels.
-</p>
-</dd>
-<dt> ‘<samp>flags +qscale</samp>’</dt>
-<dd><p>Enable fixed quality, VBR (Variable Bit Rate) mode.
-Note that VBR is implicitly enabled when the ‘<samp>vbr</samp>’ value is
-positive.
-</p>
-</dd>
-<dt> ‘<samp>cutoff</samp>’</dt>
-<dd><p>Set cutoff frequency. If not specified (or explicitly set to 0) it
-will use a value automatically computed by the library. Default value
-is 0.
-</p>
-</dd>
-<dt> ‘<samp>profile</samp>’</dt>
-<dd><p>Set audio profile.
-</p>
-<p>The following profiles are recognized:
-</p><dl compact="compact">
-<dt> ‘<samp>aac_low</samp>’</dt>
-<dd><p>Low Complexity AAC (LC)
-</p>
-</dd>
-<dt> ‘<samp>aac_he</samp>’</dt>
-<dd><p>High Efficiency AAC (HE-AAC)
-</p>
-</dd>
-<dt> ‘<samp>aac_he_v2</samp>’</dt>
-<dd><p>High Efficiency AAC version 2 (HE-AACv2)
-</p>
-</dd>
-<dt> ‘<samp>aac_ld</samp>’</dt>
-<dd><p>Low Delay AAC (LD)
-</p>
-</dd>
-<dt> ‘<samp>aac_eld</samp>’</dt>
-<dd><p>Enhanced Low Delay AAC (ELD)
-</p></dd>
-</dl>
-
-<p>If not specified it is set to ‘<samp>aac_low</samp>’.
-</p></dd>
-</dl>
-
-<p>The following are private options of the libfdk_aac encoder.
-</p>
-<dl compact="compact">
-<dt> ‘<samp>afterburner</samp>’</dt>
-<dd><p>Enable afterburner feature if set to 1, disabled if set to 0. This
-improves the quality but also the required processing power.
-</p>
-<p>Default value is 1.
-</p>
-</dd>
-<dt> ‘<samp>eld_sbr</samp>’</dt>
-<dd><p>Enable SBR (Spectral Band Replication) for ELD if set to 1, disabled
-if set to 0.
-</p>
-<p>Default value is 0.
-</p>
-</dd>
-<dt> ‘<samp>signaling</samp>’</dt>
-<dd><p>Set SBR/PS signaling style.
-</p>
-<p>It can assume one of the following values:
-</p><dl compact="compact">
-<dt> ‘<samp>default</samp>’</dt>
-<dd><p>choose signaling implicitly (explicit hierarchical by default,
-implicit if global header is disabled)
-</p>
-</dd>
-<dt> ‘<samp>implicit</samp>’</dt>
-<dd><p>implicit backwards compatible signaling
-</p>
-</dd>
-<dt> ‘<samp>explicit_sbr</samp>’</dt>
-<dd><p>explicit SBR, implicit PS signaling
-</p>
-</dd>
-<dt> ‘<samp>explicit_hierarchical</samp>’</dt>
-<dd><p>explicit hierarchical signaling
-</p></dd>
-</dl>
-
-<p>Default value is ‘<samp>default</samp>’.
-</p>
-</dd>
-<dt> ‘<samp>latm</samp>’</dt>
-<dd><p>Output LATM/LOAS encapsulated data if set to 1, disabled if set to 0.
-</p>
-<p>Default value is 0.
-</p>
-</dd>
-<dt> ‘<samp>header_period</samp>’</dt>
-<dd><p>Set StreamMuxConfig and PCE repetition period (in frames) for sending
-in-band configuration buffers within LATM/LOAS transport layer.
-</p>
-<p>Must be a 16-bits non-negative integer.
-</p>
-<p>Default value is 0.
-</p>
-</dd>
-<dt> ‘<samp>vbr</samp>’</dt>
-<dd><p>Set VBR mode, from 1 to 5. 1 is lowest quality (though still pretty
-good) and 5 is highest quality. A value of 0 will disable VBR, and CBR
-(Constant Bit Rate) is enabled.
-</p>
-<p>Currently only the ‘<samp>aac_low</samp>’ profile supports VBR encoding.
-</p>
-<p>VBR modes 1-5 correspond to roughly the following average bit rates:
-</p>
-<dl compact="compact">
-<dt> ‘<samp>1</samp>’</dt>
-<dd><p>32 kbps/channel
-</p></dd>
-<dt> ‘<samp>2</samp>’</dt>
-<dd><p>40 kbps/channel
-</p></dd>
-<dt> ‘<samp>3</samp>’</dt>
-<dd><p>48-56 kbps/channel
-</p></dd>
-<dt> ‘<samp>4</samp>’</dt>
-<dd><p>64 kbps/channel
-</p></dd>
-<dt> ‘<samp>5</samp>’</dt>
-<dd><p>about 80-96 kbps/channel
-</p></dd>
-</dl>
-
-<p>Default value is 0.
-</p></dd>
-</dl>
-
-<a name="Examples-59"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-59">13.4.2 Examples</a></h3>
-
-<ul>
-<li>
-Use <code>ffmpeg</code> to convert an audio file to VBR AAC in an M4A (MP4)
-container:
-<table><tr><td> </td><td><pre class="example">ffmpeg -i input.wav -codec:a libfdk_aac -vbr 3 output.m4a
-</pre></td></tr></table>
-
-</li><li>
-Use <code>ffmpeg</code> to convert an audio file to CBR 64k kbps AAC, using the
-High-Efficiency AAC profile:
-<table><tr><td> </td><td><pre class="example">ffmpeg -i input.wav -c:a libfdk_aac -profile:a aac_he -b:a 64k output.m4a
-</pre></td></tr></table>
-</li></ul>
-
-<p><a name="libmp3lame"></a>
-</p><a name="libmp3lame-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-libmp3lame-1">13.5 libmp3lame</a></h2>
-
-<p>LAME (Lame Ain’t an MP3 Encoder) MP3 encoder wrapper.
-</p>
-<p>Requires the presence of the libmp3lame headers and library during
-configuration. You need to explicitly configure the build with
-<code>--enable-libmp3lame</code>.
-</p>
-<p>See <a href="#libshine">libshine</a> for a fixed-point MP3 encoder, although with a
-lower quality.
-</p>
-<a name="Options-17"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-17">13.5.1 Options</a></h3>
-
-<p>The following options are supported by the libmp3lame wrapper. The
-<code>lame</code>-equivalent of the options are listed in parentheses.
-</p>
-<dl compact="compact">
-<dt> ‘<samp>b (<em>-b</em>)</samp>’</dt>
-<dd><p>Set bitrate expressed in bits/s for CBR or ABR. LAME <code>bitrate</code> is
-expressed in kilobits/s.
-</p>
-</dd>
-<dt> ‘<samp>q (<em>-V</em>)</samp>’</dt>
-<dd><p>Set constant quality setting for VBR. This option is valid only
-using the <code>ffmpeg</code> command-line tool. For library interface
-users, use ‘<samp>global_quality</samp>’.
-</p>
-</dd>
-<dt> ‘<samp>compression_level (<em>-q</em>)</samp>’</dt>
-<dd><p>Set algorithm quality. Valid arguments are integers in the 0-9 range,
-with 0 meaning highest quality but slowest, and 9 meaning fastest
-while producing the worst quality.
-</p>
-</dd>
-<dt> ‘<samp>reservoir</samp>’</dt>
-<dd><p>Enable use of bit reservoir when set to 1. Default value is 1. LAME
-has this enabled by default, but can be overriden by use
-‘<samp>--nores</samp>’ option.
-</p>
-</dd>
-<dt> ‘<samp>joint_stereo (<em>-m j</em>)</samp>’</dt>
-<dd><p>Enable the encoder to use (on a frame by frame basis) either L/R
-stereo or mid/side stereo. Default value is 1.
-</p>
-</dd>
-<dt> ‘<samp>abr (<em>--abr</em>)</samp>’</dt>
-<dd><p>Enable the encoder to use ABR when set to 1. The <code>lame</code>
-‘<samp>--abr</samp>’ sets the target bitrate, while this options only
-tells FFmpeg to use ABR still relies on ‘<samp>b</samp>’ to set bitrate.
-</p>
-</dd>
-</dl>
-
-<a name="libopencore_002damrnb"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-libopencore_002damrnb">13.6 libopencore-amrnb</a></h2>
-
-<p>OpenCORE Adaptive Multi-Rate Narrowband encoder.
-</p>
-<p>Requires the presence of the libopencore-amrnb headers and library during
-configuration. You need to explicitly configure the build with
-<code>--enable-libopencore-amrnb --enable-version3</code>.
-</p>
-<p>This is a mono-only encoder. Officially it only supports 8000Hz sample rate,
-but you can override it by setting ‘<samp>strict</samp>’ to ‘<samp>unofficial</samp>’ or
-lower.
-</p>
-<a name="Options-29"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-29">13.6.1 Options</a></h3>
-
-<dl compact="compact">
-<dt> ‘<samp>b</samp>’</dt>
-<dd><p>Set bitrate in bits per second. Only the following bitrates are supported,
-otherwise libavcodec will round to the nearest valid bitrate.
-</p>
-<dl compact="compact">
-<dt> ‘<samp>4750</samp>’</dt>
-<dt> ‘<samp>5150</samp>’</dt>
-<dt> ‘<samp>5900</samp>’</dt>
-<dt> ‘<samp>6700</samp>’</dt>
-<dt> ‘<samp>7400</samp>’</dt>
-<dt> ‘<samp>7950</samp>’</dt>
-<dt> ‘<samp>10200</samp>’</dt>
-<dt> ‘<samp>12200</samp>’</dt>
-</dl>
-
-</dd>
-<dt> ‘<samp>dtx</samp>’</dt>
-<dd><p>Allow discontinuous transmission (generate comfort noise) when set to 1. The
-default value is 0 (disabled).
-</p>
-</dd>
-</dl>
-
-<p><a name="libshine"></a>
-</p><a name="libshine-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-libshine-1">13.7 libshine</a></h2>
-
-<p>Shine Fixed-Point MP3 encoder wrapper.
-</p>
-<p>Shine is a fixed-point MP3 encoder. It has a far better performance on
-platforms without an FPU, e.g. armel CPUs, and some phones and tablets.
-However, as it is more targeted on performance than quality, it is not on par
-with LAME and other production-grade encoders quality-wise. Also, according to
-the project’s homepage, this encoder may not be free of bugs as the code was
-written a long time ago and the project was dead for at least 5 years.
-</p>
-<p>This encoder only supports stereo and mono input. This is also CBR-only.
-</p>
-<p>The original project (last updated in early 2007) is at
-<a href="http://sourceforge.net/projects/libshine-fxp/">http://sourceforge.net/projects/libshine-fxp/</a>. We only support the
-updated fork by the Savonet/Liquidsoap project at <a href="https://github.com/savonet/shine">https://github.com/savonet/shine</a>.
-</p>
-<p>Requires the presence of the libshine headers and library during
-configuration. You need to explicitly configure the build with
-<code>--enable-libshine</code>.
-</p>
-<p>See also <a href="#libmp3lame">libmp3lame</a>.
-</p>
-<a name="Options-16"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-16">13.7.1 Options</a></h3>
-
-<p>The following options are supported by the libshine wrapper. The
-<code>shineenc</code>-equivalent of the options are listed in parentheses.
-</p>
-<dl compact="compact">
-<dt> ‘<samp>b (<em>-b</em>)</samp>’</dt>
-<dd><p>Set bitrate expressed in bits/s for CBR. <code>shineenc</code> ‘<samp>-b</samp>’ option
-is expressed in kilobits/s.
-</p>
-</dd>
-</dl>
-
-<a name="libtwolame"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-libtwolame">13.8 libtwolame</a></h2>
-
-<p>TwoLAME MP2 encoder wrapper.
-</p>
-<p>Requires the presence of the libtwolame headers and library during
-configuration. You need to explicitly configure the build with
-<code>--enable-libtwolame</code>.
-</p>
-<a name="Options-22"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-22">13.8.1 Options</a></h3>
-
-<p>The following options are supported by the libtwolame wrapper. The
-<code>twolame</code>-equivalent options follow the FFmpeg ones and are in
-parentheses.
-</p>
-<dl compact="compact">
-<dt> ‘<samp>b (<em>-b</em>)</samp>’</dt>
-<dd><p>Set bitrate expressed in bits/s for CBR. <code>twolame</code> ‘<samp>b</samp>’
-option is expressed in kilobits/s. Default value is 128k.
-</p>
-</dd>
-<dt> ‘<samp>q (<em>-V</em>)</samp>’</dt>
-<dd><p>Set quality for experimental VBR support. Maximum value range is
-from -50 to 50, useful range is from -10 to 10. The higher the
-value, the better the quality. This option is valid only using the
-<code>ffmpeg</code> command-line tool. For library interface users,
-use ‘<samp>global_quality</samp>’.
-</p>
-</dd>
-<dt> ‘<samp>mode (<em>--mode</em>)</samp>’</dt>
-<dd><p>Set the mode of the resulting audio. Possible values:
-</p>
-<dl compact="compact">
-<dt> ‘<samp>auto</samp>’</dt>
-<dd><p>Choose mode automatically based on the input. This is the default.
-</p></dd>
-<dt> ‘<samp>stereo</samp>’</dt>
-<dd><p>Stereo
-</p></dd>
-<dt> ‘<samp>joint_stereo</samp>’</dt>
-<dd><p>Joint stereo
-</p></dd>
-<dt> ‘<samp>dual_channel</samp>’</dt>
-<dd><p>Dual channel
-</p></dd>
-<dt> ‘<samp>mono</samp>’</dt>
-<dd><p>Mono
-</p></dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>psymodel (<em>--psyc-mode</em>)</samp>’</dt>
-<dd><p>Set psychoacoustic model to use in encoding. The argument must be
-an integer between -1 and 4, inclusive. The higher the value, the
-better the quality. The default value is 3.
-</p>
-</dd>
-<dt> ‘<samp>energy_levels (<em>--energy</em>)</samp>’</dt>
-<dd><p>Enable energy levels extensions when set to 1. The default value is
-0 (disabled).
-</p>
-</dd>
-<dt> ‘<samp>error_protection (<em>--protect</em>)</samp>’</dt>
-<dd><p>Enable CRC error protection when set to 1. The default value is 0
-(disabled).
-</p>
-</dd>
-<dt> ‘<samp>copyright (<em>--copyright</em>)</samp>’</dt>
-<dd><p>Set MPEG audio copyright flag when set to 1. The default value is 0
-(disabled).
-</p>
-</dd>
-<dt> ‘<samp>original (<em>--original</em>)</samp>’</dt>
-<dd><p>Set MPEG audio original flag when set to 1. The default value is 0
-(disabled).
-</p>
-</dd>
-</dl>
-
-<p><a name="libvo_002daacenc"></a>
-</p><a name="libvo_002daacenc-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-libvo_002daacenc-1">13.9 libvo-aacenc</a></h2>
-
-<p>VisualOn AAC encoder.
-</p>
-<p>Requires the presence of the libvo-aacenc headers and library during
-configuration. You need to explicitly configure the build with
-<code>--enable-libvo-aacenc --enable-version3</code>.
-</p>
-<p>This encoder is considered to be worse than the
-<a href="#aacenc">native experimental FFmpeg AAC encoder</a>, according to
-multiple sources.
-</p>
-<a name="Options-11"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-11">13.9.1 Options</a></h3>
-
-<p>The VisualOn AAC encoder only support encoding AAC-LC and up to 2
-channels. It is also CBR-only.
-</p>
-<dl compact="compact">
-<dt> ‘<samp>b</samp>’</dt>
-<dd><p>Set bit rate in bits/s.
-</p>
-</dd>
-</dl>
-
-<a name="libvo_002damrwbenc"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-libvo_002damrwbenc">13.10 libvo-amrwbenc</a></h2>
-
-<p>VisualOn Adaptive Multi-Rate Wideband encoder.
-</p>
-<p>Requires the presence of the libvo-amrwbenc headers and library during
-configuration. You need to explicitly configure the build with
-<code>--enable-libvo-amrwbenc --enable-version3</code>.
-</p>
-<p>This is a mono-only encoder. Officially it only supports 16000Hz sample
-rate, but you can override it by setting ‘<samp>strict</samp>’ to
-‘<samp>unofficial</samp>’ or lower.
-</p>
-<a name="Options-23"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-23">13.10.1 Options</a></h3>
-
-<dl compact="compact">
-<dt> ‘<samp>b</samp>’</dt>
-<dd><p>Set bitrate in bits/s. Only the following bitrates are supported, otherwise
-libavcodec will round to the nearest valid bitrate.
-</p>
-<dl compact="compact">
-<dt> ‘<samp>6600</samp>’</dt>
-<dt> ‘<samp>8850</samp>’</dt>
-<dt> ‘<samp>12650</samp>’</dt>
-<dt> ‘<samp>14250</samp>’</dt>
-<dt> ‘<samp>15850</samp>’</dt>
-<dt> ‘<samp>18250</samp>’</dt>
-<dt> ‘<samp>19850</samp>’</dt>
-<dt> ‘<samp>23050</samp>’</dt>
-<dt> ‘<samp>23850</samp>’</dt>
-</dl>
-
-</dd>
-<dt> ‘<samp>dtx</samp>’</dt>
-<dd><p>Allow discontinuous transmission (generate comfort noise) when set to 1. The
-default value is 0 (disabled).
-</p>
-</dd>
-</dl>
-
-<a name="libopus-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-libopus-1">13.11 libopus</a></h2>
-
-<p>libopus Opus Interactive Audio Codec encoder wrapper.
-</p>
-<p>Requires the presence of the libopus headers and library during
-configuration. You need to explicitly configure the build with
-<code>--enable-libopus</code>.
-</p>
-<a name="Option-Mapping"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Option-Mapping">13.11.1 Option Mapping</a></h3>
-
-<p>Most libopus options are modeled after the <code>opusenc</code> utility from
-opus-tools. The following is an option mapping chart describing options
-supported by the libopus wrapper, and their <code>opusenc</code>-equivalent
-in parentheses.
-</p>
-<dl compact="compact">
-<dt> ‘<samp>b (<em>bitrate</em>)</samp>’</dt>
-<dd><p>Set the bit rate in bits/s. FFmpeg’s ‘<samp>b</samp>’ option is
-expressed in bits/s, while <code>opusenc</code>’s ‘<samp>bitrate</samp>’ in
-kilobits/s.
-</p>
-</dd>
-<dt> ‘<samp>vbr (<em>vbr</em>, <em>hard-cbr</em>, and <em>cvbr</em>)</samp>’</dt>
-<dd><p>Set VBR mode. The FFmpeg ‘<samp>vbr</samp>’ option has the following
-valid arguments, with the their <code>opusenc</code> equivalent options
-in parentheses:
-</p>
-<dl compact="compact">
-<dt> ‘<samp>off (<em>hard-cbr</em>)</samp>’</dt>
-<dd><p>Use constant bit rate encoding.
-</p>
-</dd>
-<dt> ‘<samp>on (<em>vbr</em>)</samp>’</dt>
-<dd><p>Use variable bit rate encoding (the default).
-</p>
-</dd>
-<dt> ‘<samp>constrained (<em>cvbr</em>)</samp>’</dt>
-<dd><p>Use constrained variable bit rate encoding.
-</p></dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>compression_level (<em>comp</em>)</samp>’</dt>
-<dd><p>Set encoding algorithm complexity. Valid options are integers in
-the 0-10 range. 0 gives the fastest encodes but lower quality, while 10
-gives the highest quality but slowest encoding. The default is 10.
-</p>
-</dd>
-<dt> ‘<samp>frame_duration (<em>framesize</em>)</samp>’</dt>
-<dd><p>Set maximum frame size, or duration of a frame in milliseconds. The
-argument must be exactly the following: 2.5, 5, 10, 20, 40, 60. Smaller
-frame sizes achieve lower latency but less quality at a given bitrate.
-Sizes greater than 20ms are only interesting at fairly low bitrates.
-The default is 20ms.
-</p>
-</dd>
-<dt> ‘<samp>packet_loss (<em>expect-loss</em>)</samp>’</dt>
-<dd><p>Set expected packet loss percentage. The default is 0.
-</p>
-</dd>
-<dt> ‘<samp>application (N.A.)</samp>’</dt>
-<dd><p>Set intended application type. Valid options are listed below:
-</p>
-<dl compact="compact">
-<dt> ‘<samp>voip</samp>’</dt>
-<dd><p>Favor improved speech intelligibility.
-</p></dd>
-<dt> ‘<samp>audio</samp>’</dt>
-<dd><p>Favor faithfulness to the input (the default).
-</p></dd>
-<dt> ‘<samp>lowdelay</samp>’</dt>
-<dd><p>Restrict to only the lowest delay modes.
-</p></dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>cutoff (N.A.)</samp>’</dt>
-<dd><p>Set cutoff bandwidth in Hz. The argument must be exactly one of the
-following: 4000, 6000, 8000, 12000, or 20000, corresponding to
-narrowband, mediumband, wideband, super wideband, and fullband
-respectively. The default is 0 (cutoff disabled).
-</p>
-</dd>
-</dl>
-
-<a name="libvorbis"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-libvorbis">13.12 libvorbis</a></h2>
-
-<p>libvorbis encoder wrapper.
-</p>
-<p>Requires the presence of the libvorbisenc headers and library during
-configuration. You need to explicitly configure the build with
-<code>--enable-libvorbis</code>.
-</p>
-<a name="Options-32"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-32">13.12.1 Options</a></h3>
-
-<p>The following options are supported by the libvorbis wrapper. The
-<code>oggenc</code>-equivalent of the options are listed in parentheses.
-</p>
-<p>To get a more accurate and extensive documentation of the libvorbis
-options, consult the libvorbisenc’s and <code>oggenc</code>’s documentations.
-See <a href="http://xiph.org/vorbis/">http://xiph.org/vorbis/</a>,
-<a href="http://wiki.xiph.org/Vorbis-tools">http://wiki.xiph.org/Vorbis-tools</a>, and oggenc(1).
-</p>
-<dl compact="compact">
-<dt> ‘<samp>b (<em>-b</em>)</samp>’</dt>
-<dd><p>Set bitrate expressed in bits/s for ABR. <code>oggenc</code> ‘<samp>-b</samp>’ is
-expressed in kilobits/s.
-</p>
-</dd>
-<dt> ‘<samp>q (<em>-q</em>)</samp>’</dt>
-<dd><p>Set constant quality setting for VBR. The value should be a float
-number in the range of -1.0 to 10.0. The higher the value, the better
-the quality. The default value is ‘<samp>3.0</samp>’.
-</p>
-<p>This option is valid only using the <code>ffmpeg</code> command-line tool.
-For library interface users, use ‘<samp>global_quality</samp>’.
-</p>
-</dd>
-<dt> ‘<samp>cutoff (<em>--advanced-encode-option lowpass_frequency=N</em>)</samp>’</dt>
-<dd><p>Set cutoff bandwidth in Hz, a value of 0 disables cutoff. <code>oggenc</code>’s
-related option is expressed in kHz. The default value is ‘<samp>0</samp>’ (cutoff
-disabled).
-</p>
-</dd>
-<dt> ‘<samp>minrate (<em>-m</em>)</samp>’</dt>
-<dd><p>Set minimum bitrate expressed in bits/s. <code>oggenc</code> ‘<samp>-m</samp>’ is
-expressed in kilobits/s.
-</p>
-</dd>
-<dt> ‘<samp>maxrate (<em>-M</em>)</samp>’</dt>
-<dd><p>Set maximum bitrate expressed in bits/s. <code>oggenc</code> ‘<samp>-M</samp>’ is
-expressed in kilobits/s. This only has effect on ABR mode.
-</p>
-</dd>
-<dt> ‘<samp>iblock (<em>--advanced-encode-option impulse_noisetune=N</em>)</samp>’</dt>
-<dd><p>Set noise floor bias for impulse blocks. The value is a float number from
--15.0 to 0.0. A negative bias instructs the encoder to pay special attention
-to the crispness of transients in the encoded audio. The tradeoff for better
-transient response is a higher bitrate.
-</p>
-</dd>
-</dl>
-
-<a name="libwavpack"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-libwavpack">13.13 libwavpack</a></h2>
-
-<p>A wrapper providing WavPack encoding through libwavpack.
-</p>
-<p>Only lossless mode using 32-bit integer samples is supported currently.
-The ‘<samp>compression_level</samp>’ option can be used to control speed vs.
-compression tradeoff, with the values mapped to libwavpack as follows:
-</p>
-<dl compact="compact">
-<dt> ‘<samp>0</samp>’</dt>
-<dd><p>Fast mode - corresponding to the wavpack ‘<samp>-f</samp>’ option.
-</p>
-</dd>
-<dt> ‘<samp>1</samp>’</dt>
-<dd><p>Normal (default) settings.
-</p>
-</dd>
-<dt> ‘<samp>2</samp>’</dt>
-<dd><p>High quality - corresponding to the wavpack ‘<samp>-h</samp>’ option.
-</p>
-</dd>
-<dt> ‘<samp>3</samp>’</dt>
-<dd><p>Very high quality - corresponding to the wavpack ‘<samp>-hh</samp>’ option.
-</p>
-</dd>
-<dt> ‘<samp>4-8</samp>’</dt>
-<dd><p>Same as 3, but with extra processing enabled - corresponding to the wavpack
-‘<samp>-x</samp>’ option. I.e. 4 is the same as ‘<samp>-x2</samp>’ and 8 is the same as
-‘<samp>-x6</samp>’.
-</p>
-</dd>
-</dl>
-
-
-<a name="Video-Encoders"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-Video-Encoders">14. Video Encoders</a></h1>
-
-<p>A description of some of the currently available video encoders
-follows.
-</p>
-<a name="libtheora"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-libtheora">14.1 libtheora</a></h2>
-
-<p>libtheora Theora encoder wrapper.
-</p>
-<p>Requires the presence of the libtheora headers and library during
-configuration. You need to explicitly configure the build with
-<code>--enable-libtheora</code>.
-</p>
-<p>For more informations about the libtheora project see
-<a href="http://www.theora.org/">http://www.theora.org/</a>.
-</p>
-<a name="Options-19"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-19">14.1.1 Options</a></h3>
-
-<p>The following global options are mapped to internal libtheora options
-which affect the quality and the bitrate of the encoded stream.
-</p>
-<dl compact="compact">
-<dt> ‘<samp>b</samp>’</dt>
-<dd><p>Set the video bitrate in bit/s for CBR (Constant Bit Rate) mode. In
-case VBR (Variable Bit Rate) mode is enabled this option is ignored.
-</p>
-</dd>
-<dt> ‘<samp>flags</samp>’</dt>
-<dd><p>Used to enable constant quality mode (VBR) encoding through the
-‘<samp>qscale</samp>’ flag, and to enable the <code>pass1</code> and <code>pass2</code>
-modes.
-</p>
-</dd>
-<dt> ‘<samp>g</samp>’</dt>
-<dd><p>Set the GOP size.
-</p>
-</dd>
-<dt> ‘<samp>global_quality</samp>’</dt>
-<dd><p>Set the global quality as an integer in lambda units.
-</p>
-<p>Only relevant when VBR mode is enabled with <code>flags +qscale</code>. The
-value is converted to QP units by dividing it by <code>FF_QP2LAMBDA</code>,
-clipped in the [0 - 10] range, and then multiplied by 6.3 to get a
-value in the native libtheora range [0-63]. A higher value corresponds
-to a higher quality.
-</p>
-</dd>
-<dt> ‘<samp>q</samp>’</dt>
-<dd><p>Enable VBR mode when set to a non-negative value, and set constant
-quality value as a double floating point value in QP units.
-</p>
-<p>The value is clipped in the [0-10] range, and then multiplied by 6.3
-to get a value in the native libtheora range [0-63].
-</p>
-<p>This option is valid only using the <code>ffmpeg</code> command-line
-tool. For library interface users, use ‘<samp>global_quality</samp>’.
-</p></dd>
-</dl>
-
-<a name="Examples-28"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-28">14.1.2 Examples</a></h3>
-
-<ul>
-<li>
-Set maximum constant quality (VBR) encoding with <code>ffmpeg</code>:
-<table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT -codec:v libtheora -q:v 10 OUTPUT.ogg
-</pre></td></tr></table>
-
-</li><li>
-Use <code>ffmpeg</code> to convert a CBR 1000 kbps Theora video stream:
-<table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT -codec:v libtheora -b:v 1000k OUTPUT.ogg
-</pre></td></tr></table>
-</li></ul>
-
-<a name="libvpx"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-libvpx">14.2 libvpx</a></h2>
-
-<p>VP8 format supported through libvpx.
-</p>
-<p>Requires the presence of the libvpx headers and library during configuration.
-You need to explicitly configure the build with <code>--enable-libvpx</code>.
-</p>
-<a name="Options-1"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-1">14.2.1 Options</a></h3>
-
-<p>Mapping from FFmpeg to libvpx options with conversion notes in parentheses.
-</p>
-<dl compact="compact">
-<dt> ‘<samp>threads</samp>’</dt>
-<dd><p>g_threads
-</p>
-</dd>
-<dt> ‘<samp>profile</samp>’</dt>
-<dd><p>g_profile
-</p>
-</dd>
-<dt> ‘<samp>vb</samp>’</dt>
-<dd><p>rc_target_bitrate
-</p>
-</dd>
-<dt> ‘<samp>g</samp>’</dt>
-<dd><p>kf_max_dist
-</p>
-</dd>
-<dt> ‘<samp>keyint_min</samp>’</dt>
-<dd><p>kf_min_dist
-</p>
-</dd>
-<dt> ‘<samp>qmin</samp>’</dt>
-<dd><p>rc_min_quantizer
-</p>
-</dd>
-<dt> ‘<samp>qmax</samp>’</dt>
-<dd><p>rc_max_quantizer
-</p>
-</dd>
-<dt> ‘<samp>bufsize, vb</samp>’</dt>
-<dd><p>rc_buf_sz
-<code>(bufsize * 1000 / vb)</code>
-</p>
-<p>rc_buf_optimal_sz
-<code>(bufsize * 1000 / vb * 5 / 6)</code>
-</p>
-</dd>
-<dt> ‘<samp>rc_init_occupancy, vb</samp>’</dt>
-<dd><p>rc_buf_initial_sz
-<code>(rc_init_occupancy * 1000 / vb)</code>
-</p>
-</dd>
-<dt> ‘<samp>rc_buffer_aggressivity</samp>’</dt>
-<dd><p>rc_undershoot_pct
-</p>
-</dd>
-<dt> ‘<samp>skip_threshold</samp>’</dt>
-<dd><p>rc_dropframe_thresh
-</p>
-</dd>
-<dt> ‘<samp>qcomp</samp>’</dt>
-<dd><p>rc_2pass_vbr_bias_pct
-</p>
-</dd>
-<dt> ‘<samp>maxrate, vb</samp>’</dt>
-<dd><p>rc_2pass_vbr_maxsection_pct
-<code>(maxrate * 100 / vb)</code>
-</p>
-</dd>
-<dt> ‘<samp>minrate, vb</samp>’</dt>
-<dd><p>rc_2pass_vbr_minsection_pct
-<code>(minrate * 100 / vb)</code>
-</p>
-</dd>
-<dt> ‘<samp>minrate, maxrate, vb</samp>’</dt>
-<dd><p><code>VPX_CBR</code>
-<code>(minrate == maxrate == vb)</code>
-</p>
-</dd>
-<dt> ‘<samp>crf</samp>’</dt>
-<dd><p><code>VPX_CQ</code>, <code>VP8E_SET_CQ_LEVEL</code>
-</p>
-</dd>
-<dt> ‘<samp>quality</samp>’</dt>
-<dd><dl compact="compact">
-<dt> ‘<samp><var>best</var></samp>’</dt>
-<dd><p><code>VPX_DL_BEST_QUALITY</code>
-</p></dd>
-<dt> ‘<samp><var>good</var></samp>’</dt>
-<dd><p><code>VPX_DL_GOOD_QUALITY</code>
-</p></dd>
-<dt> ‘<samp><var>realtime</var></samp>’</dt>
-<dd><p><code>VPX_DL_REALTIME</code>
-</p></dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>speed</samp>’</dt>
-<dd><p><code>VP8E_SET_CPUUSED</code>
-</p>
-</dd>
-<dt> ‘<samp>nr</samp>’</dt>
-<dd><p><code>VP8E_SET_NOISE_SENSITIVITY</code>
-</p>
-</dd>
-<dt> ‘<samp>mb_threshold</samp>’</dt>
-<dd><p><code>VP8E_SET_STATIC_THRESHOLD</code>
-</p>
-</dd>
-<dt> ‘<samp>slices</samp>’</dt>
-<dd><p><code>VP8E_SET_TOKEN_PARTITIONS</code>
-</p>
-</dd>
-<dt> ‘<samp>max-intra-rate</samp>’</dt>
-<dd><p><code>VP8E_SET_MAX_INTRA_BITRATE_PCT</code>
-</p>
-</dd>
-<dt> ‘<samp>force_key_frames</samp>’</dt>
-<dd><p><code>VPX_EFLAG_FORCE_KF</code>
-</p>
-</dd>
-<dt> ‘<samp>Alternate reference frame related</samp>’</dt>
-<dd><dl compact="compact">
-<dt> ‘<samp>vp8flags altref</samp>’</dt>
-<dd><p><code>VP8E_SET_ENABLEAUTOALTREF</code>
-</p></dd>
-<dt> ‘<samp><var>arnr_max_frames</var></samp>’</dt>
-<dd><p><code>VP8E_SET_ARNR_MAXFRAMES</code>
-</p></dd>
-<dt> ‘<samp><var>arnr_type</var></samp>’</dt>
-<dd><p><code>VP8E_SET_ARNR_TYPE</code>
-</p></dd>
-<dt> ‘<samp><var>arnr_strength</var></samp>’</dt>
-<dd><p><code>VP8E_SET_ARNR_STRENGTH</code>
-</p></dd>
-<dt> ‘<samp><var>rc_lookahead</var></samp>’</dt>
-<dd><p>g_lag_in_frames
-</p></dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>vp8flags error_resilient</samp>’</dt>
-<dd><p>g_error_resilient
-</p>
-</dd>
-</dl>
-
-<p>For more information about libvpx see:
-<a href="http://www.webmproject.org/">http://www.webmproject.org/</a>
-</p>
-<a name="libx264"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-libx264">14.3 libx264</a></h2>
-
-<p>x264 H.264/MPEG-4 AVC encoder wrapper.
-</p>
-<p>This encoder requires the presence of the libx264 headers and library
-during configuration. You need to explicitly configure the build with
-<code>--enable-libx264</code>.
-</p>
-<p>libx264 supports an impressive number of features, including 8x8 and
-4x4 adaptive spatial transform, adaptive B-frame placement, CAVLC/CABAC
-entropy coding, interlacing (MBAFF), lossless mode, psy optimizations
-for detail retention (adaptive quantization, psy-RD, psy-trellis).
-</p>
-<p>Many libx264 encoder options are mapped to FFmpeg global codec
-options, while unique encoder options are provided through private
-options. Additionally the ‘<samp>x264opts</samp>’ and ‘<samp>x264-params</samp>’
-private options allows to pass a list of key=value tuples as accepted
-by the libx264 <code>x264_param_parse</code> function.
-</p>
-<p>The x264 project website is at
-<a href="http://www.videolan.org/developers/x264.html">http://www.videolan.org/developers/x264.html</a>.
-</p>
-<a name="Options-10"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-10">14.3.1 Options</a></h3>
-
-<p>The following options are supported by the libx264 wrapper. The
-<code>x264</code>-equivalent options or values are listed in parentheses
-for easy migration.
-</p>
-<p>To reduce the duplication of documentation, only the private options
-and some others requiring special attention are documented here. For
-the documentation of the undocumented generic options, see
-<a href="#codec_002doptions">the Codec Options chapter</a>.
-</p>
-<p>To get a more accurate and extensive documentation of the libx264
-options, invoke the command <code>x264 --full-help</code> or consult
-the libx264 documentation.
-</p>
-<dl compact="compact">
-<dt> ‘<samp>b (<em>bitrate</em>)</samp>’</dt>
-<dd><p>Set bitrate in bits/s. Note that FFmpeg’s ‘<samp>b</samp>’ option is
-expressed in bits/s, while <code>x264</code>’s ‘<samp>bitrate</samp>’ is in
-kilobits/s.
-</p>
-</dd>
-<dt> ‘<samp>bf (<em>bframes</em>)</samp>’</dt>
-<dt> ‘<samp>g (<em>keyint</em>)</samp>’</dt>
-<dt> ‘<samp>qmax (<em>qpmax</em>)</samp>’</dt>
-<dt> ‘<samp>qmin (<em>qpmin</em>)</samp>’</dt>
-<dt> ‘<samp>qdiff (<em>qpstep</em>)</samp>’</dt>
-<dt> ‘<samp>qblur (<em>qblur</em>)</samp>’</dt>
-<dt> ‘<samp>qcomp (<em>qcomp</em>)</samp>’</dt>
-<dt> ‘<samp>refs (<em>ref</em>)</samp>’</dt>
-<dt> ‘<samp>sc_threshold (<em>scenecut</em>)</samp>’</dt>
-<dt> ‘<samp>trellis (<em>trellis</em>)</samp>’</dt>
-<dt> ‘<samp>nr (<em>nr</em>)</samp>’</dt>
-<dt> ‘<samp>me_range (<em>merange</em>)</samp>’</dt>
-<dt> ‘<samp>me_method (<em>me</em>)</samp>’</dt>
-<dd><p>Set motion estimation method. Possible values in the decreasing order
-of speed:
-</p>
-<dl compact="compact">
-<dt> ‘<samp>dia (<em>dia</em>)</samp>’</dt>
-<dt> ‘<samp>epzs (<em>dia</em>)</samp>’</dt>
-<dd><p>Diamond search with radius 1 (fastest). ‘<samp>epzs</samp>’ is an alias for
-‘<samp>dia</samp>’.
-</p></dd>
-<dt> ‘<samp>hex (<em>hex</em>)</samp>’</dt>
-<dd><p>Hexagonal search with radius 2.
-</p></dd>
-<dt> ‘<samp>umh (<em>umh</em>)</samp>’</dt>
-<dd><p>Uneven multi-hexagon search.
-</p></dd>
-<dt> ‘<samp>esa (<em>esa</em>)</samp>’</dt>
-<dd><p>Exhaustive search.
-</p></dd>
-<dt> ‘<samp>tesa (<em>tesa</em>)</samp>’</dt>
-<dd><p>Hadamard exhaustive search (slowest).
-</p></dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>subq (<em>subme</em>)</samp>’</dt>
-<dt> ‘<samp>b_strategy (<em>b-adapt</em>)</samp>’</dt>
-<dt> ‘<samp>keyint_min (<em>min-keyint</em>)</samp>’</dt>
-<dt> ‘<samp>coder</samp>’</dt>
-<dd><p>Set entropy encoder. Possible values:
-</p>
-<dl compact="compact">
-<dt> ‘<samp>ac</samp>’</dt>
-<dd><p>Enable CABAC.
-</p>
-</dd>
-<dt> ‘<samp>vlc</samp>’</dt>
-<dd><p>Enable CAVLC and disable CABAC. It generates the same effect as
-<code>x264</code>’s ‘<samp>--no-cabac</samp>’ option.
-</p></dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>cmp</samp>’</dt>
-<dd><p>Set full pixel motion estimation comparation algorithm. Possible values:
-</p>
-<dl compact="compact">
-<dt> ‘<samp>chroma</samp>’</dt>
-<dd><p>Enable chroma in motion estimation.
-</p>
-</dd>
-<dt> ‘<samp>sad</samp>’</dt>
-<dd><p>Ignore chroma in motion estimation. It generates the same effect as
-<code>x264</code>’s ‘<samp>--no-chroma-me</samp>’ option.
-</p></dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>threads (<em>threads</em>)</samp>’</dt>
-<dt> ‘<samp>thread_type</samp>’</dt>
-<dd><p>Set multithreading technique. Possible values:
-</p>
-<dl compact="compact">
-<dt> ‘<samp>slice</samp>’</dt>
-<dd><p>Slice-based multithreading. It generates the same effect as
-<code>x264</code>’s ‘<samp>--sliced-threads</samp>’ option.
-</p></dd>
-<dt> ‘<samp>frame</samp>’</dt>
-<dd><p>Frame-based multithreading.
-</p></dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>flags</samp>’</dt>
-<dd><p>Set encoding flags. It can be used to disable closed GOP and enable
-open GOP by setting it to <code>-cgop</code>. The result is similar to
-the behavior of <code>x264</code>’s ‘<samp>--open-gop</samp>’ option.
-</p>
-</dd>
-<dt> ‘<samp>rc_init_occupancy (<em>vbv-init</em>)</samp>’</dt>
-<dt> ‘<samp>preset (<em>preset</em>)</samp>’</dt>
-<dd><p>Set the encoding preset.
-</p>
-</dd>
-<dt> ‘<samp>tune (<em>tune</em>)</samp>’</dt>
-<dd><p>Set tuning of the encoding params.
-</p>
-</dd>
-<dt> ‘<samp>profile (<em>profile</em>)</samp>’</dt>
-<dd><p>Set profile restrictions.
-</p>
-</dd>
-<dt> ‘<samp>fastfirstpass</samp>’</dt>
-<dd><p>Enable fast settings when encoding first pass, when set to 1. When set
-to 0, it has the same effect of <code>x264</code>’s
-‘<samp>--slow-firstpass</samp>’ option.
-</p>
-</dd>
-<dt> ‘<samp>crf (<em>crf</em>)</samp>’</dt>
-<dd><p>Set the quality for constant quality mode.
-</p>
-</dd>
-<dt> ‘<samp>crf_max (<em>crf-max</em>)</samp>’</dt>
-<dd><p>In CRF mode, prevents VBV from lowering quality beyond this point.
-</p>
-</dd>
-<dt> ‘<samp>qp (<em>qp</em>)</samp>’</dt>
-<dd><p>Set constant quantization rate control method parameter.
-</p>
-</dd>
-<dt> ‘<samp>aq-mode (<em>aq-mode</em>)</samp>’</dt>
-<dd><p>Set AQ method. Possible values:
-</p>
-<dl compact="compact">
-<dt> ‘<samp>none (<em>0</em>)</samp>’</dt>
-<dd><p>Disabled.
-</p>
-</dd>
-<dt> ‘<samp>variance (<em>1</em>)</samp>’</dt>
-<dd><p>Variance AQ (complexity mask).
-</p>
-</dd>
-<dt> ‘<samp>autovariance (<em>2</em>)</samp>’</dt>
-<dd><p>Auto-variance AQ (experimental).
-</p></dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>aq-strength (<em>aq-strength</em>)</samp>’</dt>
-<dd><p>Set AQ strength, reduce blocking and blurring in flat and textured areas.
-</p>
-</dd>
-<dt> ‘<samp>psy</samp>’</dt>
-<dd><p>Use psychovisual optimizations when set to 1. When set to 0, it has the
-same effect as <code>x264</code>’s ‘<samp>--no-psy</samp>’ option.
-</p>
-</dd>
-<dt> ‘<samp>psy-rd (<em>psy-rd</em>)</samp>’</dt>
-<dd><p>Set strength of psychovisual optimization, in
-<var>psy-rd</var>:<var>psy-trellis</var> format.
-</p>
-</dd>
-<dt> ‘<samp>rc-lookahead (<em>rc-lookahead</em>)</samp>’</dt>
-<dd><p>Set number of frames to look ahead for frametype and ratecontrol.
-</p>
-</dd>
-<dt> ‘<samp>weightb</samp>’</dt>
-<dd><p>Enable weighted prediction for B-frames when set to 1. When set to 0,
-it has the same effect as <code>x264</code>’s ‘<samp>--no-weightb</samp>’ option.
-</p>
-</dd>
-<dt> ‘<samp>weightp (<em>weightp</em>)</samp>’</dt>
-<dd><p>Set weighted prediction method for P-frames. Possible values:
-</p>
-<dl compact="compact">
-<dt> ‘<samp>none (<em>0</em>)</samp>’</dt>
-<dd><p>Disabled
-</p></dd>
-<dt> ‘<samp>simple (<em>1</em>)</samp>’</dt>
-<dd><p>Enable only weighted refs
-</p></dd>
-<dt> ‘<samp>smart (<em>2</em>)</samp>’</dt>
-<dd><p>Enable both weighted refs and duplicates
-</p></dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>ssim (<em>ssim</em>)</samp>’</dt>
-<dd><p>Enable calculation and printing SSIM stats after the encoding.
-</p>
-</dd>
-<dt> ‘<samp>intra-refresh (<em>intra-refresh</em>)</samp>’</dt>
-<dd><p>Enable the use of Periodic Intra Refresh instead of IDR frames when set
-to 1.
-</p>
-</dd>
-<dt> ‘<samp>bluray-compat (<em>bluray-compat</em>)</samp>’</dt>
-<dd><p>Configure the encoder to be compatible with the bluray standard.
-It is a shorthand for setting "bluray-compat=1 force-cfr=1".
-</p>
-</dd>
-<dt> ‘<samp>b-bias (<em>b-bias</em>)</samp>’</dt>
-<dd><p>Set the influence on how often B-frames are used.
-</p>
-</dd>
-<dt> ‘<samp>b-pyramid (<em>b-pyramid</em>)</samp>’</dt>
-<dd><p>Set method for keeping of some B-frames as references. Possible values:
-</p>
-<dl compact="compact">
-<dt> ‘<samp>none (<em>none</em>)</samp>’</dt>
-<dd><p>Disabled.
-</p></dd>
-<dt> ‘<samp>strict (<em>strict</em>)</samp>’</dt>
-<dd><p>Strictly hierarchical pyramid.
-</p></dd>
-<dt> ‘<samp>normal (<em>normal</em>)</samp>’</dt>
-<dd><p>Non-strict (not Blu-ray compatible).
-</p></dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>mixed-refs</samp>’</dt>
-<dd><p>Enable the use of one reference per partition, as opposed to one
-reference per macroblock when set to 1. When set to 0, it has the
-same effect as <code>x264</code>’s ‘<samp>--no-mixed-refs</samp>’ option.
-</p>
-</dd>
-<dt> ‘<samp>8x8dct</samp>’</dt>
-<dd><p>Enable adaptive spatial transform (high profile 8x8 transform)
-when set to 1. When set to 0, it has the same effect as
-<code>x264</code>’s ‘<samp>--no-8x8dct</samp>’ option.
-</p>
-</dd>
-<dt> ‘<samp>fast-pskip</samp>’</dt>
-<dd><p>Enable early SKIP detection on P-frames when set to 1. When set
-to 0, it has the same effect as <code>x264</code>’s
-‘<samp>--no-fast-pskip</samp>’ option.
-</p>
-</dd>
-<dt> ‘<samp>aud (<em>aud</em>)</samp>’</dt>
-<dd><p>Enable use of access unit delimiters when set to 1.
-</p>
-</dd>
-<dt> ‘<samp>mbtree</samp>’</dt>
-<dd><p>Enable use macroblock tree ratecontrol when set to 1. When set
-to 0, it has the same effect as <code>x264</code>’s
-‘<samp>--no-mbtree</samp>’ option.
-</p>
-</dd>
-<dt> ‘<samp>deblock (<em>deblock</em>)</samp>’</dt>
-<dd><p>Set loop filter parameters, in <var>alpha</var>:<var>beta</var> form.
-</p>
-</dd>
-<dt> ‘<samp>cplxblur (<em>cplxblur</em>)</samp>’</dt>
-<dd><p>Set fluctuations reduction in QP (before curve compression).
-</p>
-</dd>
-<dt> ‘<samp>partitions (<em>partitions</em>)</samp>’</dt>
-<dd><p>Set partitions to consider as a comma-separated list of. Possible
-values in the list:
-</p>
-<dl compact="compact">
-<dt> ‘<samp>p8x8</samp>’</dt>
-<dd><p>8x8 P-frame partition.
-</p></dd>
-<dt> ‘<samp>p4x4</samp>’</dt>
-<dd><p>4x4 P-frame partition.
-</p></dd>
-<dt> ‘<samp>b8x8</samp>’</dt>
-<dd><p>4x4 B-frame partition.
-</p></dd>
-<dt> ‘<samp>i8x8</samp>’</dt>
-<dd><p>8x8 I-frame partition.
-</p></dd>
-<dt> ‘<samp>i4x4</samp>’</dt>
-<dd><p>4x4 I-frame partition.
-(Enabling ‘<samp>p4x4</samp>’ requires ‘<samp>p8x8</samp>’ to be enabled. Enabling
-‘<samp>i8x8</samp>’ requires adaptive spatial transform (‘<samp>8x8dct</samp>’
-option) to be enabled.)
-</p></dd>
-<dt> ‘<samp>none (<em>none</em>)</samp>’</dt>
-<dd><p>Do not consider any partitions.
-</p></dd>
-<dt> ‘<samp>all (<em>all</em>)</samp>’</dt>
-<dd><p>Consider every partition.
-</p></dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>direct-pred (<em>direct</em>)</samp>’</dt>
-<dd><p>Set direct MV prediction mode. Possible values:
-</p>
-<dl compact="compact">
-<dt> ‘<samp>none (<em>none</em>)</samp>’</dt>
-<dd><p>Disable MV prediction.
-</p></dd>
-<dt> ‘<samp>spatial (<em>spatial</em>)</samp>’</dt>
-<dd><p>Enable spatial predicting.
-</p></dd>
-<dt> ‘<samp>temporal (<em>temporal</em>)</samp>’</dt>
-<dd><p>Enable temporal predicting.
-</p></dd>
-<dt> ‘<samp>auto (<em>auto</em>)</samp>’</dt>
-<dd><p>Automatically decided.
-</p></dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>slice-max-size (<em>slice-max-size</em>)</samp>’</dt>
-<dd><p>Set the limit of the size of each slice in bytes. If not specified
-but RTP payload size (‘<samp>ps</samp>’) is specified, that is used.
-</p>
-</dd>
-<dt> ‘<samp>stats (<em>stats</em>)</samp>’</dt>
-<dd><p>Set the file name for multi-pass stats.
-</p>
-</dd>
-<dt> ‘<samp>nal-hrd (<em>nal-hrd</em>)</samp>’</dt>
-<dd><p>Set signal HRD information (requires ‘<samp>vbv-bufsize</samp>’ to be set).
-Possible values:
-</p>
-<dl compact="compact">
-<dt> ‘<samp>none (<em>none</em>)</samp>’</dt>
-<dd><p>Disable HRD information signaling.
-</p></dd>
-<dt> ‘<samp>vbr (<em>vbr</em>)</samp>’</dt>
-<dd><p>Variable bit rate.
-</p></dd>
-<dt> ‘<samp>cbr (<em>cbr</em>)</samp>’</dt>
-<dd><p>Constant bit rate (not allowed in MP4 container).
-</p></dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>x264opts (N.A.)</samp>’</dt>
-<dd><p>Set any x264 option, see <code>x264 --fullhelp</code> for a list.
-</p>
-<p>Argument is a list of <var>key</var>=<var>value</var> couples separated by
-":". In <var>filter</var> and <var>psy-rd</var> options that use ":" as a separator
-themselves, use "," instead. They accept it as well since long ago but this
-is kept undocumented for some reason.
-</p>
-<p>For example to specify libx264 encoding options with <code>ffmpeg</code>:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i foo.mpg -vcodec libx264 -x264opts keyint=123:min-keyint=20 -an out.mkv
-</pre></td></tr></table>
-
-</dd>
-<dt> ‘<samp>x264-params (N.A.)</samp>’</dt>
-<dd><p>Override the x264 configuration using a :-separated list of key=value
-parameters.
-</p>
-<p>This option is functionally the same as the ‘<samp>x264opts</samp>’, but is
-duplicated for compability with the Libav fork.
-</p>
-<p>For example to specify libx264 encoding options with <code>ffmpeg</code>:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT -c:v libx264 -x264-params level=30:bframes=0:weightp=0:\
-cabac=0:ref=1:vbv-maxrate=768:vbv-bufsize=2000:analyse=all:me=umh:\
-no-fast-pskip=1:subq=6:8x8dct=0:trellis=0 OUTPUT
-</pre></td></tr></table>
-</dd>
-</dl>
-
-<p>Encoding ffpresets for common usages are provided so they can be used with the
-general presets system (e.g. passing the ‘<samp>pre</samp>’ option).
-</p>
-<a name="libxvid"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-libxvid">14.4 libxvid</a></h2>
-
-<p>Xvid MPEG-4 Part 2 encoder wrapper.
-</p>
-<p>This encoder requires the presence of the libxvidcore headers and library
-during configuration. You need to explicitly configure the build with
-<code>--enable-libxvid --enable-gpl</code>.
-</p>
-<p>The native <code>mpeg4</code> encoder supports the MPEG-4 Part 2 format, so
-users can encode to this format without this library.
-</p>
-<a name="Options-14"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-14">14.4.1 Options</a></h3>
-
-<p>The following options are supported by the libxvid wrapper. Some of
-the following options are listed but are not documented, and
-correspond to shared codec options. See <a href="#codec_002doptions">the Codec Options chapter</a> for their documentation. The other shared options
-which are not listed have no effect for the libxvid encoder.
-</p>
-<dl compact="compact">
-<dt> ‘<samp>b</samp>’</dt>
-<dt> ‘<samp>g</samp>’</dt>
-<dt> ‘<samp>qmin</samp>’</dt>
-<dt> ‘<samp>qmax</samp>’</dt>
-<dt> ‘<samp>mpeg_quant</samp>’</dt>
-<dt> ‘<samp>threads</samp>’</dt>
-<dt> ‘<samp>bf</samp>’</dt>
-<dt> ‘<samp>b_qfactor</samp>’</dt>
-<dt> ‘<samp>b_qoffset</samp>’</dt>
-<dt> ‘<samp>flags</samp>’</dt>
-<dd><p>Set specific encoding flags. Possible values:
-</p>
-<dl compact="compact">
-<dt> ‘<samp>mv4</samp>’</dt>
-<dd><p>Use four motion vector by macroblock.
-</p>
-</dd>
-<dt> ‘<samp>aic</samp>’</dt>
-<dd><p>Enable high quality AC prediction.
-</p>
-</dd>
-<dt> ‘<samp>gray</samp>’</dt>
-<dd><p>Only encode grayscale.
-</p>
-</dd>
-<dt> ‘<samp>gmc</samp>’</dt>
-<dd><p>Enable the use of global motion compensation (GMC).
-</p>
-</dd>
-<dt> ‘<samp>qpel</samp>’</dt>
-<dd><p>Enable quarter-pixel motion compensation.
-</p>
-</dd>
-<dt> ‘<samp>cgop</samp>’</dt>
-<dd><p>Enable closed GOP.
-</p>
-</dd>
-<dt> ‘<samp>global_header</samp>’</dt>
-<dd><p>Place global headers in extradata instead of every keyframe.
-</p>
-</dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>trellis</samp>’</dt>
-<dt> ‘<samp>me_method</samp>’</dt>
-<dd><p>Set motion estimation method. Possible values in decreasing order of
-speed and increasing order of quality:
-</p>
-<dl compact="compact">
-<dt> ‘<samp>zero</samp>’</dt>
-<dd><p>Use no motion estimation (default).
-</p>
-</dd>
-<dt> ‘<samp>phods</samp>’</dt>
-<dt> ‘<samp>x1</samp>’</dt>
-<dt> ‘<samp>log</samp>’</dt>
-<dd><p>Enable advanced diamond zonal search for 16x16 blocks and half-pixel
-refinement for 16x16 blocks. ‘<samp>x1</samp>’ and ‘<samp>log</samp>’ are aliases for
-‘<samp>phods</samp>’.
-</p>
-</dd>
-<dt> ‘<samp>epzs</samp>’</dt>
-<dd><p>Enable all of the things described above, plus advanced diamond zonal
-search for 8x8 blocks, half-pixel refinement for 8x8 blocks, and motion
-estimation on chroma planes.
-</p>
-</dd>
-<dt> ‘<samp>full</samp>’</dt>
-<dd><p>Enable all of the things described above, plus extended 16x16 and 8x8
-blocks search.
-</p></dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>mbd</samp>’</dt>
-<dd><p>Set macroblock decision algorithm. Possible values in the increasing
-order of quality:
-</p>
-<dl compact="compact">
-<dt> ‘<samp>simple</samp>’</dt>
-<dd><p>Use macroblock comparing function algorithm (default).
-</p>
-</dd>
-<dt> ‘<samp>bits</samp>’</dt>
-<dd><p>Enable rate distortion-based half pixel and quarter pixel refinement for
-16x16 blocks.
-</p>
-</dd>
-<dt> ‘<samp>rd</samp>’</dt>
-<dd><p>Enable all of the things described above, plus rate distortion-based
-half pixel and quarter pixel refinement for 8x8 blocks, and rate
-distortion-based search using square pattern.
-</p></dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>lumi_aq</samp>’</dt>
-<dd><p>Enable lumi masking adaptive quantization when set to 1. Default is 0
-(disabled).
-</p>
-</dd>
-<dt> ‘<samp>variance_aq</samp>’</dt>
-<dd><p>Enable variance adaptive quantization when set to 1. Default is 0
-(disabled).
-</p>
-<p>When combined with ‘<samp>lumi_aq</samp>’, the resulting quality will not
-be better than any of the two specified individually. In other
-words, the resulting quality will be the worse one of the two
-effects.
-</p>
-</dd>
-<dt> ‘<samp>ssim</samp>’</dt>
-<dd><p>Set structural similarity (SSIM) displaying method. Possible values:
-</p>
-<dl compact="compact">
-<dt> ‘<samp>off</samp>’</dt>
-<dd><p>Disable displaying of SSIM information.
-</p>
-</dd>
-<dt> ‘<samp>avg</samp>’</dt>
-<dd><p>Output average SSIM at the end of encoding to stdout. The format of
-showing the average SSIM is:
-</p>
-<table><tr><td> </td><td><pre class="example">Average SSIM: %f
-</pre></td></tr></table>
-
-<p>For users who are not familiar with C, %f means a float number, or
-a decimal (e.g. 0.939232).
-</p>
-</dd>
-<dt> ‘<samp>frame</samp>’</dt>
-<dd><p>Output both per-frame SSIM data during encoding and average SSIM at
-the end of encoding to stdout. The format of per-frame information
-is:
-</p>
-<table><tr><td> </td><td><pre class="example"> SSIM: avg: %1.3f min: %1.3f max: %1.3f
-</pre></td></tr></table>
-
-<p>For users who are not familiar with C, %1.3f means a float number
-rounded to 3 digits after the dot (e.g. 0.932).
-</p>
-</dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>ssim_acc</samp>’</dt>
-<dd><p>Set SSIM accuracy. Valid options are integers within the range of
-0-4, while 0 gives the most accurate result and 4 computes the
-fastest.
-</p>
-</dd>
-</dl>
-
-<a name="png"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-png">14.5 png</a></h2>
-
-<p>PNG image encoder.
-</p>
-<a name="Private-options"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Private-options">14.5.1 Private options</a></h3>
-
-<dl compact="compact">
-<dt> ‘<samp>dpi <var>integer</var></samp>’</dt>
-<dd><p>Set physical density of pixels, in dots per inch, unset by default
-</p></dd>
-<dt> ‘<samp>dpm <var>integer</var></samp>’</dt>
-<dd><p>Set physical density of pixels, in dots per meter, unset by default
-</p></dd>
-</dl>
-
-<a name="ProRes"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-ProRes">14.6 ProRes</a></h2>
-
-<p>Apple ProRes encoder.
-</p>
-<p>FFmpeg contains 2 ProRes encoders, the prores-aw and prores-ks encoder.
-The used encoder can be choosen with the <code>-vcodec</code> option.
-</p>
-<a name="Private-Options-for-prores_002dks"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Private-Options-for-prores_002dks">14.6.1 Private Options for prores-ks</a></h3>
-
-<dl compact="compact">
-<dt> ‘<samp>profile <var>integer</var></samp>’</dt>
-<dd><p>Select the ProRes profile to encode
-</p><dl compact="compact">
-<dt> ‘<samp>proxy</samp>’</dt>
-<dt> ‘<samp>lt</samp>’</dt>
-<dt> ‘<samp>standard</samp>’</dt>
-<dt> ‘<samp>hq</samp>’</dt>
-<dt> ‘<samp>4444</samp>’</dt>
-</dl>
-
-</dd>
-<dt> ‘<samp>quant_mat <var>integer</var></samp>’</dt>
-<dd><p>Select quantization matrix.
-</p><dl compact="compact">
-<dt> ‘<samp>auto</samp>’</dt>
-<dt> ‘<samp>default</samp>’</dt>
-<dt> ‘<samp>proxy</samp>’</dt>
-<dt> ‘<samp>lt</samp>’</dt>
-<dt> ‘<samp>standard</samp>’</dt>
-<dt> ‘<samp>hq</samp>’</dt>
-</dl>
-<p>If set to <var>auto</var>, the matrix matching the profile will be picked.
-If not set, the matrix providing the highest quality, <var>default</var>, will be
-picked.
-</p>
-</dd>
-<dt> ‘<samp>bits_per_mb <var>integer</var></samp>’</dt>
-<dd><p>How many bits to allot for coding one macroblock. Different profiles use
-between 200 and 2400 bits per macroblock, the maximum is 8000.
-</p>
-</dd>
-<dt> ‘<samp>mbs_per_slice <var>integer</var></samp>’</dt>
-<dd><p>Number of macroblocks in each slice (1-8); the default value (8)
-should be good in almost all situations.
-</p>
-</dd>
-<dt> ‘<samp>vendor <var>string</var></samp>’</dt>
-<dd><p>Override the 4-byte vendor ID.
-A custom vendor ID like <var>apl0</var> would claim the stream was produced by
-the Apple encoder.
-</p>
-</dd>
-<dt> ‘<samp>alpha_bits <var>integer</var></samp>’</dt>
-<dd><p>Specify number of bits for alpha component.
-Possible values are <var>0</var>, <var>8</var> and <var>16</var>.
-Use <var>0</var> to disable alpha plane coding.
-</p>
-</dd>
-</dl>
-
-<a name="Speed-considerations"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Speed-considerations">14.6.2 Speed considerations</a></h3>
-
-<p>In the default mode of operation the encoder has to honor frame constraints
-(i.e. not produc frames with size bigger than requested) while still making
-output picture as good as possible.
-A frame containing a lot of small details is harder to compress and the encoder
-would spend more time searching for appropriate quantizers for each slice.
-</p>
-<p>Setting a higher ‘<samp>bits_per_mb</samp>’ limit will improve the speed.
-</p>
-<p>For the fastest encoding speed set the ‘<samp>qscale</samp>’ parameter (4 is the
-recommended value) and do not set a size constraint.
-</p>
-<a name="Bitstream-Filters"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-Bitstream-Filters">15. Bitstream Filters</a></h1>
-
-<p>When you configure your FFmpeg build, all the supported bitstream
-filters are enabled by default. You can list all available ones using
-the configure option <code>--list-bsfs</code>.
-</p>
-<p>You can disable all the bitstream filters using the configure option
-<code>--disable-bsfs</code>, and selectively enable any bitstream filter using
-the option <code>--enable-bsf=BSF</code>, or you can disable a particular
-bitstream filter using the option <code>--disable-bsf=BSF</code>.
-</p>
-<p>The option <code>-bsfs</code> of the ff* tools will display the list of
-all the supported bitstream filters included in your build.
-</p>
-<p>Below is a description of the currently available bitstream filters.
-</p>
-<a name="aac_005fadtstoasc"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-aac_005fadtstoasc">15.1 aac_adtstoasc</a></h2>
-
-<p>Convert MPEG-2/4 AAC ADTS to MPEG-4 Audio Specific Configuration
-bitstream filter.
-</p>
-<p>This filter creates an MPEG-4 AudioSpecificConfig from an MPEG-2/4
-ADTS header and removes the ADTS header.
-</p>
-<p>This is required for example when copying an AAC stream from a raw
-ADTS AAC container to a FLV or a MOV/MP4 file.
-</p>
-<a name="chomp"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-chomp">15.2 chomp</a></h2>
-
-<p>Remove zero padding at the end of a packet.
-</p>
-<a name="dump_005fextra"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-dump_005fextra">15.3 dump_extra</a></h2>
-
-<p>Add extradata to the beginning of the filtered packets.
-</p>
-<p>The additional argument specifies which packets should be filtered.
-It accepts the values:
-</p><dl compact="compact">
-<dt> ‘<samp>a</samp>’</dt>
-<dd><p>add extradata to all key packets, but only if <var>local_header</var> is
-set in the ‘<samp>flags2</samp>’ codec context field
-</p>
-</dd>
-<dt> ‘<samp>k</samp>’</dt>
-<dd><p>add extradata to all key packets
-</p>
-</dd>
-<dt> ‘<samp>e</samp>’</dt>
-<dd><p>add extradata to all packets
-</p></dd>
-</dl>
-
-<p>If not specified it is assumed ‘<samp>k</samp>’.
-</p>
-<p>For example the following <code>ffmpeg</code> command forces a global
-header (thus disabling individual packet headers) in the H.264 packets
-generated by the <code>libx264</code> encoder, but corrects them by adding
-the header stored in extradata to the key packets:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT -map 0 -flags:v +global_header -c:v libx264 -bsf:v dump_extra out.ts
-</pre></td></tr></table>
-
-<a name="h264_005fmp4toannexb"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-h264_005fmp4toannexb">15.4 h264_mp4toannexb</a></h2>
-
-<p>Convert an H.264 bitstream from length prefixed mode to start code
-prefixed mode (as defined in the Annex B of the ITU-T H.264
-specification).
-</p>
-<p>This is required by some streaming formats, typically the MPEG-2
-transport stream format ("mpegts").
-</p>
-<p>For example to remux an MP4 file containing an H.264 stream to mpegts
-format with <code>ffmpeg</code>, you can use the command:
-</p>
-<table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT.mp4 -codec copy -bsf:v h264_mp4toannexb OUTPUT.ts
-</pre></td></tr></table>
-
-<a name="imx_005fdump_005fheader"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-imx_005fdump_005fheader">15.5 imx_dump_header</a></h2>
-
-<a name="mjpeg2jpeg"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-mjpeg2jpeg">15.6 mjpeg2jpeg</a></h2>
-
-<p>Convert MJPEG/AVI1 packets to full JPEG/JFIF packets.
-</p>
-<p>MJPEG is a video codec wherein each video frame is essentially a
-JPEG image. The individual frames can be extracted without loss,
-e.g. by
-</p>
-<table><tr><td> </td><td><pre class="example">ffmpeg -i ../some_mjpeg.avi -c:v copy frames_%d.jpg
-</pre></td></tr></table>
-
-<p>Unfortunately, these chunks are incomplete JPEG images, because
-they lack the DHT segment required for decoding. Quoting from
-<a href="http://www.digitalpreservation.gov/formats/fdd/fdd000063.shtml">http://www.digitalpreservation.gov/formats/fdd/fdd000063.shtml</a>:
-</p>
-<p>Avery Lee, writing in the rec.video.desktop newsgroup in 2001,
-commented that "MJPEG, or at least the MJPEG in AVIs having the
-MJPG fourcc, is restricted JPEG with a fixed – and *omitted* –
-Huffman table. The JPEG must be YCbCr colorspace, it must be 4:2:2,
-and it must use basic Huffman encoding, not arithmetic or
-progressive. . . . You can indeed extract the MJPEG frames and
-decode them with a regular JPEG decoder, but you have to prepend
-the DHT segment to them, or else the decoder won’t have any idea
-how to decompress the data. The exact table necessary is given in
-the OpenDML spec."
-</p>
-<p>This bitstream filter patches the header of frames extracted from an MJPEG
-stream (carrying the AVI1 header ID and lacking a DHT segment) to
-produce fully qualified JPEG images.
-</p>
-<table><tr><td> </td><td><pre class="example">ffmpeg -i mjpeg-movie.avi -c:v copy -bsf:v mjpeg2jpeg frame_%d.jpg
-exiftran -i -9 frame*.jpg
-ffmpeg -i frame_%d.jpg -c:v copy rotated.avi
-</pre></td></tr></table>
-
-<a name="mjpega_005fdump_005fheader"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-mjpega_005fdump_005fheader">15.7 mjpega_dump_header</a></h2>
-
-<a name="movsub"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-movsub">15.8 movsub</a></h2>
-
-<a name="mp3_005fheader_005fdecompress"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-mp3_005fheader_005fdecompress">15.9 mp3_header_decompress</a></h2>
-
-<a name="noise-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-noise-1">15.10 noise</a></h2>
-
-<a name="remove_005fextra"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-remove_005fextra">15.11 remove_extra</a></h2>
-
-<a name="Format-Options"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-Format-Options">16. Format Options</a></h1>
-
-<p>The libavformat library provides some generic global options, which
-can be set on all the muxers and demuxers. In addition each muxer or
-demuxer may support so-called private options, which are specific for
-that component.
-</p>
-<p>Options may be set by specifying -<var>option</var> <var>value</var> in the
-FFmpeg tools, or by setting the value explicitly in the
-<code>AVFormatContext</code> options or using the ‘<tt>libavutil/opt.h</tt>’ API
-for programmatic use.
-</p>
-<p>The list of supported options follows:
-</p>
-<dl compact="compact">
-<dt> ‘<samp>avioflags <var>flags</var> (<em>input/output</em>)</samp>’</dt>
-<dd><p>Possible values:
-</p><dl compact="compact">
-<dt> ‘<samp>direct</samp>’</dt>
-<dd><p>Reduce buffering.
-</p></dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>probesize <var>integer</var> (<em>input</em>)</samp>’</dt>
-<dd><p>Set probing size in bytes, i.e. the size of the data to analyze to get
-stream information. A higher value will allow to detect more
-information in case it is dispersed into the stream, but will increase
-latency. Must be an integer not lesser than 32. It is 5000000 by default.
-</p>
-</dd>
-<dt> ‘<samp>packetsize <var>integer</var> (<em>output</em>)</samp>’</dt>
-<dd><p>Set packet size.
-</p>
-</dd>
-<dt> ‘<samp>fflags <var>flags</var> (<em>input/output</em>)</samp>’</dt>
-<dd><p>Set format flags.
-</p>
-<p>Possible values:
-</p><dl compact="compact">
-<dt> ‘<samp>ignidx</samp>’</dt>
-<dd><p>Ignore index.
-</p></dd>
-<dt> ‘<samp>genpts</samp>’</dt>
-<dd><p>Generate PTS.
-</p></dd>
-<dt> ‘<samp>nofillin</samp>’</dt>
-<dd><p>Do not fill in missing values that can be exactly calculated.
-</p></dd>
-<dt> ‘<samp>noparse</samp>’</dt>
-<dd><p>Disable AVParsers, this needs <code>+nofillin</code> too.
-</p></dd>
-<dt> ‘<samp>igndts</samp>’</dt>
-<dd><p>Ignore DTS.
-</p></dd>
-<dt> ‘<samp>discardcorrupt</samp>’</dt>
-<dd><p>Discard corrupted frames.
-</p></dd>
-<dt> ‘<samp>sortdts</samp>’</dt>
-<dd><p>Try to interleave output packets by DTS.
-</p></dd>
-<dt> ‘<samp>keepside</samp>’</dt>
-<dd><p>Do not merge side data.
-</p></dd>
-<dt> ‘<samp>latm</samp>’</dt>
-<dd><p>Enable RTP MP4A-LATM payload.
-</p></dd>
-<dt> ‘<samp>nobuffer</samp>’</dt>
-<dd><p>Reduce the latency introduced by optional buffering
-</p></dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>seek2any <var>integer</var> (<em>input</em>)</samp>’</dt>
-<dd><p>Allow seeking to non-keyframes on demuxer level when supported if set to 1.
-Default is 0.
-</p>
-</dd>
-<dt> ‘<samp>analyzeduration <var>integer</var> (<em>input</em>)</samp>’</dt>
-<dd><p>Specify how many microseconds are analyzed to probe the input. A
-higher value will allow to detect more accurate information, but will
-increase latency. It defaults to 5,000,000 microseconds = 5 seconds.
-</p>
-</dd>
-<dt> ‘<samp>cryptokey <var>hexadecimal string</var> (<em>input</em>)</samp>’</dt>
-<dd><p>Set decryption key.
-</p>
-</dd>
-<dt> ‘<samp>indexmem <var>integer</var> (<em>input</em>)</samp>’</dt>
-<dd><p>Set max memory used for timestamp index (per stream).
-</p>
-</dd>
-<dt> ‘<samp>rtbufsize <var>integer</var> (<em>input</em>)</samp>’</dt>
-<dd><p>Set max memory used for buffering real-time frames.
-</p>
-</dd>
-<dt> ‘<samp>fdebug <var>flags</var> (<em>input/output</em>)</samp>’</dt>
-<dd><p>Print specific debug info.
-</p>
-<p>Possible values:
-</p><dl compact="compact">
-<dt> ‘<samp>ts</samp>’</dt>
-</dl>
-
-</dd>
-<dt> ‘<samp>max_delay <var>integer</var> (<em>input/output</em>)</samp>’</dt>
-<dd><p>Set maximum muxing or demuxing delay in microseconds.
-</p>
-</dd>
-<dt> ‘<samp>fpsprobesize <var>integer</var> (<em>input</em>)</samp>’</dt>
-<dd><p>Set number of frames used to probe fps.
-</p>
-</dd>
-<dt> ‘<samp>audio_preload <var>integer</var> (<em>output</em>)</samp>’</dt>
-<dd><p>Set microseconds by which audio packets should be interleaved earlier.
-</p>
-</dd>
-<dt> ‘<samp>chunk_duration <var>integer</var> (<em>output</em>)</samp>’</dt>
-<dd><p>Set microseconds for each chunk.
-</p>
-</dd>
-<dt> ‘<samp>chunk_size <var>integer</var> (<em>output</em>)</samp>’</dt>
-<dd><p>Set size in bytes for each chunk.
-</p>
-</dd>
-<dt> ‘<samp>err_detect, f_err_detect <var>flags</var> (<em>input</em>)</samp>’</dt>
-<dd><p>Set error detection flags. <code>f_err_detect</code> is deprecated and
-should be used only via the <code>ffmpeg</code> tool.
-</p>
-<p>Possible values:
-</p><dl compact="compact">
-<dt> ‘<samp>crccheck</samp>’</dt>
-<dd><p>Verify embedded CRCs.
-</p></dd>
-<dt> ‘<samp>bitstream</samp>’</dt>
-<dd><p>Detect bitstream specification deviations.
-</p></dd>
-<dt> ‘<samp>buffer</samp>’</dt>
-<dd><p>Detect improper bitstream length.
-</p></dd>
-<dt> ‘<samp>explode</samp>’</dt>
-<dd><p>Abort decoding on minor error detection.
-</p></dd>
-<dt> ‘<samp>careful</samp>’</dt>
-<dd><p>Consider things that violate the spec and have not been seen in the
-wild as errors.
-</p></dd>
-<dt> ‘<samp>compliant</samp>’</dt>
-<dd><p>Consider all spec non compliancies as errors.
-</p></dd>
-<dt> ‘<samp>aggressive</samp>’</dt>
-<dd><p>Consider things that a sane encoder should not do as an error.
-</p></dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>use_wallclock_as_timestamps <var>integer</var> (<em>input</em>)</samp>’</dt>
-<dd><p>Use wallclock as timestamps.
-</p>
-</dd>
-<dt> ‘<samp>avoid_negative_ts <var>integer</var> (<em>output</em>)</samp>’</dt>
-<dd><p>Shift timestamps to make them non-negative. A value of 1 enables shifting,
-a value of 0 disables it, the default value of -1 enables shifting
-when required by the target format.
-</p>
-<p>When shifting is enabled, all output timestamps are shifted by the
-same amount. Audio, video, and subtitles desynching and relative
-timestamp differences are preserved compared to how they would have
-been without shifting.
-</p>
-<p>Also note that this affects only leading negative timestamps, and not
-non-monotonic negative timestamps.
-</p>
-</dd>
-<dt> ‘<samp>skip_initial_bytes <var>integer</var> (<em>input</em>)</samp>’</dt>
-<dd><p>Set number of bytes to skip before reading header and frames if set to 1.
-Default is 0.
-</p>
-</dd>
-<dt> ‘<samp>correct_ts_overflow <var>integer</var> (<em>input</em>)</samp>’</dt>
-<dd><p>Correct single timestamp overflows if set to 1. Default is 1.
-</p>
-</dd>
-<dt> ‘<samp>flush_packets <var>integer</var> (<em>output</em>)</samp>’</dt>
-<dd><p>Flush the underlying I/O stream after each packet. Default 1 enables it, and
-has the effect of reducing the latency; 0 disables it and may slightly
-increase performance in some cases.
-</p></dd>
-</dl>
-
-
-<p><a name="Format-stream-specifiers"></a>
-</p><a name="Format-stream-specifiers-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-Format-stream-specifiers-1">16.1 Format stream specifiers</a></h2>
-
-<p>Format stream specifiers allow selection of one or more streams that
-match specific properties.
-</p>
-<p>Possible forms of stream specifiers are:
-</p><dl compact="compact">
-<dt> ‘<samp><var>stream_index</var></samp>’</dt>
-<dd><p>Matches the stream with this index.
-</p>
-</dd>
-<dt> ‘<samp><var>stream_type</var>[:<var>stream_index</var>]</samp>’</dt>
-<dd><p><var>stream_type</var> is one of following: ’v’ for video, ’a’ for audio,
-’s’ for subtitle, ’d’ for data, and ’t’ for attachments. If
-<var>stream_index</var> is given, then it matches the stream number
-<var>stream_index</var> of this type. Otherwise, it matches all streams of
-this type.
-</p>
-</dd>
-<dt> ‘<samp>p:<var>program_id</var>[:<var>stream_index</var>]</samp>’</dt>
-<dd><p>If <var>stream_index</var> is given, then it matches the stream with number
-<var>stream_index</var> in the program with the id
-<var>program_id</var>. Otherwise, it matches all streams in the program.
-</p>
-</dd>
-<dt> ‘<samp>#<var>stream_id</var></samp>’</dt>
-<dd><p>Matches the stream by a format-specific ID.
-</p></dd>
-</dl>
-
-<p>The exact semantics of stream specifiers is defined by the
-<code>avformat_match_stream_specifier()</code> function declared in the
-‘<tt>libavformat/avformat.h</tt>’ header.
-</p>
-<a name="Demuxers"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-Demuxers">17. Demuxers</a></h1>
-
-<p>Demuxers are configured elements in FFmpeg that can read the
-multimedia streams from a particular type of file.
-</p>
-<p>When you configure your FFmpeg build, all the supported demuxers
-are enabled by default. You can list all available ones using the
-configure option <code>--list-demuxers</code>.
-</p>
-<p>You can disable all the demuxers using the configure option
-<code>--disable-demuxers</code>, and selectively enable a single demuxer with
-the option <code>--enable-demuxer=<var>DEMUXER</var></code>, or disable it
-with the option <code>--disable-demuxer=<var>DEMUXER</var></code>.
-</p>
-<p>The option <code>-formats</code> of the ff* tools will display the list of
-enabled demuxers.
-</p>
-<p>The description of some of the currently available demuxers follows.
-</p>
-<a name="applehttp"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-applehttp">17.1 applehttp</a></h2>
-
-<p>Apple HTTP Live Streaming demuxer.
-</p>
-<p>This demuxer presents all AVStreams from all variant streams.
-The id field is set to the bitrate variant index number. By setting
-the discard flags on AVStreams (by pressing ’a’ or ’v’ in ffplay),
-the caller can decide which variant streams to actually receive.
-The total bitrate of the variant that the stream belongs to is
-available in a metadata key named "variant_bitrate".
-</p>
-<a name="asf"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-asf">17.2 asf</a></h2>
-
-<p>Advanced Systems Format demuxer.
-</p>
-<p>This demuxer is used to demux ASF files and MMS network streams.
-</p>
-<dl compact="compact">
-<dt> ‘<samp>-no_resync_search <var>bool</var></samp>’</dt>
-<dd><p>Do not try to resynchronize by looking for a certain optional start code.
-</p></dd>
-</dl>
-
-<p><a name="concat"></a>
-</p><a name="concat-3"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-concat-3">17.3 concat</a></h2>
-
-<p>Virtual concatenation script demuxer.
-</p>
-<p>This demuxer reads a list of files and other directives from a text file and
-demuxes them one after the other, as if all their packet had been muxed
-together.
-</p>
-<p>The timestamps in the files are adjusted so that the first file starts at 0
-and each next file starts where the previous one finishes. Note that it is
-done globally and may cause gaps if all streams do not have exactly the same
-length.
-</p>
-<p>All files must have the same streams (same codecs, same time base, etc.).
-</p>
-<p>The duration of each file is used to adjust the timestamps of the next file:
-if the duration is incorrect (because it was computed using the bit-rate or
-because the file is truncated, for example), it can cause artifacts. The
-<code>duration</code> directive can be used to override the duration stored in
-each file.
-</p>
-<a name="Syntax-1"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Syntax-1">17.3.1 Syntax</a></h3>
-
-<p>The script is a text file in extended-ASCII, with one directive per line.
-Empty lines, leading spaces and lines starting with ’#’ are ignored. The
-following directive is recognized:
-</p>
-<dl compact="compact">
-<dt> ‘<samp><code>file <var>path</var></code></samp>’</dt>
-<dd><p>Path to a file to read; special characters and spaces must be escaped with
-backslash or single quotes.
-</p>
-<p>All subsequent directives apply to that file.
-</p>
-</dd>
-<dt> ‘<samp><code>ffconcat version 1.0</code></samp>’</dt>
-<dd><p>Identify the script type and version. It also sets the ‘<samp>safe</samp>’ option
-to 1 if it was to its default -1.
-</p>
-<p>To make FFmpeg recognize the format automatically, this directive must
-appears exactly as is (no extra space or byte-order-mark) on the very first
-line of the script.
-</p>
-</dd>
-<dt> ‘<samp><code>duration <var>dur</var></code></samp>’</dt>
-<dd><p>Duration of the file. This information can be specified from the file;
-specifying it here may be more efficient or help if the information from the
-file is not available or accurate.
-</p>
-<p>If the duration is set for all files, then it is possible to seek in the
-whole concatenated video.
-</p>
-</dd>
-</dl>
-
-<a name="Options-13"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-13">17.3.2 Options</a></h3>
-
-<p>This demuxer accepts the following option:
-</p>
-<dl compact="compact">
-<dt> ‘<samp>safe</samp>’</dt>
-<dd><p>If set to 1, reject unsafe file paths. A file path is considered safe if it
-does not contain a protocol specification and is relative and all components
-only contain characters from the portable character set (letters, digits,
-period, underscore and hyphen) and have no period at the beginning of a
-component.
-</p>
-<p>If set to 0, any file name is accepted.
-</p>
-<p>The default is -1, it is equivalent to 1 if the format was automatically
-probed and 0 otherwise.
-</p>
-</dd>
-</dl>
-
-<a name="flv"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-flv">17.4 flv</a></h2>
-
-<p>Adobe Flash Video Format demuxer.
-</p>
-<p>This demuxer is used to demux FLV files and RTMP network streams.
-</p>
-<dl compact="compact">
-<dt> ‘<samp>-flv_metadata <var>bool</var></samp>’</dt>
-<dd><p>Allocate the streams according to the onMetaData array content.
-</p></dd>
-</dl>
-
-<a name="libgme"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-libgme">17.5 libgme</a></h2>
-
-<p>The Game Music Emu library is a collection of video game music file emulators.
-</p>
-<p>See <a href="http://code.google.com/p/game-music-emu/">http://code.google.com/p/game-music-emu/</a> for more information.
-</p>
-<p>Some files have multiple tracks. The demuxer will pick the first track by
-default. The ‘<samp>track_index</samp>’ option can be used to select a different
-track. Track indexes start at 0. The demuxer exports the number of tracks as
-<var>tracks</var> meta data entry.
-</p>
-<p>For very large files, the ‘<samp>max_size</samp>’ option may have to be adjusted.
-</p>
-<a name="libquvi"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-libquvi">17.6 libquvi</a></h2>
-
-<p>Play media from Internet services using the quvi project.
-</p>
-<p>The demuxer accepts a ‘<samp>format</samp>’ option to request a specific quality. It
-is by default set to <var>best</var>.
-</p>
-<p>See <a href="http://quvi.sourceforge.net/">http://quvi.sourceforge.net/</a> for more information.
-</p>
-<p>FFmpeg needs to be built with <code>--enable-libquvi</code> for this demuxer to be
-enabled.
-</p>
-<a name="image2-2"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-image2-2">17.7 image2</a></h2>
-
-<p>Image file demuxer.
-</p>
-<p>This demuxer reads from a list of image files specified by a pattern.
-The syntax and meaning of the pattern is specified by the
-option <var>pattern_type</var>.
-</p>
-<p>The pattern may contain a suffix which is used to automatically
-determine the format of the images contained in the files.
-</p>
-<p>The size, the pixel format, and the format of each image must be the
-same for all the files in the sequence.
-</p>
-<p>This demuxer accepts the following options:
-</p><dl compact="compact">
-<dt> ‘<samp>framerate</samp>’</dt>
-<dd><p>Set the frame rate for the video stream. It defaults to 25.
-</p></dd>
-<dt> ‘<samp>loop</samp>’</dt>
-<dd><p>If set to 1, loop over the input. Default value is 0.
-</p></dd>
-<dt> ‘<samp>pattern_type</samp>’</dt>
-<dd><p>Select the pattern type used to interpret the provided filename.
-</p>
-<p><var>pattern_type</var> accepts one of the following values.
-</p><dl compact="compact">
-<dt> ‘<samp>sequence</samp>’</dt>
-<dd><p>Select a sequence pattern type, used to specify a sequence of files
-indexed by sequential numbers.
-</p>
-<p>A sequence pattern may contain the string "%d" or "%0<var>N</var>d", which
-specifies the position of the characters representing a sequential
-number in each filename matched by the pattern. If the form
-"%d0<var>N</var>d" is used, the string representing the number in each
-filename is 0-padded and <var>N</var> is the total number of 0-padded
-digits representing the number. The literal character ’%’ can be
-specified in the pattern with the string "%%".
-</p>
-<p>If the sequence pattern contains "%d" or "%0<var>N</var>d", the first filename of
-the file list specified by the pattern must contain a number
-inclusively contained between <var>start_number</var> and
-<var>start_number</var>+<var>start_number_range</var>-1, and all the following
-numbers must be sequential.
-</p>
-<p>For example the pattern "img-%03d.bmp" will match a sequence of
-filenames of the form ‘<tt>img-001.bmp</tt>’, ‘<tt>img-002.bmp</tt>’, ...,
-‘<tt>img-010.bmp</tt>’, etc.; the pattern "i%%m%%g-%d.jpg" will match a
-sequence of filenames of the form ‘<tt>i%m%g-1.jpg</tt>’,
-‘<tt>i%m%g-2.jpg</tt>’, ..., ‘<tt>i%m%g-10.jpg</tt>’, etc.
-</p>
-<p>Note that the pattern must not necessarily contain "%d" or
-"%0<var>N</var>d", for example to convert a single image file
-‘<tt>img.jpeg</tt>’ you can employ the command:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i img.jpeg img.png
-</pre></td></tr></table>
-
-</dd>
-<dt> ‘<samp>glob</samp>’</dt>
-<dd><p>Select a glob wildcard pattern type.
-</p>
-<p>The pattern is interpreted like a <code>glob()</code> pattern. This is only
-selectable if libavformat was compiled with globbing support.
-</p>
-</dd>
-<dt> ‘<samp>glob_sequence <em>(deprecated, will be removed)</em></samp>’</dt>
-<dd><p>Select a mixed glob wildcard/sequence pattern.
-</p>
-<p>If your version of libavformat was compiled with globbing support, and
-the provided pattern contains at least one glob meta character among
-<code>%*?[]{}</code> that is preceded by an unescaped "%", the pattern is
-interpreted like a <code>glob()</code> pattern, otherwise it is interpreted
-like a sequence pattern.
-</p>
-<p>All glob special characters <code>%*?[]{}</code> must be prefixed
-with "%". To escape a literal "%" you shall use "%%".
-</p>
-<p>For example the pattern <code>foo-%*.jpeg</code> will match all the
-filenames prefixed by "foo-" and terminating with ".jpeg", and
-<code>foo-%?%?%?.jpeg</code> will match all the filenames prefixed with
-"foo-", followed by a sequence of three characters, and terminating
-with ".jpeg".
-</p>
-<p>This pattern type is deprecated in favor of <var>glob</var> and
-<var>sequence</var>.
-</p></dd>
-</dl>
-
-<p>Default value is <var>glob_sequence</var>.
-</p></dd>
-<dt> ‘<samp>pixel_format</samp>’</dt>
-<dd><p>Set the pixel format of the images to read. If not specified the pixel
-format is guessed from the first image file in the sequence.
-</p></dd>
-<dt> ‘<samp>start_number</samp>’</dt>
-<dd><p>Set the index of the file matched by the image file pattern to start
-to read from. Default value is 0.
-</p></dd>
-<dt> ‘<samp>start_number_range</samp>’</dt>
-<dd><p>Set the index interval range to check when looking for the first image
-file in the sequence, starting from <var>start_number</var>. Default value
-is 5.
-</p></dd>
-<dt> ‘<samp>ts_from_file</samp>’</dt>
-<dd><p>If set to 1, will set frame timestamp to modification time of image file. Note
-that monotonity of timestamps is not provided: images go in the same order as
-without this option. Default value is 0.
-</p></dd>
-<dt> ‘<samp>video_size</samp>’</dt>
-<dd><p>Set the video size of the images to read. If not specified the video
-size is guessed from the first image file in the sequence.
-</p></dd>
-</dl>
-
-<a name="Examples-88"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-88">17.7.1 Examples</a></h3>
-
-<ul>
-<li>
-Use <code>ffmpeg</code> for creating a video from the images in the file
-sequence ‘<tt>img-001.jpeg</tt>’, ‘<tt>img-002.jpeg</tt>’, ..., assuming an
-input frame rate of 10 frames per second:
-<table><tr><td> </td><td><pre class="example">ffmpeg -framerate 10 -i 'img-%03d.jpeg' out.mkv
-</pre></td></tr></table>
-
-</li><li>
-As above, but start by reading from a file with index 100 in the sequence:
-<table><tr><td> </td><td><pre class="example">ffmpeg -framerate 10 -start_number 100 -i 'img-%03d.jpeg' out.mkv
-</pre></td></tr></table>
-
-</li><li>
-Read images matching the "*.png" glob pattern , that is all the files
-terminating with the ".png" suffix:
-<table><tr><td> </td><td><pre class="example">ffmpeg -framerate 10 -pattern_type glob -i "*.png" out.mkv
-</pre></td></tr></table>
-</li></ul>
-
-<a name="mpegts-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-mpegts-1">17.8 mpegts</a></h2>
-
-<p>MPEG-2 transport stream demuxer.
-</p>
-<dl compact="compact">
-<dt> ‘<samp>fix_teletext_pts</samp>’</dt>
-<dd><p>Overrides teletext packet PTS and DTS values with the timestamps calculated
-from the PCR of the first program which the teletext stream is part of and is
-not discarded. Default value is 1, set this option to 0 if you want your
-teletext packet PTS and DTS values untouched.
-</p></dd>
-</dl>
-
-<a name="rawvideo"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-rawvideo">17.9 rawvideo</a></h2>
-
-<p>Raw video demuxer.
-</p>
-<p>This demuxer allows to read raw video data. Since there is no header
-specifying the assumed video parameters, the user must specify them
-in order to be able to decode the data correctly.
-</p>
-<p>This demuxer accepts the following options:
-</p><dl compact="compact">
-<dt> ‘<samp>framerate</samp>’</dt>
-<dd><p>Set input video frame rate. Default value is 25.
-</p>
-</dd>
-<dt> ‘<samp>pixel_format</samp>’</dt>
-<dd><p>Set the input video pixel format. Default value is <code>yuv420p</code>.
-</p>
-</dd>
-<dt> ‘<samp>video_size</samp>’</dt>
-<dd><p>Set the input video size. This value must be specified explicitly.
-</p></dd>
-</dl>
-
-<p>For example to read a rawvideo file ‘<tt>input.raw</tt>’ with
-<code>ffplay</code>, assuming a pixel format of <code>rgb24</code>, a video
-size of <code>320x240</code>, and a frame rate of 10 images per second, use
-the command:
-</p><table><tr><td> </td><td><pre class="example">ffplay -f rawvideo -pixel_format rgb24 -video_size 320x240 -framerate 10 input.raw
-</pre></td></tr></table>
-
-<a name="sbg"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-sbg">17.10 sbg</a></h2>
-
-<p>SBaGen script demuxer.
-</p>
-<p>This demuxer reads the script language used by SBaGen
-<a href="http://uazu.net/sbagen/">http://uazu.net/sbagen/</a> to generate binaural beats sessions. A SBG
-script looks like that:
-</p><table><tr><td> </td><td><pre class="example">-SE
-a: 300-2.5/3 440+4.5/0
-b: 300-2.5/0 440+4.5/3
-off: -
-NOW == a
-+0:07:00 == b
-+0:14:00 == a
-+0:21:00 == b
-+0:30:00 off
-</pre></td></tr></table>
-
-<p>A SBG script can mix absolute and relative timestamps. If the script uses
-either only absolute timestamps (including the script start time) or only
-relative ones, then its layout is fixed, and the conversion is
-straightforward. On the other hand, if the script mixes both kind of
-timestamps, then the <var>NOW</var> reference for relative timestamps will be
-taken from the current time of day at the time the script is read, and the
-script layout will be frozen according to that reference. That means that if
-the script is directly played, the actual times will match the absolute
-timestamps up to the sound controller’s clock accuracy, but if the user
-somehow pauses the playback or seeks, all times will be shifted accordingly.
-</p>
-<a name="tedcaptions"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-tedcaptions">17.11 tedcaptions</a></h2>
-
-<p>JSON captions used for <a href="http://www.ted.com/">TED Talks</a>.
-</p>
-<p>TED does not provide links to the captions, but they can be guessed from the
-page. The file ‘<tt>tools/bookmarklets.html</tt>’ from the FFmpeg source tree
-contains a bookmarklet to expose them.
-</p>
-<p>This demuxer accepts the following option:
-</p><dl compact="compact">
-<dt> ‘<samp>start_time</samp>’</dt>
-<dd><p>Set the start time of the TED talk, in milliseconds. The default is 15000
-(15s). It is used to sync the captions with the downloadable videos, because
-they include a 15s intro.
-</p></dd>
-</dl>
-
-<p>Example: convert the captions to a format most players understand:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i http://www.ted.com/talks/subtitles/id/1/lang/en talk1-en.srt
-</pre></td></tr></table>
-
-<a name="Muxers"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-Muxers">18. Muxers</a></h1>
-
-<p>Muxers are configured elements in FFmpeg which allow writing
-multimedia streams to a particular type of file.
-</p>
-<p>When you configure your FFmpeg build, all the supported muxers
-are enabled by default. You can list all available muxers using the
-configure option <code>--list-muxers</code>.
-</p>
-<p>You can disable all the muxers with the configure option
-<code>--disable-muxers</code> and selectively enable / disable single muxers
-with the options <code>--enable-muxer=<var>MUXER</var></code> /
-<code>--disable-muxer=<var>MUXER</var></code>.
-</p>
-<p>The option <code>-formats</code> of the ff* tools will display the list of
-enabled muxers.
-</p>
-<p>A description of some of the currently available muxers follows.
-</p>
-<p><a name="aiff"></a>
-</p><a name="aiff-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-aiff-1">18.1 aiff</a></h2>
-
-<p>Audio Interchange File Format muxer.
-</p>
-<p>It accepts the following options:
-</p>
-<dl compact="compact">
-<dt> ‘<samp>write_id3v2</samp>’</dt>
-<dd><p>Enable ID3v2 tags writing when set to 1. Default is 0 (disabled).
-</p>
-</dd>
-<dt> ‘<samp>id3v2_version</samp>’</dt>
-<dd><p>Select ID3v2 version to write. Currently only version 3 and 4 (aka.
-ID3v2.3 and ID3v2.4) are supported. The default is version 4.
-</p>
-</dd>
-</dl>
-
-<p><a name="crc"></a>
-</p><a name="crc-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-crc-1">18.2 crc</a></h2>
-
-<p>CRC (Cyclic Redundancy Check) testing format.
-</p>
-<p>This muxer computes and prints the Adler-32 CRC of all the input audio
-and video frames. By default audio frames are converted to signed
-16-bit raw audio and video frames to raw video before computing the
-CRC.
-</p>
-<p>The output of the muxer consists of a single line of the form:
-CRC=0x<var>CRC</var>, where <var>CRC</var> is a hexadecimal number 0-padded to
-8 digits containing the CRC for all the decoded input frames.
-</p>
-<p>For example to compute the CRC of the input, and store it in the file
-‘<tt>out.crc</tt>’:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT -f crc out.crc
-</pre></td></tr></table>
-
-<p>You can print the CRC to stdout with the command:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT -f crc -
-</pre></td></tr></table>
-
-<p>You can select the output format of each frame with <code>ffmpeg</code> by
-specifying the audio and video codec and format. For example to
-compute the CRC of the input audio converted to PCM unsigned 8-bit
-and the input video converted to MPEG-2 video, use the command:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT -c:a pcm_u8 -c:v mpeg2video -f crc -
-</pre></td></tr></table>
-
-<p>See also the <a href="#framecrc">framecrc</a> muxer.
-</p>
-<p><a name="framecrc"></a>
-</p><a name="framecrc-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-framecrc-1">18.3 framecrc</a></h2>
-
-<p>Per-packet CRC (Cyclic Redundancy Check) testing format.
-</p>
-<p>This muxer computes and prints the Adler-32 CRC for each audio
-and video packet. By default audio frames are converted to signed
-16-bit raw audio and video frames to raw video before computing the
-CRC.
-</p>
-<p>The output of the muxer consists of a line for each audio and video
-packet of the form:
-</p><table><tr><td> </td><td><pre class="example"><var>stream_index</var>, <var>packet_dts</var>, <var>packet_pts</var>, <var>packet_duration</var>, <var>packet_size</var>, 0x<var>CRC</var>
-</pre></td></tr></table>
-
-<p><var>CRC</var> is a hexadecimal number 0-padded to 8 digits containing the
-CRC of the packet.
-</p>
-<p>For example to compute the CRC of the audio and video frames in
-‘<tt>INPUT</tt>’, converted to raw audio and video packets, and store it
-in the file ‘<tt>out.crc</tt>’:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT -f framecrc out.crc
-</pre></td></tr></table>
-
-<p>To print the information to stdout, use the command:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT -f framecrc -
-</pre></td></tr></table>
-
-<p>With <code>ffmpeg</code>, you can select the output format to which the
-audio and video frames are encoded before computing the CRC for each
-packet by specifying the audio and video codec. For example, to
-compute the CRC of each decoded input audio frame converted to PCM
-unsigned 8-bit and of each decoded input video frame converted to
-MPEG-2 video, use the command:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT -c:a pcm_u8 -c:v mpeg2video -f framecrc -
-</pre></td></tr></table>
-
-<p>See also the <a href="#crc">crc</a> muxer.
-</p>
-<p><a name="framemd5"></a>
-</p><a name="framemd5-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-framemd5-1">18.4 framemd5</a></h2>
-
-<p>Per-packet MD5 testing format.
-</p>
-<p>This muxer computes and prints the MD5 hash for each audio
-and video packet. By default audio frames are converted to signed
-16-bit raw audio and video frames to raw video before computing the
-hash.
-</p>
-<p>The output of the muxer consists of a line for each audio and video
-packet of the form:
-</p><table><tr><td> </td><td><pre class="example"><var>stream_index</var>, <var>packet_dts</var>, <var>packet_pts</var>, <var>packet_duration</var>, <var>packet_size</var>, <var>MD5</var>
-</pre></td></tr></table>
-
-<p><var>MD5</var> is a hexadecimal number representing the computed MD5 hash
-for the packet.
-</p>
-<p>For example to compute the MD5 of the audio and video frames in
-‘<tt>INPUT</tt>’, converted to raw audio and video packets, and store it
-in the file ‘<tt>out.md5</tt>’:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT -f framemd5 out.md5
-</pre></td></tr></table>
-
-<p>To print the information to stdout, use the command:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT -f framemd5 -
-</pre></td></tr></table>
-
-<p>See also the <a href="#md5">md5</a> muxer.
-</p>
-<p><a name="gif"></a>
-</p><a name="gif-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-gif-1">18.5 gif</a></h2>
-
-<p>Animated GIF muxer.
-</p>
-<p>It accepts the following options:
-</p>
-<dl compact="compact">
-<dt> ‘<samp>loop</samp>’</dt>
-<dd><p>Set the number of times to loop the output. Use <code>-1</code> for no loop, <code>0</code>
-for looping indefinitely (default).
-</p>
-</dd>
-<dt> ‘<samp>final_delay</samp>’</dt>
-<dd><p>Force the delay (expressed in centiseconds) after the last frame. Each frame
-ends with a delay until the next frame. The default is <code>-1</code>, which is a
-special value to tell the muxer to re-use the previous delay. In case of a
-loop, you might want to customize this value to mark a pause for instance.
-</p></dd>
-</dl>
-
-<p>For example, to encode a gif looping 10 times, with a 5 seconds delay between
-the loops:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT -loop 10 -final_delay 500 out.gif
-</pre></td></tr></table>
-
-<p>Note 1: if you wish to extract the frames in separate GIF files, you need to
-force the <a href="#image2">image2</a> muxer:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT -c:v gif -f image2 "out%d.gif"
-</pre></td></tr></table>
-
-<p>Note 2: the GIF format has a very small time base: the delay between two frames
-can not be smaller than one centi second.
-</p>
-<p><a name="hls"></a>
-</p><a name="hls-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-hls-1">18.6 hls</a></h2>
-
-<p>Apple HTTP Live Streaming muxer that segments MPEG-TS according to
-the HTTP Live Streaming specification.
-</p>
-<p>It creates a playlist file and numbered segment files. The output
-filename specifies the playlist filename; the segment filenames
-receive the same basename as the playlist, a sequential number and
-a .ts extension.
-</p>
-<table><tr><td> </td><td><pre class="example">ffmpeg -i in.nut out.m3u8
-</pre></td></tr></table>
-
-<dl compact="compact">
-<dt> ‘<samp>-hls_time <var>seconds</var></samp>’</dt>
-<dd><p>Set the segment length in seconds.
-</p></dd>
-<dt> ‘<samp>-hls_list_size <var>size</var></samp>’</dt>
-<dd><p>Set the maximum number of playlist entries.
-</p></dd>
-<dt> ‘<samp>-hls_wrap <var>wrap</var></samp>’</dt>
-<dd><p>Set the number after which index wraps.
-</p></dd>
-<dt> ‘<samp>-start_number <var>number</var></samp>’</dt>
-<dd><p>Start the sequence from <var>number</var>.
-</p></dd>
-</dl>
-
-<p><a name="ico"></a>
-</p><a name="ico-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-ico-1">18.7 ico</a></h2>
-
-<p>ICO file muxer.
-</p>
-<p>Microsoft’s icon file format (ICO) has some strict limitations that should be noted:
-</p>
-<ul>
-<li>
-Size cannot exceed 256 pixels in any dimension
-
-</li><li>
-Only BMP and PNG images can be stored
-
-</li><li>
-If a BMP image is used, it must be one of the following pixel formats:
-<table><tr><td> </td><td><pre class="example">BMP Bit Depth FFmpeg Pixel Format
-1bit pal8
-4bit pal8
-8bit pal8
-16bit rgb555le
-24bit bgr24
-32bit bgra
-</pre></td></tr></table>
-
-</li><li>
-If a BMP image is used, it must use the BITMAPINFOHEADER DIB header
-
-</li><li>
-If a PNG image is used, it must use the rgba pixel format
-</li></ul>
-
-<p><a name="image2"></a>
-</p><a name="image2-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-image2-1">18.8 image2</a></h2>
-
-<p>Image file muxer.
-</p>
-<p>The image file muxer writes video frames to image files.
-</p>
-<p>The output filenames are specified by a pattern, which can be used to
-produce sequentially numbered series of files.
-The pattern may contain the string "%d" or "%0<var>N</var>d", this string
-specifies the position of the characters representing a numbering in
-the filenames. If the form "%0<var>N</var>d" is used, the string
-representing the number in each filename is 0-padded to <var>N</var>
-digits. The literal character ’%’ can be specified in the pattern with
-the string "%%".
-</p>
-<p>If the pattern contains "%d" or "%0<var>N</var>d", the first filename of
-the file list specified will contain the number 1, all the following
-numbers will be sequential.
-</p>
-<p>The pattern may contain a suffix which is used to automatically
-determine the format of the image files to write.
-</p>
-<p>For example the pattern "img-%03d.bmp" will specify a sequence of
-filenames of the form ‘<tt>img-001.bmp</tt>’, ‘<tt>img-002.bmp</tt>’, ...,
-‘<tt>img-010.bmp</tt>’, etc.
-The pattern "img%%-%d.jpg" will specify a sequence of filenames of the
-form ‘<tt>img%-1.jpg</tt>’, ‘<tt>img%-2.jpg</tt>’, ..., ‘<tt>img%-10.jpg</tt>’,
-etc.
-</p>
-<p>The following example shows how to use <code>ffmpeg</code> for creating a
-sequence of files ‘<tt>img-001.jpeg</tt>’, ‘<tt>img-002.jpeg</tt>’, ...,
-taking one image every second from the input video:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i in.avi -vsync 1 -r 1 -f image2 'img-%03d.jpeg'
-</pre></td></tr></table>
-
-<p>Note that with <code>ffmpeg</code>, if the format is not specified with the
-<code>-f</code> option and the output filename specifies an image file
-format, the image2 muxer is automatically selected, so the previous
-command can be written as:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i in.avi -vsync 1 -r 1 'img-%03d.jpeg'
-</pre></td></tr></table>
-
-<p>Note also that the pattern must not necessarily contain "%d" or
-"%0<var>N</var>d", for example to create a single image file
-‘<tt>img.jpeg</tt>’ from the input video you can employ the command:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i in.avi -f image2 -frames:v 1 img.jpeg
-</pre></td></tr></table>
-
-<dl compact="compact">
-<dt> ‘<samp>start_number <var>number</var></samp>’</dt>
-<dd><p>Start the sequence from <var>number</var>. Default value is 1. Must be a
-non-negative number.
-</p>
-</dd>
-<dt> ‘<samp>-update <var>number</var></samp>’</dt>
-<dd><p>If <var>number</var> is nonzero, the filename will always be interpreted as just a
-filename, not a pattern, and this file will be continuously overwritten with new
-images.
-</p>
-</dd>
-</dl>
-
-<p>The image muxer supports the .Y.U.V image file format. This format is
-special in that that each image frame consists of three files, for
-each of the YUV420P components. To read or write this image file format,
-specify the name of the ’.Y’ file. The muxer will automatically open the
-’.U’ and ’.V’ files as required.
-</p>
-<a name="matroska"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-matroska">18.9 matroska</a></h2>
-
-<p>Matroska container muxer.
-</p>
-<p>This muxer implements the matroska and webm container specs.
-</p>
-<p>The recognized metadata settings in this muxer are:
-</p>
-<dl compact="compact">
-<dt> ‘<samp>title=<var>title name</var></samp>’</dt>
-<dd><p>Name provided to a single track
-</p></dd>
-</dl>
-
-<dl compact="compact">
-<dt> ‘<samp>language=<var>language name</var></samp>’</dt>
-<dd><p>Specifies the language of the track in the Matroska languages form
-</p></dd>
-</dl>
-
-<dl compact="compact">
-<dt> ‘<samp>stereo_mode=<var>mode</var></samp>’</dt>
-<dd><p>Stereo 3D video layout of two views in a single video track
-</p><dl compact="compact">
-<dt> ‘<samp>mono</samp>’</dt>
-<dd><p>video is not stereo
-</p></dd>
-<dt> ‘<samp>left_right</samp>’</dt>
-<dd><p>Both views are arranged side by side, Left-eye view is on the left
-</p></dd>
-<dt> ‘<samp>bottom_top</samp>’</dt>
-<dd><p>Both views are arranged in top-bottom orientation, Left-eye view is at bottom
-</p></dd>
-<dt> ‘<samp>top_bottom</samp>’</dt>
-<dd><p>Both views are arranged in top-bottom orientation, Left-eye view is on top
-</p></dd>
-<dt> ‘<samp>checkerboard_rl</samp>’</dt>
-<dd><p>Each view is arranged in a checkerboard interleaved pattern, Left-eye view being first
-</p></dd>
-<dt> ‘<samp>checkerboard_lr</samp>’</dt>
-<dd><p>Each view is arranged in a checkerboard interleaved pattern, Right-eye view being first
-</p></dd>
-<dt> ‘<samp>row_interleaved_rl</samp>’</dt>
-<dd><p>Each view is constituted by a row based interleaving, Right-eye view is first row
-</p></dd>
-<dt> ‘<samp>row_interleaved_lr</samp>’</dt>
-<dd><p>Each view is constituted by a row based interleaving, Left-eye view is first row
-</p></dd>
-<dt> ‘<samp>col_interleaved_rl</samp>’</dt>
-<dd><p>Both views are arranged in a column based interleaving manner, Right-eye view is first column
-</p></dd>
-<dt> ‘<samp>col_interleaved_lr</samp>’</dt>
-<dd><p>Both views are arranged in a column based interleaving manner, Left-eye view is first column
-</p></dd>
-<dt> ‘<samp>anaglyph_cyan_red</samp>’</dt>
-<dd><p>All frames are in anaglyph format viewable through red-cyan filters
-</p></dd>
-<dt> ‘<samp>right_left</samp>’</dt>
-<dd><p>Both views are arranged side by side, Right-eye view is on the left
-</p></dd>
-<dt> ‘<samp>anaglyph_green_magenta</samp>’</dt>
-<dd><p>All frames are in anaglyph format viewable through green-magenta filters
-</p></dd>
-<dt> ‘<samp>block_lr</samp>’</dt>
-<dd><p>Both eyes laced in one Block, Left-eye view is first
-</p></dd>
-<dt> ‘<samp>block_rl</samp>’</dt>
-<dd><p>Both eyes laced in one Block, Right-eye view is first
-</p></dd>
-</dl>
-</dd>
-</dl>
-
-<p>For example a 3D WebM clip can be created using the following command line:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i sample_left_right_clip.mpg -an -c:v libvpx -metadata stereo_mode=left_right -y stereo_clip.webm
-</pre></td></tr></table>
-
-<p>This muxer supports the following options:
-</p>
-<dl compact="compact">
-<dt> ‘<samp>reserve_index_space</samp>’</dt>
-<dd><p>By default, this muxer writes the index for seeking (called cues in Matroska
-terms) at the end of the file, because it cannot know in advance how much space
-to leave for the index at the beginning of the file. However for some use cases
-– e.g. streaming where seeking is possible but slow – it is useful to put the
-index at the beginning of the file.
-</p>
-<p>If this option is set to a non-zero value, the muxer will reserve a given amount
-of space in the file header and then try to write the cues there when the muxing
-finishes. If the available space does not suffice, muxing will fail. A safe size
-for most use cases should be about 50kB per hour of video.
-</p>
-<p>Note that cues are only written if the output is seekable and this option will
-have no effect if it is not.
-</p>
-</dd>
-</dl>
-
-<p><a name="md5"></a>
-</p><a name="md5-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-md5-1">18.10 md5</a></h2>
-
-<p>MD5 testing format.
-</p>
-<p>This muxer computes and prints the MD5 hash of all the input audio
-and video frames. By default audio frames are converted to signed
-16-bit raw audio and video frames to raw video before computing the
-hash.
-</p>
-<p>The output of the muxer consists of a single line of the form:
-MD5=<var>MD5</var>, where <var>MD5</var> is a hexadecimal number representing
-the computed MD5 hash.
-</p>
-<p>For example to compute the MD5 hash of the input converted to raw
-audio and video, and store it in the file ‘<tt>out.md5</tt>’:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT -f md5 out.md5
-</pre></td></tr></table>
-
-<p>You can print the MD5 to stdout with the command:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT -f md5 -
-</pre></td></tr></table>
-
-<p>See also the <a href="#framemd5">framemd5</a> muxer.
-</p>
-<a name="mov_002fmp4_002fismv"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-mov_002fmp4_002fismv">18.11 mov/mp4/ismv</a></h2>
-
-<p>MOV/MP4/ISMV (Smooth Streaming) muxer.
-</p>
-<p>The mov/mp4/ismv muxer supports fragmentation. Normally, a MOV/MP4
-file has all the metadata about all packets stored in one location
-(written at the end of the file, it can be moved to the start for
-better playback by adding <var>faststart</var> to the <var>movflags</var>, or
-using the <code>qt-faststart</code> tool). A fragmented
-file consists of a number of fragments, where packets and metadata
-about these packets are stored together. Writing a fragmented
-file has the advantage that the file is decodable even if the
-writing is interrupted (while a normal MOV/MP4 is undecodable if
-it is not properly finished), and it requires less memory when writing
-very long files (since writing normal MOV/MP4 files stores info about
-every single packet in memory until the file is closed). The downside
-is that it is less compatible with other applications.
-</p>
-<p>Fragmentation is enabled by setting one of the AVOptions that define
-how to cut the file into fragments:
-</p>
-<dl compact="compact">
-<dt> ‘<samp>-moov_size <var>bytes</var></samp>’</dt>
-<dd><p>Reserves space for the moov atom at the beginning of the file instead of placing the
-moov atom at the end. If the space reserved is insufficient, muxing will fail.
-</p></dd>
-<dt> ‘<samp>-movflags frag_keyframe</samp>’</dt>
-<dd><p>Start a new fragment at each video keyframe.
-</p></dd>
-<dt> ‘<samp>-frag_duration <var>duration</var></samp>’</dt>
-<dd><p>Create fragments that are <var>duration</var> microseconds long.
-</p></dd>
-<dt> ‘<samp>-frag_size <var>size</var></samp>’</dt>
-<dd><p>Create fragments that contain up to <var>size</var> bytes of payload data.
-</p></dd>
-<dt> ‘<samp>-movflags frag_custom</samp>’</dt>
-<dd><p>Allow the caller to manually choose when to cut fragments, by
-calling <code>av_write_frame(ctx, NULL)</code> to write a fragment with
-the packets written so far. (This is only useful with other
-applications integrating libavformat, not from <code>ffmpeg</code>.)
-</p></dd>
-<dt> ‘<samp>-min_frag_duration <var>duration</var></samp>’</dt>
-<dd><p>Don’t create fragments that are shorter than <var>duration</var> microseconds long.
-</p></dd>
-</dl>
-
-<p>If more than one condition is specified, fragments are cut when
-one of the specified conditions is fulfilled. The exception to this is
-<code>-min_frag_duration</code>, which has to be fulfilled for any of the other
-conditions to apply.
+<dt> ‘<samp>flush_packets <var>integer</var> (<em>output</em>)</samp>’</dt>
+<dd><p>Flush the underlying I/O stream after each packet. Default 1 enables it, and
+has the effect of reducing the latency; 0 disables it and may slightly
+increase performance in some cases.
</p>
-<p>Additionally, the way the output file is written can be adjusted
-through a few other options:
+</dd>
+<dt> ‘<samp>output_ts_offset <var>offset</var> (<em>output</em>)</samp>’</dt>
+<dd><p>Set the output time offset.
</p>
-<dl compact="compact">
-<dt> ‘<samp>-movflags empty_moov</samp>’</dt>
-<dd><p>Write an initial moov atom directly at the start of the file, without
-describing any samples in it. Generally, an mdat/moov pair is written
-at the start of the file, as a normal MOV/MP4 file, containing only
-a short portion of the file. With this option set, there is no initial
-mdat atom, and the moov atom only describes the tracks but has
-a zero duration.
+<p><var>offset</var> must be a time duration specification,
+see <a href="ffmpeg-utils.html#time-duration-syntax">(ffmpeg-utils)time duration syntax</a>.
</p>
-<p>Files written with this option set do not work in QuickTime.
-This option is implicitly set when writing ismv (Smooth Streaming) files.
-</p></dd>
-<dt> ‘<samp>-movflags separate_moof</samp>’</dt>
-<dd><p>Write a separate moof (movie fragment) atom for each track. Normally,
-packets for all tracks are written in a moof atom (which is slightly
-more efficient), but with this option set, the muxer writes one moof/mdat
-pair for each track, making it easier to separate tracks.
+<p>The offset is added by the muxer to the output timestamps.
</p>
-<p>This option is implicitly set when writing ismv (Smooth Streaming) files.
-</p></dd>
-<dt> ‘<samp>-movflags faststart</samp>’</dt>
-<dd><p>Run a second pass moving the index (moov atom) to the beginning of the file.
-This operation can take a while, and will not work in various situations such
-as fragmented output, thus it is not enabled by default.
-</p></dd>
-<dt> ‘<samp>-movflags rtphint</samp>’</dt>
-<dd><p>Add RTP hinting tracks to the output file.
+<p>Specifying a positive offset means that the corresponding streams are
+delayed bt the time duration specified in <var>offset</var>. Default value
+is <code>0</code> (meaning that no offset is applied).
</p></dd>
</dl>
-<p>Smooth Streaming content can be pushed in real time to a publishing
-point on IIS with this muxer. Example:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -re <var><normal input/transcoding options></var> -movflags isml+frag_keyframe -f ismv http://server/publishingpoint.isml/Streams(Encoder1)
-</pre></td></tr></table>
-<a name="mp3"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-mp3">18.12 mp3</a></h2>
+<p><a name="Format-stream-specifiers"></a>
+</p><a name="Format-stream-specifiers-1"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-Format-stream-specifiers-1">13.1 Format stream specifiers</a></h2>
-<p>The MP3 muxer writes a raw MP3 stream with an ID3v2 header at the beginning and
-optionally an ID3v1 tag at the end. ID3v2.3 and ID3v2.4 are supported, the
-<code>id3v2_version</code> option controls which one is used. The legacy ID3v1 tag is
-not written by default, but may be enabled with the <code>write_id3v1</code> option.
-</p>
-<p>For seekable output the muxer also writes a Xing frame at the beginning, which
-contains the number of frames in the file. It is useful for computing duration
-of VBR files.
+<p>Format stream specifiers allow selection of one or more streams that
+match specific properties.
</p>
-<p>The muxer supports writing ID3v2 attached pictures (APIC frames). The pictures
-are supplied to the muxer in form of a video stream with a single packet. There
-can be any number of those streams, each will correspond to a single APIC frame.
-The stream metadata tags <var>title</var> and <var>comment</var> map to APIC
-<var>description</var> and <var>picture type</var> respectively. See
-<a href="http://id3.org/id3v2.4.0-frames">http://id3.org/id3v2.4.0-frames</a> for allowed picture types.
+<p>Possible forms of stream specifiers are:
+</p><dl compact="compact">
+<dt> ‘<samp><var>stream_index</var></samp>’</dt>
+<dd><p>Matches the stream with this index.
</p>
-<p>Note that the APIC frames must be written at the beginning, so the muxer will
-buffer the audio frames until it gets all the pictures. It is therefore advised
-to provide the pictures as soon as possible to avoid excessive buffering.
+</dd>
+<dt> ‘<samp><var>stream_type</var>[:<var>stream_index</var>]</samp>’</dt>
+<dd><p><var>stream_type</var> is one of following: ’v’ for video, ’a’ for audio,
+’s’ for subtitle, ’d’ for data, and ’t’ for attachments. If
+<var>stream_index</var> is given, then it matches the stream number
+<var>stream_index</var> of this type. Otherwise, it matches all streams of
+this type.
</p>
-<p>Examples:
+</dd>
+<dt> ‘<samp>p:<var>program_id</var>[:<var>stream_index</var>]</samp>’</dt>
+<dd><p>If <var>stream_index</var> is given, then it matches the stream with number
+<var>stream_index</var> in the program with the id
+<var>program_id</var>. Otherwise, it matches all streams in the program.
</p>
-<p>Write an mp3 with an ID3v2.3 header and an ID3v1 footer:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT -id3v2_version 3 -write_id3v1 1 out.mp3
-</pre></td></tr></table>
-
-<p>To attach a picture to an mp3 file select both the audio and the picture stream
-with <code>map</code>:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i input.mp3 -i cover.png -c copy -map 0 -map 1
--metadata:s:v title="Album cover" -metadata:s:v comment="Cover (Front)" out.mp3
-</pre></td></tr></table>
+</dd>
+<dt> ‘<samp>#<var>stream_id</var></samp>’</dt>
+<dd><p>Matches the stream by a format-specific ID.
+</p></dd>
+</dl>
-<a name="mpegts"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-mpegts">18.13 mpegts</a></h2>
+<p>The exact semantics of stream specifiers is defined by the
+<code>avformat_match_stream_specifier()</code> function declared in the
+‘<tt>libavformat/avformat.h</tt>’ header.
+</p>
+<a name="Demuxers"></a>
+<h1 class="chapter"><a href="ffplay-all.html#toc-Demuxers">14. Demuxers</a></h1>
-<p>MPEG transport stream muxer.
+<p>Demuxers are configured elements in FFmpeg that can read the
+multimedia streams from a particular type of file.
</p>
-<p>This muxer implements ISO 13818-1 and part of ETSI EN 300 468.
+<p>When you configure your FFmpeg build, all the supported demuxers
+are enabled by default. You can list all available ones using the
+configure option <code>--list-demuxers</code>.
</p>
-<p>The muxer options are:
+<p>You can disable all the demuxers using the configure option
+<code>--disable-demuxers</code>, and selectively enable a single demuxer with
+the option <code>--enable-demuxer=<var>DEMUXER</var></code>, or disable it
+with the option <code>--disable-demuxer=<var>DEMUXER</var></code>.
</p>
-<dl compact="compact">
-<dt> ‘<samp>-mpegts_original_network_id <var>number</var></samp>’</dt>
-<dd><p>Set the original_network_id (default 0x0001). This is unique identifier
-of a network in DVB. Its main use is in the unique identification of a
-service through the path Original_Network_ID, Transport_Stream_ID.
-</p></dd>
-<dt> ‘<samp>-mpegts_transport_stream_id <var>number</var></samp>’</dt>
-<dd><p>Set the transport_stream_id (default 0x0001). This identifies a
-transponder in DVB.
-</p></dd>
-<dt> ‘<samp>-mpegts_service_id <var>number</var></samp>’</dt>
-<dd><p>Set the service_id (default 0x0001) also known as program in DVB.
-</p></dd>
-<dt> ‘<samp>-mpegts_pmt_start_pid <var>number</var></samp>’</dt>
-<dd><p>Set the first PID for PMT (default 0x1000, max 0x1f00).
-</p></dd>
-<dt> ‘<samp>-mpegts_start_pid <var>number</var></samp>’</dt>
-<dd><p>Set the first PID for data packets (default 0x0100, max 0x0f00).
-</p></dd>
-<dt> ‘<samp>-mpegts_m2ts_mode <var>number</var></samp>’</dt>
-<dd><p>Enable m2ts mode if set to 1. Default value is -1 which disables m2ts mode.
-</p></dd>
-<dt> ‘<samp>-muxrate <var>number</var></samp>’</dt>
-<dd><p>Set muxrate.
-</p></dd>
-<dt> ‘<samp>-pes_payload_size <var>number</var></samp>’</dt>
-<dd><p>Set minimum PES packet payload in bytes.
-</p></dd>
-<dt> ‘<samp>-mpegts_flags <var>flags</var></samp>’</dt>
-<dd><p>Set flags (see below).
-</p></dd>
-<dt> ‘<samp>-mpegts_copyts <var>number</var></samp>’</dt>
-<dd><p>Preserve original timestamps, if value is set to 1. Default value is -1, which
-results in shifting timestamps so that they start from 0.
-</p></dd>
-<dt> ‘<samp>-tables_version <var>number</var></samp>’</dt>
-<dd><p>Set PAT, PMT and SDT version (default 0, valid values are from 0 to 31, inclusively).
-This option allows updating stream structure so that standard consumer may
-detect the change. To do so, reopen output AVFormatContext (in case of API
-usage) or restart ffmpeg instance, cyclically changing tables_version value:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i source1.ts -codec copy -f mpegts -tables_version 0 udp://1.1.1.1:1111
-ffmpeg -i source2.ts -codec copy -f mpegts -tables_version 1 udp://1.1.1.1:1111
-...
-ffmpeg -i source3.ts -codec copy -f mpegts -tables_version 31 udp://1.1.1.1:1111
-ffmpeg -i source1.ts -codec copy -f mpegts -tables_version 0 udp://1.1.1.1:1111
-ffmpeg -i source2.ts -codec copy -f mpegts -tables_version 1 udp://1.1.1.1:1111
-...
-</pre></td></tr></table>
-</dd>
-</dl>
-
-<p>Option mpegts_flags may take a set of such flags:
+<p>The option <code>-formats</code> of the ff* tools will display the list of
+enabled demuxers.
</p>
-<dl compact="compact">
-<dt> ‘<samp>resend_headers</samp>’</dt>
-<dd><p>Reemit PAT/PMT before writing the next packet.
-</p></dd>
-<dt> ‘<samp>latm</samp>’</dt>
-<dd><p>Use LATM packetization for AAC.
-</p></dd>
-</dl>
-
-<p>The recognized metadata settings in mpegts muxer are <code>service_provider</code>
-and <code>service_name</code>. If they are not set the default for
-<code>service_provider</code> is "FFmpeg" and the default for
-<code>service_name</code> is "Service01".
+<p>The description of some of the currently available demuxers follows.
</p>
-<table><tr><td> </td><td><pre class="example">ffmpeg -i file.mpg -c copy \
- -mpegts_original_network_id 0x1122 \
- -mpegts_transport_stream_id 0x3344 \
- -mpegts_service_id 0x5566 \
- -mpegts_pmt_start_pid 0x1500 \
- -mpegts_start_pid 0x150 \
- -metadata service_provider="Some provider" \
- -metadata service_name="Some Channel" \
- -y out.ts
-</pre></td></tr></table>
-
-<a name="null-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-null-1">18.14 null</a></h2>
+<a name="applehttp"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-applehttp">14.1 applehttp</a></h2>
-<p>Null muxer.
+<p>Apple HTTP Live Streaming demuxer.
</p>
-<p>This muxer does not generate any output file, it is mainly useful for
-testing or benchmarking purposes.
+<p>This demuxer presents all AVStreams from all variant streams.
+The id field is set to the bitrate variant index number. By setting
+the discard flags on AVStreams (by pressing ’a’ or ’v’ in ffplay),
+the caller can decide which variant streams to actually receive.
+The total bitrate of the variant that the stream belongs to is
+available in a metadata key named "variant_bitrate".
</p>
-<p>For example to benchmark decoding with <code>ffmpeg</code> you can use the
-command:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -benchmark -i INPUT -f null out.null
-</pre></td></tr></table>
+<a name="asf"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-asf">14.2 asf</a></h2>
-<p>Note that the above command does not read or write the ‘<tt>out.null</tt>’
-file, but specifying the output file is required by the <code>ffmpeg</code>
-syntax.
+<p>Advanced Systems Format demuxer.
</p>
-<p>Alternatively you can write the command as:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -benchmark -i INPUT -f null -
-</pre></td></tr></table>
-
-<a name="ogg"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-ogg">18.15 ogg</a></h2>
-
-<p>Ogg container muxer.
+<p>This demuxer is used to demux ASF files and MMS network streams.
</p>
<dl compact="compact">
-<dt> ‘<samp>-page_duration <var>duration</var></samp>’</dt>
-<dd><p>Preferred page duration, in microseconds. The muxer will attempt to create
-pages that are approximately <var>duration</var> microseconds long. This allows the
-user to compromise between seek granularity and container overhead. The default
-is 1 second. A value of 0 will fill all segments, making pages as large as
-possible. A value of 1 will effectively use 1 packet-per-page in most
-situations, giving a small seek granularity at the cost of additional container
-overhead.
+<dt> ‘<samp>-no_resync_search <var>bool</var></samp>’</dt>
+<dd><p>Do not try to resynchronize by looking for a certain optional start code.
</p></dd>
</dl>
-<a name="segment_002c-stream_005fsegment_002c-ssegment"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-segment_002c-stream_005fsegment_002c-ssegment">18.16 segment, stream_segment, ssegment</a></h2>
+<p><a name="concat"></a>
+</p><a name="concat-1"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-concat-1">14.3 concat</a></h2>
-<p>Basic stream segmenter.
-</p>
-<p>The segmenter muxer outputs streams to a number of separate files of nearly
-fixed duration. Output filename pattern can be set in a fashion similar to
-<a href="#image2">image2</a>.
-</p>
-<p><code>stream_segment</code> is a variant of the muxer used to write to
-streaming output formats, i.e. which do not require global headers,
-and is recommended for outputting e.g. to MPEG transport stream segments.
-<code>ssegment</code> is a shorter alias for <code>stream_segment</code>.
+<p>Virtual concatenation script demuxer.
</p>
-<p>Every segment starts with a keyframe of the selected reference stream,
-which is set through the ‘<samp>reference_stream</samp>’ option.
+<p>This demuxer reads a list of files and other directives from a text file and
+demuxes them one after the other, as if all their packet had been muxed
+together.
</p>
-<p>Note that if you want accurate splitting for a video file, you need to
-make the input key frames correspond to the exact splitting times
-expected by the segmenter, or the segment muxer will start the new
-segment with the key frame found next after the specified start
-time.
+<p>The timestamps in the files are adjusted so that the first file starts at 0
+and each next file starts where the previous one finishes. Note that it is
+done globally and may cause gaps if all streams do not have exactly the same
+length.
</p>
-<p>The segment muxer works best with a single constant frame rate video.
+<p>All files must have the same streams (same codecs, same time base, etc.).
</p>
-<p>Optionally it can generate a list of the created segments, by setting
-the option <var>segment_list</var>. The list type is specified by the
-<var>segment_list_type</var> option. The entry filenames in the segment
-list are set by default to the basename of the corresponding segment
-files.
+<p>The duration of each file is used to adjust the timestamps of the next file:
+if the duration is incorrect (because it was computed using the bit-rate or
+because the file is truncated, for example), it can cause artifacts. The
+<code>duration</code> directive can be used to override the duration stored in
+each file.
</p>
-<p>The segment muxer supports the following options:
+<a name="Syntax-1"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Syntax-1">14.3.1 Syntax</a></h3>
+
+<p>The script is a text file in extended-ASCII, with one directive per line.
+Empty lines, leading spaces and lines starting with ’#’ are ignored. The
+following directive is recognized:
</p>
<dl compact="compact">
-<dt> ‘<samp>reference_stream <var>specifier</var></samp>’</dt>
-<dd><p>Set the reference stream, as specified by the string <var>specifier</var>.
-If <var>specifier</var> is set to <code>auto</code>, the reference is choosen
-automatically. Otherwise it must be a stream specifier (see the “Stream
-specifiers” chapter in the ffmpeg manual) which specifies the
-reference stream. The default value is <code>auto</code>.
+<dt> ‘<samp><code>file <var>path</var></code></samp>’</dt>
+<dd><p>Path to a file to read; special characters and spaces must be escaped with
+backslash or single quotes.
</p>
-</dd>
-<dt> ‘<samp>segment_format <var>format</var></samp>’</dt>
-<dd><p>Override the inner container format, by default it is guessed by the filename
-extension.
+<p>All subsequent directives apply to that file.
</p>
</dd>
-<dt> ‘<samp>segment_list <var>name</var></samp>’</dt>
-<dd><p>Generate also a listfile named <var>name</var>. If not specified no
-listfile is generated.
+<dt> ‘<samp><code>ffconcat version 1.0</code></samp>’</dt>
+<dd><p>Identify the script type and version. It also sets the ‘<samp>safe</samp>’ option
+to 1 if it was to its default -1.
+</p>
+<p>To make FFmpeg recognize the format automatically, this directive must
+appears exactly as is (no extra space or byte-order-mark) on the very first
+line of the script.
</p>
</dd>
-<dt> ‘<samp>segment_list_flags <var>flags</var></samp>’</dt>
-<dd><p>Set flags affecting the segment list generation.
+<dt> ‘<samp><code>duration <var>dur</var></code></samp>’</dt>
+<dd><p>Duration of the file. This information can be specified from the file;
+specifying it here may be more efficient or help if the information from the
+file is not available or accurate.
</p>
-<p>It currently supports the following flags:
-</p><dl compact="compact">
-<dt> ‘<samp>cache</samp>’</dt>
-<dd><p>Allow caching (only affects M3U8 list files).
+<p>If the duration is set for all files, then it is possible to seek in the
+whole concatenated video.
</p>
</dd>
-<dt> ‘<samp>live</samp>’</dt>
-<dd><p>Allow live-friendly file generation.
-</p></dd>
</dl>
-</dd>
-<dt> ‘<samp>segment_list_size <var>size</var></samp>’</dt>
-<dd><p>Update the list file so that it contains at most the last <var>size</var>
-segments. If 0 the list file will contain all the segments. Default
-value is 0.
+<a name="Options-2"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Options-2">14.3.2 Options</a></h3>
+
+<p>This demuxer accepts the following option:
</p>
-</dd>
-<dt> ‘<samp>segment_list_entry_prefix <var>prefix</var></samp>’</dt>
-<dd><p>Set <var>prefix</var> to prepend to the name of each entry filename. By
-default no prefix is applied.
+<dl compact="compact">
+<dt> ‘<samp>safe</samp>’</dt>
+<dd><p>If set to 1, reject unsafe file paths. A file path is considered safe if it
+does not contain a protocol specification and is relative and all components
+only contain characters from the portable character set (letters, digits,
+period, underscore and hyphen) and have no period at the beginning of a
+component.
</p>
-</dd>
-<dt> ‘<samp>segment_list_type <var>type</var></samp>’</dt>
-<dd><p>Specify the format for the segment list file.
+<p>If set to 0, any file name is accepted.
</p>
-<p>The following values are recognized:
-</p><dl compact="compact">
-<dt> ‘<samp>flat</samp>’</dt>
-<dd><p>Generate a flat list for the created segments, one segment per line.
+<p>The default is -1, it is equivalent to 1 if the format was automatically
+probed and 0 otherwise.
</p>
</dd>
-<dt> ‘<samp>csv, ext</samp>’</dt>
-<dd><p>Generate a list for the created segments, one segment per line,
-each line matching the format (comma-separated values):
-</p><table><tr><td> </td><td><pre class="example"><var>segment_filename</var>,<var>segment_start_time</var>,<var>segment_end_time</var>
-</pre></td></tr></table>
+</dl>
-<p><var>segment_filename</var> is the name of the output file generated by the
-muxer according to the provided pattern. CSV escaping (according to
-RFC4180) is applied if required.
-</p>
-<p><var>segment_start_time</var> and <var>segment_end_time</var> specify
-the segment start and end time expressed in seconds.
+<a name="flv"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-flv">14.4 flv</a></h2>
+
+<p>Adobe Flash Video Format demuxer.
</p>
-<p>A list file with the suffix <code>".csv"</code> or <code>".ext"</code> will
-auto-select this format.
+<p>This demuxer is used to demux FLV files and RTMP network streams.
</p>
-<p>‘<samp>ext</samp>’ is deprecated in favor or ‘<samp>csv</samp>’.
+<dl compact="compact">
+<dt> ‘<samp>-flv_metadata <var>bool</var></samp>’</dt>
+<dd><p>Allocate the streams according to the onMetaData array content.
+</p></dd>
+</dl>
+
+<a name="libgme"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-libgme">14.5 libgme</a></h2>
+
+<p>The Game Music Emu library is a collection of video game music file emulators.
</p>
-</dd>
-<dt> ‘<samp>ffconcat</samp>’</dt>
-<dd><p>Generate an ffconcat file for the created segments. The resulting file
-can be read using the FFmpeg <a href="#concat">concat</a> demuxer.
+<p>See <a href="http://code.google.com/p/game-music-emu/">http://code.google.com/p/game-music-emu/</a> for more information.
</p>
-<p>A list file with the suffix <code>".ffcat"</code> or <code>".ffconcat"</code> will
-auto-select this format.
+<p>Some files have multiple tracks. The demuxer will pick the first track by
+default. The ‘<samp>track_index</samp>’ option can be used to select a different
+track. Track indexes start at 0. The demuxer exports the number of tracks as
+<var>tracks</var> meta data entry.
</p>
-</dd>
-<dt> ‘<samp>m3u8</samp>’</dt>
-<dd><p>Generate an extended M3U8 file, version 3, compliant with
-<a href="http://tools.ietf.org/id/draft-pantos-http-live-streaming">http://tools.ietf.org/id/draft-pantos-http-live-streaming</a>.
+<p>For very large files, the ‘<samp>max_size</samp>’ option may have to be adjusted.
</p>
-<p>A list file with the suffix <code>".m3u8"</code> will auto-select this format.
-</p></dd>
-</dl>
+<a name="libquvi"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-libquvi">14.6 libquvi</a></h2>
-<p>If not specified the type is guessed from the list file name suffix.
+<p>Play media from Internet services using the quvi project.
</p>
-</dd>
-<dt> ‘<samp>segment_time <var>time</var></samp>’</dt>
-<dd><p>Set segment duration to <var>time</var>, the value must be a duration
-specification. Default value is "2". See also the
-‘<samp>segment_times</samp>’ option.
+<p>The demuxer accepts a ‘<samp>format</samp>’ option to request a specific quality. It
+is by default set to <var>best</var>.
</p>
-<p>Note that splitting may not be accurate, unless you force the
-reference stream key-frames at the given time. See the introductory
-notice and the examples below.
+<p>See <a href="http://quvi.sourceforge.net/">http://quvi.sourceforge.net/</a> for more information.
</p>
-</dd>
-<dt> ‘<samp>segment_time_delta <var>delta</var></samp>’</dt>
-<dd><p>Specify the accuracy time when selecting the start time for a
-segment, expressed as a duration specification. Default value is "0".
+<p>FFmpeg needs to be built with <code>--enable-libquvi</code> for this demuxer to be
+enabled.
</p>
-<p>When delta is specified a key-frame will start a new segment if its
-PTS satisfies the relation:
-</p><table><tr><td> </td><td><pre class="example">PTS >= start_time - time_delta
-</pre></td></tr></table>
+<a name="image2"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-image2">14.7 image2</a></h2>
-<p>This option is useful when splitting video content, which is always
-split at GOP boundaries, in case a key frame is found just before the
-specified split time.
+<p>Image file demuxer.
</p>
-<p>In particular may be used in combination with the ‘<tt>ffmpeg</tt>’ option
-<var>force_key_frames</var>. The key frame times specified by
-<var>force_key_frames</var> may not be set accurately because of rounding
-issues, with the consequence that a key frame time may result set just
-before the specified time. For constant frame rate videos a value of
-1/2*<var>frame_rate</var> should address the worst case mismatch between
-the specified time and the time set by <var>force_key_frames</var>.
+<p>This demuxer reads from a list of image files specified by a pattern.
+The syntax and meaning of the pattern is specified by the
+option <var>pattern_type</var>.
</p>
-</dd>
-<dt> ‘<samp>segment_times <var>times</var></samp>’</dt>
-<dd><p>Specify a list of split points. <var>times</var> contains a list of comma
-separated duration specifications, in increasing order. See also
-the ‘<samp>segment_time</samp>’ option.
+<p>The pattern may contain a suffix which is used to automatically
+determine the format of the images contained in the files.
+</p>
+<p>The size, the pixel format, and the format of each image must be the
+same for all the files in the sequence.
+</p>
+<p>This demuxer accepts the following options:
+</p><dl compact="compact">
+<dt> ‘<samp>framerate</samp>’</dt>
+<dd><p>Set the frame rate for the video stream. It defaults to 25.
+</p></dd>
+<dt> ‘<samp>loop</samp>’</dt>
+<dd><p>If set to 1, loop over the input. Default value is 0.
+</p></dd>
+<dt> ‘<samp>pattern_type</samp>’</dt>
+<dd><p>Select the pattern type used to interpret the provided filename.
+</p>
+<p><var>pattern_type</var> accepts one of the following values.
+</p><dl compact="compact">
+<dt> ‘<samp>sequence</samp>’</dt>
+<dd><p>Select a sequence pattern type, used to specify a sequence of files
+indexed by sequential numbers.
+</p>
+<p>A sequence pattern may contain the string "%d" or "%0<var>N</var>d", which
+specifies the position of the characters representing a sequential
+number in each filename matched by the pattern. If the form
+"%d0<var>N</var>d" is used, the string representing the number in each
+filename is 0-padded and <var>N</var> is the total number of 0-padded
+digits representing the number. The literal character ’%’ can be
+specified in the pattern with the string "%%".
+</p>
+<p>If the sequence pattern contains "%d" or "%0<var>N</var>d", the first filename of
+the file list specified by the pattern must contain a number
+inclusively contained between <var>start_number</var> and
+<var>start_number</var>+<var>start_number_range</var>-1, and all the following
+numbers must be sequential.
+</p>
+<p>For example the pattern "img-%03d.bmp" will match a sequence of
+filenames of the form ‘<tt>img-001.bmp</tt>’, ‘<tt>img-002.bmp</tt>’, ...,
+‘<tt>img-010.bmp</tt>’, etc.; the pattern "i%%m%%g-%d.jpg" will match a
+sequence of filenames of the form ‘<tt>i%m%g-1.jpg</tt>’,
+‘<tt>i%m%g-2.jpg</tt>’, ..., ‘<tt>i%m%g-10.jpg</tt>’, etc.
</p>
+<p>Note that the pattern must not necessarily contain "%d" or
+"%0<var>N</var>d", for example to convert a single image file
+‘<tt>img.jpeg</tt>’ you can employ the command:
+</p><table><tr><td> </td><td><pre class="example">ffmpeg -i img.jpeg img.png
+</pre></td></tr></table>
+
</dd>
-<dt> ‘<samp>segment_frames <var>frames</var></samp>’</dt>
-<dd><p>Specify a list of split video frame numbers. <var>frames</var> contains a
-list of comma separated integer numbers, in increasing order.
+<dt> ‘<samp>glob</samp>’</dt>
+<dd><p>Select a glob wildcard pattern type.
</p>
-<p>This option specifies to start a new segment whenever a reference
-stream key frame is found and the sequential number (starting from 0)
-of the frame is greater or equal to the next value in the list.
+<p>The pattern is interpreted like a <code>glob()</code> pattern. This is only
+selectable if libavformat was compiled with globbing support.
</p>
</dd>
-<dt> ‘<samp>segment_wrap <var>limit</var></samp>’</dt>
-<dd><p>Wrap around segment index once it reaches <var>limit</var>.
+<dt> ‘<samp>glob_sequence <em>(deprecated, will be removed)</em></samp>’</dt>
+<dd><p>Select a mixed glob wildcard/sequence pattern.
+</p>
+<p>If your version of libavformat was compiled with globbing support, and
+the provided pattern contains at least one glob meta character among
+<code>%*?[]{}</code> that is preceded by an unescaped "%", the pattern is
+interpreted like a <code>glob()</code> pattern, otherwise it is interpreted
+like a sequence pattern.
</p>
-</dd>
-<dt> ‘<samp>segment_start_number <var>number</var></samp>’</dt>
-<dd><p>Set the sequence number of the first segment. Defaults to <code>0</code>.
+<p>All glob special characters <code>%*?[]{}</code> must be prefixed
+with "%". To escape a literal "%" you shall use "%%".
</p>
-</dd>
-<dt> ‘<samp>reset_timestamps <var>1|0</var></samp>’</dt>
-<dd><p>Reset timestamps at the begin of each segment, so that each segment
-will start with near-zero timestamps. It is meant to ease the playback
-of the generated segments. May not work with some combinations of
-muxers/codecs. It is set to <code>0</code> by default.
+<p>For example the pattern <code>foo-%*.jpeg</code> will match all the
+filenames prefixed by "foo-" and terminating with ".jpeg", and
+<code>foo-%?%?%?.jpeg</code> will match all the filenames prefixed with
+"foo-", followed by a sequence of three characters, and terminating
+with ".jpeg".
</p>
-</dd>
-<dt> ‘<samp>initial_offset <var>offset</var></samp>’</dt>
-<dd><p>Specify timestamp offset to apply to the output packet timestamps. The
-argument must be a time duration specification, and defaults to 0.
+<p>This pattern type is deprecated in favor of <var>glob</var> and
+<var>sequence</var>.
</p></dd>
</dl>
-<a name="Examples-81"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-81">18.16.1 Examples</a></h3>
+<p>Default value is <var>glob_sequence</var>.
+</p></dd>
+<dt> ‘<samp>pixel_format</samp>’</dt>
+<dd><p>Set the pixel format of the images to read. If not specified the pixel
+format is guessed from the first image file in the sequence.
+</p></dd>
+<dt> ‘<samp>start_number</samp>’</dt>
+<dd><p>Set the index of the file matched by the image file pattern to start
+to read from. Default value is 0.
+</p></dd>
+<dt> ‘<samp>start_number_range</samp>’</dt>
+<dd><p>Set the index interval range to check when looking for the first image
+file in the sequence, starting from <var>start_number</var>. Default value
+is 5.
+</p></dd>
+<dt> ‘<samp>ts_from_file</samp>’</dt>
+<dd><p>If set to 1, will set frame timestamp to modification time of image file. Note
+that monotonity of timestamps is not provided: images go in the same order as
+without this option. Default value is 0.
+</p></dd>
+<dt> ‘<samp>video_size</samp>’</dt>
+<dd><p>Set the video size of the images to read. If not specified the video
+size is guessed from the first image file in the sequence.
+</p></dd>
+</dl>
+
+<a name="Examples-75"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-75">14.7.1 Examples</a></h3>
<ul>
<li>
-To remux the content of file ‘<tt>in.mkv</tt>’ to a list of segments
-‘<tt>out-000.nut</tt>’, ‘<tt>out-001.nut</tt>’, etc., and write the list of
-generated segments to ‘<tt>out.list</tt>’:
-<table><tr><td> </td><td><pre class="example">ffmpeg -i in.mkv -codec copy -map 0 -f segment -segment_list out.list out%03d.nut
-</pre></td></tr></table>
-
-</li><li>
-As the example above, but segment the input file according to the split
-points specified by the <var>segment_times</var> option:
-<table><tr><td> </td><td><pre class="example">ffmpeg -i in.mkv -codec copy -map 0 -f segment -segment_list out.csv -segment_times 1,2,3,5,8,13,21 out%03d.nut
-</pre></td></tr></table>
-
-</li><li>
-As the example above, but use the <code>ffmpeg</code> ‘<samp>force_key_frames</samp>’
-option to force key frames in the input at the specified location, together
-with the segment option ‘<samp>segment_time_delta</samp>’ to account for
-possible roundings operated when setting key frame times.
-<table><tr><td> </td><td><pre class="example">ffmpeg -i in.mkv -force_key_frames 1,2,3,5,8,13,21 -codec:v mpeg4 -codec:a pcm_s16le -map 0 \
--f segment -segment_list out.csv -segment_times 1,2,3,5,8,13,21 -segment_time_delta 0.05 out%03d.nut
-</pre></td></tr></table>
-<p>In order to force key frames on the input file, transcoding is
-required.
-</p>
-</li><li>
-Segment the input file by splitting the input file according to the
-frame numbers sequence specified with the ‘<samp>segment_frames</samp>’ option:
-<table><tr><td> </td><td><pre class="example">ffmpeg -i in.mkv -codec copy -map 0 -f segment -segment_list out.csv -segment_frames 100,200,300,500,800 out%03d.nut
+Use <code>ffmpeg</code> for creating a video from the images in the file
+sequence ‘<tt>img-001.jpeg</tt>’, ‘<tt>img-002.jpeg</tt>’, ..., assuming an
+input frame rate of 10 frames per second:
+<table><tr><td> </td><td><pre class="example">ffmpeg -framerate 10 -i 'img-%03d.jpeg' out.mkv
</pre></td></tr></table>
</li><li>
-To convert the ‘<tt>in.mkv</tt>’ to TS segments using the <code>libx264</code>
-and <code>libfaac</code> encoders:
-<table><tr><td> </td><td><pre class="example">ffmpeg -i in.mkv -map 0 -codec:v libx264 -codec:a libfaac -f ssegment -segment_list out.list out%03d.ts
+As above, but start by reading from a file with index 100 in the sequence:
+<table><tr><td> </td><td><pre class="example">ffmpeg -framerate 10 -start_number 100 -i 'img-%03d.jpeg' out.mkv
</pre></td></tr></table>
</li><li>
-Segment the input file, and create an M3U8 live playlist (can be used
-as live HLS source):
-<table><tr><td> </td><td><pre class="example">ffmpeg -re -i in.mkv -codec copy -map 0 -f segment -segment_list playlist.m3u8 \
--segment_list_flags +live -segment_time 10 out%03d.mkv
+Read images matching the "*.png" glob pattern , that is all the files
+terminating with the ".png" suffix:
+<table><tr><td> </td><td><pre class="example">ffmpeg -framerate 10 -pattern_type glob -i "*.png" out.mkv
</pre></td></tr></table>
</li></ul>
-<a name="tee"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-tee">18.17 tee</a></h2>
+<a name="mpegts"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-mpegts">14.8 mpegts</a></h2>
-<p>The tee muxer can be used to write the same data to several files or any
-other kind of muxer. It can be used, for example, to both stream a video to
-the network and save it to disk at the same time.
-</p>
-<p>It is different from specifying several outputs to the <code>ffmpeg</code>
-command-line tool because the audio and video data will be encoded only once
-with the tee muxer; encoding can be a very expensive process. It is not
-useful when using the libavformat API directly because it is then possible
-to feed the same packets to several muxers directly.
+<p>MPEG-2 transport stream demuxer.
</p>
-<p>The slave outputs are specified in the file name given to the muxer,
-separated by ’|’. If any of the slave name contains the ’|’ separator,
-leading or trailing spaces or any special character, it must be
-escaped (see the “Quoting and escaping” section in the ffmpeg-utils
-manual).
+<dl compact="compact">
+<dt> ‘<samp>fix_teletext_pts</samp>’</dt>
+<dd><p>Overrides teletext packet PTS and DTS values with the timestamps calculated
+from the PCR of the first program which the teletext stream is part of and is
+not discarded. Default value is 1, set this option to 0 if you want your
+teletext packet PTS and DTS values untouched.
+</p></dd>
+</dl>
+
+<a name="rawvideo"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-rawvideo">14.9 rawvideo</a></h2>
+
+<p>Raw video demuxer.
</p>
-<p>Muxer options can be specified for each slave by prepending them as a list of
-<var>key</var>=<var>value</var> pairs separated by ’:’, between square brackets. If
-the options values contain a special character or the ’:’ separator, they
-must be escaped; note that this is a second level escaping.
+<p>This demuxer allows one to read raw video data. Since there is no header
+specifying the assumed video parameters, the user must specify them
+in order to be able to decode the data correctly.
</p>
-<p>The following special options are also recognized:
+<p>This demuxer accepts the following options:
</p><dl compact="compact">
-<dt> ‘<samp>f</samp>’</dt>
-<dd><p>Specify the format name. Useful if it cannot be guessed from the
-output name suffix.
+<dt> ‘<samp>framerate</samp>’</dt>
+<dd><p>Set input video frame rate. Default value is 25.
</p>
</dd>
-<dt> ‘<samp>bsfs[/<var>spec</var>]</samp>’</dt>
-<dd><p>Specify a list of bitstream filters to apply to the specified
-output. It is possible to specify to which streams a given bitstream
-filter applies, by appending a stream specifier to the option
-separated by <code>/</code>. If the stream specifier is not specified, the
-bistream filters will be applied to all streams in the output.
-</p>
-<p>Several bitstream filters can be specified, separated by ",".
+<dt> ‘<samp>pixel_format</samp>’</dt>
+<dd><p>Set the input video pixel format. Default value is <code>yuv420p</code>.
</p>
</dd>
-<dt> ‘<samp>select</samp>’</dt>
-<dd><p>Select the streams that should be mapped to the slave output,
-specified by a stream specifier. If not specified, this defaults to
-all the input streams.
+<dt> ‘<samp>video_size</samp>’</dt>
+<dd><p>Set the input video size. This value must be specified explicitly.
</p></dd>
</dl>
-<p>Some examples follow.
-</p><ul>
-<li>
-Encode something and both archive it in a WebM file and stream it
-as MPEG-TS over UDP (the streams need to be explicitly mapped):
-<table><tr><td> </td><td><pre class="example">ffmpeg -i ... -c:v libx264 -c:a mp2 -f tee -map 0:v -map 0:a
- "archive-20121107.mkv|[f=mpegts]udp://10.0.1.255:1234/"
+<p>For example to read a rawvideo file ‘<tt>input.raw</tt>’ with
+<code>ffplay</code>, assuming a pixel format of <code>rgb24</code>, a video
+size of <code>320x240</code>, and a frame rate of 10 images per second, use
+the command:
+</p><table><tr><td> </td><td><pre class="example">ffplay -f rawvideo -pixel_format rgb24 -video_size 320x240 -framerate 10 input.raw
</pre></td></tr></table>
-</li><li>
-Use <code>ffmpeg</code> to encode the input, and send the output
-to three different destinations. The <code>dump_extra</code> bitstream
-filter is used to add extradata information to all the output video
-keyframes packets, as requested by the MPEG-TS format. The select
-option is applied to ‘<tt>out.aac</tt>’ in order to make it contain only
-audio packets.
-<table><tr><td> </td><td><pre class="example">ffmpeg -i ... -map 0 -flags +global_header -c:v libx264 -c:a aac -strict experimental
- -f tee "[bsfs/v=dump_extra]out.ts|[movflags=+faststart]out.mp4|[select=a]out.aac"
+<a name="sbg"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-sbg">14.10 sbg</a></h2>
+
+<p>SBaGen script demuxer.
+</p>
+<p>This demuxer reads the script language used by SBaGen
+<a href="http://uazu.net/sbagen/">http://uazu.net/sbagen/</a> to generate binaural beats sessions. A SBG
+script looks like that:
+</p><table><tr><td> </td><td><pre class="example">-SE
+a: 300-2.5/3 440+4.5/0
+b: 300-2.5/0 440+4.5/3
+off: -
+NOW == a
++0:07:00 == b
++0:14:00 == a
++0:21:00 == b
++0:30:00 off
</pre></td></tr></table>
-</li></ul>
-<p>Note: some codecs may need different options depending on the output format;
-the auto-detection of this can not work with the tee muxer. The main example
-is the ‘<samp>global_header</samp>’ flag.
+<p>A SBG script can mix absolute and relative timestamps. If the script uses
+either only absolute timestamps (including the script start time) or only
+relative ones, then its layout is fixed, and the conversion is
+straightforward. On the other hand, if the script mixes both kind of
+timestamps, then the <var>NOW</var> reference for relative timestamps will be
+taken from the current time of day at the time the script is read, and the
+script layout will be frozen according to that reference. That means that if
+the script is directly played, the actual times will match the absolute
+timestamps up to the sound controller’s clock accuracy, but if the user
+somehow pauses the playback or seeks, all times will be shifted accordingly.
+</p>
+<a name="tedcaptions"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-tedcaptions">14.11 tedcaptions</a></h2>
+
+<p>JSON captions used for <a href="http://www.ted.com/">TED Talks</a>.
</p>
+<p>TED does not provide links to the captions, but they can be guessed from the
+page. The file ‘<tt>tools/bookmarklets.html</tt>’ from the FFmpeg source tree
+contains a bookmarklet to expose them.
+</p>
+<p>This demuxer accepts the following option:
+</p><dl compact="compact">
+<dt> ‘<samp>start_time</samp>’</dt>
+<dd><p>Set the start time of the TED talk, in milliseconds. The default is 15000
+(15s). It is used to sync the captions with the downloadable videos, because
+they include a 15s intro.
+</p></dd>
+</dl>
+
+<p>Example: convert the captions to a format most players understand:
+</p><table><tr><td> </td><td><pre class="example">ffmpeg -i http://www.ted.com/talks/subtitles/id/1/lang/en talk1-en.srt
+</pre></td></tr></table>
+
<a name="Metadata"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-Metadata">19. Metadata</a></h1>
+<h1 class="chapter"><a href="ffplay-all.html#toc-Metadata">15. Metadata</a></h1>
<p>FFmpeg is able to dump metadata from media files into a simple UTF-8-encoded
INI-like text file and then load it back using the metadata muxer/demuxer.
</pre></td></tr></table>
<a name="Protocols"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-Protocols">20. Protocols</a></h1>
+<h1 class="chapter"><a href="ffplay-all.html#toc-Protocols">16. Protocols</a></h1>
<p>Protocols are configured elements in FFmpeg that enable access to
resources that require specific protocols.
<p>A description of the currently available protocols follows.
</p>
<a name="bluray"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-bluray">20.1 bluray</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-bluray">16.1 bluray</a></h2>
<p>Read BluRay playlist.
</p>
</pre></td></tr></table>
<a name="cache"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-cache">20.2 cache</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-cache">16.2 cache</a></h2>
<p>Caching wrapper for input stream.
</p>
<table><tr><td> </td><td><pre class="example">cache:<var>URL</var>
</pre></td></tr></table>
-<a name="concat-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-concat-1">20.3 concat</a></h2>
+<a name="concat-3"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-concat-3">16.3 concat</a></h2>
<p>Physical concatenation protocol.
</p>
many shells.
</p>
<a name="crypto"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-crypto">20.4 crypto</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-crypto">16.4 crypto</a></h2>
<p>AES-encrypted stream reading protocol.
</p>
</pre></td></tr></table>
<a name="data"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-data">20.5 data</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-data">16.5 data</a></h2>
<p>Data in-line in the URI. See <a href="http://en.wikipedia.org/wiki/Data_URI_scheme">http://en.wikipedia.org/wiki/Data_URI_scheme</a>.
</p>
</pre></td></tr></table>
<a name="file"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-file">20.6 file</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-file">16.6 file</a></h2>
<p>File access protocol.
</p>
-<p>Allow to read from or read to a file.
+<p>Allow to read from or write to a file.
+</p>
+<p>A file URL can have the form:
+</p><table><tr><td> </td><td><pre class="example">file:<var>filename</var>
+</pre></td></tr></table>
+
+<p>where <var>filename</var> is the path of the file to read.
+</p>
+<p>An URL that does not have a protocol prefix will be assumed to be a
+file URL. Depending on the build, an URL that looks like a Windows
+path with the drive letter at the beginning will also be assumed to be
+a file URL (usually not the case in builds for unix-like systems).
</p>
<p>For example to read from a file ‘<tt>input.mpeg</tt>’ with <code>ffmpeg</code>
use the command:
</p><table><tr><td> </td><td><pre class="example">ffmpeg -i file:input.mpeg output.mpeg
</pre></td></tr></table>
-<p>The ff* tools default to the file protocol, that is a resource
-specified with the name "FILE.mpeg" is interpreted as the URL
-"file:FILE.mpeg".
-</p>
<p>This protocol accepts the following options:
</p>
<dl compact="compact">
</dl>
<a name="ftp"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-ftp">20.7 ftp</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-ftp">16.7 ftp</a></h2>
<p>FTP (File Transfer Protocol).
</p>
operation. ff* tools may produce incomplete content due to server limitations.
</p>
<a name="gopher"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-gopher">20.8 gopher</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-gopher">16.8 gopher</a></h2>
<p>Gopher protocol.
</p>
-<a name="hls-2"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-hls-2">20.9 hls</a></h2>
+<a name="hls"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-hls">16.9 hls</a></h2>
<p>Read Apple HTTP Live Streaming compliant segmented stream as
a uniform one. The M3U8 playlists describing the segments can be
m3u8 files.
</p>
<a name="http"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-http">20.10 http</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-http">16.10 http</a></h2>
<p>HTTP (Hyper Text Transfer Protocol).
</p>
-<p>This protocol accepts the following options.
+<p>This protocol accepts the following options:
</p>
<dl compact="compact">
<dt> ‘<samp>seekable</samp>’</dt>
</p>
</dd>
<dt> ‘<samp>chunked_post</samp>’</dt>
-<dd><p>If set to 1 use chunked transfer-encoding for posts, default is 1.
-</p>
-</dd>
-<dt> ‘<samp>headers</samp>’</dt>
-<dd><p>Set custom HTTP headers, can override built in default headers. The
-value must be a string encoding the headers.
+<dd><p>If set to 1 use chunked Transfer-Encoding for posts, default is 1.
</p>
</dd>
<dt> ‘<samp>content_type</samp>’</dt>
-<dd><p>Force a content type.
+<dd><p>Set a specific content type for the POST messages.
</p>
</dd>
-<dt> ‘<samp>user-agent</samp>’</dt>
-<dd><p>Override User-Agent header. If not specified the protocol will use a
-string describing the libavformat build.
+<dt> ‘<samp>headers</samp>’</dt>
+<dd><p>Set custom HTTP headers, can override built in default headers. The
+value must be a string encoding the headers.
</p>
</dd>
<dt> ‘<samp>multiple_requests</samp>’</dt>
-<dd><p>Use persistent connections if set to 1. By default it is 0.
+<dd><p>Use persistent connections if set to 1, default is 0.
</p>
</dd>
<dt> ‘<samp>post_data</samp>’</dt>
<dd><p>Set custom HTTP post data.
</p>
</dd>
+<dt> ‘<samp>user-agent</samp>’</dt>
+<dt> ‘<samp>user_agent</samp>’</dt>
+<dd><p>Override the User-Agent header. If not specified the protocol will use a
+string describing the libavformat build. ("Lavf/<version>")
+</p>
+</dd>
<dt> ‘<samp>timeout</samp>’</dt>
<dd><p>Set timeout of socket I/O operations used by the underlying low level
operation. By default it is set to -1, which means that the timeout is
</p>
</dd>
<dt> ‘<samp>mime_type</samp>’</dt>
-<dd><p>Set MIME type.
+<dd><p>Export the MIME type.
</p>
</dd>
<dt> ‘<samp>icy</samp>’</dt>
</p>
</dd>
<dt> ‘<samp>icy_metadata_headers</samp>’</dt>
-<dd><p>If the server supports ICY metadata, this contains the ICY specific HTTP reply
-headers, separated with newline characters.
+<dd><p>If the server supports ICY metadata, this contains the ICY-specific HTTP reply
+headers, separated by newline characters.
</p>
</dd>
<dt> ‘<samp>icy_metadata_packet</samp>’</dt>
<dd><p>If the server supports ICY metadata, and ‘<samp>icy</samp>’ was set to 1, this
-contains the last non-empty metadata packet sent by the server.
+contains the last non-empty metadata packet sent by the server. It should be
+polled in regular intervals by applications interested in mid-stream metadata
+updates.
</p>
</dd>
<dt> ‘<samp>cookies</samp>’</dt>
<dd><p>Set the cookies to be sent in future requests. The format of each cookie is the
same as the value of a Set-Cookie HTTP response field. Multiple cookies can be
delimited by a newline character.
+</p>
+</dd>
+<dt> ‘<samp>offset</samp>’</dt>
+<dd><p>Set initial byte offset.
+</p>
+</dd>
+<dt> ‘<samp>end_offset</samp>’</dt>
+<dd><p>Try to limit the request to bytes preceding this offset.
</p></dd>
</dl>
<a name="HTTP-Cookies"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-HTTP-Cookies">20.10.1 HTTP Cookies</a></h3>
+<h3 class="subsection"><a href="ffplay-all.html#toc-HTTP-Cookies">16.10.1 HTTP Cookies</a></h3>
<p>Some HTTP requests will be denied unless cookie values are passed in with the
request. The ‘<samp>cookies</samp>’ option allows these cookies to be specified. At
</pre></td></tr></table>
<a name="mmst"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-mmst">20.11 mmst</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-mmst">16.11 mmst</a></h2>
<p>MMS (Microsoft Media Server) protocol over TCP.
</p>
<a name="mmsh"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-mmsh">20.12 mmsh</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-mmsh">16.12 mmsh</a></h2>
<p>MMS (Microsoft Media Server) protocol over HTTP.
</p>
</p><table><tr><td> </td><td><pre class="example">mmsh://<var>server</var>[:<var>port</var>][/<var>app</var>][/<var>playpath</var>]
</pre></td></tr></table>
-<a name="md5-2"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-md5-2">20.13 md5</a></h2>
+<a name="md5"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-md5">16.13 md5</a></h2>
<p>MD5 output protocol.
</p>
be seekable, so they will fail with the MD5 output protocol.
</p>
<a name="pipe"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-pipe">20.14 pipe</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-pipe">16.14 pipe</a></h2>
<p>UNIX pipe access protocol.
</p>
be seekable, so they will fail with the pipe output protocol.
</p>
<a name="rtmp"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-rtmp">20.15 rtmp</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-rtmp">16.15 rtmp</a></h2>
<p>Real-Time Messaging Protocol.
</p>
</pre></td></tr></table>
<a name="rtmpe"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-rtmpe">20.16 rtmpe</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-rtmpe">16.16 rtmpe</a></h2>
<p>Encrypted Real-Time Messaging Protocol.
</p>
a pair of RC4 keys.
</p>
<a name="rtmps"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-rtmps">20.17 rtmps</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-rtmps">16.17 rtmps</a></h2>
<p>Real-Time Messaging Protocol over a secure SSL connection.
</p>
multimedia content across an encrypted connection.
</p>
<a name="rtmpt"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-rtmpt">20.18 rtmpt</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-rtmpt">16.18 rtmpt</a></h2>
<p>Real-Time Messaging Protocol tunneled through HTTP.
</p>
firewalls.
</p>
<a name="rtmpte"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-rtmpte">20.19 rtmpte</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-rtmpte">16.19 rtmpte</a></h2>
<p>Encrypted Real-Time Messaging Protocol tunneled through HTTP.
</p>
firewalls.
</p>
<a name="rtmpts"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-rtmpts">20.20 rtmpts</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-rtmpts">16.20 rtmpts</a></h2>
<p>Real-Time Messaging Protocol tunneled through HTTPS.
</p>
firewalls.
</p>
<a name="libssh"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-libssh">20.21 libssh</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-libssh">16.21 libssh</a></h2>
<p>Secure File Transfer Protocol via libssh
</p>
truncating. Default value is 1.
</p>
</dd>
+<dt> ‘<samp>private_key</samp>’</dt>
+<dd><p>Specify the path of the file containing private key to use during authorization.
+By default libssh searches for keys in the ‘<tt>~/.ssh/</tt>’ directory.
+</p>
+</dd>
</dl>
<p>Example: Play a file stored on remote server.
</pre></td></tr></table>
<a name="librtmp-rtmp_002c-rtmpe_002c-rtmps_002c-rtmpt_002c-rtmpte"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-librtmp-rtmp_002c-rtmpe_002c-rtmps_002c-rtmpt_002c-rtmpte">20.22 librtmp rtmp, rtmpe, rtmps, rtmpt, rtmpte</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-librtmp-rtmp_002c-rtmpe_002c-rtmps_002c-rtmpt_002c-rtmpte">16.22 librtmp rtmp, rtmpe, rtmps, rtmpt, rtmpte</a></h2>
<p>Real-Time Messaging Protocol and its variants supported through
librtmp.
</pre></td></tr></table>
<a name="rtp"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-rtp">20.23 rtp</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-rtp">16.23 rtp</a></h2>
<p>Real-time Transport Protocol.
</p>
</li></ol>
<a name="rtsp"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-rtsp">20.24 rtsp</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-rtsp">16.24 rtsp</a></h2>
+<p>Real-Time Streaming Protocol.
+</p>
<p>RTSP is not technically a protocol handler in libavformat, it is a demuxer
and muxer. The demuxer supports both normal RTSP (with data transferred
over RTP; this is used by e.g. Apple and Microsoft) and Real-RTSP (with
</p><table><tr><td> </td><td><pre class="example">rtsp://<var>hostname</var>[:<var>port</var>]/<var>path</var>
</pre></td></tr></table>
-<p>The following options (set on the <code>ffmpeg</code>/<code>ffplay</code> command
-line, or set in code via <code>AVOption</code>s or in <code>avformat_open_input</code>),
-are supported:
+<p>Options can be set on the <code>ffmpeg</code>/<code>ffplay</code> command
+line, or set in code via <code>AVOption</code>s or in
+<code>avformat_open_input</code>.
</p>
-<p>Flags for <code>rtsp_transport</code>:
+<p>The following options are supported.
</p>
<dl compact="compact">
+<dt> ‘<samp>initial_pause</samp>’</dt>
+<dd><p>Do not start playing the stream immediately if set to 1. Default value
+is 0.
+</p>
+</dd>
+<dt> ‘<samp>rtsp_transport</samp>’</dt>
+<dd><p>Set RTSP trasport protocols.
+</p>
+<p>It accepts the following values:
+</p><dl compact="compact">
<dt> ‘<samp>udp</samp>’</dt>
<dd><p>Use UDP as lower transport protocol.
</p>
<p>Multiple lower transport protocols may be specified, in that case they are
tried one at a time (if the setup of one fails, the next one is tried).
-For the muxer, only the <code>tcp</code> and <code>udp</code> options are supported.
+For the muxer, only the ‘<samp>tcp</samp>’ and ‘<samp>udp</samp>’ options are supported.
</p>
-<p>Flags for <code>rtsp_flags</code>:
+</dd>
+<dt> ‘<samp>rtsp_flags</samp>’</dt>
+<dd><p>Set RTSP flags.
</p>
-<dl compact="compact">
+<p>The following values are accepted:
+</p><dl compact="compact">
<dt> ‘<samp>filter_src</samp>’</dt>
<dd><p>Accept packets only from negotiated peer address and port.
</p></dd>
</p></dd>
</dl>
+<p>Default value is ‘<samp>none</samp>’.
+</p>
+</dd>
+<dt> ‘<samp>allowed_media_types</samp>’</dt>
+<dd><p>Set media types to accept from the server.
+</p>
+<p>The following flags are accepted:
+</p><dl compact="compact">
+<dt> ‘<samp>video</samp>’</dt>
+<dt> ‘<samp>audio</samp>’</dt>
+<dt> ‘<samp>data</samp>’</dt>
+</dl>
+
+<p>By default it accepts all media types.
+</p>
+</dd>
+<dt> ‘<samp>min_port</samp>’</dt>
+<dd><p>Set minimum local UDP port. Default value is 5000.
+</p>
+</dd>
+<dt> ‘<samp>max_port</samp>’</dt>
+<dd><p>Set maximum local UDP port. Default value is 65000.
+</p>
+</dd>
+<dt> ‘<samp>timeout</samp>’</dt>
+<dd><p>Set maximum timeout (in seconds) to wait for incoming connections.
+</p>
+<p>A value of -1 mean infinite (default). This option implies the
+‘<samp>rtsp_flags</samp>’ set to ‘<samp>listen</samp>’.
+</p>
+</dd>
+<dt> ‘<samp>reorder_queue_size</samp>’</dt>
+<dd><p>Set number of packets to buffer for handling of reordered packets.
+</p>
+</dd>
+<dt> ‘<samp>stimeout</samp>’</dt>
+<dd><p>Set socket TCP I/O timeout in micro seconds.
+</p>
+</dd>
+<dt> ‘<samp>user-agent</samp>’</dt>
+<dd><p>Override User-Agent header. If not specified, it default to the
+libavformat identifier string.
+</p></dd>
+</dl>
+
<p>When receiving data over UDP, the demuxer tries to reorder received packets
(since they may arrive out of order, or packets may get lost totally). This
can be disabled by setting the maximum demuxing delay to zero (via
<code>-ast</code> <var>n</var> for video and audio respectively, and can be switched
on the fly by pressing <code>v</code> and <code>a</code>.
</p>
-<p>Example command lines:
-</p>
-<p>To watch a stream over UDP, with a max reordering delay of 0.5 seconds:
+<a name="Examples-78"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-78">16.24.1 Examples</a></h3>
+
+<p>The following examples all make use of the <code>ffplay</code> and
+<code>ffmpeg</code> tools.
</p>
+<ul>
+<li>
+Watch a stream over UDP, with a max reordering delay of 0.5 seconds:
<table><tr><td> </td><td><pre class="example">ffplay -max_delay 500000 -rtsp_transport udp rtsp://server/video.mp4
</pre></td></tr></table>
-<p>To watch a stream tunneled over HTTP:
-</p>
+</li><li>
+Watch a stream tunneled over HTTP:
<table><tr><td> </td><td><pre class="example">ffplay -rtsp_transport http rtsp://server/video.mp4
</pre></td></tr></table>
-<p>To send a stream in realtime to a RTSP server, for others to watch:
-</p>
+</li><li>
+Send a stream in realtime to a RTSP server, for others to watch:
<table><tr><td> </td><td><pre class="example">ffmpeg -re -i <var>input</var> -f rtsp -muxdelay 0.1 rtsp://server/live.sdp
</pre></td></tr></table>
-<p>To receive a stream in realtime:
-</p>
+</li><li>
+Receive a stream in realtime:
<table><tr><td> </td><td><pre class="example">ffmpeg -rtsp_flags listen -i rtsp://ownaddress/live.sdp <var>output</var>
</pre></td></tr></table>
-
-<dl compact="compact">
-<dt> ‘<samp>stimeout</samp>’</dt>
-<dd><p>Socket IO timeout in micro seconds.
-</p></dd>
-</dl>
+</li></ul>
<a name="sap"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-sap">20.25 sap</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-sap">16.25 sap</a></h2>
<p>Session Announcement Protocol (RFC 2974). This is not technically a
protocol handler in libavformat, it is a muxer and demuxer.
streams regularly on a separate port.
</p>
<a name="Muxer"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Muxer">20.25.1 Muxer</a></h3>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Muxer">16.25.1 Muxer</a></h3>
<p>The syntax for a SAP url given to the muxer is:
</p><table><tr><td> </td><td><pre class="example">sap://<var>destination</var>[:<var>port</var>][?<var>options</var>]
</pre></td></tr></table>
<a name="Demuxer"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Demuxer">20.25.2 Demuxer</a></h3>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Demuxer">16.25.2 Demuxer</a></h3>
<p>The syntax for a SAP url given to the demuxer is:
</p><table><tr><td> </td><td><pre class="example">sap://[<var>address</var>][:<var>port</var>]
</pre></td></tr></table>
<a name="sctp"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-sctp">20.26 sctp</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-sctp">16.26 sctp</a></h2>
<p>Stream Control Transmission Protocol.
</p>
</dl>
<a name="srtp"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-srtp">20.27 srtp</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-srtp">16.27 srtp</a></h2>
<p>Secure Real-time Transport Protocol.
</p>
</dl>
<a name="tcp"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-tcp">20.28 tcp</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-tcp">16.28 tcp</a></h2>
-<p>Trasmission Control Protocol.
+<p>Transmission Control Protocol.
</p>
<p>The required syntax for a TCP url is:
</p><table><tr><td> </td><td><pre class="example">tcp://<var>hostname</var>:<var>port</var>[?<var>options</var>]
</pre></td></tr></table>
+<p><var>options</var> contains a list of &-separated options of the form
+<var>key</var>=<var>val</var>.
+</p>
+<p>The list of supported options follows.
+</p>
<dl compact="compact">
-<dt> ‘<samp>listen</samp>’</dt>
-<dd><p>Listen for an incoming connection
+<dt> ‘<samp>listen=<var>1|0</var></samp>’</dt>
+<dd><p>Listen for an incoming connection. Default value is 0.
</p>
</dd>
<dt> ‘<samp>timeout=<var>microseconds</var></samp>’</dt>
-<dd><p>In read mode: if no data arrived in more than this time interval, raise error.
-In write mode: if socket cannot be written in more than this time interval, raise error.
-This also sets timeout on TCP connection establishing.
+<dd><p>Set raise error timeout, expressed in microseconds.
+</p>
+<p>This option is only relevant in read mode: if no data arrived in more
+than this time interval, raise error.
</p>
-<table><tr><td> </td><td><pre class="example">ffmpeg -i <var>input</var> -f <var>format</var> tcp://<var>hostname</var>:<var>port</var>?listen
-ffplay tcp://<var>hostname</var>:<var>port</var>
-</pre></td></tr></table>
-
</dd>
+<dt> ‘<samp>listen_timeout=<var>microseconds</var></samp>’</dt>
+<dd><p>Set listen timeout, expressed in microseconds.
+</p></dd>
</dl>
+<p>The following example shows how to setup a listening TCP connection
+with <code>ffmpeg</code>, which is then accessed with <code>ffplay</code>:
+</p><table><tr><td> </td><td><pre class="example">ffmpeg -i <var>input</var> -f <var>format</var> tcp://<var>hostname</var>:<var>port</var>?listen
+ffplay tcp://<var>hostname</var>:<var>port</var>
+</pre></td></tr></table>
+
<a name="tls"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-tls">20.29 tls</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-tls">16.29 tls</a></h2>
<p>Transport Layer Security (TLS) / Secure Sockets Layer (SSL)
</p>
</pre></td></tr></table>
<a name="udp"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-udp">20.30 udp</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-udp">16.30 udp</a></h2>
<p>User Datagram Protocol.
</p>
-<p>The required syntax for a UDP url is:
+<p>The required syntax for an UDP URL is:
</p><table><tr><td> </td><td><pre class="example">udp://<var>hostname</var>:<var>port</var>[?<var>options</var>]
</pre></td></tr></table>
<p><var>options</var> contains a list of &-separated options of the form <var>key</var>=<var>val</var>.
</p>
<p>In case threading is enabled on the system, a circular buffer is used
-to store the incoming data, which allows to reduce loss of data due to
+to store the incoming data, which allows one to reduce loss of data due to
UDP socket buffer overruns. The <var>fifo_size</var> and
<var>overrun_nonfatal</var> options are related to this buffer.
</p>
</p>
</dd>
<dt> ‘<samp>timeout=<var>microseconds</var></samp>’</dt>
-<dd><p>In read mode: if no data arrived in more than this time interval, raise error.
+<dd><p>Set raise error timeout, expressed in microseconds.
+</p>
+<p>This option is only relevant in read mode: if no data arrived in more
+than this time interval, raise error.
</p></dd>
</dl>
-<p>Some usage examples of the UDP protocol with <code>ffmpeg</code> follow.
-</p>
-<p>To stream over UDP to a remote endpoint:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i <var>input</var> -f <var>format</var> udp://<var>hostname</var>:<var>port</var>
+<a name="Examples-53"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-53">16.30.1 Examples</a></h3>
+
+<ul>
+<li>
+Use <code>ffmpeg</code> to stream over UDP to a remote endpoint:
+<table><tr><td> </td><td><pre class="example">ffmpeg -i <var>input</var> -f <var>format</var> udp://<var>hostname</var>:<var>port</var>
</pre></td></tr></table>
-<p>To stream in mpegts format over UDP using 188 sized UDP packets, using a large input buffer:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i <var>input</var> -f mpegts udp://<var>hostname</var>:<var>port</var>?pkt_size=188&buffer_size=65535
+</li><li>
+Use <code>ffmpeg</code> to stream in mpegts format over UDP using 188
+sized UDP packets, using a large input buffer:
+<table><tr><td> </td><td><pre class="example">ffmpeg -i <var>input</var> -f mpegts udp://<var>hostname</var>:<var>port</var>?pkt_size=188&buffer_size=65535
</pre></td></tr></table>
-<p>To receive over UDP from a remote endpoint:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i udp://[<var>multicast-address</var>]:<var>port</var>
+</li><li>
+Use <code>ffmpeg</code> to receive over UDP from a remote endpoint:
+<table><tr><td> </td><td><pre class="example">ffmpeg -i udp://[<var>multicast-address</var>]:<var>port</var> ...
</pre></td></tr></table>
+</li></ul>
<a name="unix"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-unix">20.31 unix</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-unix">16.31 unix</a></h2>
<p>Unix local socket
</p>
</dl>
<a name="Device-Options"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-Device-Options">21. Device Options</a></h1>
+<h1 class="chapter"><a href="ffplay-all.html#toc-Device-Options">17. Device Options</a></h1>
<p>The libavdevice library provides the same interface as
libavformat. Namely, an input device is considered like a demuxer, and
</p>
<a name="Input-Devices"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-Input-Devices">22. Input Devices</a></h1>
+<h1 class="chapter"><a href="ffplay-all.html#toc-Input-Devices">18. Input Devices</a></h1>
<p>Input devices are configured elements in FFmpeg which allow to access
the data coming from a multimedia device attached to your system.
</p>
<p>A description of the currently available input devices follows.
</p>
-<a name="alsa-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-alsa-1">22.1 alsa</a></h2>
+<a name="alsa"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-alsa">18.1 alsa</a></h2>
<p>ALSA (Advanced Linux Sound Architecture) input device.
</p>
<a href="http://www.alsa-project.org/alsa-doc/alsa-lib/pcm.html">http://www.alsa-project.org/alsa-doc/alsa-lib/pcm.html</a>
</p>
<a name="bktr"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-bktr">22.2 bktr</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-bktr">18.2 bktr</a></h2>
<p>BSD video input device.
</p>
<a name="dshow"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-dshow">22.3 dshow</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-dshow">18.3 dshow</a></h2>
<p>Windows DirectShow input device.
</p>
<p>where <var>TYPE</var> can be either <var>audio</var> or <var>video</var>,
and <var>NAME</var> is the device’s name.
</p>
-<a name="Options-18"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-18">22.3.1 Options</a></h3>
+<a name="Options-1"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Options-1">18.3.1 Options</a></h3>
<p>If no options are specified, the device’s defaults are used.
If the device does not support the requested options, it will
</dd>
</dl>
-<a name="Examples-71"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-71">22.3.2 Examples</a></h3>
+<a name="Examples-23"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-23">18.3.2 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="dv1394"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-dv1394">22.4 dv1394</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-dv1394">18.4 dv1394</a></h2>
<p>Linux DV 1394 input device.
</p>
-<a name="fbdev-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-fbdev-1">22.5 fbdev</a></h2>
+<a name="fbdev"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-fbdev">18.5 fbdev</a></h2>
<p>Linux framebuffer input device.
</p>
<p>See also <a href="http://linux-fbdev.sourceforge.net/">http://linux-fbdev.sourceforge.net/</a>, and fbset(1).
</p>
<a name="iec61883"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-iec61883">22.6 iec61883</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-iec61883">18.6 iec61883</a></h2>
<p>FireWire DV/HDV input device using libiec61883.
</p>
<p>Specify the FireWire port to be used as input file, or "auto"
to choose the first port connected.
</p>
-<a name="Options-5"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-5">22.6.1 Options</a></h3>
+<a name="Options-12"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Options-12">18.6.1 Options</a></h3>
<dl compact="compact">
<dt> ‘<samp>dvtype</samp>’</dt>
</dd>
</dl>
-<a name="Examples-37"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-37">22.6.2 Examples</a></h3>
+<a name="Examples-26"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-26">18.6.2 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="jack"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-jack">22.7 jack</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-jack">18.7 jack</a></h2>
<p>JACK input device.
</p>
<a href="http://jackaudio.org/">http://jackaudio.org/</a>
</p>
<a name="lavfi"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-lavfi">22.8 lavfi</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-lavfi">18.8 lavfi</a></h2>
<p>Libavfilter input virtual device.
</p>
only video data is supported. The filtergraph is specified through the
option ‘<samp>graph</samp>’.
</p>
-<a name="Options-31"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-31">22.8.1 Options</a></h3>
+<a name="Options-13"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Options-13">18.8.1 Options</a></h3>
<dl compact="compact">
<dt> ‘<samp>graph</samp>’</dt>
</dd>
</dl>
-<a name="Examples-87"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-87">22.8.2 Examples</a></h3>
+<a name="Examples-27"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-27">18.8.2 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="libdc1394"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-libdc1394">22.9 libdc1394</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-libdc1394">18.9 libdc1394</a></h2>
<p>IIDC1394 input device, based on libdc1394 and libraw1394.
</p>
<a name="openal"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-openal">22.10 openal</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-openal">18.10 openal</a></h2>
<p>The OpenAL input device provides audio capture on all systems with a
working OpenAL 1.1 implementation.
</p></dd>
</dl>
-<p>This device allows to capture from an audio input device handled
+<p>This device allows one to capture from an audio input device handled
through OpenAL.
</p>
<p>You need to specify the name of the device to capture in the provided
automatically select the default device. You can get the list of the
supported devices by using the option <var>list_devices</var>.
</p>
-<a name="Options-26"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-26">22.10.1 Options</a></h3>
+<a name="Options-14"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Options-14">18.10.1 Options</a></h3>
<dl compact="compact">
<dt> ‘<samp>channels</samp>’</dt>
</dd>
</dl>
-<a name="Examples-74"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-74">22.10.2 Examples</a></h3>
+<a name="Examples-42"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-42">18.10.2 Examples</a></h3>
<p>Print the list of OpenAL supported devices and exit:
</p><table><tr><td> </td><td><pre class="example">$ ffmpeg -list_devices true -f openal -i dummy out.ogg
try the latest OpenAL Soft if the above does not work.
</p>
<a name="oss"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-oss">22.11 oss</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-oss">18.11 oss</a></h2>
<p>Open Sound System input device.
</p>
<p>For more information about OSS see:
<a href="http://manuals.opensound.com/usersguide/dsp.html">http://manuals.opensound.com/usersguide/dsp.html</a>
</p>
-<a name="pulse-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-pulse-1">22.12 pulse</a></h2>
+<a name="pulse"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-pulse">18.12 pulse</a></h2>
<p>PulseAudio input device.
</p>
</p>
<p>More information about PulseAudio can be found on <a href="http://www.pulseaudio.org">http://www.pulseaudio.org</a>.
</p>
-<a name="Options-30"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-30">22.12.1 Options</a></h3>
+<a name="Options"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Options">18.12.1 Options</a></h3>
<dl compact="compact">
<dt> ‘<samp>server</samp>’</dt>
<dd><p>Connect to a specific PulseAudio server, specified by an IP address.
</p></dd>
</dl>
-<a name="Examples-49"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-49">22.12.2 Examples</a></h3>
+<a name="Examples-71"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-71">18.12.2 Examples</a></h3>
<p>Record a stream from default device:
</p><table><tr><td> </td><td><pre class="example">ffmpeg -f pulse -i default /tmp/pulse.wav
</pre></td></tr></table>
-<a name="sndio-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-sndio-1">22.13 sndio</a></h2>
+<a name="sndio"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-sndio">18.13 sndio</a></h2>
<p>sndio input device.
</p>
</pre></td></tr></table>
<a name="video4linux2_002c-v4l2"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-video4linux2_002c-v4l2">22.14 video4linux2, v4l2</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-video4linux2_002c-v4l2">18.14 video4linux2, v4l2</a></h2>
<p>Video4Linux2 input video device.
</p>
<p>For more information about Video4Linux, check <a href="http://linuxtv.org/">http://linuxtv.org/</a>.
</p>
-<a name="Options-2"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-2">22.14.1 Options</a></h3>
+<a name="Options-9"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Options-9">18.14.1 Options</a></h3>
<dl compact="compact">
<dt> ‘<samp>standard</samp>’</dt>
</dd>
<dt> ‘<samp>input_format</samp>’</dt>
<dd><p>Set the preferred pixel format (for raw video) or a codec name.
-This option allows to select the input format, when several are
+This option allows one to select the input format, when several are
available.
</p>
</dd>
<dd><p>List available formats (supported pixel formats, codecs, and frame
sizes) and exit.
</p>
-<p>Available values are:
-</p><dl compact="compact">
-<dt> ‘<samp>all</samp>’</dt>
-<dd><p>Show all available (compressed and non-compressed) formats.
-</p>
-</dd>
-<dt> ‘<samp>raw</samp>’</dt>
-<dd><p>Show only raw video (non-compressed) formats.
-</p>
-</dd>
-<dt> ‘<samp>compressed</samp>’</dt>
-<dd><p>Show only compressed formats.
-</p></dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>list_standards</samp>’</dt>
-<dd><p>List supported standards and exit.
-</p>
-<p>Available values are:
-</p><dl compact="compact">
-<dt> ‘<samp>all</samp>’</dt>
-<dd><p>Show all supported standards.
-</p></dd>
-</dl>
-
-</dd>
-<dt> ‘<samp>timestamps, ts</samp>’</dt>
-<dd><p>Set type of timestamps for grabbed frames.
-</p>
-<p>Available values are:
-</p><dl compact="compact">
-<dt> ‘<samp>default</samp>’</dt>
-<dd><p>Use timestamps from the kernel.
-</p>
-</dd>
-<dt> ‘<samp>abs</samp>’</dt>
-<dd><p>Use absolute timestamps (wall clock).
-</p>
-</dd>
-<dt> ‘<samp>mono2abs</samp>’</dt>
-<dd><p>Force conversion from monotonic to absolute timestamps.
-</p></dd>
-</dl>
-
-<p>Default value is <code>default</code>.
-</p></dd>
-</dl>
-
-<a name="vfwcap"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-vfwcap">22.15 vfwcap</a></h2>
-
-<p>VfW (Video for Windows) capture input device.
-</p>
-<p>The filename passed as input is the capture driver number, ranging from
-0 to 9. You may use "list" as filename to print a list of drivers. Any
-other filename will be interpreted as device number 0.
-</p>
-<a name="x11grab"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-x11grab">22.16 x11grab</a></h2>
-
-<p>X11 video input device.
-</p>
-<p>This device allows to capture a region of an X11 display.
-</p>
-<p>The filename passed as input has the syntax:
-</p><table><tr><td> </td><td><pre class="example">[<var>hostname</var>]:<var>display_number</var>.<var>screen_number</var>[+<var>x_offset</var>,<var>y_offset</var>]
-</pre></td></tr></table>
-
-<p><var>hostname</var>:<var>display_number</var>.<var>screen_number</var> specifies the
-X11 display name of the screen to grab from. <var>hostname</var> can be
-omitted, and defaults to "localhost". The environment variable
-<code>DISPLAY</code> contains the default display name.
-</p>
-<p><var>x_offset</var> and <var>y_offset</var> specify the offsets of the grabbed
-area with respect to the top-left border of the X11 screen. They
-default to 0.
-</p>
-<p>Check the X11 documentation (e.g. man X) for more detailed information.
-</p>
-<p>Use the <code>dpyinfo</code> program for getting basic information about the
-properties of your X11 display (e.g. grep for "name" or "dimensions").
-</p>
-<p>For example to grab from ‘<tt>:0.0</tt>’ using <code>ffmpeg</code>:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -f x11grab -framerate 25 -video_size cif -i :0.0 out.mpg
-</pre></td></tr></table>
-
-<p>Grab at position <code>10,20</code>:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -f x11grab -framerate 25 -video_size cif -i :0.0+10,20 out.mpg
-</pre></td></tr></table>
-
-<a name="Options-20"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-20">22.16.1 Options</a></h3>
-
-<dl compact="compact">
-<dt> ‘<samp>draw_mouse</samp>’</dt>
-<dd><p>Specify whether to draw the mouse pointer. A value of <code>0</code> specify
-not to draw the pointer. Default value is <code>1</code>.
-</p>
-</dd>
-<dt> ‘<samp>follow_mouse</samp>’</dt>
-<dd><p>Make the grabbed area follow the mouse. The argument can be
-<code>centered</code> or a number of pixels <var>PIXELS</var>.
-</p>
-<p>When it is specified with "centered", the grabbing region follows the mouse
-pointer and keeps the pointer at the center of region; otherwise, the region
-follows only when the mouse pointer reaches within <var>PIXELS</var> (greater than
-zero) to the edge of region.
-</p>
-<p>For example:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -f x11grab -follow_mouse centered -framerate 25 -video_size cif -i :0.0 out.mpg
-</pre></td></tr></table>
-
-<p>To follow only when the mouse pointer reaches within 100 pixels to edge:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -f x11grab -follow_mouse 100 -framerate 25 -video_size cif -i :0.0 out.mpg
-</pre></td></tr></table>
-
-</dd>
-<dt> ‘<samp>framerate</samp>’</dt>
-<dd><p>Set the grabbing frame rate. Default value is <code>ntsc</code>,
-corresponding to a frame rate of <code>30000/1001</code>.
-</p>
-</dd>
-<dt> ‘<samp>show_region</samp>’</dt>
-<dd><p>Show grabbed region on screen.
-</p>
-<p>If <var>show_region</var> is specified with <code>1</code>, then the grabbing
-region will be indicated on screen. With this option, it is easy to
-know what is being grabbed if only a portion of the screen is grabbed.
-</p>
-<p>For example:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -f x11grab -show_region 1 -framerate 25 -video_size cif -i :0.0+10,20 out.mpg
-</pre></td></tr></table>
-
-<p>With <var>follow_mouse</var>:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -f x11grab -follow_mouse centered -show_region 1 -framerate 25 -video_size cif -i :0.0 out.mpg
-</pre></td></tr></table>
-
-</dd>
-<dt> ‘<samp>video_size</samp>’</dt>
-<dd><p>Set the video frame size. Default value is <code>vga</code>.
-</p></dd>
-</dl>
-
-<a name="Output-Devices"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-Output-Devices">23. Output Devices</a></h1>
-
-<p>Output devices are configured elements in FFmpeg that can write
-multimedia data to an output device attached to your system.
-</p>
-<p>When you configure your FFmpeg build, all the supported output devices
-are enabled by default. You can list all available ones using the
-configure option "–list-outdevs".
-</p>
-<p>You can disable all the output devices using the configure option
-"–disable-outdevs", and selectively enable an output device using the
-option "–enable-outdev=<var>OUTDEV</var>", or you can disable a particular
-input device using the option "–disable-outdev=<var>OUTDEV</var>".
-</p>
-<p>The option "-formats" of the ff* tools will display the list of
-enabled output devices (amongst the muxers).
-</p>
-<p>A description of the currently available output devices follows.
-</p>
-<a name="alsa"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-alsa">23.1 alsa</a></h2>
-
-<p>ALSA (Advanced Linux Sound Architecture) output device.
-</p>
-<a name="Examples-33"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-33">23.1.1 Examples</a></h3>
-
-<ul>
-<li>
-Play a file on default ALSA device:
-<table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT -f alsa default
-</pre></td></tr></table>
-
-</li><li>
-Play a file on soundcard 1, audio device 7:
-<table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT -f alsa hw:1,7
-</pre></td></tr></table>
-</li></ul>
-
-<a name="caca"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-caca">23.2 caca</a></h2>
-
-<p>CACA output device.
-</p>
-<p>This output device allows to show a video stream in CACA window.
-Only one CACA window is allowed per application, so you can
-have only one instance of this output device in an application.
-</p>
-<p>To enable this output device you need to configure FFmpeg with
-<code>--enable-libcaca</code>.
-libcaca is a graphics library that outputs text instead of pixels.
-</p>
-<p>For more information about libcaca, check:
-<a href="http://caca.zoy.org/wiki/libcaca">http://caca.zoy.org/wiki/libcaca</a>
-</p>
-<a name="Options-4"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-4">23.2.1 Options</a></h3>
-
-<dl compact="compact">
-<dt> ‘<samp>window_title</samp>’</dt>
-<dd><p>Set the CACA window title, if not specified default to the filename
-specified for the output device.
-</p>
-</dd>
-<dt> ‘<samp>window_size</samp>’</dt>
-<dd><p>Set the CACA window size, can be a string of the form
-<var>width</var>x<var>height</var> or a video size abbreviation.
-If not specified it defaults to the size of the input video.
-</p>
-</dd>
-<dt> ‘<samp>driver</samp>’</dt>
-<dd><p>Set display driver.
-</p>
-</dd>
-<dt> ‘<samp>algorithm</samp>’</dt>
-<dd><p>Set dithering algorithm. Dithering is necessary
-because the picture being rendered has usually far more colours than
-the available palette.
-The accepted values are listed with <code>-list_dither algorithms</code>.
-</p>
-</dd>
-<dt> ‘<samp>antialias</samp>’</dt>
-<dd><p>Set antialias method. Antialiasing smoothens the rendered
-image and avoids the commonly seen staircase effect.
-The accepted values are listed with <code>-list_dither antialiases</code>.
-</p>
-</dd>
-<dt> ‘<samp>charset</samp>’</dt>
-<dd><p>Set which characters are going to be used when rendering text.
-The accepted values are listed with <code>-list_dither charsets</code>.
-</p>
-</dd>
-<dt> ‘<samp>color</samp>’</dt>
-<dd><p>Set color to be used when rendering text.
-The accepted values are listed with <code>-list_dither colors</code>.
-</p>
-</dd>
-<dt> ‘<samp>list_drivers</samp>’</dt>
-<dd><p>If set to ‘<samp>true</samp>’, print a list of available drivers and exit.
-</p>
-</dd>
-<dt> ‘<samp>list_dither</samp>’</dt>
-<dd><p>List available dither options related to the argument.
-The argument must be one of <code>algorithms</code>, <code>antialiases</code>,
-<code>charsets</code>, <code>colors</code>.
-</p></dd>
-</dl>
-
-<a name="Examples-56"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-56">23.2.2 Examples</a></h3>
-
-<ul>
-<li>
-The following command shows the <code>ffmpeg</code> output is an
-CACA window, forcing its size to 80x25:
-<table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT -vcodec rawvideo -pix_fmt rgb24 -window_size 80x25 -f caca -
-</pre></td></tr></table>
-
-</li><li>
-Show the list of available drivers and exit:
-<table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT -pix_fmt rgb24 -f caca -list_drivers true -
-</pre></td></tr></table>
-
-</li><li>
-Show the list of available dither colors and exit:
-<table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT -pix_fmt rgb24 -f caca -list_dither colors -
-</pre></td></tr></table>
-</li></ul>
-
-<a name="fbdev"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-fbdev">23.3 fbdev</a></h2>
-
-<p>Linux framebuffer output device.
-</p>
-<p>The Linux framebuffer is a graphic hardware-independent abstraction
-layer to show graphics on a computer monitor, typically on the
-console. It is accessed through a file device node, usually
-‘<tt>/dev/fb0</tt>’.
-</p>
-<p>For more detailed information read the file
-‘<tt>Documentation/fb/framebuffer.txt</tt>’ included in the Linux source tree.
-</p>
-<a name="Options-15"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-15">23.3.1 Options</a></h3>
-<dl compact="compact">
-<dt> ‘<samp>xoffset</samp>’</dt>
-<dt> ‘<samp>yoffset</samp>’</dt>
-<dd><p>Set x/y coordinate of top left corner. Default is 0.
-</p></dd>
-</dl>
-
-<a name="Examples-66"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-66">23.3.2 Examples</a></h3>
-<p>Play a file on framebuffer device ‘<tt>/dev/fb0</tt>’.
-Required pixel format depends on current framebuffer settings.
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -re -i INPUT -vcodec rawvideo -pix_fmt bgra -f fbdev /dev/fb0
-</pre></td></tr></table>
-
-<p>See also <a href="http://linux-fbdev.sourceforge.net/">http://linux-fbdev.sourceforge.net/</a>, and fbset(1).
-</p>
-<a name="oss-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-oss-1">23.4 oss</a></h2>
-
-<p>OSS (Open Sound System) output device.
-</p>
-<a name="pulse"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-pulse">23.5 pulse</a></h2>
-
-<p>PulseAudio output device.
-</p>
-<p>To enable this output device you need to configure FFmpeg with <code>--enable-libpulse</code>.
-</p>
-<p>More information about PulseAudio can be found on <a href="http://www.pulseaudio.org">http://www.pulseaudio.org</a>
-</p>
-<a name="Options-6"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-6">23.5.1 Options</a></h3>
-<dl compact="compact">
-<dt> ‘<samp>server</samp>’</dt>
-<dd><p>Connect to a specific PulseAudio server, specified by an IP address.
-Default server is used when not provided.
-</p>
-</dd>
-<dt> ‘<samp>name</samp>’</dt>
-<dd><p>Specify the application name PulseAudio will use when showing active clients,
-by default it is the <code>LIBAVFORMAT_IDENT</code> string.
-</p>
-</dd>
-<dt> ‘<samp>stream_name</samp>’</dt>
-<dd><p>Specify the stream name PulseAudio will use when showing active streams,
-by default it is set to the specified output name.
+<p>Available values are:
+</p><dl compact="compact">
+<dt> ‘<samp>all</samp>’</dt>
+<dd><p>Show all available (compressed and non-compressed) formats.
</p>
</dd>
-<dt> ‘<samp>device</samp>’</dt>
-<dd><p>Specify the device to use. Default device is used when not provided.
-List of output devices can be obtained with command <code>pactl list sinks</code>.
+<dt> ‘<samp>raw</samp>’</dt>
+<dd><p>Show only raw video (non-compressed) formats.
</p>
</dd>
-<dt> ‘<samp>buffer_size</samp>’</dt>
-<dt> ‘<samp>buffer_duration</samp>’</dt>
-<dd><p>Control the size and duration of the PulseAudio buffer. A small buffer
-gives more control, but requires more frequent updates.
-</p>
-<p>‘<samp>buffer_size</samp>’ specifies size in bytes while
-‘<samp>buffer_duration</samp>’ specifies duration in milliseconds.
-</p>
-<p>When both options are provided then the highest value is used
-(duration is recalculated to bytes using stream parameters). If they
-are set to 0 (which is default), the device will use the default
-PulseAudio duration value. By default PulseAudio set buffer duration
-to around 2 seconds.
+<dt> ‘<samp>compressed</samp>’</dt>
+<dd><p>Show only compressed formats.
</p></dd>
</dl>
-<a name="Examples-23"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-23">23.5.2 Examples</a></h3>
-<p>Play a file on default device on default server:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT -f pulse "stream name"
-</pre></td></tr></table>
-
-<a name="sdl"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-sdl">23.6 sdl</a></h2>
-
-<p>SDL (Simple DirectMedia Layer) output device.
-</p>
-<p>This output device allows to show a video stream in an SDL
-window. Only one SDL window is allowed per application, so you can
-have only one instance of this output device in an application.
-</p>
-<p>To enable this output device you need libsdl installed on your system
-when configuring your build.
-</p>
-<p>For more information about SDL, check:
-<a href="http://www.libsdl.org/">http://www.libsdl.org/</a>
+</dd>
+<dt> ‘<samp>list_standards</samp>’</dt>
+<dd><p>List supported standards and exit.
</p>
-<a name="Options-12"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-12">23.6.1 Options</a></h3>
+<p>Available values are:
+</p><dl compact="compact">
+<dt> ‘<samp>all</samp>’</dt>
+<dd><p>Show all supported standards.
+</p></dd>
+</dl>
-<dl compact="compact">
-<dt> ‘<samp>window_title</samp>’</dt>
-<dd><p>Set the SDL window title, if not specified default to the filename
-specified for the output device.
-</p>
</dd>
-<dt> ‘<samp>icon_title</samp>’</dt>
-<dd><p>Set the name of the iconified SDL window, if not specified it is set
-to the same value of <var>window_title</var>.
+<dt> ‘<samp>timestamps, ts</samp>’</dt>
+<dd><p>Set type of timestamps for grabbed frames.
+</p>
+<p>Available values are:
+</p><dl compact="compact">
+<dt> ‘<samp>default</samp>’</dt>
+<dd><p>Use timestamps from the kernel.
</p>
</dd>
-<dt> ‘<samp>window_size</samp>’</dt>
-<dd><p>Set the SDL window size, can be a string of the form
-<var>width</var>x<var>height</var> or a video size abbreviation.
-If not specified it defaults to the size of the input video,
-downscaled according to the aspect ratio.
+<dt> ‘<samp>abs</samp>’</dt>
+<dd><p>Use absolute timestamps (wall clock).
</p>
</dd>
-<dt> ‘<samp>window_fullscreen</samp>’</dt>
-<dd><p>Set fullscreen mode when non-zero value is provided.
-Default value is zero.
+<dt> ‘<samp>mono2abs</samp>’</dt>
+<dd><p>Force conversion from monotonic to absolute timestamps.
</p></dd>
</dl>
-<a name="Interactive-commands"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Interactive-commands">23.6.2 Interactive commands</a></h3>
-
-<p>The window created by the device can be controlled through the
-following interactive commands.
-</p>
-<dl compact="compact">
-<dt> <q, ESC></dt>
-<dd><p>Quit the device immediately.
+<p>Default value is <code>default</code>.
</p></dd>
</dl>
-<a name="Examples-82"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-82">23.6.3 Examples</a></h3>
-
-<p>The following command shows the <code>ffmpeg</code> output is an
-SDL window, forcing its size to the qcif format:
-</p><table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT -vcodec rawvideo -pix_fmt yuv420p -window_size qcif -f sdl "SDL output"
-</pre></td></tr></table>
-
-<a name="sndio"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-sndio">23.7 sndio</a></h2>
+<a name="vfwcap"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-vfwcap">18.15 vfwcap</a></h2>
-<p>sndio audio output device.
+<p>VfW (Video for Windows) capture input device.
+</p>
+<p>The filename passed as input is the capture driver number, ranging from
+0 to 9. You may use "list" as filename to print a list of drivers. Any
+other filename will be interpreted as device number 0.
</p>
-<a name="xv"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-xv">23.8 xv</a></h2>
+<a name="x11grab"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-x11grab">18.16 x11grab</a></h2>
-<p>XV (XVideo) output device.
+<p>X11 video input device.
</p>
-<p>This output device allows to show a video stream in a X Window System
-window.
+<p>This device allows one to capture a region of an X11 display.
</p>
-<a name="Options-3"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-3">23.8.1 Options</a></h3>
+<p>The filename passed as input has the syntax:
+</p><table><tr><td> </td><td><pre class="example">[<var>hostname</var>]:<var>display_number</var>.<var>screen_number</var>[+<var>x_offset</var>,<var>y_offset</var>]
+</pre></td></tr></table>
-<dl compact="compact">
-<dt> ‘<samp>display_name</samp>’</dt>
-<dd><p>Specify the hardware display name, which determines the display and
-communications domain to be used.
-</p>
-<p>The display name or DISPLAY environment variable can be a string in
-the format <var>hostname</var>[:<var>number</var>[.<var>screen_number</var>]].
+<p><var>hostname</var>:<var>display_number</var>.<var>screen_number</var> specifies the
+X11 display name of the screen to grab from. <var>hostname</var> can be
+omitted, and defaults to "localhost". The environment variable
+<code>DISPLAY</code> contains the default display name.
</p>
-<p><var>hostname</var> specifies the name of the host machine on which the
-display is physically attached. <var>number</var> specifies the number of
-the display server on that host machine. <var>screen_number</var> specifies
-the screen to be used on that server.
+<p><var>x_offset</var> and <var>y_offset</var> specify the offsets of the grabbed
+area with respect to the top-left border of the X11 screen. They
+default to 0.
</p>
-<p>If unspecified, it defaults to the value of the DISPLAY environment
-variable.
+<p>Check the X11 documentation (e.g. man X) for more detailed information.
</p>
-<p>For example, <code>dual-headed:0.1</code> would specify screen 1 of display
-0 on the machine named “dual-headed”.
+<p>Use the <code>dpyinfo</code> program for getting basic information about the
+properties of your X11 display (e.g. grep for "name" or "dimensions").
</p>
-<p>Check the X11 specification for more detailed information about the
-display name format.
+<p>For example to grab from ‘<tt>:0.0</tt>’ using <code>ffmpeg</code>:
+</p><table><tr><td> </td><td><pre class="example">ffmpeg -f x11grab -framerate 25 -video_size cif -i :0.0 out.mpg
+</pre></td></tr></table>
+
+<p>Grab at position <code>10,20</code>:
+</p><table><tr><td> </td><td><pre class="example">ffmpeg -f x11grab -framerate 25 -video_size cif -i :0.0+10,20 out.mpg
+</pre></td></tr></table>
+
+<a name="Options-8"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Options-8">18.16.1 Options</a></h3>
+
+<dl compact="compact">
+<dt> ‘<samp>draw_mouse</samp>’</dt>
+<dd><p>Specify whether to draw the mouse pointer. A value of <code>0</code> specify
+not to draw the pointer. Default value is <code>1</code>.
</p>
</dd>
-<dt> ‘<samp>window_size</samp>’</dt>
-<dd><p>Set the created window size, can be a string of the form
-<var>width</var>x<var>height</var> or a video size abbreviation. If not
-specified it defaults to the size of the input video.
+<dt> ‘<samp>follow_mouse</samp>’</dt>
+<dd><p>Make the grabbed area follow the mouse. The argument can be
+<code>centered</code> or a number of pixels <var>PIXELS</var>.
+</p>
+<p>When it is specified with "centered", the grabbing region follows the mouse
+pointer and keeps the pointer at the center of region; otherwise, the region
+follows only when the mouse pointer reaches within <var>PIXELS</var> (greater than
+zero) to the edge of region.
</p>
+<p>For example:
+</p><table><tr><td> </td><td><pre class="example">ffmpeg -f x11grab -follow_mouse centered -framerate 25 -video_size cif -i :0.0 out.mpg
+</pre></td></tr></table>
+
+<p>To follow only when the mouse pointer reaches within 100 pixels to edge:
+</p><table><tr><td> </td><td><pre class="example">ffmpeg -f x11grab -follow_mouse 100 -framerate 25 -video_size cif -i :0.0 out.mpg
+</pre></td></tr></table>
+
</dd>
-<dt> ‘<samp>window_x</samp>’</dt>
-<dt> ‘<samp>window_y</samp>’</dt>
-<dd><p>Set the X and Y window offsets for the created window. They are both
-set to 0 by default. The values may be ignored by the window manager.
+<dt> ‘<samp>framerate</samp>’</dt>
+<dd><p>Set the grabbing frame rate. Default value is <code>ntsc</code>,
+corresponding to a frame rate of <code>30000/1001</code>.
</p>
</dd>
-<dt> ‘<samp>window_title</samp>’</dt>
-<dd><p>Set the window title, if not specified default to the filename
-specified for the output device.
-</p></dd>
-</dl>
-
-<p>For more information about XVideo see <a href="http://www.x.org/">http://www.x.org/</a>.
+<dt> ‘<samp>show_region</samp>’</dt>
+<dd><p>Show grabbed region on screen.
</p>
-<a name="Examples-48"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-48">23.8.2 Examples</a></h3>
-
-<ul>
-<li>
-Decode, display and encode video input with <code>ffmpeg</code> at the
-same time:
-<table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT OUTPUT -f xv display
+<p>If <var>show_region</var> is specified with <code>1</code>, then the grabbing
+region will be indicated on screen. With this option, it is easy to
+know what is being grabbed if only a portion of the screen is grabbed.
+</p>
+<p>For example:
+</p><table><tr><td> </td><td><pre class="example">ffmpeg -f x11grab -show_region 1 -framerate 25 -video_size cif -i :0.0+10,20 out.mpg
</pre></td></tr></table>
-</li><li>
-Decode and display the input video to multiple X11 windows:
-<table><tr><td> </td><td><pre class="example">ffmpeg -i INPUT -f xv normal -vf negate -f xv negated
+<p>With <var>follow_mouse</var>:
+</p><table><tr><td> </td><td><pre class="example">ffmpeg -f x11grab -follow_mouse centered -show_region 1 -framerate 25 -video_size cif -i :0.0 out.mpg
</pre></td></tr></table>
-</li></ul>
+
+</dd>
+<dt> ‘<samp>video_size</samp>’</dt>
+<dd><p>Set the video frame size. Default value is <code>vga</code>.
+</p></dd>
+</dl>
<a name="Resampler-Options"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-Resampler-Options">24. Resampler Options</a></h1>
+<h1 class="chapter"><a href="ffplay-all.html#toc-Resampler-Options">19. Resampler Options</a></h1>
<p>The audio resampler supports the following named options.
</p>
<p><a name="scaler_005foptions"></a>
</p><a name="Scaler-Options"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-Scaler-Options">25. Scaler Options</a></h1>
+<h1 class="chapter"><a href="ffplay-all.html#toc-Scaler-Options">20. Scaler Options</a></h1>
<p>The video scaler supports the following named options.
</p>
<dd><p>Select averaging area rescaling algorithm.
</p>
</dd>
-<dt> ‘<samp>bicubiclin</samp>’</dt>
+<dt> ‘<samp>bicublin</samp>’</dt>
<dd><p>Select bicubic scaling algorithm for the luma component, bilinear for
chroma components.
</p>
</dl>
<a name="Filtering-Introduction"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-Filtering-Introduction">26. Filtering Introduction</a></h1>
+<h1 class="chapter"><a href="ffplay-all.html#toc-Filtering-Introduction">21. Filtering Introduction</a></h1>
<p>Filtering in FFmpeg is enabled through the libavfilter library.
</p>
</p>
<a name="graph2dot"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-graph2dot">27. graph2dot</a></h1>
+<h1 class="chapter"><a href="ffplay-all.html#toc-graph2dot">22. graph2dot</a></h1>
<p>The ‘<tt>graph2dot</tt>’ program included in the FFmpeg ‘<tt>tools</tt>’
directory can be used to parse a filtergraph description and issue a
</p>
<a name="Filtergraph-description"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-Filtergraph-description">28. Filtergraph description</a></h1>
+<h1 class="chapter"><a href="ffplay-all.html#toc-Filtergraph-description">23. Filtergraph description</a></h1>
<p>A filtergraph is a directed graph of connected filters. It can contain
cycles, and there can be multiple links between a pair of
</p>
<p><a name="Filtergraph-syntax"></a>
</p><a name="Filtergraph-syntax-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-Filtergraph-syntax-1">28.1 Filtergraph syntax</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-Filtergraph-syntax-1">23.1 Filtergraph syntax</a></h2>
<p>A filtergraph can be represented using a textual representation, which is
recognized by the ‘<samp>-filter</samp>’/‘<samp>-vf</samp>’ and ‘<samp>-filter_complex</samp>’
</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
</pre></td></tr></table>
<a name="Notes-on-filtergraph-escaping"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-Notes-on-filtergraph-escaping">28.2 Notes on filtergraph escaping</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-Notes-on-filtergraph-escaping">23.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="ffplay-all.html#toc-Timeline-editing">29. Timeline editing</a></h1>
+<h1 class="chapter"><a href="ffplay-all.html#toc-Timeline-editing">24. Timeline editing</a></h1>
<p>Some filters support a generic ‘<samp>enable</samp>’ option. For the filters
supporting timeline editing, this option can be set to an expression which is
<a name="Audio-Filters"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-Audio-Filters">30. Audio Filters</a></h1>
+<h1 class="chapter"><a href="ffplay-all.html#toc-Audio-Filters">25. Audio Filters</a></h1>
<p>When you configure your FFmpeg build, you can disable any of the
existing filters using <code>--disable-filters</code>.
<p>Below is a description of the currently available audio filters.
</p>
<a name="aconvert"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-aconvert">30.1 aconvert</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-aconvert">25.1 aconvert</a></h2>
<p>Convert the input audio format to the specified formats.
</p>
<p>The special parameter "auto", signifies that the filter will
automatically select the output format depending on the output filter.
</p>
-<a name="Examples-47"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-47">30.1.1 Examples</a></h3>
+<a name="Examples-18"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-18">25.1.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="adelay"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-adelay">30.2 adelay</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-adelay">25.2 adelay</a></h2>
<p>Delay one or more audio channels.
</p>
</p></dd>
</dl>
-<a name="Examples-41"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-41">30.2.1 Examples</a></h3>
+<a name="Examples-30"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-30">25.2.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="aecho"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-aecho">30.3 aecho</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-aecho">25.3 aecho</a></h2>
<p>Apply echoing to the input audio.
</p>
</p></dd>
</dl>
-<a name="Examples-19"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-19">30.3.1 Examples</a></h3>
+<a name="Examples-41"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-41">25.3.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="aeval"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-aeval">30.4 aeval</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-aeval">25.4 aeval</a></h2>
<p>Modify an audio signal according to the specified expressions.
</p>
<p>Note: this filter is slow. For faster processing you should use a
dedicated filter.
</p>
-<a name="Examples-34"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-34">30.4.1 Examples</a></h3>
+<a name="Examples-21"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-21">25.4.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="afade"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-afade">30.5 afade</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-afade">25.5 afade</a></h2>
<p>Apply fade-in/out effect to input audio.
</p>
</dd>
</dl>
-<a name="Examples-24"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-24">30.5.1 Examples</a></h3>
+<a name="Examples-72"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-72">25.5.1 Examples</a></h3>
<ul>
<li>
<p><a name="aformat"></a>
</p><a name="aformat-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-aformat-1">30.6 aformat</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-aformat-1">25.6 aformat</a></h2>
<p>Set output format constraints for the input audio. The framework will
negotiate the most appropriate format to minimize conversions.
</pre></td></tr></table>
<a name="allpass"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-allpass">30.7 allpass</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-allpass">25.7 allpass</a></h2>
<p>Apply a two-pole all-pass filter with central frequency (in Hz)
<var>frequency</var>, and filter-width <var>width</var>.
</dl>
<a name="amerge"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-amerge">30.8 amerge</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-amerge">25.8 amerge</a></h2>
<p>Merge two or more audio streams into a single multi-channel stream.
</p>
<p>If inputs do not have the same duration, the output will stop with the
shortest.
</p>
-<a name="Examples-62"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-62">30.8.1 Examples</a></h3>
+<a name="Examples-28"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-28">25.8.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="amix"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-amix">30.9 amix</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-amix">25.9 amix</a></h2>
<p>Mixes multiple audio inputs into a single output.
</p>
</dl>
<a name="anull"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-anull">30.10 anull</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-anull">25.10 anull</a></h2>
<p>Pass the audio source unchanged to the output.
</p>
<a name="apad"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-apad">30.11 apad</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-apad">25.11 apad</a></h2>
<p>Pad the end of a audio stream with silence, this can be used together with
-shortest to extend audio streams to the same length as the video stream.
</p>
<a name="aphaser"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-aphaser">30.12 aphaser</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-aphaser">25.12 aphaser</a></h2>
<p>Add a phasing effect to the input audio.
</p>
<p>A phaser filter creates series of peaks and troughs in the frequency spectrum.
<p><a name="aresample"></a>
</p><a name="aresample-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-aresample-1">30.13 aresample</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-aresample-1">25.13 aresample</a></h2>
<p>Resample the input audio to the specified parameters, using the
libswresample library. If none are specified then the filter will
<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-22"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-22">30.13.1 Examples</a></h3>
+<a name="Examples-84"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-84">25.13.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="asetnsamples"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-asetnsamples">30.14 asetnsamples</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-asetnsamples">25.14 asetnsamples</a></h2>
<p>Set the number of samples per each output audio frame.
</p>
</pre></td></tr></table>
<a name="asetrate"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-asetrate">30.15 asetrate</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-asetrate">25.15 asetrate</a></h2>
<p>Set the sample rate without altering the PCM data.
This will result in a change of speed and pitch.
</dl>
<a name="ashowinfo"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-ashowinfo">30.16 ashowinfo</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-ashowinfo">25.16 ashowinfo</a></h2>
<p>Show a line containing various information for each input audio frame.
The input audio is not modified.
</dl>
<a name="astats"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-astats">30.17 astats</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-astats">25.17 astats</a></h2>
<p>Display time domain statistical information about the audio channels.
Statistics are calculated and displayed for each audio channel and,
</dl>
<a name="astreamsync"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-astreamsync">30.18 astreamsync</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-astreamsync">25.18 astreamsync</a></h2>
<p>Forward two audio streams and control the order the buffers are forwarded.
</p>
</p></dd>
</dl>
-<a name="Examples-46"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-46">30.18.1 Examples</a></h3>
+<a name="Examples-35"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-35">25.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:
</pre></td></tr></table>
<a name="asyncts"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-asyncts">30.19 asyncts</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-asyncts">25.19 asyncts</a></h2>
<p>Synchronize audio data with timestamps by squeezing/stretching it and/or
dropping samples/adding silence when needed.
</dl>
<a name="atempo"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-atempo">30.20 atempo</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-atempo">25.20 atempo</a></h2>
<p>Adjust audio tempo.
</p>
specified then the filter will assume nominal 1.0 tempo. Tempo must
be in the [0.5, 2.0] range.
</p>
-<a name="Examples-60"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-60">30.20.1 Examples</a></h3>
+<a name="Examples-57"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-57">25.20.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="atrim"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-atrim">30.21 atrim</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-atrim">25.21 atrim</a></h2>
<p>Trim the input so that the output contains one continuous subpart of the input.
</p>
</li></ul>
<a name="bandpass"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-bandpass">30.22 bandpass</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-bandpass">25.22 bandpass</a></h2>
<p>Apply a two-pole Butterworth band-pass filter with central
frequency <var>frequency</var>, and (3dB-point) band-width width.
</dl>
<a name="bandreject"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-bandreject">30.23 bandreject</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-bandreject">25.23 bandreject</a></h2>
<p>Apply a two-pole Butterworth band-reject filter with central
frequency <var>frequency</var>, and (3dB-point) band-width <var>width</var>.
</dl>
<a name="bass"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-bass">30.24 bass</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-bass">25.24 bass</a></h2>
<p>Boost or cut the bass (lower) frequencies of the audio using a two-pole
shelving filter with a response similar to that of a standard
</dl>
<a name="biquad"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-biquad">30.25 biquad</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-biquad">25.25 biquad</a></h2>
<p>Apply a biquad IIR filter with the given coefficients.
Where <var>b0</var>, <var>b1</var>, <var>b2</var> and <var>a0</var>, <var>a1</var>, <var>a2</var>
are the numerator and denominator coefficients respectively.
</p>
<a name="channelmap"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-channelmap">30.26 channelmap</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-channelmap">25.26 channelmap</a></h2>
<p>Remap input channels to new locations.
</p>
</pre></td></tr></table>
<a name="channelsplit"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-channelsplit">30.27 channelsplit</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-channelsplit">25.27 channelsplit</a></h2>
<p>Split each channel in input audio stream into a separate output stream.
</p>
</pre></td></tr></table>
<a name="compand"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-compand">30.28 compand</a></h2>
-
+<h2 class="section"><a href="ffplay-all.html#toc-compand">25.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-15"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-15">30.28.1 Examples</a></h3>
+<a name="Examples-37"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-37">25.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>
<a name="earwax"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-earwax">30.29 earwax</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-earwax">25.29 earwax</a></h2>
<p>Make audio easier to listen to on headphones.
</p>
<p>Ported from SoX.
</p>
<a name="equalizer"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-equalizer">30.30 equalizer</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-equalizer">25.30 equalizer</a></h2>
<p>Apply a two-pole peaking equalisation (EQ) filter. With this
filter, the signal-level at and around a selected frequency can
</p></dd>
</dl>
+<a name="Examples-69"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-69">25.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="ffplay-all.html#toc-highpass">30.31 highpass</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-highpass">25.31 highpass</a></h2>
<p>Apply a high-pass filter with 3dB point frequency.
The filter can be either single-pole, or double-pole (the default).
</dl>
<a name="join"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-join">30.32 join</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-join">25.32 join</a></h2>
<p>Join multiple input streams into one multi-channel stream.
</p>
</pre></td></tr></table>
<a name="ladspa"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-ladspa">30.33 ladspa</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-ladspa">25.33 ladspa</a></h2>
<p>Load a LADSPA (Linux Audio Developer’s Simple Plugin API) plugin.
</p>
</dd>
</dl>
-<a name="Examples-9"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-9">30.33.1 Examples</a></h3>
+<a name="Examples-54"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-54">25.33.1 Examples</a></h3>
<ul>
<li>
</pre></td></tr></table>
</li></ul>
-<a name="Commands-3"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Commands-3">30.33.2 Commands</a></h3>
+<a name="Commands-1"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Commands-1">25.33.2 Commands</a></h3>
<p>This filter supports the following commands:
</p><dl compact="compact">
</dl>
<a name="lowpass"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-lowpass">30.34 lowpass</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-lowpass">25.34 lowpass</a></h2>
<p>Apply a low-pass filter with 3dB point frequency.
The filter can be either single-pole or double-pole (the default).
</dl>
<a name="pan"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-pan">30.35 pan</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-pan">25.35 pan</a></h2>
<p>Mix channels with specific gain levels. The filter accepts the output
channel layout followed by a set of channels definitions.
avoiding clipping noise.
</p>
<a name="Mixing-examples"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Mixing-examples">30.35.1 Mixing examples</a></h3>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Mixing-examples">25.35.1 Mixing examples</a></h3>
<p>For example, if you want to down-mix from stereo to mono, but with a bigger
factor for the left channel:
needs.
</p>
<a name="Remapping-examples"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Remapping-examples">30.35.2 Remapping examples</a></h3>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Remapping-examples">25.35.2 Remapping examples</a></h3>
<p>The channel remapping will be effective if, and only if:
</p>
</pre></td></tr></table>
<a name="replaygain"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-replaygain">30.36 replaygain</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-replaygain">25.36 replaygain</a></h2>
<p>ReplayGain scanner filter. This filter takes an audio stream as an input and
outputs it unchanged.
At end of filtering it displays <code>track_gain</code> and <code>track_peak</code>.
</p>
<a name="resample"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-resample">30.37 resample</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-resample">25.37 resample</a></h2>
<p>Convert the audio sample format, sample rate and channel layout. This filter is
not meant to be used directly.
</p>
<a name="silencedetect"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-silencedetect">30.38 silencedetect</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-silencedetect">25.38 silencedetect</a></h2>
<p>Detect silence in an audio stream.
</p>
</p></dd>
</dl>
-<a name="Examples-64"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-64">30.38.1 Examples</a></h3>
+<a name="Examples-14"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-14">25.38.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="treble"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-treble">30.39 treble</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-treble">25.39 treble</a></h2>
<p>Boost or cut treble (upper) frequencies of the audio using a two-pole
shelving filter with a response similar to that of a standard
</dl>
<a name="volume"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-volume">30.40 volume</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-volume">25.40 volume</a></h2>
<p>Adjust the input audio volume.
</p>
</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-80"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-80">30.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-3"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Commands-3">25.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-51"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-51">25.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>
-<h2 class="section"><a href="ffplay-all.html#toc-volumedetect">30.41 volumedetect</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-volumedetect">25.41 volumedetect</a></h2>
<p>Detect the volume of the input video.
</p>
</p>
<p>All volumes are in decibels relative to the maximum PCM value.
</p>
-<a name="Examples-55"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-55">30.41.1 Examples</a></h3>
+<a name="Examples-63"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-63">25.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
</p>
<a name="Audio-Sources"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-Audio-Sources">31. Audio Sources</a></h1>
+<h1 class="chapter"><a href="ffplay-all.html#toc-Audio-Sources">26. Audio Sources</a></h1>
<p>Below is a description of the currently available audio sources.
</p>
<a name="abuffer"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-abuffer">31.1 abuffer</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-abuffer">26.1 abuffer</a></h2>
<p>Buffer audio frames, and make them available to the filter chain.
</p>
</dd>
</dl>
-<a name="Examples-27"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-27">31.1.1 Examples</a></h3>
+<a name="Examples-6"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-6">26.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>
</pre></td></tr></table>
<a name="aevalsrc"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-aevalsrc">31.2 aevalsrc</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-aevalsrc">26.2 aevalsrc</a></h2>
<p>Generate an audio signal specified by an expression.
</p>
</dd>
</dl>
-<a name="Examples-78"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-78">31.2.1 Examples</a></h3>
+<a name="Examples-56"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-56">26.2.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="anullsrc"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-anullsrc">31.3 anullsrc</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-anullsrc">26.3 anullsrc</a></h2>
<p>Null audio source, return unprocessed audio frames. It is mainly useful
as a template and to be employed in analysis / debugging tools, or as
</dd>
</dl>
-<a name="Examples-84"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-84">31.3.1 Examples</a></h3>
+<a name="Examples-38"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-38">26.3.1 Examples</a></h3>
<ul>
<li>
<p>All the parameters need to be explicitly defined.
</p>
<a name="flite"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-flite">31.4 flite</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-flite">26.4 flite</a></h2>
<p>Synthesize a voice utterance using the libflite library.
</p>
</p></dd>
</dl>
-<a name="Examples-85"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-85">31.4.1 Examples</a></h3>
+<a name="Examples-80"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-80">26.4.1 Examples</a></h3>
<ul>
<li>
<a href="http://www.speech.cs.cmu.edu/flite/">http://www.speech.cs.cmu.edu/flite/</a>
</p>
<a name="sine"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-sine">31.5 sine</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-sine">26.5 sine</a></h2>
<p>Generate an audio signal made of a sine wave with amplitude 1/8.
</p>
</p></dd>
</dl>
-<a name="Examples-32"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-32">31.5.1 Examples</a></h3>
+<a name="Examples-50"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-50">26.5.1 Examples</a></h3>
<ul>
<li>
<a name="Audio-Sinks"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-Audio-Sinks">32. Audio Sinks</a></h1>
+<h1 class="chapter"><a href="ffplay-all.html#toc-Audio-Sinks">27. Audio Sinks</a></h1>
<p>Below is a description of the currently available audio sinks.
</p>
<a name="abuffersink"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-abuffersink">32.1 abuffersink</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-abuffersink">27.1 abuffersink</a></h2>
<p>Buffer audio frames, and make them available to the end of filter chain.
</p>
parameter to <code>avfilter_init_filter</code> for initialization.
</p>
<a name="anullsink"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-anullsink">32.2 anullsink</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-anullsink">27.2 anullsink</a></h2>
<p>Null audio sink, do absolutely nothing with the input audio. It is
mainly useful as a template and to be employed in analysis / debugging
</p>
<a name="Video-Filters"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-Video-Filters">33. Video Filters</a></h1>
+<h1 class="chapter"><a href="ffplay-all.html#toc-Video-Filters">28. Video Filters</a></h1>
<p>When you configure your FFmpeg build, you can disable any of the
existing filters using <code>--disable-filters</code>.
<p>Below is a description of the currently available video filters.
</p>
<a name="alphaextract"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-alphaextract">33.1 alphaextract</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-alphaextract">28.1 alphaextract</a></h2>
<p>Extract the alpha component from the input as a grayscale video. This
is especially useful with the <var>alphamerge</var> filter.
</p>
<a name="alphamerge"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-alphamerge">33.2 alphamerge</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-alphamerge">28.2 alphamerge</a></h2>
<p>Add or replace the alpha component of the primary input with the
grayscale value of a second input. This is intended for use with
overlay to a video stream, consider the <var>overlay</var> filter instead.
</p>
<a name="ass"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-ass">33.3 ass</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-ass">28.3 ass</a></h2>
<p>Same as the <a href="#subtitles">subtitles</a> filter, except that it doesn’t require libavcodec
and libavformat to work. On the other hand, it is limited to ASS (Advanced
Substation Alpha) subtitles files.
</p>
<a name="bbox"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-bbox">33.4 bbox</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-bbox">28.4 bbox</a></h2>
<p>Compute the bounding box for the non-black pixels in the input frame
luminance plane.
</dl>
<a name="blackdetect"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-blackdetect">33.5 blackdetect</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-blackdetect">28.5 blackdetect</a></h2>
<p>Detect video intervals that are (almost) completely black. Can be
useful to detect chapter transitions, commercials, or invalid
</pre></td></tr></table>
<a name="blackframe"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-blackframe">33.6 blackframe</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-blackframe">28.6 blackframe</a></h2>
<p>Detect frames that are (almost) completely black. Can be useful to
detect chapter transitions or commercials. Output lines consist of
</dl>
<a name="blend"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-blend">33.7 blend</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-blend">28.7 blend</a></h2>
<p>Blend two video frames into each other.
</p>
</p></dd>
</dl>
-<a name="Examples-54"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-54">33.7.1 Examples</a></h3>
+<a name="Examples-62"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-62">28.7.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="boxblur"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-boxblur">33.8 boxblur</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-boxblur">28.8 boxblur</a></h2>
<p>Apply boxblur algorithm to the input video.
</p>
</p></dd>
</dl>
-<a name="Examples-4"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-4">33.8.1 Examples</a></h3>
+<a name="Examples-12"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-12">28.8.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="colorbalance"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-colorbalance">33.9 colorbalance</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-colorbalance">28.9 colorbalance</a></h2>
<p>Modify intensity of primary colors (red, green and blue) of input frames.
</p>
<p>The filter allows an input frame to be adjusted in the shadows, midtones or highlights
</p></dd>
</dl>
-<a name="Examples-89"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-89">33.9.1 Examples</a></h3>
+<a name="Examples-68"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-68">28.9.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="colorchannelmixer"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-colorchannelmixer">33.10 colorchannelmixer</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-colorchannelmixer">28.10 colorchannelmixer</a></h2>
<p>Adjust video input frames by re-mixing color channels.
</p>
</p></dd>
</dl>
-<a name="Examples-65"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-65">33.10.1 Examples</a></h3>
+<a name="Examples-33"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-33">28.10.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="colormatrix"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-colormatrix">33.11 colormatrix</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-colormatrix">28.11 colormatrix</a></h2>
<p>Convert color matrix.
</p>
</pre></td></tr></table>
<a name="copy"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-copy">33.12 copy</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-copy">28.12 copy</a></h2>
<p>Copy the input source unchanged to the output. Mainly useful for
testing purposes.
</p>
<a name="crop"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-crop">33.13 crop</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-crop">28.13 crop</a></h2>
<p>Crop the input video to given dimensions.
</p>
<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-8"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-8">33.13.1 Examples</a></h3>
+<a name="Examples-64"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-64">28.13.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="cropdetect"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-cropdetect">33.14 cropdetect</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-cropdetect">28.14 cropdetect</a></h2>
<p>Auto-detect crop size.
</p>
<p><a name="curves"></a>
</p><a name="curves-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-curves-1">33.15 curves</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-curves-1">28.15 curves</a></h2>
<p>Apply color adjustments using curves.
</p>
<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-75"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-75">33.15.1 Examples</a></h3>
+<a name="Examples-77"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-77">28.15.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="dctdnoiz"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-dctdnoiz">33.16 dctdnoiz</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-dctdnoiz">28.16 dctdnoiz</a></h2>
<p>Denoise frames using 2D DCT (frequency domain filtering).
</p>
</p></dd>
</dl>
-<a name="Examples-20"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-20">33.16.1 Examples</a></h3>
+<a name="Examples-22"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-22">28.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><a name="decimate"></a>
</p><a name="decimate-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-decimate-1">33.17 decimate</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-decimate-1">28.17 decimate</a></h2>
<p>Drop duplicated frames at regular intervals.
</p>
</p></dd>
</dl>
+<a name="dejudder"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-dejudder">28.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="ffplay-all.html#toc-delogo">33.18 delogo</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-delogo">28.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-44"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-44">33.18.1 Examples</a></h3>
+<a name="Examples-32"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-32">28.19.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="deshake"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-deshake">33.19 deshake</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-deshake">28.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="ffplay-all.html#toc-drawbox">33.20 drawbox</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-drawbox">28.21 drawbox</a></h2>
<p>Draw a colored box on the input image.
</p>
</dd>
</dl>
-<a name="Examples-86"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-86">33.20.1 Examples</a></h3>
+<a name="Examples-19"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-19">28.21.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="drawgrid"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-drawgrid">33.21 drawgrid</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-drawgrid">28.22 drawgrid</a></h2>
<p>Draw a grid on the input image.
</p>
</dd>
</dl>
-<a name="Examples-36"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-36">33.21.1 Examples</a></h3>
+<a name="Examples-40"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-40">28.22.1 Examples</a></h3>
<ul>
<li>
<p><a name="drawtext"></a>
</p><a name="drawtext-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-drawtext-1">33.22 drawtext</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-drawtext-1">28.23 drawtext</a></h2>
<p>Draw text string or text from specified file on top of video using the
libfreetype library.
<p>To enable compilation of this filter you need to configure FFmpeg with
<code>--enable-libfreetype</code>.
</p>
-<a name="Syntax"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Syntax">33.22.1 Syntax</a></h3>
+<a name="Syntax-2"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Syntax-2">28.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="ffplay-all.html#toc-Text-expansion">33.22.2 Text expansion</a></h3>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Text-expansion">28.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-58"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-58">33.22.3 Examples</a></h3>
+<a name="Examples-44"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-44">28.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="ffplay-all.html#toc-edgedetect">33.23 edgedetect</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-edgedetect">28.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="ffplay-all.html#toc-extractplanes">33.24 extractplanes</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-extractplanes">28.25 extractplanes</a></h2>
<p>Extract color channel components from input video stream into
separate grayscale video streams.
</p></dd>
</dl>
-<a name="Examples-70"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-70">33.24.1 Examples</a></h3>
+<a name="Examples-43"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-43">28.25.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="elbg"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-elbg">33.25 elbg</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-elbg">28.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="ffplay-all.html#toc-fade">33.26 fade</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-fade">28.27 fade</a></h2>
<p>Apply fade-in/out effect to input video.
</p>
</p></dd>
</dl>
-<a name="Examples-3"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-3">33.26.1 Examples</a></h3>
+<a name="Examples-34"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-34">28.27.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="field"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-field">33.27 field</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-field">28.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="ffplay-all.html#toc-fieldmatch">33.28 fieldmatch</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-fieldmatch">28.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="ffplay-all.html#toc-p_002fc_002fn_002fu_002fb-meaning-1">33.28.1 p/c/n/u/b meaning</a></h3>
+<h3 class="subsection"><a href="ffplay-all.html#toc-p_002fc_002fn_002fu_002fb-meaning-1">28.29.1 p/c/n/u/b meaning</a></h3>
<a name="p_002fc_002fn"></a>
-<h4 class="subsubsection"><a href="ffplay-all.html#toc-p_002fc_002fn">33.28.1.1 p/c/n</a></h4>
+<h4 class="subsubsection"><a href="ffplay-all.html#toc-p_002fc_002fn">28.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="ffplay-all.html#toc-u_002fb">33.28.1.2 u/b</a></h4>
+<h4 class="subsubsection"><a href="ffplay-all.html#toc-u_002fb">28.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-52"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-52">33.28.2 Examples</a></h3>
+<a name="Examples-55"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-55">28.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="ffplay-all.html#toc-fieldorder">33.29 fieldorder</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-fieldorder">28.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="ffplay-all.html#toc-fifo">33.30 fifo</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-fifo">28.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="ffplay-all.html#toc-format-1">33.31 format</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-format-1">28.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-57"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-57">33.31.1 Examples</a></h3>
+<a name="Examples-17"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-17">28.32.1 Examples</a></h3>
<ul>
<li>
<p><a name="fps"></a>
</p><a name="fps-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-fps-1">33.32 fps</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-fps-1">28.33 fps</a></h2>
<p>Convert the video to specified constant frame rate by duplicating or dropping
frames as necessary.
</p>
<p>See also the <a href="#setpts">setpts</a> filter.
</p>
-<a name="Examples-25"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-25">33.32.1 Examples</a></h3>
+<a name="Examples-60"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-60">28.33.1 Examples</a></h3>
<ul>
<li>
</pre></td></tr></table>
</li></ul>
+<a name="framepack"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-framepack">28.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="ffplay-all.html#toc-framestep">33.33 framestep</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-framestep">28.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="ffplay-all.html#toc-frei0r-1">33.34 frei0r</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-frei0r-1">28.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-12"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-12">33.34.1 Examples</a></h3>
+<a name="Examples-1"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-1">28.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="ffplay-all.html#toc-geq">33.35 geq</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-geq">28.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-79"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-79">33.35.1 Examples</a></h3>
+<a name="Examples-82"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-82">28.37.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="gradfun"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-gradfun">33.36 gradfun</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-gradfun">28.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-72"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-72">33.36.1 Examples</a></h3>
+<a name="Examples"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples">28.38.1 Examples</a></h3>
<ul>
<li>
<p><a name="haldclut"></a>
</p><a name="haldclut-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-haldclut-1">33.37 haldclut</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-haldclut-1">28.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="ffplay-all.html#toc-Workflow-examples">33.37.1 Workflow examples</a></h3>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Workflow-examples">28.39.1 Workflow examples</a></h3>
<a name="Hald-CLUT-video-stream"></a>
-<h4 class="subsubsection"><a href="ffplay-all.html#toc-Hald-CLUT-video-stream">33.37.1.1 Hald CLUT video stream</a></h4>
+<h4 class="subsubsection"><a href="ffplay-all.html#toc-Hald-CLUT-video-stream">28.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="ffplay-all.html#toc-Hald-CLUT-with-preview">33.37.1.2 Hald CLUT with preview</a></h4>
+<h4 class="subsubsection"><a href="ffplay-all.html#toc-Hald-CLUT-with-preview">28.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="ffplay-all.html#toc-hflip">33.38 hflip</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-hflip">28.40 hflip</a></h2>
<p>Flip the input video horizontally.
</p>
</pre></td></tr></table>
<a name="histeq"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-histeq">33.39 histeq</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-histeq">28.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="ffplay-all.html#toc-histogram">33.40 histogram</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-histogram">28.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-16"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-16">33.40.1 Examples</a></h3>
+<a name="Examples-74"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-74">28.42.1 Examples</a></h3>
<ul>
<li>
<p><a name="hqdn3d"></a>
</p><a name="hqdn3d-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-hqdn3d-1">33.41 hqdn3d</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-hqdn3d-1">28.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="ffplay-all.html#toc-hue">33.42 hue</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-hue">28.44 hue</a></h2>
<p>Modify the hue and/or the saturation of the input.
</p>
</p></dd>
</dl>
-<a name="Examples-51"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-51">33.42.1 Examples</a></h3>
+<a name="Examples-39"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-39">28.44.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="Commands"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Commands">33.42.2 Commands</a></h3>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Commands">28.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="ffplay-all.html#toc-idet">33.43 idet</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-idet">28.45 idet</a></h2>
<p>Detect video interlacing type.
</p>
</dl>
<a name="il"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-il">33.44 il</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-il">28.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="ffplay-all.html#toc-interlace">33.45 interlace</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-interlace">28.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="ffplay-all.html#toc-kerndeint">33.46 kerndeint</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-kerndeint">28.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-50"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-50">33.46.1 Examples</a></h3>
+<a name="Examples-45"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-45">28.48.1 Examples</a></h3>
<ul>
<li>
<p><a name="lut3d"></a>
</p><a name="lut3d-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-lut3d-1">33.47 lut3d</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-lut3d-1">28.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="ffplay-all.html#toc-lut_002c-lutrgb_002c-lutyuv">33.48 lut, lutrgb, lutyuv</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-lut_002c-lutrgb_002c-lutyuv">28.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-14"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-14">33.48.1 Examples</a></h3>
+<a name="Examples-5"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-5">28.50.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="mergeplanes"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-mergeplanes">33.49 mergeplanes</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-mergeplanes">28.51 mergeplanes</a></h2>
<p>Merge color channel components from several video streams.
</p>
</p></dd>
</dl>
-<a name="Examples-67"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-67">33.49.1 Examples</a></h3>
+<a name="Examples-3"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-3">28.51.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="mcdeint"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-mcdeint">33.50 mcdeint</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-mcdeint">28.52 mcdeint</a></h2>
<p>Apply motion-compensation deinterlacing.
</p>
</dl>
<a name="mp"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-mp">33.51 mp</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-mp">28.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-7"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-7">33.51.1 Examples</a></h3>
+<a name="Examples-10"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-10">28.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="ffplay-all.html#toc-mpdecimate">33.52 mpdecimate</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-mpdecimate">28.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="ffplay-all.html#toc-negate">33.53 negate</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-negate">28.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="ffplay-all.html#toc-noformat">33.54 noformat</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-noformat">28.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-53"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-53">33.54.1 Examples</a></h3>
+<a name="Examples-65"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-65">28.56.1 Examples</a></h3>
<ul>
<li>
</pre></td></tr></table>
</li></ul>
-<a name="noise"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-noise">33.55 noise</a></h2>
+<a name="noise-1"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-noise-1">28.57 noise</a></h2>
<p>Add noise on video input frame.
</p>
</dd>
</dl>
-<a name="Examples-17"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-17">33.55.1 Examples</a></h3>
+<a name="Examples-58"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-58">28.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="ffplay-all.html#toc-null">33.56 null</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-null">28.58 null</a></h2>
<p>Pass the video source unchanged to the output.
</p>
<a name="ocv"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-ocv">33.57 ocv</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-ocv">28.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="ffplay-all.html#toc-dilate-1">33.57.1 dilate</a></h3>
+<h3 class="subsection"><a href="ffplay-all.html#toc-dilate-1">28.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="ffplay-all.html#toc-erode">33.57.2 erode</a></h3>
+<h3 class="subsection"><a href="ffplay-all.html#toc-erode">28.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="ffplay-all.html#toc-smooth">33.57.3 smooth</a></h3>
+<h3 class="subsection"><a href="ffplay-all.html#toc-smooth">28.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="ffplay-all.html#toc-overlay-1">33.58 overlay</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-overlay-1">28.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-2"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Commands-2">33.58.1 Commands</a></h3>
+<a name="Commands-4"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Commands-4">28.60.1 Commands</a></h3>
<p>This filter supports the following commands:
</p><dl compact="compact">
</p></dd>
</dl>
-<a name="Examples-73"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-73">33.58.2 Examples</a></h3>
+<a name="Examples-15"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-15">28.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="ffplay-all.html#toc-owdenoise">33.59 owdenoise</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-owdenoise">28.61 owdenoise</a></h2>
<p>Apply Overcomplete Wavelet denoiser.
</p>
</dl>
<a name="pad"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-pad">33.60 pad</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-pad">28.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-63"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-63">33.60.1 Examples</a></h3>
+<a name="Examples-52"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-52">28.62.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="perspective"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-perspective">33.61 perspective</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-perspective">28.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="ffplay-all.html#toc-phase">33.62 phase</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-phase">28.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="ffplay-all.html#toc-pixdesctest">33.63 pixdesctest</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-pixdesctest">28.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="ffplay-all.html#toc-pp">33.64 pp</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-pp">28.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-26"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-26">33.64.1 Examples</a></h3>
+<a name="Examples-11"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-11">28.66.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="psnr"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-psnr">33.65 psnr</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-psnr">28.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="ffplay-all.html#toc-pullup">33.66 pullup</a></h2>
+<p><a name="pullup"></a>
+</p><a name="pullup-1"></a>
+<h2 class="section"><a href="ffplay-all.html#toc-pullup-1">28.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="ffplay-all.html#toc-removelogo">33.67 removelogo</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-removelogo">28.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="ffplay-all.html#toc-rotate">33.68 rotate</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-rotate">28.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-61"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-61">33.68.1 Examples</a></h3>
+<a name="Examples-79"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-79">28.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-1"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Commands-1">33.68.2 Commands</a></h3>
+<a name="Commands-5"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Commands-5">28.70.2 Commands</a></h3>
<p>The filter supports the following commands:
</p>
</dl>
<a name="sab"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-sab">33.69 sab</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-sab">28.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="ffplay-all.html#toc-scale-1">33.70 scale</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-scale-1">28.72 scale</a></h2>
<p>Scale (resize) the input video, using the libswscale library.
</p>
the next filter, the scale filter will convert the input to the
requested format.
</p>
-<a name="Options-21"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Options-21">33.70.1 Options</a></h3>
+<a name="Options-6"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Options-6">28.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-1"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-1">33.70.2 Examples</a></h3>
+<a name="Examples-47"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-47">28.72.2 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="separatefields"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-separatefields">33.71 separatefields</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-separatefields">28.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="ffplay-all.html#toc-setdar_002c-setsar">33.72 setdar, setsar</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-setdar_002c-setsar">28.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-91"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-91">33.72.1 Examples</a></h3>
+<a name="Examples-76"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-76">28.74.1 Examples</a></h3>
<ul>
<li>
<p><a name="setfield"></a>
</p><a name="setfield-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-setfield-1">33.73 setfield</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-setfield-1">28.75 setfield</a></h2>
<p>Force field for the output video frame.
</p>
</dl>
<a name="showinfo"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-showinfo">33.74 showinfo</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-showinfo">28.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="ffplay-all.html#toc-smartblur-1">33.75 smartblur</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-smartblur-1">28.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="ffplay-all.html#toc-stereo3d">33.76 stereo3d</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-stereo3d">28.78 stereo3d</a></h2>
<p>Convert between different stereoscopic image formats.
</p>
</p></dd>
</dl>
-<a name="Examples-77"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-77">33.76.1 Examples</a></h3>
+<a name="Examples-2"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-2">28.78.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="spp"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-spp">33.77 spp</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-spp">28.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="ffplay-all.html#toc-subtitles-1">33.78 subtitles</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-subtitles-1">28.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="ffplay-all.html#toc-super2xsai">33.79 super2xsai</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-super2xsai">28.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="ffplay-all.html#toc-swapuv">33.80 swapuv</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-swapuv">28.82 swapuv</a></h2>
<p>Swap U & V plane.
</p>
<a name="telecine"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-telecine">33.81 telecine</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-telecine">28.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="ffplay-all.html#toc-thumbnail">33.82 thumbnail</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-thumbnail">28.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-30"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-30">33.82.1 Examples</a></h3>
+<a name="Examples-9"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-9">28.84.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="tile"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-tile">33.83 tile</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-tile">28.85 tile</a></h2>
<p>Tile several successive frames together.
</p>
</p></dd>
</dl>
-<a name="Examples-11"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-11">33.83.1 Examples</a></h3>
+<a name="Examples-70"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-70">28.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="ffplay-all.html#toc-tinterlace">33.84 tinterlace</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-tinterlace">28.86 tinterlace</a></h2>
<p>Perform various types of temporal field interlacing.
</p>
</dl>
<a name="transpose"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-transpose">33.85 transpose</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-transpose">28.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="ffplay-all.html#toc-trim">33.86 trim</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-trim">28.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="ffplay-all.html#toc-unsharp">33.87 unsharp</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-unsharp">28.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-6"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-6">33.87.1 Examples</a></h3>
+<a name="Examples-81"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-81">28.89.1 Examples</a></h3>
<ul>
<li>
<p><a name="vidstabdetect"></a>
</p><a name="vidstabdetect-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-vidstabdetect-1">33.88 vidstabdetect</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-vidstabdetect-1">28.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-5"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-5">33.88.1 Examples</a></h3>
+<a name="Examples-29"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-29">28.90.1 Examples</a></h3>
<ul>
<li>
<p><a name="vidstabtransform"></a>
</p><a name="vidstabtransform-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-vidstabtransform-1">33.89 vidstabtransform</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-vidstabtransform-1">28.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-5"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Options-5">28.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-10"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-10">33.89.1 Examples</a></h3>
+<a name="Examples-25"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-25">28.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="ffplay-all.html#toc-vflip">33.90 vflip</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-vflip">28.92 vflip</a></h2>
<p>Flip the input video vertically.
</p>
</pre></td></tr></table>
<a name="vignette"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-vignette">33.91 vignette</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-vignette">28.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="ffplay-all.html#toc-Expressions">33.91.1 Expressions</a></h3>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Expressions">28.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-45"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-45">33.91.2 Examples</a></h3>
+<a name="Examples-49"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-49">28.93.2 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="w3fdif"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-w3fdif">33.92 w3fdif</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-w3fdif">28.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="ffplay-all.html#toc-yadif-1">33.93 yadif</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-yadif-1">28.95 yadif</a></h2>
<p>Deinterlace the input video ("yadif" means "yet another deinterlacing
filter").
<a name="Video-Sources"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-Video-Sources">34. Video Sources</a></h1>
+<h1 class="chapter"><a href="ffplay-all.html#toc-Video-Sources">29. Video Sources</a></h1>
<p>Below is a description of the currently available video sources.
</p>
<a name="buffer"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-buffer">34.1 buffer</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-buffer">29.1 buffer</a></h2>
<p>Buffer video frames, and make them available to the filter chain.
</p>
<p><var>width</var>:<var>height</var>:<var>pix_fmt</var>:<var>time_base.num</var>:<var>time_base.den</var>:<var>pixel_aspect.num</var>:<var>pixel_aspect.den</var>[:<var>sws_param</var>]
</p>
<a name="cellauto"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-cellauto">34.2 cellauto</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-cellauto">29.2 cellauto</a></h2>
<p>Create a pattern generated by an elementary cellular automaton.
</p>
</p></dd>
</dl>
-<a name="Examples-38"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-38">34.2.1 Examples</a></h3>
+<a name="Examples-16"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-16">29.2.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="mandelbrot"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-mandelbrot">34.3 mandelbrot</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-mandelbrot">29.3 mandelbrot</a></h2>
<p>Generate a Mandelbrot set fractal, and progressively zoom towards the
point specified with <var>start_x</var> and <var>start_y</var>.
</dl>
<a name="mptestsrc"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-mptestsrc">34.4 mptestsrc</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-mptestsrc">29.4 mptestsrc</a></h2>
<p>Generate various test patterns, as generated by the MPlayer test filter.
</p>
<p>will generate a "dc_luma" test pattern.
</p>
<a name="frei0r_005fsrc"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-frei0r_005fsrc">34.5 frei0r_src</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-frei0r_005fsrc">29.5 frei0r_src</a></h2>
<p>Provide a frei0r source.
</p>
</pre></td></tr></table>
<a name="life"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-life">34.6 life</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-life">29.6 life</a></h2>
<p>Generate a life pattern.
</p>
</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-21"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-21">34.6.1 Examples</a></h3>
+<a name="Examples-73"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-73">29.6.1 Examples</a></h3>
<ul>
<li>
<a name="smptehdbars"></a>
<a name="testsrc"></a>
</p><a name="color_002c-haldclutsrc_002c-nullsrc_002c-rgbtestsrc_002c-smptebars_002c-smptehdbars_002c-testsrc"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-color_002c-haldclutsrc_002c-nullsrc_002c-rgbtestsrc_002c-smptebars_002c-smptehdbars_002c-testsrc">34.7 color, haldclutsrc, nullsrc, rgbtestsrc, smptebars, smptehdbars, testsrc</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-color_002c-haldclutsrc_002c-nullsrc_002c-rgbtestsrc_002c-smptebars_002c-smptehdbars_002c-testsrc">29.7 color, haldclutsrc, nullsrc, rgbtestsrc, smptebars, smptehdbars, testsrc</a></h2>
<p>The <code>color</code> source provides an uniformly colored input.
</p>
</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-4"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Commands-4">34.7.1 Commands</a></h3>
+<a name="Commands-2"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Commands-2">29.7.1 Commands</a></h3>
<p>The <code>color</code> source supports the following commands:
</p>
<a name="Video-Sinks"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-Video-Sinks">35. Video Sinks</a></h1>
+<h1 class="chapter"><a href="ffplay-all.html#toc-Video-Sinks">30. Video Sinks</a></h1>
<p>Below is a description of the currently available video sinks.
</p>
<a name="buffersink"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-buffersink">35.1 buffersink</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-buffersink">30.1 buffersink</a></h2>
<p>Buffer video frames, and make them available to the end of the filter
graph.
parameter to <code>avfilter_init_filter</code> for initialization.
</p>
<a name="nullsink"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-nullsink">35.2 nullsink</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-nullsink">30.2 nullsink</a></h2>
<p>Null video sink, do absolutely nothing with the input video. It is
mainly useful as a template and to be employed in analysis / debugging
</p>
<a name="Multimedia-Filters"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-Multimedia-Filters">36. Multimedia Filters</a></h1>
+<h1 class="chapter"><a href="ffplay-all.html#toc-Multimedia-Filters">31. Multimedia Filters</a></h1>
<p>Below is a description of the currently available multimedia filters.
</p>
<a name="avectorscope"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-avectorscope">36.1 avectorscope</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-avectorscope">31.1 avectorscope</a></h2>
<p>Convert input audio to a video output, representing the audio vector
scope.
</p></dd>
</dl>
-<a name="Examples"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples">36.1.1 Examples</a></h3>
+<a name="Examples-48"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-48">31.1.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="concat-2"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-concat-2">36.2 concat</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-concat-2">31.2 concat</a></h2>
<p>Concatenate audio and video streams, joining them together one after the
other.
<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-40"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-40">36.2.1 Examples</a></h3>
+<a name="Examples-24"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-24">31.2.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="ebur128"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-ebur128">36.3 ebur128</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-ebur128">31.3 ebur128</a></h2>
<p>EBU R128 scanner filter. This filter takes an audio stream as input and outputs
it unchanged. By default, it logs a message at a frequency of 10Hz with the
<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-18"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-18">36.3.1 Examples</a></h3>
+</dd>
+</dl>
+
+<a name="Examples-13"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-13">31.3.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="interleave_002c-ainterleave"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-interleave_002c-ainterleave">36.4 interleave, ainterleave</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-interleave_002c-ainterleave">31.4 interleave, ainterleave</a></h2>
<p>Temporally interleave frames from several inputs.
</p>
</p></dd>
</dl>
-<a name="Examples-35"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-35">36.4.1 Examples</a></h3>
+<a name="Examples-7"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-7">31.4.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="perms_002c-aperms"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-perms_002c-aperms">36.5 perms, aperms</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-perms_002c-aperms">31.5 perms, aperms</a></h2>
<p>Set read/write permissions for the output frames.
</p>
perms/aperms filter can avoid this problem.
</p>
<a name="select_002c-aselect"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-select_002c-aselect">36.6 select, aselect</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-select_002c-aselect">31.6 select, aselect</a></h2>
<p>Select frames to pass in output.
</p>
<p>The default value of the select expression is "1".
</p>
-<a name="Examples-76"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-76">36.6.1 Examples</a></h3>
+<a name="Examples-20"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-20">31.6.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="sendcmd_002c-asendcmd"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-sendcmd_002c-asendcmd">36.7 sendcmd, asendcmd</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-sendcmd_002c-asendcmd">31.7 sendcmd, asendcmd</a></h2>
<p>Send commands to filters in the filtergraph.
</p>
</dl>
<a name="Commands-syntax"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Commands-syntax">36.7.1 Commands syntax</a></h3>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Commands-syntax">31.7.1 Commands syntax</a></h3>
<p>A commands description consists of a sequence of interval
specifications, comprising a list of commands to be executed when a
<var>INTERVALS</var> ::= <var>INTERVAL</var>[;<var>INTERVALS</var>]
</pre></td></tr></table>
-<a name="Examples-39"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-39">36.7.2 Examples</a></h3>
+<a name="Examples-36"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-36">31.7.2 Examples</a></h3>
<ul>
<li>
<p><a name="setpts"></a>
</p><a name="setpts_002c-asetpts"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-setpts_002c-asetpts">36.8 setpts, asetpts</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-setpts_002c-asetpts">31.8 setpts, asetpts</a></h2>
<p>Change the PTS (presentation timestamp) of the input frames.
</p>
</dd>
</dl>
-<a name="Examples-42"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-42">36.8.1 Examples</a></h3>
+<a name="Examples-59"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-59">31.8.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="settb_002c-asettb"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-settb_002c-asettb">36.9 settb, asettb</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-settb_002c-asettb">31.9 settb, asettb</a></h2>
<p>Set the timebase to use for the output frames timestamps.
It is mainly useful for testing timebase configuration.
timebase), "intb" (the input timebase) and "sr" (the sample rate,
audio only). Default value is "intb".
</p>
-<a name="Examples-68"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-68">36.9.1 Examples</a></h3>
+<a name="Examples-8"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-8">31.9.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="showspectrum"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-showspectrum">36.10 showspectrum</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-showspectrum">31.10 showspectrum</a></h2>
<p>Convert input audio to a video output, representing the audio frequency
spectrum.
<p>The usage is very similar to the showwaves filter; see the examples in that
section.
</p>
-<a name="Examples-2"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-2">36.10.1 Examples</a></h3>
+<a name="Examples-67"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-67">31.10.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="showwaves"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-showwaves">36.11 showwaves</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-showwaves">31.11 showwaves</a></h2>
<p>Convert input audio to a video output, representing the samples waves.
</p>
</dd>
</dl>
-<a name="Examples-90"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-90">36.11.1 Examples</a></h3>
+<a name="Examples-83"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-83">31.11.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="split_002c-asplit"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-split_002c-asplit">36.12 split, asplit</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-split_002c-asplit">31.12 split, asplit</a></h2>
<p>Split input into several identical outputs.
</p>
<p>The filter accepts a single parameter which specifies the number of outputs. If
unspecified, it defaults to 2.
</p>
-<a name="Examples-83"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-83">36.12.1 Examples</a></h3>
+<a name="Examples-46"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-46">31.12.1 Examples</a></h3>
<ul>
<li>
</li></ul>
<a name="zmq_002c-azmq"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-zmq_002c-azmq">36.13 zmq, azmq</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-zmq_002c-azmq">31.13 zmq, azmq</a></h2>
<p>Receive commands sent through a libzmq client, and forward them to
filters in the filtergraph.
<p><var>MESSAGE</var> is optional.
</p>
-<a name="Examples-29"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-29">36.13.1 Examples</a></h3>
+<a name="Examples-31"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-31">31.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.
<a name="Multimedia-Sources"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-Multimedia-Sources">37. Multimedia Sources</a></h1>
+<h1 class="chapter"><a href="ffplay-all.html#toc-Multimedia-Sources">32. Multimedia Sources</a></h1>
<p>Below is a description of the currently available multimedia sources.
</p>
<a name="amovie"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-amovie">37.1 amovie</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-amovie">32.1 amovie</a></h2>
<p>This is the same as <a href="#movie">movie</a> source, except it selects an audio
stream by default.
</p>
<p><a name="movie"></a>
</p><a name="movie-1"></a>
-<h2 class="section"><a href="ffplay-all.html#toc-movie-1">37.2 movie</a></h2>
+<h2 class="section"><a href="ffplay-all.html#toc-movie-1">32.2 movie</a></h2>
<p>Read audio and/or video stream(s) from a movie container.
</p>
</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-69"></a>
-<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-69">37.2.1 Examples</a></h3>
+<a name="Examples-61"></a>
+<h3 class="subsection"><a href="ffplay-all.html#toc-Examples-61">32.2.1 Examples</a></h3>
<ul>
<li>
<a name="See-Also"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-See-Also">38. See Also</a></h1>
+<h1 class="chapter"><a href="ffplay-all.html#toc-See-Also">33. See Also</a></h1>
<p><a href="ffplay.html">ffplay</a>,
<a href="ffmpeg.html">ffmpeg</a>, <a href="ffprobe.html">ffprobe</a>, <a href="ffserver.html">ffserver</a>,
</p>
<a name="Authors"></a>
-<h1 class="chapter"><a href="ffplay-all.html#toc-Authors">39. Authors</a></h1>
+<h1 class="chapter"><a href="ffplay-all.html#toc-Authors">34. Authors</a></h1>
<p>The FFmpeg developers.
</p>
</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>
projects / casparcg / blobdiff