Statistics
| Branch: | Revision:

ffmpeg / doc / ffplay-doc.texi @ 29b5a3aa

History | View | Annotate | Download (3.89 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
11
@chapter Introduction
12
13
@c man begin DESCRIPTION
14
FFplay is a very simple and portable media player using the FFmpeg
15 6527639b Diego Biurrun
libraries and the SDL library. It is mostly used as a testbed for the
16
various FFmpeg APIs.
17 e99c4e10 Fabrice Bellard
@c man end
18
19
@chapter Invocation
20
21
@section Syntax
22 115329f1 Diego Biurrun
@example
23 e99c4e10 Fabrice Bellard
@c man begin SYNOPSIS
24
ffplay [options] @file{input_file}
25
@c man end
26
@end example
27
28
@c man begin OPTIONS
29
@section Main options
30
31
@table @option
32
@item -h
33 b467be72 Stefano Sabatini
Show help.
34 1b068b29 Stefano Sabatini
@item -version
35 b467be72 Stefano Sabatini
Show version.
36 8fdea204 Stefano Sabatini
@item -L
37 b467be72 Stefano Sabatini
Show license.
38 a28b7ed4 Stefano Sabatini
@item -formats
39
Show available formats, codecs, protocols, ...
40 a19caa0f Stefano Sabatini
@item -x @var{width}
41 b467be72 Stefano Sabatini
Force displayed width.
42 a19caa0f Stefano Sabatini
@item -y @var{height}
43 b467be72 Stefano Sabatini
Force displayed height.
44 a19caa0f Stefano Sabatini
@item -s @var{size}
45 05e894bc Limin Wang
Set frame size (WxH or abbreviation), needed for videos which don't
46 831ec935 Diego Biurrun
contain a header with the frame size like raw YUV.
47 e99c4e10 Fabrice Bellard
@item -an
48 b467be72 Stefano Sabatini
Disable audio.
49 e99c4e10 Fabrice Bellard
@item -vn
50 b467be72 Stefano Sabatini
Disable video.
51 a19caa0f Stefano Sabatini
@item -ss @var{pos}
52 b467be72 Stefano Sabatini
Seek to a given position in seconds.
53 05e894bc Limin Wang
@item -bytes
54 b467be72 Stefano Sabatini
Seek by bytes.
55 e99c4e10 Fabrice Bellard
@item -nodisp
56 b467be72 Stefano Sabatini
Disable graphical display.
57 a19caa0f Stefano Sabatini
@item -f @var{fmt}
58 b467be72 Stefano Sabatini
Force format.
59 5a6d6664 Stefano Sabatini
@item -loglevel @var{loglevel}
60
Set the logging level used by the library.
61
@var{loglevel} is a number or a string containing one of the following values:
62
@table @samp
63
@item quiet
64
@item panic
65
@item fatal
66
@item error
67
@item warning
68
@item info
69
@item verbose
70
@item debug
71
@end table
72 e99c4e10 Fabrice Bellard
@end table
73
74
@section Advanced options
75
@table @option
76 a19caa0f Stefano Sabatini
@item -pix_fmt @var{format}
77 b467be72 Stefano Sabatini
Set pixel format.
78 e99c4e10 Fabrice Bellard
@item -stats
79 6527639b Diego Biurrun
Show the stream duration, the codec parameters, the current position in
80
the stream and the audio/video synchronisation drift.
81 05e894bc Limin Wang
@item -debug
82 b467be72 Stefano Sabatini
Print specific debug info.
83 05e894bc Limin Wang
@item -bug
84 b467be72 Stefano Sabatini
Work around bugs.
85 05e894bc Limin Wang
@item -vismv
86 b467be72 Stefano Sabatini
Visualize motion vectors.
87 05e894bc Limin Wang
@item -fast
88 b467be72 Stefano Sabatini
Non-spec-compliant optimizations.
89 05e894bc Limin Wang
@item -genpts
90 b467be72 Stefano Sabatini
Generate pts.
91 e99c4e10 Fabrice Bellard
@item -rtp_tcp
92 6527639b Diego Biurrun
Force RTP/TCP protocol usage instead of RTP/UDP. It is only meaningful
93
if you are streaming with the RTSP protocol.
94 a19caa0f Stefano Sabatini
@item -sync @var{type}
95 6527639b Diego Biurrun
Set the master clock to audio (@code{type=audio}), video
96 e99c4e10 Fabrice Bellard
(@code{type=video}) or external (@code{type=ext}). Default is audio. The
97
master clock is used to control audio-video synchronization. Most media
98
players use audio as master clock, but in some cases (streaming or high
99
quality broadcast) it is necessary to change that. This option is mainly
100
used for debugging purposes.
101 a19caa0f Stefano Sabatini
@item -threads @var{count}
102 b467be72 Stefano Sabatini
Set the thread count.
103 4b037567 Stefano Sabatini
@item -ast @var{audio_stream_number}
104
Select the desired audio stream number, counting from 0. The number
105
refers to the list of all the input audio streams. If it is greater
106
than the number of audio streams minus one, then the last one is
107
selected, if it is negative the audio playback is disabled.
108
@item -vst @var{video_stream_number}
109
Select the desired video stream number, counting from 0. The number
110
refers to the list of all the input video streams. If it is greater
111
than the number of video streams minus one, then the last one is
112
selected, if it is negative the video playback is disabled.
113
@item -sst @var{subtitle_stream_number}
114
Select the desired subtitle stream number, counting from 0. The number
115
refers to the list of all the input subtitle streams. If it is greater
116
than the number of subtitle streams minus one, then the last one is
117
selected, if it is negative the subtitle rendering is disabled.
118 e99c4e10 Fabrice Bellard
@end table
119
120
@section While playing
121
122
@table @key
123
@item q, ESC
124 b467be72 Stefano Sabatini
Quit.
125 e99c4e10 Fabrice Bellard
126
@item f
127 b467be72 Stefano Sabatini
Toggle full screen.
128 e99c4e10 Fabrice Bellard
129
@item p, SPC
130 b467be72 Stefano Sabatini
Pause.
131 e99c4e10 Fabrice Bellard
132
@item a
133 b467be72 Stefano Sabatini
Cycle audio channel.
134 e99c4e10 Fabrice Bellard
135
@item v
136 b467be72 Stefano Sabatini
Cycle video channel.
137 e99c4e10 Fabrice Bellard
138 173c7185 Björn Axelsson
@item t
139
Cycle subtitle channel.
140
141 e99c4e10 Fabrice Bellard
@item w
142 b467be72 Stefano Sabatini
Show audio waves.
143 05e894bc Limin Wang
144
@item left/right
145 b467be72 Stefano Sabatini
Seek backward/forward 10 seconds.
146 05e894bc Limin Wang
147
@item down/up
148 b467be72 Stefano Sabatini
Seek backward/forward 1 minute.
149 05e894bc Limin Wang
150
@item mouse click
151 b467be72 Stefano Sabatini
Seek to percentage in file corresponding to fraction of width.
152 05e894bc Limin Wang
153 e99c4e10 Fabrice Bellard
@end table
154
155
@c man end
156
157
@ignore
158
159
@setfilename ffplay
160
@settitle FFplay media player
161
162
@c man begin SEEALSO
163 831ec935 Diego Biurrun
ffmpeg(1), ffserver(1) and the HTML documentation of @file{ffmpeg}.
164 e99c4e10 Fabrice Bellard
@c man end
165
166
@c man begin AUTHOR
167
Fabrice Bellard
168
@c man end
169
170
@end ignore
171
172
@bye