doc: add decoders.texi
[ffmpeg.git] / doc / avplay.texi
1 \input texinfo @c -*- texinfo -*-
2
3 @settitle avplay Documentation
4 @titlepage
5 @center @titlefont{avplay Documentation}
6 @end titlepage
7
8 @top
9
10 @contents
11
12 @chapter Synopsis
13
14 @example
15 @c man begin SYNOPSIS
16 avplay [options] @file{input_file}
17 @c man end
18 @end example
19
20 @chapter Description
21 @c man begin DESCRIPTION
22
23 AVplay is a very simple and portable media player using the Libav
24 libraries and the SDL library. It is mostly used as a testbed for the
25 various Libav APIs.
26 @c man end
27
28 @chapter Options
29 @c man begin OPTIONS
30
31 @include avtools-common-opts.texi
32
33 @section Main options
34
35 @table @option
36 @item -x @var{width}
37 Force displayed width.
38 @item -y @var{height}
39 Force displayed height.
40 @item -s @var{size}
41 This option has been removed. Use private format options for specifying the
42 input video size.  For example with the rawvideo demuxer you need to specify the
43 option @var{video_size}.
44 @item -an
45 Disable audio.
46 @item -vn
47 Disable video.
48 @item -ss @var{pos}
49 Seek to a given position in seconds.
50 @item -t @var{duration}
51 play <duration> seconds of audio/video
52 @item -bytes
53 Seek by bytes.
54 @item -nodisp
55 Disable graphical display.
56 @item -f @var{fmt}
57 Force format.
58 @item -window_title @var{title}
59 Set window title (default is the input filename).
60 @item -loop @var{number}
61 Loops movie playback <number> times. 0 means forever.
62 @item -vf @var{filter_graph}
63 @var{filter_graph} is a description of the filter graph to apply to
64 the input video.
65 Use the option "-filters" to show all the available filters (including
66 also sources and sinks).
67
68 @end table
69
70 @section Advanced options
71 @table @option
72 @item -pix_fmt @var{format}
73 This option has been removed. Use private options for specifying the
74 input pixel format. For example with the rawvideo demuxer you need to specify
75 the option @var{pixel_format}.
76 @item -stats
77 Show the stream duration, the codec parameters, the current position in
78 the stream and the audio/video synchronisation drift.
79 @item -bug
80 Work around bugs.
81 @item -fast
82 Non-spec-compliant optimizations.
83 @item -genpts
84 Generate pts.
85 @item -rtp_tcp
86 Force RTP/TCP protocol usage instead of RTP/UDP. It is only meaningful
87 if you are streaming with the RTSP protocol.
88 @item -sync @var{type}
89 Set the master clock to audio (@code{type=audio}), video
90 (@code{type=video}) or external (@code{type=ext}). Default is audio. The
91 master clock is used to control audio-video synchronization. Most media
92 players use audio as master clock, but in some cases (streaming or high
93 quality broadcast) it is necessary to change that. This option is mainly
94 used for debugging purposes.
95 @item -threads @var{count}
96 Set the thread count.
97 @item -ast @var{audio_stream_number}
98 Select the desired audio stream number, counting from 0. The number
99 refers to the list of all the input audio streams. If it is greater
100 than the number of audio streams minus one, then the last one is
101 selected, if it is negative the audio playback is disabled.
102 @item -vst @var{video_stream_number}
103 Select the desired video stream number, counting from 0. The number
104 refers to the list of all the input video streams. If it is greater
105 than the number of video streams minus one, then the last one is
106 selected, if it is negative the video playback is disabled.
107 @item -sst @var{subtitle_stream_number}
108 Select the desired subtitle stream number, counting from 0. The number
109 refers to the list of all the input subtitle streams. If it is greater
110 than the number of subtitle streams minus one, then the last one is
111 selected, if it is negative the subtitle rendering is disabled.
112 @item -autoexit
113 Exit when video is done playing.
114 @item -exitonkeydown
115 Exit if any key is pressed.
116 @item -exitonmousedown
117 Exit if any mouse button is pressed.
118 @end table
119
120 @section While playing
121
122 @table @key
123 @item q, ESC
124 Quit.
125
126 @item f
127 Toggle full screen.
128
129 @item p, SPC
130 Pause.
131
132 @item a
133 Cycle audio channel.
134
135 @item v
136 Cycle video channel.
137
138 @item t
139 Cycle subtitle channel.
140
141 @item w
142 Show audio waves.
143
144 @item left/right
145 Seek backward/forward 10 seconds.
146
147 @item down/up
148 Seek backward/forward 1 minute.
149
150 @item mouse click
151 Seek to percentage in file corresponding to fraction of width.
152
153 @end table
154
155 @c man end
156
157 @include eval.texi
158 @include decoders.texi
159 @include demuxers.texi
160 @include muxers.texi
161 @include indevs.texi
162 @include outdevs.texi
163 @include protocols.texi
164 @include filters.texi
165
166 @ignore
167
168 @setfilename avplay
169 @settitle AVplay media player
170
171 @c man begin SEEALSO
172 avconv(1), avprobe(1) and the Libav HTML documentation
173 @c man end
174
175 @c man begin AUTHORS
176 The Libav developers
177 @c man end
178
179 @end ignore
180
181 @bye