Statistics
| Branch: | Revision:

ffmpeg / doc / ffplay-doc.texi @ 22b6a24c

History | View | Annotate | Download (3.52 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 5f6cb6eb Stefano Sabatini
@include fftools-common-opts.texi
33 a19caa0f Stefano Sabatini
@item -x @var{width}
34 b467be72 Stefano Sabatini
Force displayed width.
35 a19caa0f Stefano Sabatini
@item -y @var{height}
36 b467be72 Stefano Sabatini
Force displayed height.
37 a19caa0f Stefano Sabatini
@item -s @var{size}
38 05e894bc Limin Wang
Set frame size (WxH or abbreviation), needed for videos which don't
39 831ec935 Diego Biurrun
contain a header with the frame size like raw YUV.
40 e99c4e10 Fabrice Bellard
@item -an
41 b467be72 Stefano Sabatini
Disable audio.
42 e99c4e10 Fabrice Bellard
@item -vn
43 b467be72 Stefano Sabatini
Disable video.
44 a19caa0f Stefano Sabatini
@item -ss @var{pos}
45 b467be72 Stefano Sabatini
Seek to a given position in seconds.
46 05e894bc Limin Wang
@item -bytes
47 b467be72 Stefano Sabatini
Seek by bytes.
48 e99c4e10 Fabrice Bellard
@item -nodisp
49 b467be72 Stefano Sabatini
Disable graphical display.
50 a19caa0f Stefano Sabatini
@item -f @var{fmt}
51 b467be72 Stefano Sabatini
Force format.
52 dc7f38f5 Stefano Sabatini
@end table
53 e99c4e10 Fabrice Bellard
54
@section Advanced options
55
@table @option
56 a19caa0f Stefano Sabatini
@item -pix_fmt @var{format}
57 b467be72 Stefano Sabatini
Set pixel format.
58 e99c4e10 Fabrice Bellard
@item -stats
59 6527639b Diego Biurrun
Show the stream duration, the codec parameters, the current position in
60
the stream and the audio/video synchronisation drift.
61 05e894bc Limin Wang
@item -debug
62 b467be72 Stefano Sabatini
Print specific debug info.
63 05e894bc Limin Wang
@item -bug
64 b467be72 Stefano Sabatini
Work around bugs.
65 05e894bc Limin Wang
@item -vismv
66 b467be72 Stefano Sabatini
Visualize motion vectors.
67 05e894bc Limin Wang
@item -fast
68 b467be72 Stefano Sabatini
Non-spec-compliant optimizations.
69 05e894bc Limin Wang
@item -genpts
70 b467be72 Stefano Sabatini
Generate pts.
71 e99c4e10 Fabrice Bellard
@item -rtp_tcp
72 6527639b Diego Biurrun
Force RTP/TCP protocol usage instead of RTP/UDP. It is only meaningful
73
if you are streaming with the RTSP protocol.
74 a19caa0f Stefano Sabatini
@item -sync @var{type}
75 6527639b Diego Biurrun
Set the master clock to audio (@code{type=audio}), video
76 e99c4e10 Fabrice Bellard
(@code{type=video}) or external (@code{type=ext}). Default is audio. The
77
master clock is used to control audio-video synchronization. Most media
78
players use audio as master clock, but in some cases (streaming or high
79
quality broadcast) it is necessary to change that. This option is mainly
80
used for debugging purposes.
81 a19caa0f Stefano Sabatini
@item -threads @var{count}
82 b467be72 Stefano Sabatini
Set the thread count.
83 4b037567 Stefano Sabatini
@item -ast @var{audio_stream_number}
84
Select the desired audio stream number, counting from 0. The number
85
refers to the list of all the input audio streams. If it is greater
86
than the number of audio streams minus one, then the last one is
87
selected, if it is negative the audio playback is disabled.
88
@item -vst @var{video_stream_number}
89
Select the desired video stream number, counting from 0. The number
90
refers to the list of all the input video streams. If it is greater
91
than the number of video streams minus one, then the last one is
92
selected, if it is negative the video playback is disabled.
93
@item -sst @var{subtitle_stream_number}
94
Select the desired subtitle stream number, counting from 0. The number
95
refers to the list of all the input subtitle streams. If it is greater
96
than the number of subtitle streams minus one, then the last one is
97
selected, if it is negative the subtitle rendering is disabled.
98 e99c4e10 Fabrice Bellard
@end table
99
100
@section While playing
101
102
@table @key
103
@item q, ESC
104 b467be72 Stefano Sabatini
Quit.
105 e99c4e10 Fabrice Bellard
106
@item f
107 b467be72 Stefano Sabatini
Toggle full screen.
108 e99c4e10 Fabrice Bellard
109
@item p, SPC
110 b467be72 Stefano Sabatini
Pause.
111 e99c4e10 Fabrice Bellard
112
@item a
113 b467be72 Stefano Sabatini
Cycle audio channel.
114 e99c4e10 Fabrice Bellard
115
@item v
116 b467be72 Stefano Sabatini
Cycle video channel.
117 e99c4e10 Fabrice Bellard
118 173c7185 Björn Axelsson
@item t
119
Cycle subtitle channel.
120
121 e99c4e10 Fabrice Bellard
@item w
122 b467be72 Stefano Sabatini
Show audio waves.
123 05e894bc Limin Wang
124
@item left/right
125 b467be72 Stefano Sabatini
Seek backward/forward 10 seconds.
126 05e894bc Limin Wang
127
@item down/up
128 b467be72 Stefano Sabatini
Seek backward/forward 1 minute.
129 05e894bc Limin Wang
130
@item mouse click
131 b467be72 Stefano Sabatini
Seek to percentage in file corresponding to fraction of width.
132 05e894bc Limin Wang
133 e99c4e10 Fabrice Bellard
@end table
134
135
@c man end
136
137
@ignore
138
139
@setfilename ffplay
140
@settitle FFplay media player
141
142
@c man begin SEEALSO
143 831ec935 Diego Biurrun
ffmpeg(1), ffserver(1) and the HTML documentation of @file{ffmpeg}.
144 e99c4e10 Fabrice Bellard
@c man end
145
146
@c man begin AUTHOR
147
Fabrice Bellard
148
@c man end
149
150
@end ignore
151
152
@bye