Statistics
| Branch: | Revision:

ffmpeg / doc / ffplay-doc.texi @ 5d6e4c16

History | View | Annotate | Download (4.21 KB)

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