Statistics
| Branch: | Revision:

ffmpeg / doc / ffplay.texi @ aad2f2f4

History | View | Annotate | Download (4.25 KB)

1 e99c4e10 Fabrice Bellard
\input texinfo @c -*- texinfo -*-
2
3
@settitle FFplay Documentation
4
@titlepage
5
@center @titlefont{FFplay Documentation}
6
@end titlepage
7
8 a8f0814a Janne Grunau
@top
9
10
@contents
11
12 a66d8cd9 Stefano Sabatini
@chapter Synopsis
13
14
@example
15
@c man begin SYNOPSIS
16
ffplay [options] @file{input_file}
17
@c man end
18
@end example
19 e99c4e10 Fabrice Bellard
20 4fff6084 Stefano Sabatini
@chapter Description
21 e99c4e10 Fabrice Bellard
@c man begin DESCRIPTION
22 4fff6084 Stefano Sabatini
23 f8a45fa1 Janne Grunau
FFplay is a very simple and portable media player using the Libav
24 6527639b Diego Biurrun
libraries and the SDL library. It is mostly used as a testbed for the
25 f8a45fa1 Janne Grunau
various Libav APIs.
26 e99c4e10 Fabrice Bellard
@c man end
27
28 a66d8cd9 Stefano Sabatini
@chapter Options
29 e99c4e10 Fabrice Bellard
@c man begin OPTIONS
30 8b9da8b5 Stefano Sabatini
31
@include fftools-common-opts.texi
32
33 e99c4e10 Fabrice Bellard
@section Main options
34
35
@table @option
36 a19caa0f Stefano Sabatini
@item -x @var{width}
37 b467be72 Stefano Sabatini
Force displayed width.
38 a19caa0f Stefano Sabatini
@item -y @var{height}
39 b467be72 Stefano Sabatini
Force displayed height.
40 a19caa0f Stefano Sabatini
@item -s @var{size}
41 05e894bc Limin Wang
Set frame size (WxH or abbreviation), needed for videos which don't
42 831ec935 Diego Biurrun
contain a header with the frame size like raw YUV.
43 e99c4e10 Fabrice Bellard
@item -an
44 b467be72 Stefano Sabatini
Disable audio.
45 e99c4e10 Fabrice Bellard
@item -vn
46 b467be72 Stefano Sabatini
Disable video.
47 a19caa0f Stefano Sabatini
@item -ss @var{pos}
48 b467be72 Stefano Sabatini
Seek to a given position in seconds.
49 d834d63b Robert Krüger
@item -t @var{duration}
50
play <duration> seconds of audio/video
51 05e894bc Limin Wang
@item -bytes
52 b467be72 Stefano Sabatini
Seek by bytes.
53 e99c4e10 Fabrice Bellard
@item -nodisp
54 b467be72 Stefano Sabatini
Disable graphical display.
55 a19caa0f Stefano Sabatini
@item -f @var{fmt}
56 b467be72 Stefano Sabatini
Force format.
57 076db5ed Robert Krüger
@item -window_title @var{title}
58
Set window title (default is the input filename).
59 1922c0a7 Robert Krüger
@item -loop @var{number}
60
Loops movie playback <number> times. 0 means forever.
61 3275ac6a Stefano Sabatini
@item -vf @var{filter_graph}
62
@var{filter_graph} is a description of the filter graph to apply to
63
the input video.
64
Use the option "-filters" to show all the available filters (including
65
also sources and sinks).
66
67 dc7f38f5 Stefano Sabatini
@end table
68 e99c4e10 Fabrice Bellard
69
@section Advanced options
70
@table @option
71 a19caa0f Stefano Sabatini
@item -pix_fmt @var{format}
72 b467be72 Stefano Sabatini
Set pixel format.
73 e99c4e10 Fabrice Bellard
@item -stats
74 6527639b Diego Biurrun
Show the stream duration, the codec parameters, the current position in
75
the stream and the audio/video synchronisation drift.
76 05e894bc Limin Wang
@item -debug
77 b467be72 Stefano Sabatini
Print specific debug info.
78 05e894bc Limin Wang
@item -bug
79 b467be72 Stefano Sabatini
Work around bugs.
80 05e894bc Limin Wang
@item -vismv
81 b467be72 Stefano Sabatini
Visualize motion vectors.
82 05e894bc Limin Wang
@item -fast
83 b467be72 Stefano Sabatini
Non-spec-compliant optimizations.
84 05e894bc Limin Wang
@item -genpts
85 b467be72 Stefano Sabatini
Generate pts.
86 e99c4e10 Fabrice Bellard
@item -rtp_tcp
87 6527639b Diego Biurrun
Force RTP/TCP protocol usage instead of RTP/UDP. It is only meaningful
88
if you are streaming with the RTSP protocol.
89 a19caa0f Stefano Sabatini
@item -sync @var{type}
90 6527639b Diego Biurrun
Set the master clock to audio (@code{type=audio}), video
91 e99c4e10 Fabrice Bellard
(@code{type=video}) or external (@code{type=ext}). Default is audio. The
92
master clock is used to control audio-video synchronization. Most media
93
players use audio as master clock, but in some cases (streaming or high
94
quality broadcast) it is necessary to change that. This option is mainly
95
used for debugging purposes.
96 a19caa0f Stefano Sabatini
@item -threads @var{count}
97 b467be72 Stefano Sabatini
Set the thread count.
98 4b037567 Stefano Sabatini
@item -ast @var{audio_stream_number}
99
Select the desired audio stream number, counting from 0. The number
100
refers to the list of all the input audio streams. If it is greater
101
than the number of audio streams minus one, then the last one is
102
selected, if it is negative the audio playback is disabled.
103
@item -vst @var{video_stream_number}
104
Select the desired video stream number, counting from 0. The number
105
refers to the list of all the input video streams. If it is greater
106
than the number of video streams minus one, then the last one is
107
selected, if it is negative the video playback is disabled.
108
@item -sst @var{subtitle_stream_number}
109
Select the desired subtitle stream number, counting from 0. The number
110
refers to the list of all the input subtitle streams. If it is greater
111
than the number of subtitle streams minus one, then the last one is
112
selected, if it is negative the subtitle rendering is disabled.
113 07a90cd5 Alexei Svitkine
@item -autoexit
114
Exit when video is done playing.
115 066ce8c9 Alexei Svitkine
@item -exitonkeydown
116
Exit if any key is pressed.
117
@item -exitonmousedown
118
Exit if any mouse button is pressed.
119 e99c4e10 Fabrice Bellard
@end table
120
121
@section While playing
122
123
@table @key
124
@item q, ESC
125 b467be72 Stefano Sabatini
Quit.
126 e99c4e10 Fabrice Bellard
127
@item f
128 b467be72 Stefano Sabatini
Toggle full screen.
129 e99c4e10 Fabrice Bellard
130
@item p, SPC
131 b467be72 Stefano Sabatini
Pause.
132 e99c4e10 Fabrice Bellard
133
@item a
134 b467be72 Stefano Sabatini
Cycle audio channel.
135 e99c4e10 Fabrice Bellard
136
@item v
137 b467be72 Stefano Sabatini
Cycle video channel.
138 e99c4e10 Fabrice Bellard
139 173c7185 Björn Axelsson
@item t
140
Cycle subtitle channel.
141
142 e99c4e10 Fabrice Bellard
@item w
143 b467be72 Stefano Sabatini
Show audio waves.
144 05e894bc Limin Wang
145
@item left/right
146 b467be72 Stefano Sabatini
Seek backward/forward 10 seconds.
147 05e894bc Limin Wang
148
@item down/up
149 b467be72 Stefano Sabatini
Seek backward/forward 1 minute.
150 05e894bc Limin Wang
151
@item mouse click
152 b467be72 Stefano Sabatini
Seek to percentage in file corresponding to fraction of width.
153 05e894bc Limin Wang
154 e99c4e10 Fabrice Bellard
@end table
155
156
@c man end
157
158 07851d79 Stefano Sabatini
@include eval.texi
159 ef298ea7 Stefano Sabatini
@include demuxers.texi
160 85466e1e Stefano Sabatini
@include muxers.texi
161 4419c8bf Stefano Sabatini
@include indevs.texi
162
@include outdevs.texi
163 1de4cfe6 Stefano Sabatini
@include protocols.texi
164 3275ac6a Stefano Sabatini
@include filters.texi
165
166 e99c4e10 Fabrice Bellard
@ignore
167
168
@setfilename ffplay
169
@settitle FFplay media player
170
171
@c man begin SEEALSO
172 f8a45fa1 Janne Grunau
ffmpeg(1), ffprobe(1), ffserver(1) and the Libav HTML documentation
173 e99c4e10 Fabrice Bellard
@c man end
174
175 aeadb328 Stefano Sabatini
@c man begin AUTHORS
176 f8a45fa1 Janne Grunau
The Libav developers
177 e99c4e10 Fabrice Bellard
@c man end
178
179
@end ignore
180
181
@bye