Statistics
| Branch: | Revision:

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

History | View | Annotate | Download (3.51 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

    
11
@chapter Introduction
12

    
13
@c man begin DESCRIPTION
14
FFplay is a very simple and portable media player using the FFmpeg
15
libraries and the SDL library. It is mostly used as a testbed for the
16
various FFmpeg APIs.
17
@c man end
18

    
19
@chapter Invocation
20

    
21
@section Syntax
22
@example
23
@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
@include fftools-common-opts.texi
33
@item -x @var{width}
34
Force displayed width.
35
@item -y @var{height}
36
Force displayed height.
37
@item -s @var{size}
38
Set frame size (WxH or abbreviation), needed for videos which don't
39
contain a header with the frame size like raw YUV.
40
@item -an
41
Disable audio.
42
@item -vn
43
Disable video.
44
@item -ss @var{pos}
45
Seek to a given position in seconds.
46
@item -bytes
47
Seek by bytes.
48
@item -nodisp
49
Disable graphical display.
50
@item -f @var{fmt}
51
Force format.
52

    
53
@section Advanced options
54
@table @option
55
@item -pix_fmt @var{format}
56
Set pixel format.
57
@item -stats
58
Show the stream duration, the codec parameters, the current position in
59
the stream and the audio/video synchronisation drift.
60
@item -debug
61
Print specific debug info.
62
@item -bug
63
Work around bugs.
64
@item -vismv
65
Visualize motion vectors.
66
@item -fast
67
Non-spec-compliant optimizations.
68
@item -genpts
69
Generate pts.
70
@item -rtp_tcp
71
Force RTP/TCP protocol usage instead of RTP/UDP. It is only meaningful
72
if you are streaming with the RTSP protocol.
73
@item -sync @var{type}
74
Set the master clock to audio (@code{type=audio}), video
75
(@code{type=video}) or external (@code{type=ext}). Default is audio. The
76
master clock is used to control audio-video synchronization. Most media
77
players use audio as master clock, but in some cases (streaming or high
78
quality broadcast) it is necessary to change that. This option is mainly
79
used for debugging purposes.
80
@item -threads @var{count}
81
Set the thread count.
82
@item -ast @var{audio_stream_number}
83
Select the desired audio stream number, counting from 0. The number
84
refers to the list of all the input audio streams. If it is greater
85
than the number of audio streams minus one, then the last one is
86
selected, if it is negative the audio playback is disabled.
87
@item -vst @var{video_stream_number}
88
Select the desired video stream number, counting from 0. The number
89
refers to the list of all the input video streams. If it is greater
90
than the number of video streams minus one, then the last one is
91
selected, if it is negative the video playback is disabled.
92
@item -sst @var{subtitle_stream_number}
93
Select the desired subtitle stream number, counting from 0. The number
94
refers to the list of all the input subtitle streams. If it is greater
95
than the number of subtitle streams minus one, then the last one is
96
selected, if it is negative the subtitle rendering is disabled.
97
@end table
98

    
99
@section While playing
100

    
101
@table @key
102
@item q, ESC
103
Quit.
104

    
105
@item f
106
Toggle full screen.
107

    
108
@item p, SPC
109
Pause.
110

    
111
@item a
112
Cycle audio channel.
113

    
114
@item v
115
Cycle video channel.
116

    
117
@item t
118
Cycle subtitle channel.
119

    
120
@item w
121
Show audio waves.
122

    
123
@item left/right
124
Seek backward/forward 10 seconds.
125

    
126
@item down/up
127
Seek backward/forward 1 minute.
128

    
129
@item mouse click
130
Seek to percentage in file corresponding to fraction of width.
131

    
132
@end table
133

    
134
@c man end
135

    
136
@ignore
137

    
138
@setfilename ffplay
139
@settitle FFplay media player
140

    
141
@c man begin SEEALSO
142
ffmpeg(1), ffserver(1) and the HTML documentation of @file{ffmpeg}.
143
@c man end
144

    
145
@c man begin AUTHOR
146
Fabrice Bellard
147
@c man end
148

    
149
@end ignore
150

    
151
@bye