Statistics
| Branch: | Revision:

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

History | View | Annotate | Download (4.21 KB)

1
\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
@chapter Synopsis
11

    
12
@example
13
@c man begin SYNOPSIS
14
ffplay [options] @file{input_file}
15
@c man end
16
@end example
17

    
18
@chapter Description
19
@c man begin DESCRIPTION
20

    
21
FFplay is a very simple and portable media player using the FFmpeg
22
libraries and the SDL library. It is mostly used as a testbed for the
23
various FFmpeg APIs.
24
@c man end
25

    
26
@chapter Options
27
@c man begin OPTIONS
28

    
29
@include fftools-common-opts.texi
30

    
31
@section Main options
32

    
33
@table @option
34
@item -x @var{width}
35
Force displayed width.
36
@item -y @var{height}
37
Force displayed height.
38
@item -s @var{size}
39
Set frame size (WxH or abbreviation), needed for videos which don't
40
contain a header with the frame size like raw YUV.
41
@item -an
42
Disable audio.
43
@item -vn
44
Disable video.
45
@item -ss @var{pos}
46
Seek to a given position in seconds.
47
@item -t @var{duration}
48
play <duration> seconds of audio/video
49
@item -bytes
50
Seek by bytes.
51
@item -nodisp
52
Disable graphical display.
53
@item -f @var{fmt}
54
Force format.
55
@item -window_title @var{title}
56
Set window title (default is the input filename).
57
@item -loop @var{number}
58
Loops movie playback <number> times. 0 means forever.
59
@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
@end table
66

    
67
@section Advanced options
68
@table @option
69
@item -pix_fmt @var{format}
70
Set pixel format.
71
@item -stats
72
Show the stream duration, the codec parameters, the current position in
73
the stream and the audio/video synchronisation drift.
74
@item -debug
75
Print specific debug info.
76
@item -bug
77
Work around bugs.
78
@item -vismv
79
Visualize motion vectors.
80
@item -fast
81
Non-spec-compliant optimizations.
82
@item -genpts
83
Generate pts.
84
@item -rtp_tcp
85
Force RTP/TCP protocol usage instead of RTP/UDP. It is only meaningful
86
if you are streaming with the RTSP protocol.
87
@item -sync @var{type}
88
Set the master clock to audio (@code{type=audio}), video
89
(@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
@item -threads @var{count}
95
Set the thread count.
96
@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
@item -autoexit
112
Exit when video is done playing.
113
@item -exitonkeydown
114
Exit if any key is pressed.
115
@item -exitonmousedown
116
Exit if any mouse button is pressed.
117
@end table
118

    
119
@section While playing
120

    
121
@table @key
122
@item q, ESC
123
Quit.
124

    
125
@item f
126
Toggle full screen.
127

    
128
@item p, SPC
129
Pause.
130

    
131
@item a
132
Cycle audio channel.
133

    
134
@item v
135
Cycle video channel.
136

    
137
@item t
138
Cycle subtitle channel.
139

    
140
@item w
141
Show audio waves.
142

    
143
@item left/right
144
Seek backward/forward 10 seconds.
145

    
146
@item down/up
147
Seek backward/forward 1 minute.
148

    
149
@item mouse click
150
Seek to percentage in file corresponding to fraction of width.
151

    
152
@end table
153

    
154
@c man end
155

    
156
@include eval.texi
157
@include indevs.texi
158
@include outdevs.texi
159
@include protocols.texi
160
@include filters.texi
161

    
162
@ignore
163

    
164
@setfilename ffplay
165
@settitle FFplay media player
166

    
167
@c man begin SEEALSO
168
ffmpeg(1), ffprobe(1), ffserver(1) and the FFmpeg HTML documentation
169
@c man end
170

    
171
@c man begin AUTHORS
172
The FFmpeg developers
173
@c man end
174

    
175
@end ignore
176

    
177
@bye