Statistics
| Branch: | Revision:

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

History | View | Annotate | Download (3.51 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 e99c4e10 Fabrice Bellard
53
@section Advanced options
54
@table @option
55 a19caa0f Stefano Sabatini
@item -pix_fmt @var{format}
56 b467be72 Stefano Sabatini
Set pixel format.
57 e99c4e10 Fabrice Bellard
@item -stats
58 6527639b Diego Biurrun
Show the stream duration, the codec parameters, the current position in
59
the stream and the audio/video synchronisation drift.
60 05e894bc Limin Wang
@item -debug
61 b467be72 Stefano Sabatini
Print specific debug info.
62 05e894bc Limin Wang
@item -bug
63 b467be72 Stefano Sabatini
Work around bugs.
64 05e894bc Limin Wang
@item -vismv
65 b467be72 Stefano Sabatini
Visualize motion vectors.
66 05e894bc Limin Wang
@item -fast
67 b467be72 Stefano Sabatini
Non-spec-compliant optimizations.
68 05e894bc Limin Wang
@item -genpts
69 b467be72 Stefano Sabatini
Generate pts.
70 e99c4e10 Fabrice Bellard
@item -rtp_tcp
71 6527639b Diego Biurrun
Force RTP/TCP protocol usage instead of RTP/UDP. It is only meaningful
72
if you are streaming with the RTSP protocol.
73 a19caa0f Stefano Sabatini
@item -sync @var{type}
74 6527639b Diego Biurrun
Set the master clock to audio (@code{type=audio}), video
75 e99c4e10 Fabrice Bellard
(@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 a19caa0f Stefano Sabatini
@item -threads @var{count}
81 b467be72 Stefano Sabatini
Set the thread count.
82 4b037567 Stefano Sabatini
@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 e99c4e10 Fabrice Bellard
@end table
98
99
@section While playing
100
101
@table @key
102
@item q, ESC
103 b467be72 Stefano Sabatini
Quit.
104 e99c4e10 Fabrice Bellard
105
@item f
106 b467be72 Stefano Sabatini
Toggle full screen.
107 e99c4e10 Fabrice Bellard
108
@item p, SPC
109 b467be72 Stefano Sabatini
Pause.
110 e99c4e10 Fabrice Bellard
111
@item a
112 b467be72 Stefano Sabatini
Cycle audio channel.
113 e99c4e10 Fabrice Bellard
114
@item v
115 b467be72 Stefano Sabatini
Cycle video channel.
116 e99c4e10 Fabrice Bellard
117 173c7185 Björn Axelsson
@item t
118
Cycle subtitle channel.
119
120 e99c4e10 Fabrice Bellard
@item w
121 b467be72 Stefano Sabatini
Show audio waves.
122 05e894bc Limin Wang
123
@item left/right
124 b467be72 Stefano Sabatini
Seek backward/forward 10 seconds.
125 05e894bc Limin Wang
126
@item down/up
127 b467be72 Stefano Sabatini
Seek backward/forward 1 minute.
128 05e894bc Limin Wang
129
@item mouse click
130 b467be72 Stefano Sabatini
Seek to percentage in file corresponding to fraction of width.
131 05e894bc Limin Wang
132 e99c4e10 Fabrice Bellard
@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 831ec935 Diego Biurrun
ffmpeg(1), ffserver(1) and the HTML documentation of @file{ffmpeg}.
143 e99c4e10 Fabrice Bellard
@c man end
144
145
@c man begin AUTHOR
146
Fabrice Bellard
147
@c man end
148
149
@end ignore
150
151
@bye