]> git.sesse.net Git - casparcg/blob - dependencies/ffmpeg/doc/ffplay.html
Check in complete ffmpeg-20131215-git-ec13849-win32 Zeranoe build with README updates...
[casparcg] / dependencies / ffmpeg / doc / ffplay.html
1 <!DOCTYPE html>
2 <html>
3 <!-- Created on December 14, 2013 by texi2html 1.82 -->
4 <!--
5 texi2html was written by: 
6             Lionel Cons <Lionel.Cons@cern.ch> (original author)
7             Karl Berry  <karl@freefriends.org>
8             Olaf Bachmann <obachman@mathematik.uni-kl.de>
9             and many others.
10 Maintained by: Many creative people.
11 Send bugs and suggestions to <texi2html-bug@nongnu.org>
12
13 -->
14 <head>
15 <title>FFmpeg documentation : ffplay </title>
16
17 <meta name="description" content="ffplay Documentation: ">
18 <meta name="keywords" content="FFmpeg documentation : ffplay ">
19 <meta name="Generator" content="texi2html 1.82">
20 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
21 <link rel="stylesheet" type="text/css" href="default.css" />
22
23 <link rel="icon" href="favicon.png" type="image/png" />
24 </head>
25 <body>
26 <div id="container">
27 <div id="body">
28
29 <a name="SEC_Top"></a>
30 <h1 class="settitle">ffplay Documentation</h1>
31
32 <a name="SEC_Contents"></a>
33 <h1>Table of Contents</h1>
34 <div class="contents">
35
36 <ul class="toc">
37   <li><a name="toc-Synopsis" href="#Synopsis">1. Synopsis</a></li>
38   <li><a name="toc-Description" href="#Description">2. Description</a></li>
39   <li><a name="toc-Options" href="#Options">3. Options</a>
40   <ul class="toc">
41     <li><a name="toc-Stream-specifiers-1" href="#Stream-specifiers-1">3.1 Stream specifiers</a></li>
42     <li><a name="toc-Generic-options" href="#Generic-options">3.2 Generic options</a></li>
43     <li><a name="toc-AVOptions" href="#AVOptions">3.3 AVOptions</a></li>
44     <li><a name="toc-Main-options" href="#Main-options">3.4 Main options</a></li>
45     <li><a name="toc-Advanced-options" href="#Advanced-options">3.5 Advanced options</a></li>
46     <li><a name="toc-While-playing" href="#While-playing">3.6 While playing</a></li>
47   </ul></li>
48   <li><a name="toc-See-Also" href="#See-Also">4. See Also</a></li>
49   <li><a name="toc-Authors" href="#Authors">5. Authors</a></li>
50 </ul>
51 </div>
52
53 <a name="Synopsis"></a>
54 <h1 class="chapter"><a href="ffplay.html#toc-Synopsis">1. Synopsis</a></h1>
55
56 <p>ffplay [<var>options</var>] [&lsquo;<tt>input_file</tt>&rsquo;]
57 </p>
58 <a name="Description"></a>
59 <h1 class="chapter"><a href="ffplay.html#toc-Description">2. Description</a></h1>
60
61 <p>FFplay is a very simple and portable media player using the FFmpeg
62 libraries and the SDL library. It is mostly used as a testbed for the
63 various FFmpeg APIs.
64 </p>
65 <a name="Options"></a>
66 <h1 class="chapter"><a href="ffplay.html#toc-Options">3. Options</a></h1>
67
68 <p>All the numerical options, if not specified otherwise, accept a string
69 representing a number as input, which may be followed by one of the SI
70 unit prefixes, for example: &rsquo;K&rsquo;, &rsquo;M&rsquo;, or &rsquo;G&rsquo;.
71 </p>
72 <p>If &rsquo;i&rsquo; is appended to the SI unit prefix, the complete prefix will be
73 interpreted as a unit prefix for binary multiplies, which are based on
74 powers of 1024 instead of powers of 1000. Appending &rsquo;B&rsquo; to the SI unit
75 prefix multiplies the value by 8. This allows using, for example:
76 &rsquo;KB&rsquo;, &rsquo;MiB&rsquo;, &rsquo;G&rsquo; and &rsquo;B&rsquo; as number suffixes.
77 </p>
78 <p>Options which do not take arguments are boolean options, and set the
79 corresponding value to true. They can be set to false by prefixing
80 the option name with &quot;no&quot;. For example using &quot;-nofoo&quot;
81 will set the boolean option with name &quot;foo&quot; to false.
82 </p>
83 <p><a name="Stream-specifiers"></a>
84 </p><a name="Stream-specifiers-1"></a>
85 <h2 class="section"><a href="ffplay.html#toc-Stream-specifiers-1">3.1 Stream specifiers</a></h2>
86 <p>Some options are applied per-stream, e.g. bitrate or codec. Stream specifiers
87 are used to precisely specify which stream(s) a given option belongs to.
88 </p>
89 <p>A stream specifier is a string generally appended to the option name and
90 separated from it by a colon. E.g. <code>-codec:a:1 ac3</code> contains the
91 <code>a:1</code> stream specifier, which matches the second audio stream. Therefore, it
92 would select the ac3 codec for the second audio stream.
93 </p>
94 <p>A stream specifier can match several streams, so that the option is applied to all
95 of them. E.g. the stream specifier in <code>-b:a 128k</code> matches all audio
96 streams.
97 </p>
98 <p>An empty stream specifier matches all streams. For example, <code>-codec copy</code>
99 or <code>-codec: copy</code> would copy all the streams without reencoding.
100 </p>
101 <p>Possible forms of stream specifiers are:
102 </p><dl compact="compact">
103 <dt> &lsquo;<samp><var>stream_index</var></samp>&rsquo;</dt>
104 <dd><p>Matches the stream with this index. E.g. <code>-threads:1 4</code> would set the
105 thread count for the second stream to 4.
106 </p></dd>
107 <dt> &lsquo;<samp><var>stream_type</var>[:<var>stream_index</var>]</samp>&rsquo;</dt>
108 <dd><p><var>stream_type</var> is one of following: &rsquo;v&rsquo; for video, &rsquo;a&rsquo; for audio, &rsquo;s&rsquo; for subtitle,
109 &rsquo;d&rsquo; for data, and &rsquo;t&rsquo; for attachments. If <var>stream_index</var> is given, then it matches
110 stream number <var>stream_index</var> of this type. Otherwise, it matches all
111 streams of this type.
112 </p></dd>
113 <dt> &lsquo;<samp>p:<var>program_id</var>[:<var>stream_index</var>]</samp>&rsquo;</dt>
114 <dd><p>If <var>stream_index</var> is given, then it matches the stream with number <var>stream_index</var>
115 in the program with the id <var>program_id</var>. Otherwise, it matches all streams in the
116 program.
117 </p></dd>
118 <dt> &lsquo;<samp>#<var>stream_id</var></samp>&rsquo;</dt>
119 <dd><p>Matches the stream by a format-specific ID.
120 </p></dd>
121 </dl>
122
123 <a name="Generic-options"></a>
124 <h2 class="section"><a href="ffplay.html#toc-Generic-options">3.2 Generic options</a></h2>
125
126 <p>These options are shared amongst the ff* tools.
127 </p>
128 <dl compact="compact">
129 <dt> &lsquo;<samp>-L</samp>&rsquo;</dt>
130 <dd><p>Show license.
131 </p>
132 </dd>
133 <dt> &lsquo;<samp>-h, -?, -help, --help [<var>arg</var>]</samp>&rsquo;</dt>
134 <dd><p>Show help. An optional parameter may be specified to print help about a specific
135 item. If no argument is specified, only basic (non advanced) tool
136 options are shown.
137 </p>
138 <p>Possible values of <var>arg</var> are:
139 </p><dl compact="compact">
140 <dt> &lsquo;<samp>long</samp>&rsquo;</dt>
141 <dd><p>Print advanced tool options in addition to the basic tool options.
142 </p>
143 </dd>
144 <dt> &lsquo;<samp>full</samp>&rsquo;</dt>
145 <dd><p>Print complete list of options, including shared and private options
146 for encoders, decoders, demuxers, muxers, filters, etc.
147 </p>
148 </dd>
149 <dt> &lsquo;<samp>decoder=<var>decoder_name</var></samp>&rsquo;</dt>
150 <dd><p>Print detailed information about the decoder named <var>decoder_name</var>. Use the
151 &lsquo;<samp>-decoders</samp>&rsquo; option to get a list of all decoders.
152 </p>
153 </dd>
154 <dt> &lsquo;<samp>encoder=<var>encoder_name</var></samp>&rsquo;</dt>
155 <dd><p>Print detailed information about the encoder named <var>encoder_name</var>. Use the
156 &lsquo;<samp>-encoders</samp>&rsquo; option to get a list of all encoders.
157 </p>
158 </dd>
159 <dt> &lsquo;<samp>demuxer=<var>demuxer_name</var></samp>&rsquo;</dt>
160 <dd><p>Print detailed information about the demuxer named <var>demuxer_name</var>. Use the
161 &lsquo;<samp>-formats</samp>&rsquo; option to get a list of all demuxers and muxers.
162 </p>
163 </dd>
164 <dt> &lsquo;<samp>muxer=<var>muxer_name</var></samp>&rsquo;</dt>
165 <dd><p>Print detailed information about the muxer named <var>muxer_name</var>. Use the
166 &lsquo;<samp>-formats</samp>&rsquo; option to get a list of all muxers and demuxers.
167 </p>
168 </dd>
169 <dt> &lsquo;<samp>filter=<var>filter_name</var></samp>&rsquo;</dt>
170 <dd><p>Print detailed information about the filter name <var>filter_name</var>. Use the
171 &lsquo;<samp>-filters</samp>&rsquo; option to get a list of all filters.
172 </p></dd>
173 </dl>
174
175 </dd>
176 <dt> &lsquo;<samp>-version</samp>&rsquo;</dt>
177 <dd><p>Show version.
178 </p>
179 </dd>
180 <dt> &lsquo;<samp>-formats</samp>&rsquo;</dt>
181 <dd><p>Show available formats.
182 </p>
183 </dd>
184 <dt> &lsquo;<samp>-codecs</samp>&rsquo;</dt>
185 <dd><p>Show all codecs known to libavcodec.
186 </p>
187 <p>Note that the term &rsquo;codec&rsquo; is used throughout this documentation as a shortcut
188 for what is more correctly called a media bitstream format.
189 </p>
190 </dd>
191 <dt> &lsquo;<samp>-decoders</samp>&rsquo;</dt>
192 <dd><p>Show available decoders.
193 </p>
194 </dd>
195 <dt> &lsquo;<samp>-encoders</samp>&rsquo;</dt>
196 <dd><p>Show all available encoders.
197 </p>
198 </dd>
199 <dt> &lsquo;<samp>-bsfs</samp>&rsquo;</dt>
200 <dd><p>Show available bitstream filters.
201 </p>
202 </dd>
203 <dt> &lsquo;<samp>-protocols</samp>&rsquo;</dt>
204 <dd><p>Show available protocols.
205 </p>
206 </dd>
207 <dt> &lsquo;<samp>-filters</samp>&rsquo;</dt>
208 <dd><p>Show available libavfilter filters.
209 </p>
210 </dd>
211 <dt> &lsquo;<samp>-pix_fmts</samp>&rsquo;</dt>
212 <dd><p>Show available pixel formats.
213 </p>
214 </dd>
215 <dt> &lsquo;<samp>-sample_fmts</samp>&rsquo;</dt>
216 <dd><p>Show available sample formats.
217 </p>
218 </dd>
219 <dt> &lsquo;<samp>-layouts</samp>&rsquo;</dt>
220 <dd><p>Show channel names and standard channel layouts.
221 </p>
222 </dd>
223 <dt> &lsquo;<samp>-colors</samp>&rsquo;</dt>
224 <dd><p>Show recognized color names.
225 </p>
226 </dd>
227 <dt> &lsquo;<samp>-loglevel [repeat+]<var>loglevel</var> | -v [repeat+]<var>loglevel</var></samp>&rsquo;</dt>
228 <dd><p>Set the logging level used by the library.
229 Adding &quot;repeat+&quot; indicates that repeated log output should not be compressed
230 to the first line and the &quot;Last message repeated n times&quot; line will be
231 omitted. &quot;repeat&quot; can also be used alone.
232 If &quot;repeat&quot; is used alone, and with no prior loglevel set, the default
233 loglevel will be used. If multiple loglevel parameters are given, using
234 &rsquo;repeat&rsquo; will not change the loglevel.
235 <var>loglevel</var> is a number or a string containing one of the following values:
236 </p><dl compact="compact">
237 <dt> &lsquo;<samp>quiet</samp>&rsquo;</dt>
238 <dd><p>Show nothing at all; be silent.
239 </p></dd>
240 <dt> &lsquo;<samp>panic</samp>&rsquo;</dt>
241 <dd><p>Only show fatal errors which could lead the process to crash, such as
242 and assert failure. This is not currently used for anything.
243 </p></dd>
244 <dt> &lsquo;<samp>fatal</samp>&rsquo;</dt>
245 <dd><p>Only show fatal errors. These are errors after which the process absolutely
246 cannot continue after.
247 </p></dd>
248 <dt> &lsquo;<samp>error</samp>&rsquo;</dt>
249 <dd><p>Show all errors, including ones which can be recovered from.
250 </p></dd>
251 <dt> &lsquo;<samp>warning</samp>&rsquo;</dt>
252 <dd><p>Show all warnings and errors. Any message related to possibly
253 incorrect or unexpected events will be shown.
254 </p></dd>
255 <dt> &lsquo;<samp>info</samp>&rsquo;</dt>
256 <dd><p>Show informative messages during processing. This is in addition to
257 warnings and errors. This is the default value.
258 </p></dd>
259 <dt> &lsquo;<samp>verbose</samp>&rsquo;</dt>
260 <dd><p>Same as <code>info</code>, except more verbose.
261 </p></dd>
262 <dt> &lsquo;<samp>debug</samp>&rsquo;</dt>
263 <dd><p>Show everything, including debugging information.
264 </p></dd>
265 </dl>
266
267 <p>By default the program logs to stderr, if coloring is supported by the
268 terminal, colors are used to mark errors and warnings. Log coloring
269 can be disabled setting the environment variable
270 <code>AV_LOG_FORCE_NOCOLOR</code> or <code>NO_COLOR</code>, or can be forced setting
271 the environment variable <code>AV_LOG_FORCE_COLOR</code>.
272 The use of the environment variable <code>NO_COLOR</code> is deprecated and
273 will be dropped in a following FFmpeg version.
274 </p>
275 </dd>
276 <dt> &lsquo;<samp>-report</samp>&rsquo;</dt>
277 <dd><p>Dump full command line and console output to a file named
278 <code><var>program</var>-<var>YYYYMMDD</var>-<var>HHMMSS</var>.log</code> in the current
279 directory.
280 This file can be useful for bug reports.
281 It also implies <code>-loglevel verbose</code>.
282 </p>
283 <p>Setting the environment variable <code>FFREPORT</code> to any value has the
284 same effect. If the value is a &rsquo;:&rsquo;-separated key=value sequence, these
285 options will affect the report; options values must be escaped if they
286 contain special characters or the options delimiter &rsquo;:&rsquo; (see the
287 &ldquo;Quoting and escaping&rdquo; section in the ffmpeg-utils manual). The
288 following option is recognized:
289 </p><dl compact="compact">
290 <dt> &lsquo;<samp>file</samp>&rsquo;</dt>
291 <dd><p>set the file name to use for the report; <code>%p</code> is expanded to the name
292 of the program, <code>%t</code> is expanded to a timestamp, <code>%%</code> is expanded
293 to a plain <code>%</code>
294 </p></dd>
295 </dl>
296
297 <p>Errors in parsing the environment variable are not fatal, and will not
298 appear in the report.
299 </p>
300 </dd>
301 <dt> &lsquo;<samp>-cpuflags flags (<em>global</em>)</samp>&rsquo;</dt>
302 <dd><p>Allows setting and clearing cpu flags. This option is intended
303 for testing. Do not use it unless you know what you&rsquo;re doing.
304 </p><table><tr><td>&nbsp;</td><td><pre class="example">ffmpeg -cpuflags -sse+mmx ...
305 ffmpeg -cpuflags mmx ...
306 ffmpeg -cpuflags 0 ...
307 </pre></td></tr></table>
308 <p>Possible flags for this option are:
309 </p><dl compact="compact">
310 <dt> &lsquo;<samp>x86</samp>&rsquo;</dt>
311 <dd><dl compact="compact">
312 <dt> &lsquo;<samp>mmx</samp>&rsquo;</dt>
313 <dt> &lsquo;<samp>mmxext</samp>&rsquo;</dt>
314 <dt> &lsquo;<samp>sse</samp>&rsquo;</dt>
315 <dt> &lsquo;<samp>sse2</samp>&rsquo;</dt>
316 <dt> &lsquo;<samp>sse2slow</samp>&rsquo;</dt>
317 <dt> &lsquo;<samp>sse3</samp>&rsquo;</dt>
318 <dt> &lsquo;<samp>sse3slow</samp>&rsquo;</dt>
319 <dt> &lsquo;<samp>ssse3</samp>&rsquo;</dt>
320 <dt> &lsquo;<samp>atom</samp>&rsquo;</dt>
321 <dt> &lsquo;<samp>sse4.1</samp>&rsquo;</dt>
322 <dt> &lsquo;<samp>sse4.2</samp>&rsquo;</dt>
323 <dt> &lsquo;<samp>avx</samp>&rsquo;</dt>
324 <dt> &lsquo;<samp>xop</samp>&rsquo;</dt>
325 <dt> &lsquo;<samp>fma4</samp>&rsquo;</dt>
326 <dt> &lsquo;<samp>3dnow</samp>&rsquo;</dt>
327 <dt> &lsquo;<samp>3dnowext</samp>&rsquo;</dt>
328 <dt> &lsquo;<samp>cmov</samp>&rsquo;</dt>
329 </dl>
330 </dd>
331 <dt> &lsquo;<samp>ARM</samp>&rsquo;</dt>
332 <dd><dl compact="compact">
333 <dt> &lsquo;<samp>armv5te</samp>&rsquo;</dt>
334 <dt> &lsquo;<samp>armv6</samp>&rsquo;</dt>
335 <dt> &lsquo;<samp>armv6t2</samp>&rsquo;</dt>
336 <dt> &lsquo;<samp>vfp</samp>&rsquo;</dt>
337 <dt> &lsquo;<samp>vfpv3</samp>&rsquo;</dt>
338 <dt> &lsquo;<samp>neon</samp>&rsquo;</dt>
339 </dl>
340 </dd>
341 <dt> &lsquo;<samp>PowerPC</samp>&rsquo;</dt>
342 <dd><dl compact="compact">
343 <dt> &lsquo;<samp>altivec</samp>&rsquo;</dt>
344 </dl>
345 </dd>
346 <dt> &lsquo;<samp>Specific Processors</samp>&rsquo;</dt>
347 <dd><dl compact="compact">
348 <dt> &lsquo;<samp>pentium2</samp>&rsquo;</dt>
349 <dt> &lsquo;<samp>pentium3</samp>&rsquo;</dt>
350 <dt> &lsquo;<samp>pentium4</samp>&rsquo;</dt>
351 <dt> &lsquo;<samp>k6</samp>&rsquo;</dt>
352 <dt> &lsquo;<samp>k62</samp>&rsquo;</dt>
353 <dt> &lsquo;<samp>athlon</samp>&rsquo;</dt>
354 <dt> &lsquo;<samp>athlonxp</samp>&rsquo;</dt>
355 <dt> &lsquo;<samp>k8</samp>&rsquo;</dt>
356 </dl>
357 </dd>
358 </dl>
359
360 </dd>
361 <dt> &lsquo;<samp>-opencl_bench</samp>&rsquo;</dt>
362 <dd><p>Benchmark all available OpenCL devices and show the results. This option
363 is only available when FFmpeg has been compiled with <code>--enable-opencl</code>.
364 </p>
365 </dd>
366 <dt> &lsquo;<samp>-opencl_options options (<em>global</em>)</samp>&rsquo;</dt>
367 <dd><p>Set OpenCL environment options. This option is only available when
368 FFmpeg has been compiled with <code>--enable-opencl</code>.
369 </p>
370 <p><var>options</var> must be a list of <var>key</var>=<var>value</var> option pairs
371 separated by &rsquo;:&rsquo;. See the &ldquo;OpenCL Options&rdquo; section in the
372 ffmpeg-utils manual for the list of supported options.
373 </p></dd>
374 </dl>
375
376 <a name="AVOptions"></a>
377 <h2 class="section"><a href="ffplay.html#toc-AVOptions">3.3 AVOptions</a></h2>
378
379 <p>These options are provided directly by the libavformat, libavdevice and
380 libavcodec libraries. To see the list of available AVOptions, use the
381 &lsquo;<samp>-help</samp>&rsquo; option. They are separated into two categories:
382 </p><dl compact="compact">
383 <dt> &lsquo;<samp>generic</samp>&rsquo;</dt>
384 <dd><p>These options can be set for any container, codec or device. Generic options
385 are listed under AVFormatContext options for containers/devices and under
386 AVCodecContext options for codecs.
387 </p></dd>
388 <dt> &lsquo;<samp>private</samp>&rsquo;</dt>
389 <dd><p>These options are specific to the given container, device or codec. Private
390 options are listed under their corresponding containers/devices/codecs.
391 </p></dd>
392 </dl>
393
394 <p>For example to write an ID3v2.3 header instead of a default ID3v2.4 to
395 an MP3 file, use the &lsquo;<samp>id3v2_version</samp>&rsquo; private option of the MP3
396 muxer:
397 </p><table><tr><td>&nbsp;</td><td><pre class="example">ffmpeg -i input.flac -id3v2_version 3 out.mp3
398 </pre></td></tr></table>
399
400 <p>All codec AVOptions are per-stream, and thus a stream specifier
401 should be attached to them.
402 </p>
403 <p>Note: the &lsquo;<samp>-nooption</samp>&rsquo; syntax cannot be used for boolean
404 AVOptions, use &lsquo;<samp>-option 0</samp>&rsquo;/&lsquo;<samp>-option 1</samp>&rsquo;.
405 </p>
406 <p>Note: the old undocumented way of specifying per-stream AVOptions by
407 prepending v/a/s to the options name is now obsolete and will be
408 removed soon.
409 </p>
410 <a name="Main-options"></a>
411 <h2 class="section"><a href="ffplay.html#toc-Main-options">3.4 Main options</a></h2>
412
413 <dl compact="compact">
414 <dt> &lsquo;<samp>-x <var>width</var></samp>&rsquo;</dt>
415 <dd><p>Force displayed width.
416 </p></dd>
417 <dt> &lsquo;<samp>-y <var>height</var></samp>&rsquo;</dt>
418 <dd><p>Force displayed height.
419 </p></dd>
420 <dt> &lsquo;<samp>-s <var>size</var></samp>&rsquo;</dt>
421 <dd><p>Set frame size (WxH or abbreviation), needed for videos which do
422 not contain a header with the frame size like raw YUV.  This option
423 has been deprecated in favor of private options, try -video_size.
424 </p></dd>
425 <dt> &lsquo;<samp>-an</samp>&rsquo;</dt>
426 <dd><p>Disable audio.
427 </p></dd>
428 <dt> &lsquo;<samp>-vn</samp>&rsquo;</dt>
429 <dd><p>Disable video.
430 </p></dd>
431 <dt> &lsquo;<samp>-ss <var>pos</var></samp>&rsquo;</dt>
432 <dd><p>Seek to a given position in seconds.
433 </p></dd>
434 <dt> &lsquo;<samp>-t <var>duration</var></samp>&rsquo;</dt>
435 <dd><p>play &lt;duration&gt; seconds of audio/video
436 </p></dd>
437 <dt> &lsquo;<samp>-bytes</samp>&rsquo;</dt>
438 <dd><p>Seek by bytes.
439 </p></dd>
440 <dt> &lsquo;<samp>-nodisp</samp>&rsquo;</dt>
441 <dd><p>Disable graphical display.
442 </p></dd>
443 <dt> &lsquo;<samp>-f <var>fmt</var></samp>&rsquo;</dt>
444 <dd><p>Force format.
445 </p></dd>
446 <dt> &lsquo;<samp>-window_title <var>title</var></samp>&rsquo;</dt>
447 <dd><p>Set window title (default is the input filename).
448 </p></dd>
449 <dt> &lsquo;<samp>-loop <var>number</var></samp>&rsquo;</dt>
450 <dd><p>Loops movie playback &lt;number&gt; times. 0 means forever.
451 </p></dd>
452 <dt> &lsquo;<samp>-showmode <var>mode</var></samp>&rsquo;</dt>
453 <dd><p>Set the show mode to use.
454 Available values for <var>mode</var> are:
455 </p><dl compact="compact">
456 <dt> &lsquo;<samp>0, video</samp>&rsquo;</dt>
457 <dd><p>show video
458 </p></dd>
459 <dt> &lsquo;<samp>1, waves</samp>&rsquo;</dt>
460 <dd><p>show audio waves
461 </p></dd>
462 <dt> &lsquo;<samp>2, rdft</samp>&rsquo;</dt>
463 <dd><p>show audio frequency band using RDFT ((Inverse) Real Discrete Fourier Transform)
464 </p></dd>
465 </dl>
466
467 <p>Default value is &quot;video&quot;, if video is not present or cannot be played
468 &quot;rdft&quot; is automatically selected.
469 </p>
470 <p>You can interactively cycle through the available show modes by
471 pressing the key &lt;w&gt;.
472 </p>
473 </dd>
474 <dt> &lsquo;<samp>-vf <var>filtergraph</var></samp>&rsquo;</dt>
475 <dd><p>Create the filtergraph specified by <var>filtergraph</var> and use it to
476 filter the video stream.
477 </p>
478 <p><var>filtergraph</var> is a description of the filtergraph to apply to
479 the stream, and must have a single video input and a single video
480 output. In the filtergraph, the input is associated to the label
481 <code>in</code>, and the output to the label <code>out</code>. See the
482 ffmpeg-filters manual for more information about the filtergraph
483 syntax.
484 </p>
485 </dd>
486 <dt> &lsquo;<samp>-af <var>filtergraph</var></samp>&rsquo;</dt>
487 <dd><p><var>filtergraph</var> is a description of the filtergraph to apply to
488 the input audio.
489 Use the option &quot;-filters&quot; to show all the available filters (including
490 sources and sinks).
491 </p>
492 </dd>
493 <dt> &lsquo;<samp>-i <var>input_file</var></samp>&rsquo;</dt>
494 <dd><p>Read <var>input_file</var>.
495 </p></dd>
496 </dl>
497
498 <a name="Advanced-options"></a>
499 <h2 class="section"><a href="ffplay.html#toc-Advanced-options">3.5 Advanced options</a></h2>
500 <dl compact="compact">
501 <dt> &lsquo;<samp>-pix_fmt <var>format</var></samp>&rsquo;</dt>
502 <dd><p>Set pixel format.
503 This option has been deprecated in favor of private options, try -pixel_format.
504 </p>
505 </dd>
506 <dt> &lsquo;<samp>-stats</samp>&rsquo;</dt>
507 <dd><p>Print several playback statistics, in particular show the stream
508 duration, the codec parameters, the current position in the stream and
509 the audio/video synchronisation drift. It is on by default, to
510 explicitly disable it you need to specify <code>-nostats</code>.
511 </p>
512 </dd>
513 <dt> &lsquo;<samp>-bug</samp>&rsquo;</dt>
514 <dd><p>Work around bugs.
515 </p></dd>
516 <dt> &lsquo;<samp>-fast</samp>&rsquo;</dt>
517 <dd><p>Non-spec-compliant optimizations.
518 </p></dd>
519 <dt> &lsquo;<samp>-genpts</samp>&rsquo;</dt>
520 <dd><p>Generate pts.
521 </p></dd>
522 <dt> &lsquo;<samp>-rtp_tcp</samp>&rsquo;</dt>
523 <dd><p>Force RTP/TCP protocol usage instead of RTP/UDP. It is only meaningful
524 if you are streaming with the RTSP protocol.
525 </p></dd>
526 <dt> &lsquo;<samp>-sync <var>type</var></samp>&rsquo;</dt>
527 <dd><p>Set the master clock to audio (<code>type=audio</code>), video
528 (<code>type=video</code>) or external (<code>type=ext</code>). Default is audio. The
529 master clock is used to control audio-video synchronization. Most media
530 players use audio as master clock, but in some cases (streaming or high
531 quality broadcast) it is necessary to change that. This option is mainly
532 used for debugging purposes.
533 </p></dd>
534 <dt> &lsquo;<samp>-threads <var>count</var></samp>&rsquo;</dt>
535 <dd><p>Set the thread count.
536 </p></dd>
537 <dt> &lsquo;<samp>-ast <var>audio_stream_number</var></samp>&rsquo;</dt>
538 <dd><p>Select the desired audio stream number, counting from 0. The number
539 refers to the list of all the input audio streams. If it is greater
540 than the number of audio streams minus one, then the last one is
541 selected, if it is negative the audio playback is disabled.
542 </p></dd>
543 <dt> &lsquo;<samp>-vst <var>video_stream_number</var></samp>&rsquo;</dt>
544 <dd><p>Select the desired video stream number, counting from 0. The number
545 refers to the list of all the input video streams. If it is greater
546 than the number of video streams minus one, then the last one is
547 selected, if it is negative the video playback is disabled.
548 </p></dd>
549 <dt> &lsquo;<samp>-sst <var>subtitle_stream_number</var></samp>&rsquo;</dt>
550 <dd><p>Select the desired subtitle stream number, counting from 0. The number
551 refers to the list of all the input subtitle streams. If it is greater
552 than the number of subtitle streams minus one, then the last one is
553 selected, if it is negative the subtitle rendering is disabled.
554 </p></dd>
555 <dt> &lsquo;<samp>-autoexit</samp>&rsquo;</dt>
556 <dd><p>Exit when video is done playing.
557 </p></dd>
558 <dt> &lsquo;<samp>-exitonkeydown</samp>&rsquo;</dt>
559 <dd><p>Exit if any key is pressed.
560 </p></dd>
561 <dt> &lsquo;<samp>-exitonmousedown</samp>&rsquo;</dt>
562 <dd><p>Exit if any mouse button is pressed.
563 </p>
564 </dd>
565 <dt> &lsquo;<samp>-codec:<var>media_specifier</var> <var>codec_name</var></samp>&rsquo;</dt>
566 <dd><p>Force a specific decoder implementation for the stream identified by
567 <var>media_specifier</var>, which can assume the values <code>a</code> (audio),
568 <code>v</code> (video), and <code>s</code> subtitle.
569 </p>
570 </dd>
571 <dt> &lsquo;<samp>-acodec <var>codec_name</var></samp>&rsquo;</dt>
572 <dd><p>Force a specific audio decoder.
573 </p>
574 </dd>
575 <dt> &lsquo;<samp>-vcodec <var>codec_name</var></samp>&rsquo;</dt>
576 <dd><p>Force a specific video decoder.
577 </p>
578 </dd>
579 <dt> &lsquo;<samp>-scodec <var>codec_name</var></samp>&rsquo;</dt>
580 <dd><p>Force a specific subtitle decoder.
581 </p></dd>
582 </dl>
583
584 <a name="While-playing"></a>
585 <h2 class="section"><a href="ffplay.html#toc-While-playing">3.6 While playing</a></h2>
586
587 <dl compact="compact">
588 <dt> &lt;q, ESC&gt;</dt>
589 <dd><p>Quit.
590 </p>
591 </dd>
592 <dt> &lt;f&gt;</dt>
593 <dd><p>Toggle full screen.
594 </p>
595 </dd>
596 <dt> &lt;p, SPC&gt;</dt>
597 <dd><p>Pause.
598 </p>
599 </dd>
600 <dt> &lt;a&gt;</dt>
601 <dd><p>Cycle audio channel in the curret program.
602 </p>
603 </dd>
604 <dt> &lt;v&gt;</dt>
605 <dd><p>Cycle video channel.
606 </p>
607 </dd>
608 <dt> &lt;t&gt;</dt>
609 <dd><p>Cycle subtitle channel in the current program.
610 </p>
611 </dd>
612 <dt> &lt;c&gt;</dt>
613 <dd><p>Cycle program.
614 </p>
615 </dd>
616 <dt> &lt;w&gt;</dt>
617 <dd><p>Show audio waves.
618 </p>
619 </dd>
620 <dt> &lt;left/right&gt;</dt>
621 <dd><p>Seek backward/forward 10 seconds.
622 </p>
623 </dd>
624 <dt> &lt;down/up&gt;</dt>
625 <dd><p>Seek backward/forward 1 minute.
626 </p>
627 </dd>
628 <dt> &lt;page down/page up&gt;</dt>
629 <dd><p>Seek backward/forward 10 minutes.
630 </p>
631 </dd>
632 <dt> &lt;mouse click&gt;</dt>
633 <dd><p>Seek to percentage in file corresponding to fraction of width.
634 </p>
635 </dd>
636 </dl>
637
638
639
640 <a name="See-Also"></a>
641 <h1 class="chapter"><a href="ffplay.html#toc-See-Also">4. See Also</a></h1>
642
643 <p><a href="ffplay-all.html">ffmpeg-all</a>,
644 <a href="ffmpeg.html">ffmpeg</a>, <a href="ffprobe.html">ffprobe</a>, <a href="ffserver.html">ffserver</a>,
645 <a href="ffmpeg-utils.html">ffmpeg-utils</a>,
646 <a href="ffmpeg-scaler.html">ffmpeg-scaler</a>,
647 <a href="ffmpeg-resampler.html">ffmpeg-resampler</a>,
648 <a href="ffmpeg-codecs.html">ffmpeg-codecs</a>,
649 <a href="ffmpeg-bitstream-filters.html">ffmpeg-bitstream-filters</a>,
650 <a href="ffmpeg-formats.html">ffmpeg-formats</a>,
651 <a href="ffmpeg-devices.html">ffmpeg-devices</a>,
652 <a href="ffmpeg-protocols.html">ffmpeg-protocols</a>,
653 <a href="ffmpeg-filters.html">ffmpeg-filters</a>
654 </p>
655
656 <a name="Authors"></a>
657 <h1 class="chapter"><a href="ffplay.html#toc-Authors">5. Authors</a></h1>
658
659 <p>The FFmpeg developers.
660 </p>
661 <p>For details about the authorship, see the Git history of the project
662 (git://source.ffmpeg.org/ffmpeg), e.g. by typing the command
663 <code>git log</code> in the FFmpeg source directory, or browsing the
664 online repository at <a href="http://source.ffmpeg.org">http://source.ffmpeg.org</a>.
665 </p>
666 <p>Maintainers for the specific components are listed in the file
667 &lsquo;<tt>MAINTAINERS</tt>&rsquo; in the source code tree.
668 </p>
669
670 <footer class="footer pagination-right">
671 <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>