Mercurial > mplayer.hg
comparison DOCS/mplayer.1 @ 6469:caac66533fa0
Tons of typos plus wording updated here and there.
author | diego |
---|---|
date | Thu, 20 Jun 2002 11:09:47 +0000 |
parents | b6b9060dd94f |
children | 7663637ddba4 |
comparison
equal
deleted
inserted
replaced
6468:6cf0e246e15d | 6469:caac66533fa0 |
---|---|
1 .\" MPlayer (C) 2000-2002 Arpad Gereoffy <sendmail@to.mplayer-users> | 1 .\" MPlayer (C) 2000-2002 Arpad Gereoffy <sendmail@to.mplayer-users> |
2 .\" This manpage was/is done by Gabucino <sendmail@to.mplayer-users> | 2 .\" This man page was/is done by Gabucino <sendmail@to.mplayer-users> |
3 .\" (Patches done by Jonas Jermann <sendmail@to.mplayer-users>) | 3 .\" (Patches done by Jonas Jermann <sendmail@to.mplayer-users>) |
4 .\" | 4 .\" |
5 .TH "MPlayer" "1" "2002-05-13" | 5 .TH "MPlayer" "1" "2002-05-13" |
6 | 6 |
7 .SH "NAME" | 7 .SH "NAME" |
8 mplayer \- Movie Player for Linux | 8 mplayer \- Movie Player for Linux |
9 .br | 9 .br |
10 mencoder \- Movie Encoder for Linux | 10 mencoder \- Movie Encoder for Linux |
11 | 11 |
12 .SH "SYNOPSIS" | 12 .SH "SYNOPSIS" |
13 .B mplayer | 13 .B mplayer |
35 .B mplayer | 35 .B mplayer |
36 is a movie player for LINUX (runs on many other Unices, and non\-x86 | 36 is a movie player for LINUX (runs on many other Unices, and non\-x86 |
37 CPUs, see the documentation). It plays most MPEG, VOB, AVI, OGG, VIVO, ASF/WMV, QT/MOV, | 37 CPUs, see the documentation). It plays most MPEG, VOB, AVI, OGG, VIVO, ASF/WMV, QT/MOV, |
38 FLI, RM, NuppelVideo, yuv4mpeg, FILM, RoQ files, supported by many native, XAnim, and | 38 FLI, RM, NuppelVideo, yuv4mpeg, FILM, RoQ files, supported by many native, XAnim, and |
39 Win32 DLL codecs. You can watch VideoCD, SVCD, DVD, 3ivx, DivX 3/4/5 and even WMV | 39 Win32 DLL codecs. You can watch VideoCD, SVCD, DVD, 3ivx, DivX 3/4/5 and even WMV |
40 movies too (and you don't need the avifile library at all!). | 40 movies, too (without the avifile library). |
41 | 41 |
42 Another big feature of mplayer is the wide range of supported output drivers. | 42 Another great feature of mplayer is the wide range of supported output drivers. |
43 It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev, AAlib, DirectFB, but you can use | 43 It works with X11, XV, DGA, OpenGL, SVGAlib, fbdev, AAlib, DirectFB, but you can use |
44 GGI, SDL (and this way all their drivers), VESA (on every VESA compatible card, even | 44 GGI, SDL (and this way all their drivers), VESA (on every VESA compatible card, even |
45 without X!) and some lowlevel card-specific drivers (for Matrox, 3Dfx and Radeon) too! | 45 without X11!) and some low level card-specific drivers (for Matrox, 3Dfx and Radeon), too! |
46 .br | 46 .br |
47 Most of them supports software or hardware scaling, so you can enjoy movies in fullscreen. | 47 Most of them support software or hardware scaling, so you can enjoy movies in fullscreen. |
48 MPlayer supports displaying through some hardware MPEG decoder boards, such as the Siemens | 48 MPlayer supports displaying through some hardware MPEG decoder boards, such as the Siemens |
49 DVB, DXR2 and DXR3/Hollywood+! | 49 DVB, DXR2 and DXR3/Hollywood+! |
50 | 50 |
51 Nice big antialiased shaded subtitles with european/ISO 8859-1,2 (hungarian, english, czech, | 51 Nice big antialiased shaded subtitles with European/ISO 8859-1,2 (Hungarian, English, Czech, |
52 etc), cyrillic, korean fonts are supported (10 supported subtitle formats: VobSub, MicroDVD, | 52 etc), Cyrillic, Korean fonts are supported (10 supported subtitle formats: VobSub, MicroDVD, |
53 SubRip, SubViewer, Sami, VPlayer, RT, SSA, AQTitle and our own: MPsub). | 53 SubRip, SubViewer, Sami, VPlayer, RT, SSA, AQTitle and our own: MPsub). |
54 | 54 |
55 .B mencoder | 55 .B mencoder |
56 (MPlayer's Movie Encoder) is a simple movie encoder, designed to | 56 (MPlayer's Movie Encoder) is a simple movie encoder, designed to |
57 encode MPlayer-playable movies (AVI/ASF/OGG/DVD/VCD/VOB/MPG/MOV/VIV/FLI/RM/NUV/NET) | 57 encode MPlayer-playable movies (AVI/ASF/OGG/DVD/VCD/VOB/MPG/MOV/VIV/FLI/RM/NUV/NET) |
58 to other MPlayer-playable formats (see below). It encodes to DivX4 | 58 to other MPlayer-playable formats (see below). It encodes to DivX4 |
59 (1, 2 or 3 passes), XviD, codecs of libavcodec, PCM/MP3/VBRMP3 audio. | 59 (1, 2 or 3 passes), XviD, codecs of libavcodec, PCM/MP3/VBRMP3 audio. |
60 Also has stream copying abilities, a powerful plugin system | 60 It also has stream copying abilities, a powerful plugin system |
61 (crop, expand, flip, postprocess, rotate, scale, rgb/yuv conversion) and more. | 61 (crop, expand, flip, postprocess, rotate, scale, rgb/yuv conversion) and more. |
62 | 62 |
63 .B gmplayer | 63 .B gmplayer |
64 is MPlayer with a graphical user interface. | 64 is MPlayer with a graphical user interface. |
65 It has the same options as MPlayer. | 65 It has the same options as MPlayer. |
66 | 66 |
67 .SH GENERAL NOTES | 67 .SH GENERAL NOTES |
68 Every "flag" option has "noflag" pair, e.g. \-fs opposite is \-nofs. | 68 Every "flag" option has a "noflag" counterpart, e.g. the opposite of the \-fs |
69 .br | 69 option is \-nofs. |
70 .B Check the html documentation too! | 70 .br |
71 .B Check the HTML documentation, too! | |
71 | 72 |
72 .SH "DEMUXER/STREAM OPTIONS" | 73 .SH "DEMUXER/STREAM OPTIONS" |
73 .TP | 74 .TP |
74 .B \-aid <id> | 75 .B \-aid <id> |
75 Select audio channel [MPG: 0\-31 AVI: 1\-99 ASF: 0\-127 VOB: 128\-...] | 76 Select audio channel [MPG: 0\-31 AVI: 1\-99 ASF: 0\-127 VOB: 128\-...] |
76 .br | 77 .br |
77 .I NOTE: | 78 .I NOTE: |
78 Use \-alang to define the language by name. | 79 Use \-alang to choose the language. |
79 .TP | 80 .TP |
80 .B \-alang <audio\ stream\ language> | 81 .B \-alang <audio\ stream\ language> |
81 Usable when playing DVD disks. Expects a two\-letter country code(s) as | 82 Usable when playing DVD disks. Expects a two\-letter country code(s) as |
82 parameter, and always tries to play back audio streams those language | 83 parameter, and always tries to play audio streams whose language matches the |
83 matches the given code. For example: \-alang hu,en will always try to play | 84 given code. For example: \-alang hu,en will play Hungarian and fall back to |
84 hungarian or if it's non\-existant then english audio streams if there are any. | 85 English if Hungarian is not available, provided that English audio exists. |
85 .TP | 86 .TP |
86 .B \-audio\-demuxer <number> | 87 .B \-audio\-demuxer <number> |
87 Force audio demuxer type for \-audiofile. | 88 Force audio demuxer type for \-audiofile. |
88 Give the demuxer ID as defined in demuxers.h. | 89 Give the demuxer ID as defined in demuxers.h. |
89 You can use \-audio\-demuxer 17 to force .mp3 detection! | 90 Use \-audio\-demuxer 17 to force .mp3 detection. |
90 .TP | 91 .TP |
91 .B \-audiofile <filename> | 92 .B \-audiofile <filename> |
92 Play audio from an external file (WAV, MP3 or OggVorbis) | 93 Play audio from an external file (WAV, MP3 or Ogg Vorbis). |
93 .TP | 94 .TP |
94 .B \-cdrom\-device <path\ to\ device> | 95 .B \-cdrom\-device <path\ to\ device> |
95 Override default CDROM drive name /dev/cdrom | 96 Override default CDROM drive name /dev/cdrom. |
96 .TP | 97 .TP |
97 .B \-cache <kbytes> | 98 .B \-cache <kbytes> |
98 This option specifies how much memory (in kbytes) to use when precaching a file/URL. | 99 This option specifies how much memory (in kbytes) to use when precaching a file/URL. |
99 Especially useful on slow media (default is \-nocache). | 100 Especially useful on slow media (default is \-nocache). |
100 .TP | 101 .TP |
125 .B \-chapter <chapter\ id>[-<end chapter id>] | 126 .B \-chapter <chapter\ id>[-<end chapter id>] |
126 Specify which chapter to start playing at. Optionally specify which chapter to | 127 Specify which chapter to start playing at. Optionally specify which chapter to |
127 end playing at. Examples can be found below. | 128 end playing at. Examples can be found below. |
128 .TP | 129 .TP |
129 .B \-csslib <filename> | 130 .B \-csslib <filename> |
130 (old-style DVD option) This option is used to override the default location of libcss.so | 131 (old-style DVD option) This option is used to override the default location of libcss.so. |
131 .TP | 132 .TP |
132 .B \-demuxer <number> | 133 .B \-demuxer <number> |
133 Force demuxer type. Give the demuxer ID as defined in demuxers.h. | 134 Force demuxer type. Give the demuxer ID as defined in demuxers.h. |
134 .TP | 135 .TP |
135 .B \-dumpaudio (MPLAYER only) | 136 .B \-dumpaudio (MPLAYER only) |
136 Dumps raw compressed audio stream to ./stream.dump (useful with mpeg/ac3) | 137 Dumps raw compressed audio stream to ./stream.dump (useful with mpeg/ac3). |
137 .TP | 138 .TP |
138 .B \-dumpfile <filename> (MPLAYER only) | 139 .B \-dumpfile <filename> (MPLAYER only) |
139 Specify which file MPlayer should dump to. Should be used together | 140 Specify which file MPlayer should dump to. Should be used together |
140 with \-dumpaudio/\-dumpvideo/\-dumpstream. | 141 with \-dumpaudio/\-dumpvideo/\-dumpstream. |
141 .TP | 142 .TP |
142 .B \-dumpstream (MPLAYER only) | 143 .B \-dumpstream (MPLAYER only) |
143 Dumps the raw stream to ./stream.dump . Useful for example | 144 Dumps the raw stream to ./stream.dump. Useful for example |
144 when ripping from DVD or network. | 145 when ripping from DVD or network. |
145 .TP | 146 .TP |
146 .B \-dumpsub (MPLAYER only) | 147 .B \-dumpsub (MPLAYER only) |
147 Dumps the subtitle substream from VOB streams. | 148 Dumps the subtitle substream from VOB streams. |
148 .TP | 149 .TP |
149 .B \-dumpvideo (MPLAYER only) | 150 .B \-dumpvideo (MPLAYER only) |
150 Dump raw compressed video stream to ./stream.dump (not very usable) | 151 Dump raw compressed video stream to ./stream.dump (not very usable). |
151 .TP | 152 .TP |
152 .B \-dvd <title\ id> | 153 .B \-dvd <title\ id> |
153 Tell MPlayer which movies (marked with titleid) to play. For example | 154 Tell MPlayer which movies (specified by title id) to play. For example |
154 sometimes '1' are trailers, and '2' is the real movie. Sometimes deinterlacing | 155 sometimes '1' is a trailer, and '2' is the real movie. Sometimes deinterlacing |
155 is required for DVD playback: see '\-pp 0x20000' or '\-npp lb' options too. | 156 is required for DVD playback: see '\-pp 0x20000' or '\-npp lb' options, too. |
156 .TP | 157 .TP |
157 .B \-dvd\-device <path\ to\ device> | 158 .B \-dvd\-device <path\ to\ device> |
158 Override default DVD device name /dev/dvd | 159 Override default DVD device name /dev/dvd. |
159 .TP | 160 .TP |
160 .B \-dvdangle <angle\ id> | 161 .B \-dvdangle <angle\ id> |
161 Some DVD discs contain scenes that can be viewed from multiple angles. | 162 Some DVD discs contain scenes that can be viewed from multiple angles. |
162 Here you can tell MPlayer which angles to use. Examples can be found below. | 163 Here you can tell MPlayer which angles to use. Examples can be found below. |
163 .TP | 164 .TP |
175 Force rebuilding of INDEX. Useful for files with broken index (desyncs, etc). | 176 Force rebuilding of INDEX. Useful for files with broken index (desyncs, etc). |
176 Seeking will be possible. You can fix the index permanently with | 177 Seeking will be possible. You can fix the index permanently with |
177 MEncoder (see the documentation). | 178 MEncoder (see the documentation). |
178 .TP | 179 .TP |
179 .B \-fps <value> | 180 .B \-fps <value> |
180 Override video frame rate (if value is wrong/missing in the header) (float number) | 181 Override video framerate (if value is wrong/missing in the header) (float number). |
181 .TP | 182 .TP |
182 .B \-frames <number> | 183 .B \-frames <number> |
183 Play/convert only first <number> frames, then quit. | 184 Play/convert only first <number> frames, then quit. |
184 .TP | 185 .TP |
185 .B \-hr\-mp3\-seek (.MP3 only) | 186 .B \-hr\-mp3\-seek (.MP3 only) |
186 Hi\-res mp3 seeking. Default is: enabled when playing from external MP3 file, | 187 Hi\-res mp3 seeking. Default is: enabled when playing from external MP3 file, |
187 as we need to seek to the very exact position to keep A/V sync. It can be slow | 188 as we need to seek to the very exact position to keep A/V sync. It can be slow |
188 especially when seeking backwards \- it has to rewind to the beginning to find | 189 especially when seeking backwards \- it has to rewind to the beginning to find |
189 the exact frame. | 190 the exact frame. |
190 .TP | 191 .TP .B \-idx (also see \-forceidx) |
191 .B \-idx (see \-forceidx option too!) | |
192 Rebuilds INDEX of the AVI if no INDEX was found, | 192 Rebuilds INDEX of the AVI if no INDEX was found, |
193 thus allowing seeking. Useful with broken/incomplete | 193 thus allowing seeking. Useful with broken/incomplete |
194 downloads, or badly created AVIs. | 194 downloads, or badly created AVIs. |
195 .TP | 195 .TP |
196 .B \-mc <seconds/frame> | 196 .B \-mc <seconds/frame> |
197 Maximum A-V sync correction per frame (in seconds) | 197 Maximum A-V sync correction per frame (in seconds) |
198 .TP | 198 .TP |
199 .B \-mf <option1:option2:...> | 199 .B \-mf <option1:option2:...> |
200 Used when decoding from multiple PNG or JPEG files. | 200 Used when decoding from multiple PNG or JPEG files |
201 (see documentation). They are: | 201 (see documentation). The options are: |
202 | 202 |
203 on turns on multifile support | 203 on turns on multifile support |
204 w=<value> width of the output (autodetect) | 204 w=<value> width of the output (autodetect) |
205 h=<value> height of the output (autodetect) | 205 h=<value> height of the output (autodetect) |
206 fps=<value> fps of the output (default: 25) | 206 fps=<value> fps of the output (default: 25) |
209 .B \-ni (.AVI only) | 209 .B \-ni (.AVI only) |
210 Force usage of non\-interleaved AVI parser (fixes playing | 210 Force usage of non\-interleaved AVI parser (fixes playing |
211 of some bad AVI files). | 211 of some bad AVI files). |
212 .TP | 212 .TP |
213 .B \-nobps (.AVI only) | 213 .B \-nobps (.AVI only) |
214 Don't use avg. byte/sec value for A\-V sync (AVI). | 214 Do not use average byte/sec value for A\-V sync (AVI). |
215 Helps with some AVI files with broken header. | 215 Helps with some AVI files with broken header. |
216 .TP | 216 .TP |
217 .B \-skipopening | 217 .B \-skipopening |
218 Skip dvd opening (dvdnav only). | 218 Skip DVD opening (dvdnav only). |
219 .TP | 219 .TP |
220 .B \-sb <byte\ position> (see \-ss option too!) | 220 .B \-sb <byte\ position> (see \-ss option too!) |
221 Seek to byte position. Useful for playback from cdrom | 221 Seek to byte position. Useful for playback from CDROM |
222 images / vob files with junk at the beginning. | 222 images / vob files with junk at the beginning. |
223 .TP | 223 .TP |
224 .B \-srate <Hz> | 224 .B \-srate <Hz> |
225 Specifies Hz to playback audio on. Has effect on playback speed! | 225 Specifies Hz to playback audio on. Affects playback speed! |
226 .TP | 226 .TP |
227 .B \-ss <time> (see \-sb option too!) | 227 .B \-ss <time> (see \-sb option too!) |
228 Seek to given time position. For example: | 228 Seek to given time position. For example: |
229 | 229 |
230 \-ss 56 seeks to 56 seconds | 230 \-ss 56 seeks to 56 seconds |
237 on use TV input | 237 on use TV input |
238 noaudio no sound | 238 noaudio no sound |
239 driver=<value> available: dummy, v4l | 239 driver=<value> available: dummy, v4l |
240 device=<value> specify other device than the default /dev/video0 | 240 device=<value> specify other device than the default /dev/video0 |
241 input=<value> available: television, s-video, composite, etc | 241 input=<value> available: television, s-video, composite, etc |
242 freq=<value> specify the frequency to set the tuner (e.g. 511.250) | 242 freq=<value> specify the frequency to set the tuner to (e.g. 511.250) |
243 outfmt=<value> output format of the tuner (rgb32, rgb24, yv12, uyvy, i420) | 243 outfmt=<value> output format of the tuner (rgb32, rgb24, yv12, uyvy, i420) |
244 width=<value> the width of the output window | 244 width=<value> width of the output window |
245 height=<value> the height of the output window | 245 height=<value> height of the output window |
246 norm=<value> available: PAL, SECAM, NTSC | 246 norm=<value> available: PAL, SECAM, NTSC |
247 channel=<value> set the tuner to the given channel | 247 channel=<value> set the tuner to the given channel |
248 chanlist=<value> available: us-bcast, us-cable, europe-west, europe-east, etc | 248 chanlist=<value> available: us-bcast, us-cable, europe-west, europe-east, etc |
249 .TP | 249 .TP |
250 .B \-vcd <track> | 250 .B \-vcd <track> |
251 Play video cd track from device instead of plain file | 251 Play video CD track from device instead of plain file. |
252 .TP | 252 .TP |
253 .B \-vid <id> | 253 .B \-vid <id> |
254 Select video channel [MPG: 0\-15 ASF: 0\-255 ] | 254 Select video channel [MPG: 0\-15 ASF: 0\-255]. |
255 .TP | 255 .TP |
256 .B \-vivo <sub\-options> (DEBUG CODE) | 256 .B \-vivo <sub\-options> (DEBUG CODE) |
257 Force audio parameters for the .vivo demuxer (for debugging purposes) | 257 Force audio parameters for the .vivo demuxer (for debugging purposes). |
258 | 258 |
259 | 259 |
260 .SH "DECODING/FILTERING OPTIONS" | 260 .SH "DECODING/FILTERING OPTIONS" |
261 .TP | 261 .TP |
262 .B \-ac <codec name> | 262 .B \-ac <codec name> |
268 \-ac ac3 use AC3 codec | 268 \-ac ac3 use AC3 codec |
269 \-ac hwac3 enable Hardware AC3 passthrough (see documentation) | 269 \-ac hwac3 enable Hardware AC3 passthrough (see documentation) |
270 \-ac vorbis use libvorbis | 270 \-ac vorbis use libvorbis |
271 \-ac ffmp3 use ffmpeg's MP3 decoder (SLOW) | 271 \-ac ffmp3 use ffmpeg's MP3 decoder (SLOW) |
272 | 272 |
273 See '\-ac help' for FULL list! | 273 See \-ac help for a full list of available codecs. |
274 .TP | 274 .TP |
275 .B \-afm <1\-12> (OBSOLETE) | 275 .B \-afm <1\-12> (OBSOLETE) |
276 Force usage of a specific audio format. For example: | 276 Force usage of a specific audio format family. For example: |
277 | 277 |
278 \-afm 1 use libmp3 (mp2/mp3, but not mp1) | 278 \-afm 1 use libmp3 (mp2/mp3, but not mp1) |
279 \-afm 2 suppose raw PCM audio | 279 \-afm 2 suppose raw PCM audio |
280 \-afm 3 use libac3 | 280 \-afm 3 use libac3 |
281 \-afm 4 use a matching Win32 codec | 281 \-afm 4 use a matching Win32 codec |
282 \-afm 5 use aLaw/uLaw driver | 282 \-afm 5 use aLaw/uLaw driver |
283 \-afm 10 use libvorbis | 283 \-afm 10 use libvorbis |
284 \-afm 11 use ffmpeg's MP3 decoder (even mp1) | 284 \-afm 11 use ffmpeg's MP3 decoder (even mp1) |
285 | 285 |
286 See \-ac help for FULL list! | 286 See \-afm help for a full list of available format families. |
287 .TP | 287 .TP |
288 .B \-aspect <ratio> | 288 .B \-aspect <ratio> |
289 Override aspect ratio of movies. It's autodetected on MPEG files, but can't be | 289 Override aspect ratio of movies. It's autodetected on MPEG files, but can't be |
290 autodetected on most AVI files. Examples: | 290 autodetected on most AVI files. Examples: |
291 | 291 |
292 \-aspect 4:3 or \-aspect 1.3333 | 292 \-aspect 4:3 or \-aspect 1.3333 |
293 \-aspect 16:9 or \-aspect 1.7777 | 293 \-aspect 16:9 or \-aspect 1.7777 |
294 .TP | 294 .TP |
295 .B \-flip | 295 .B \-flip |
296 Flip image upside-down | 296 Flip image upside-down. |
297 .TP | 297 .TP |
298 .B \-nosound | 298 .B \-nosound |
299 Don't play/encode sound | 299 Do not play/encode sound. |
300 .TP | 300 .TP |
301 .B \-npp <option1,option2,...> | 301 .B \-npp <option1,option2,...> |
302 This option allows to give more litterate options for postprocessing, | 302 This option allows giving more literate postprocessing options, |
303 and is another way of calling it (not with \-pp). | 303 and is another way of calling it (not with \-pp). |
304 .br | 304 .br |
305 NOTE: -npp only controls the external postprocess filter, and you HAVE TO | 305 NOTE: -npp only controls the external postprocess filter, and you HAVE TO |
306 load it manually by '-vop pp', it is not auto-loaded! | 306 load it manually by '-vop pp', it is not auto-loaded! |
307 .br | 307 .br |
308 So, the usage: -vop pp -npp <options> | 308 Usage: -vop pp -npp <options> |
309 | 309 |
310 .I EXAMPLE: | 310 .I EXAMPLE: |
311 '\-pp 0x2007f' <=> '\-npp hb,vb,dr,al,lb' | 311 '\-pp 0x2007f' <=> '\-npp hb,vb,dr,al,lb' |
312 '\-pp 0x7f' <=> '\-npp hb,vb,dr,al' | 312 '\-pp 0x7f' <=> '\-npp hb,vb,dr,al' |
313 | 313 |
314 You can get a list of options for \-npp by executing | 314 See \-npp help for a full list of available options. |
315 .I mplayer \-npp help | |
316 .br | 315 .br |
317 These keywords accept a '\-' prefix to disable the option. | 316 These keywords accept a '\-' prefix to disable the option. |
318 | 317 |
319 .I EXAMPLE: | 318 .I EXAMPLE: |
320 '\-npp de,\-al' means 'default filters without brightness/contrast correction' | 319 '\-npp de,\-al' means 'default filters without brightness/contrast correction' |
321 | 320 |
322 A ':' followed by a letter may be appended to the option to indicate its | 321 A ':' followed by a letter may be appended to the option to indicate its |
323 scope: | 322 scope: |
324 a : automatically switches the filter off if the cpu is too slow | 323 a : Automatically switches the filter off if the CPU is too slow. |
325 c : do chrominance filtering too | 324 c : Do chrominance filtering, too. |
326 y : do not do chrominance filtering (that is only luminance filtering) | 325 y : Do not do chrominance filtering (only luminance filtering). |
327 | 326 |
328 Each filter defaults to 'c' (chrominance). | 327 Each filter defaults to 'c' (chrominance). |
329 | 328 |
330 .I EXAMPLE: | 329 .I EXAMPLE: |
331 '\-npp de,tn:1:2:3' means 'enable default filters & temporal denoiser' | 330 '\-npp de,tn:1:2:3' means 'enable default filters & temporal denoiser' |
332 '\-npp hb:y,vb:a \-autoq 6' means 'deblock horizontal only luminance, and | 331 '\-npp hb:y,vb:a \-autoq 6' means 'deblock horizontal only luminance, and |
333 automatically switch vertical deblocking on/off depending on available | 332 automatically switch vertical deblocking on/off depending on available |
334 cpu time' | 333 CPU time' |
335 .TP | 334 .TP |
336 .B \-pp <quality> (see \-npp option too!) | 335 .B \-pp <quality> (see \-npp option too!) |
337 Apply postprocess filter on decoded image | 336 Apply postprocess filter on decoded image |
338 | 337 |
339 Value given by -pp is sent to the codec, if the codec has built-in postprocess | 338 Value given by -pp is sent to the codec, if the codec has built-in postprocess |
355 \-pp 0x7f <=> \-npp hb,vb,dr,al (deblocking filter - for DivX) | 354 \-pp 0x7f <=> \-npp hb,vb,dr,al (deblocking filter - for DivX) |
356 .TP | 355 .TP |
357 .B \-ssf <mode> (BETA CODE) | 356 .B \-ssf <mode> (BETA CODE) |
358 Specifies SwScaler parameters. Available options are: | 357 Specifies SwScaler parameters. Available options are: |
359 | 358 |
360 lgb=[0..100] gaussian blur filter (luma) | 359 lgb=[0..100] Gaussian blur filter (luma) |
361 cgb=[0..100] gaussian blur filter (chroma) | 360 cgb=[0..100] Gaussian blur filter (chroma) |
362 ls=[0..100] sharpen filter (luma) | 361 ls=[0..100] sharpen filter (luma) |
363 cs=[0..100] sharpen filter (chroma) | 362 cs=[0..100] sharpen filter (chroma) |
364 cvs=x chroma vertival shifting | 363 cvs=x chroma vertical shifting |
365 chs=x chroma horizontal shifting | 364 chs=x chroma horizontal shifting |
366 .TP | 365 .TP |
367 .B \-stereo <mode> | 366 .B \-stereo <mode> |
368 Select type of MP2/MP3 stereo output. | 367 Select type of MP2/MP3 stereo output. |
369 | 368 |
379 0 fast bilinear (default) | 378 0 fast bilinear (default) |
380 1 bilinear | 379 1 bilinear |
381 2 bicubic (best quality) | 380 2 bicubic (best quality) |
382 3 ? | 381 3 ? |
383 4 nearest neighbor (bad quality) | 382 4 nearest neighbor (bad quality) |
384 5 area averageing scaling support | 383 5 area averaging scaling support |
385 .TP | 384 .TP |
386 .B \-vc <codec name> | 385 .B \-vc <codec name> |
387 Force usage of a specific video codec, according to its name in codecs.conf, | 386 Force usage of a specific video codec, according to its name in codecs.conf, |
388 for example: | 387 for example: |
389 | 388 |
390 \-vc divx use VFW DivX codec | 389 \-vc divx use VFW DivX codec |
391 \-vc divxds use DirectShow DivX codec | 390 \-vc divxds use DirectShow DivX codec |
392 \-vc ffdivx use libavcodec's DivX codec | 391 \-vc ffdivx use libavcodec's DivX codec |
393 \-vc ffmpeg12 use libavcodec's MPEG1/2 codec | 392 \-vc ffmpeg12 use libavcodec's MPEG1/2 codec |
394 \-vc divx4 use ProjectMayo's DivX codec | 393 \-vc divx4 use Project Mayo's DivX codec |
395 | 394 |
396 See '\-vc help' for FULL list! | 395 See '\-vc help' for FULL list! |
397 .TP | 396 .TP |
398 .B \-vfm <1\-12> (OBSOLETE) | 397 .B \-vfm <1\-12> (OBSOLETE) |
399 Force usage of a specific codec FAMILY, and FALLBACK to default if failed. | 398 Force usage of a specific codec FAMILY, and FALLBACK to default if failed. |
517 .I NOTE: | 516 .I NOTE: |
518 Use \-slang to define the subtitle language by name. | 517 Use \-slang to define the subtitle language by name. |
519 .TP | 518 .TP |
520 .B \-slang <subtitle\ language> | 519 .B \-slang <subtitle\ language> |
521 See the \-sid option, but this one needs a two\-letter parameter, a country code. | 520 See the \-sid option, but this one needs a two\-letter parameter, a country code. |
522 Like: \-slang hu,en will always select hungarian or if it's non existant then | 521 Like: \-slang hu,en will always select Hungarian or if it is non existent then |
523 english subtitles, if there are any. For the list of available subtitles, use | 522 English subtitles, if there are any. For the list of available subtitles, use |
524 with the \-v switch and look at the output. | 523 with the \-v switch and look at the output. |
525 .TP | 524 .TP |
526 .B \-sub <subtitle\ file> | 525 .B \-sub <subtitle\ file> |
527 Use/display this subtitle file | 526 Use/display this subtitle file |
528 .TP | 527 .TP |
555 Tells MPlayer to handle the subtitle file as UNICODE. | 554 Tells MPlayer to handle the subtitle file as UNICODE. |
556 .TP | 555 .TP |
557 .B \-utf8 | 556 .B \-utf8 |
558 Tells MPlayer to handle the subtitle file as UTF8. | 557 Tells MPlayer to handle the subtitle file as UTF8. |
559 .TP | 558 .TP |
560 .B \-vobsub <vobsub\ file\ without\ extention> | 559 .B \-vobsub <vobsub\ file\ without\ extension> |
561 Specify the VobSub files that are to be used for subtitle. This is | 560 Specify the VobSub files that are to be used for subtitle. This is |
562 the full pathname without extensions, i.e. without the ".idx", ".ifo" | 561 the full pathname without extensions, i.e. without the ".idx", ".ifo" |
563 or ".sub". | 562 or ".sub". |
564 .TP | 563 .TP |
565 .B \-vobsubid <vobsub\ subtitle\ id> | 564 .B \-vobsubid <vobsub\ subtitle\ id> |
570 .TP | 569 .TP |
571 .B \-abs <value> (OBSOLETE) | 570 .B \-abs <value> (OBSOLETE) |
572 Override audio driver/card buffer size detection, -ao oss only | 571 Override audio driver/card buffer size detection, -ao oss only |
573 .TP | 572 .TP |
574 .B \-ao <driver>[:<device>] | 573 .B \-ao <driver>[:<device>] |
575 Select audio output driver and optionaly device. "device" is valid with | 574 Select audio output driver and optionally device. "device" is valid with |
576 SDL too, it means sub\-driver then (for example: \-vo sdl:esd). | 575 SDL too, it means sub\-driver then (for example: \-vo sdl:esd). |
577 If using OSS, you can specify which sound device to use like this: | 576 If using OSS, you can specify which sound device to use like this: |
578 | 577 |
579 \-ao oss:/dev/dsp1 (replaces the old \-dsp option) | 578 \-ao oss:/dev/dsp1 (replaces the old \-dsp option) |
580 | 579 |
602 | 601 |
603 Stereo 2 | 602 Stereo 2 |
604 Surround 4 | 603 Surround 4 |
605 Full 5.1 6 | 604 Full 5.1 6 |
606 | 605 |
607 Currently this option is only honoured for AC3 audio, and/or the surround plugin. | 606 Currently this option is only honored for AC3 audio, and/or the surround plugin. |
608 .TP | 607 .TP |
609 .B \-delay <secs> | 608 .B \-delay <secs> |
610 Audio delay in seconds (may be +/\- float value) | 609 Audio delay in seconds (may be +/\- float value) |
611 .TP | 610 .TP |
612 .B \-mixer <device> | 611 .B \-mixer <device> |
648 .TP | 647 .TP |
649 .B \-dr | 648 .B \-dr |
650 Turns on direct rendering (not supported by all codecs and video outputs) | 649 Turns on direct rendering (not supported by all codecs and video outputs) |
651 (default is off). | 650 (default is off). |
652 .TP | 651 .TP |
653 .B \-fb <device> (FBdev or DirectFB only) | 652 .B \-fb <device> (fbdev or DirectFB only) |
654 Specifies the framebuffer device to use. By default it uses /dev/fb0. | 653 Specifies the framebuffer device to use. By default it uses /dev/fb0. |
655 .TP | 654 .TP |
656 .B \-fbmode <modename> (FBdev only) | 655 .B \-fbmode <modename> (fbdev only) |
657 Change videomode to the one that is labelled as <modename> in /etc/fb.modes. | 656 Change video mode to the one that is labelled as <modename> in /etc/fb.modes. |
658 .br | 657 .br |
659 .I NOTE: | 658 .I NOTE: |
660 VESA framebuffer doesn't support mode changing. | 659 VESA framebuffer doesn't support mode changing. |
661 .TP | 660 .TP |
662 .B \-fbmodeconfig <filename> (FBdev only) | 661 .B \-fbmodeconfig <filename> (fbdev only) |
663 Use this config file instead of the default /etc/fb.modes. | 662 Use this config file instead of the default /etc/fb.modes. |
664 Only valid for the fbdev driver. | 663 Only valid for the fbdev driver. |
665 .TP | 664 .TP |
666 .B \-forcexv (SDL only) | 665 .B \-forcexv (SDL only) |
667 Force using XVideo | 666 Force using XVideo |
690 OnTop 6 | 689 OnTop 6 |
691 Dock 8 | 690 Dock 8 |
692 AboveDock 10 | 691 AboveDock 10 |
693 Menu 12 | 692 Menu 12 |
694 | 693 |
695 Defautl is layer Menu (12). | 694 Default is layer Menu (12). |
696 .TP | 695 .TP |
697 .B \-jpeg <sub\-options> | 696 .B \-jpeg <sub\-options> |
698 Specify options for the JPEG output (-vo jpeg), separated by ":" (see documentation!). | 697 Specify options for the JPEG output (-vo jpeg), separated by ":" (see documentation!). |
699 Available sub\-options are [no]progressiv, [no]baseline, | 698 Available sub\-options are [no]progressiv, [no]baseline, |
700 optimize, smooth, quality and outdir. | 699 optimize, smooth, quality and outdir. |
701 .TP | 700 .TP |
702 .B \-monitor_dotclock <dotclock\ (or\ pixelclock) range> (FBdev only) | 701 .B \-monitor_dotclock <dotclock\ (or\ pixelclock) range> (fbdev only) |
703 Look into etc/example.conf for further information and in DOCS/video.html. | 702 Look into etc/example.conf for further information and in DOCS/video.html. |
704 .TP | 703 .TP |
705 .B \-monitor_hfreq <horizontal frequency range> (FBdev only) | 704 .B \-monitor_hfreq <horizontal frequency range> (fbdev only) |
706 .TP | 705 .TP |
707 .B \-monitor_vfreq <vertical frequency range> (FBdev only) | 706 .B \-monitor_vfreq <vertical frequency range> (fbdev only) |
708 .TP | 707 .TP |
709 .B \-monitoraspect <ratio> | 708 .B \-monitoraspect <ratio> |
710 Set aspect ratio of your screen. Examples: | 709 Set aspect ratio of your screen. Examples: |
711 | 710 |
712 \-monitoraspect 4:3 or 1.3333 | 711 \-monitoraspect 4:3 or 1.3333 |
745 .B \-vm | 744 .B \-vm |
746 Try to change to a better video mode. dga, x11/xv (XF86VidMode) and sdl | 745 Try to change to a better video mode. dga, x11/xv (XF86VidMode) and sdl |
747 output drivers support it. | 746 output drivers support it. |
748 .TP | 747 .TP |
749 .B \-vo <driver>[:<device>] | 748 .B \-vo <driver>[:<device>] |
750 Select video output driver and optinally device. "device" is valid with | 749 Select video output driver and optionally device. "device" is valid with |
751 SDL and GGI too, it means sub\-driver then (for example: \-vo sdl:aalib). | 750 SDL and GGI too, it means sub\-driver then (for example: \-vo sdl:aalib). |
752 | 751 |
753 You can get the list of available drivers executing | 752 You can get the list of available drivers executing |
754 .I mplayer \-vo help | 753 .I mplayer \-vo help |
755 .TP | 754 .TP |
777 .SH "PLAYER OPTIONS (MPLAYER ONLY)" | 776 .SH "PLAYER OPTIONS (MPLAYER ONLY)" |
778 .TP | 777 .TP |
779 .B \-autoq <quality> (use with -vop pp!) | 778 .B \-autoq <quality> (use with -vop pp!) |
780 Dynamically changes the level of postprocess, depending on spare CPU time | 779 Dynamically changes the level of postprocess, depending on spare CPU time |
781 available. The number you specify will be the maximum level used. Usually you | 780 available. The number you specify will be the maximum level used. Usually you |
782 can use some big number. You may not use together with \-pp but it's ok with | 781 can use some big number. You may not use it together with \-pp but it is OK with |
783 \-npp! | 782 \-npp! |
784 .TP | 783 .TP |
785 .B \-benchmark | 784 .B \-benchmark |
786 Prints some statistics on CPU usage and dropped frames at the end. | 785 Prints some statistics on CPU usage and dropped frames at the end. |
787 Used in combination with \-nosound and \-vo null for benchmarking only video codec. | 786 Used in combination with \-nosound and \-vo null for benchmarking only video codec. |
797 .TP | 796 .TP |
798 .B \-h, \-\-help | 797 .B \-h, \-\-help |
799 Show short summary of options | 798 Show short summary of options |
800 .TP | 799 .TP |
801 .B \-hardframedrop | 800 .B \-hardframedrop |
802 More intense frame dropping (breaks decoding). Leads to image disortion! | 801 More intense frame dropping (breaks decoding). Leads to image distortion! |
803 .TP | 802 .TP |
804 .B \-input <commands> | 803 .B \-input <commands> |
805 This option can be used to configure certain parts of the input system. | 804 This option can be used to configure certain parts of the input system. |
806 Relative path are relative to $HOME/.mplayer. | 805 Relative path are relative to $HOME/.mplayer. |
807 | 806 |
809 If given without pathname, | 808 If given without pathname, |
810 $HOME/.mplayer is assumed. | 809 $HOME/.mplayer is assumed. |
811 ar\-delay delay in msec before we start | 810 ar\-delay delay in msec before we start |
812 to autorepeat a key | 811 to autorepeat a key |
813 (0 to disable) | 812 (0 to disable) |
814 ar\-rate how many keypress/second when | 813 ar\-rate how many key presses/second when |
815 we autorepeat | 814 we autorepeat |
816 keylist prints all keys that can be | 815 keylist prints all keys that can be |
817 bound to | 816 bound to |
818 cmdlist prints all commands that can | 817 cmdlist prints all commands that can |
819 be bound | 818 be bound |
838 .TP | 837 .TP |
839 .B \-nortc | 838 .B \-nortc |
840 Turns off usage of /dev/rtc (real-time clock) | 839 Turns off usage of /dev/rtc (real-time clock) |
841 .TP | 840 .TP |
842 .B \-playlist <file> | 841 .B \-playlist <file> |
843 Play files according to this filelist (1 file/row or Winamp or ASX format). | 842 Play files according to this file list (1 file/row or Winamp or asx format). |
844 .TP | 843 .TP |
845 .B \-quiet | 844 .B \-quiet |
846 Display less output, status messages. | 845 Display less output, status messages. |
847 .TP | 846 .TP |
848 .B \-skin <skin\ directory> (BETA CODE) | 847 .B \-skin <skin\ directory> (BETA CODE) |
902 .B \-endpos <time|byte\ position> | 901 .B \-endpos <time|byte\ position> |
903 Stop encoding at given time or byte position. Can be specified in many ways : | 902 Stop encoding at given time or byte position. Can be specified in many ways : |
904 | 903 |
905 -endpos 56 encode only 56 seconds | 904 -endpos 56 encode only 56 seconds |
906 -endpos 01:10:00 encode only 1 hours | 905 -endpos 01:10:00 encode only 1 hours |
907 -endpos 100mb encode only 100 mbytes | 906 -endpos 100mb encode only 100 MBytes |
908 | 907 |
909 Can be used in conjuction with -ss or -sb! | 908 Can be used in conjunction with -ss or -sb! |
910 .br | 909 .br |
911 .I NOTE: | 910 .I NOTE: |
912 Byte position won't be accurate, as it can only stop at | 911 Byte position won't be accurate, as it can only stop at |
913 a frame boundary. | 912 a frame boundary. |
914 .TP | 913 .TP |
1071 disabled) | 1070 disabled) |
1072 | 1071 |
1073 vb_strategy=<value> | 1072 vb_strategy=<value> |
1074 strategy to choose between | 1073 strategy to choose between |
1075 I/P/B frames : | 1074 I/P/B frames : |
1076 0 allways use max B | 1075 0 always use max B |
1077 1 avoid B frames in high | 1076 1 avoid B frames in high |
1078 motion / scene change (can | 1077 motion / scene change (can |
1079 lead to filesize miss | 1078 lead to filesize miss |
1080 prediction) | 1079 prediction) |
1081 default = 0 | 1080 default = 0 |
1157 or remote control (using lirc). | 1156 or remote control (using lirc). |
1158 .B See documentation! | 1157 .B See documentation! |
1159 .br | 1158 .br |
1160 .I NOTE: | 1159 .I NOTE: |
1161 The default config file for the input system is | 1160 The default config file for the input system is |
1162 $HOME/.mplayer/input.conf but it can be overrided | 1161 $HOME/.mplayer/input.conf but it can be overriden |
1163 using the -input conf option. | 1162 using the -input conf option. |
1164 .br | 1163 .br |
1165 .I NOTE: | 1164 .I NOTE: |
1166 These keys may/may not work, depending on your video output driver. | 1165 These keys may/may not work, depending on your video output driver. |
1167 .TP | 1166 .TP |
1258 Type 0 is a relative seek of +/- | 1257 Type 0 is a relative seek of +/- |
1259 <value> seconds. Type 1 seek to | 1258 <value> seconds. Type 1 seek to |
1260 <value> % in the movie. | 1259 <value> % in the movie. |
1261 | 1260 |
1262 audio_delay <value> | 1261 audio_delay <value> |
1263 Adjust the audio delay of val seconds | 1262 Adjust the audio delay of value seconds |
1264 | 1263 |
1265 quit Quit MPlayer | 1264 quit Quit MPlayer |
1266 | 1265 |
1267 pause Pause/unpause the playback | 1266 pause Pause/unpause the playback |
1268 | 1267 |
1269 grap_frames Somebody know ? | 1268 grap_frames Somebody know ? |
1270 | 1269 |
1271 pt_step <value> [force=<value>] | 1270 pt_step <value> [force=<value>] |
1272 Go to next/prev entry in playtree. | 1271 Go to next/previous entry in the playtree. |
1273 | 1272 |
1274 pt_up_step <value> [force=<value>] | 1273 pt_up_step <value> [force=<value>] |
1275 Like pt_step but it jump to next/prev | 1274 Like pt_step but it jumps to next/previous |
1276 in the parent list. | 1275 in the parent list. |
1277 | 1276 |
1278 alt_src_step <value> | 1277 alt_src_step <value> |
1279 When more than one source is available | 1278 When more than one source is available |
1280 it select the next/previous one (only | 1279 it select the next/previous one (only |
1296 brightness <value> [abs=<value>] | 1295 brightness <value> [abs=<value>] |
1297 .br | 1296 .br |
1298 hue <value> [abs=<value>] | 1297 hue <value> [abs=<value>] |
1299 .br | 1298 .br |
1300 saturation <value> [abs=<value>] | 1299 saturation <value> [abs=<value>] |
1301 Set/Adjust video paramters. | 1300 Set/Adjust video parameters. |
1302 <value> range from -100 to 100. | 1301 <value> range from -100 to 100. |
1303 | 1302 |
1304 frame_drop [type=<value>] | 1303 frame_drop [type=<value>] |
1305 Toggle/Set frame dropping mode. | 1304 Toggle/Set frame dropping mode. |
1306 | 1305 |
1409 | 1408 |
1410 .SH "BUGS" | 1409 .SH "BUGS" |
1411 Probably. PLEASE, double-check the documentation (especially bugreports.html), | 1410 Probably. PLEASE, double-check the documentation (especially bugreports.html), |
1412 the FAQ and the mail archive before! | 1411 the FAQ and the mail archive before! |
1413 | 1412 |
1414 Send your complete bugreports to the MPlayer-users mailing list at | 1413 Send your complete bug reports to the MPlayer-users mailing list at |
1415 <mplayer-users@mplayerhq.hu>. We love complete bugreports :) | 1414 <mplayer-users@mplayerhq.hu>. We love complete bug reports :) |
1416 | 1415 |
1417 | 1416 |
1418 .SH "AUTHORS" | 1417 .SH "AUTHORS" |
1419 Check documentation! | 1418 Check documentation! |
1420 | 1419 |
1421 MPlayer is (C) 2000\-2002 | 1420 MPlayer is (C) 2000\-2002 |
1422 .I Arpad Gereoffy <sendmail@to.mplayer\-users> | 1421 .I Arpad Gereoffy <sendmail@to.mplayer\-users> |
1423 | 1422 |
1424 This manpage is written and maintained by | 1423 This man page is written and maintained by |
1425 .I Gabucino <sendmail@to.mplayer\-users>. | 1424 .I Gabucino <sendmail@to.mplayer\-users>. |
1426 | 1425 |
1427 (Patches done by | 1426 (Patches done by |
1428 .I Jonas Jermann <sendmail@to.mplayer\-users> | 1427 .I Jonas Jermann <sendmail@to.mplayer\-users> |
1429 ) | 1428 ) |