Mercurial > mplayer.hg
comparison DOCS/mplayer.1 @ 5992:b70736ca6f0c
various fixes
author | arpi |
---|---|
date | Sun, 05 May 2002 23:11:28 +0000 |
parents | de86623c35ef |
children | 0292c6b7cfc4 |
comparison
equal
deleted
inserted
replaced
5991:ddfae38afc28 | 5992:b70736ca6f0c |
---|---|
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 manpage 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-04" | 5 .TH "MPlayer" "1" "2002-05-05" |
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 |
21 .br | 21 .br |
22 .B mplayer | 22 .B mplayer |
23 .RB [dvd|vcd|tv]://[title]\ [options] | 23 .RB [dvd|vcd|tv]://[title]\ [options] |
24 .br | 24 .br |
25 .B mplayer | 25 .B mplayer |
26 .RB [mms|http|http_proxy|ftp]://URL[:port]\ [options] | 26 .RB [mms|http|http_proxy|rtp]://URL[:port]\ [options] |
27 .br | 27 .br |
28 .B mencoder | 28 .B mencoder |
29 .RB [options]\ [\fIfile\fP\ |\ \fIURL\fP\ |\ \fIplaylist\fP\ |\ \-\ ]\ [\-o\ file] | 29 .RB [options]\ [\fIfile\fP\ |\ \fIURL\fP\ |\ \-\ ]\ [\-o\ file] |
30 .br | 30 .br |
31 .B gmplayer | 31 .B gmplayer |
32 .RB [options]\ [\-skin\ skin] | 32 .RB [options]\ [\-skin\ skin] |
33 | 33 |
34 .SH "DESCRIPTION" | 34 .SH "DESCRIPTION" |
77 .br | 77 .br |
78 .I NOTE: | 78 .I NOTE: |
79 Use \-alang to define the language by name. | 79 Use \-alang to define the language by name. |
80 .TP | 80 .TP |
81 .B \-alang <audio\ stream\ language> | 81 .B \-alang <audio\ stream\ language> |
82 Used 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 |
83 parameter, and always tries to play back audio streams those language | 83 parameter, and always tries to play back audio streams those language |
84 matches the given code. For example: \-alang hu,en will always try to play | 84 matches the given code. For example: \-alang hu,en will always try to play |
85 hungarian or if it's non\-existant then english audio streams if there are any. | 85 hungarian or if it's non\-existant then english audio streams if there are any. |
86 .TP | 86 .TP |
87 .B \-audio\-demuxer <number> | 87 .B \-audio\-demuxer <number> |
88 Force audio demuxer type for \-audiofile. | 88 Force audio demuxer type for \-audiofile. |
89 Give the demuxer ID as defined in demuxers.h. | 89 Give the demuxer ID as defined in demuxers.h. |
90 You can 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 Vorbis) | 93 Play audio from an external file (WAV, MP3 or OggVorbis) |
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 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 |
101 .B \-chapter <chapter\ id>[-<end chapter id>] | 102 .B \-chapter <chapter\ id>[-<end chapter id>] |
102 Specify which chapter to start playing at. Optionally specify which chapter to | 103 Specify which chapter to start playing at. Optionally specify which chapter to |
103 end playing at. Examples can be found below. | 104 end playing at. Examples can be found below. |
110 .TP | 111 .TP |
111 .B \-dumpaudio (MPLAYER only) | 112 .B \-dumpaudio (MPLAYER only) |
112 Dumps raw compressed audio stream to ./stream.dump (usefull with mpeg/ac3) | 113 Dumps raw compressed audio stream to ./stream.dump (usefull with mpeg/ac3) |
113 .TP | 114 .TP |
114 .B \-dumpfile <filename> (MPLAYER only) | 115 .B \-dumpfile <filename> (MPLAYER only) |
115 Specify to which file MPlayer should dump to. Should be used together | 116 Specify which file MPlayer should dump to. Should be used together |
116 with \-dumpaudio/\-dumpvideo/\-dumpstream. | 117 with \-dumpaudio/\-dumpvideo/\-dumpstream. |
117 .TP | 118 .TP |
118 .B \-dumpstream (MPLAYER only) | 119 .B \-dumpstream (MPLAYER only) |
119 Dumps the raw steram to ./stream.dump . Useful for example | 120 Dumps the raw stream to ./stream.dump . Useful for example |
120 when ripping from DVD or network. | 121 when ripping from DVD or network. |
121 .TP | 122 .TP |
122 .B \-dumpsub (MPLAYER only) | 123 .B \-dumpsub (MPLAYER only) |
123 Dumps the subtitle substream from VOB streams. | 124 Dumps the subtitle substream from VOB streams. |
124 .TP | 125 .TP |
151 Force rebuilding of INDEX. Useful for files with broken index (desyncs, etc). | 152 Force rebuilding of INDEX. Useful for files with broken index (desyncs, etc). |
152 Seeking will be possible. You can fix the index permanently with | 153 Seeking will be possible. You can fix the index permanently with |
153 MEncoder (see the documentation). | 154 MEncoder (see the documentation). |
154 .TP | 155 .TP |
155 .B \-fps <value> | 156 .B \-fps <value> |
156 Force frame rate (if value is wrong in the header) (float number) | 157 Override video frame rate (if value is wrong/missing in the header) (float number) |
157 .TP | 158 .TP |
158 .B \-frames <number> | 159 .B \-frames <number> |
159 MPlayer plays <number> frames, then quits. | 160 Play/convert only first <number> frames, then quit. |
160 .TP | 161 .TP |
161 .B \-hr\-mp3\-seek | 162 .B \-hr\-mp3\-seek (.MP3 only) |
162 Hi\-res mp3 seeking. Default is: enabled when playing from external MP3 file, | 163 Hi\-res mp3 seeking. Default is: enabled when playing from external MP3 file, |
163 as we need to seek to the very exact position to keep A/V sync. It can be slow | 164 as we need to seek to the very exact position to keep A/V sync. It can be slow |
164 especially when seeking backwards \- it has to rewind to the beginning to find | 165 especially when seeking backwards \- it has to rewind to the beginning to find |
165 the exact frame. | 166 the exact frame. |
166 .TP | 167 .TP |
180 w=<value> width of the output (autodetect) | 181 w=<value> width of the output (autodetect) |
181 h=<value> height of the output (autodetect) | 182 h=<value> height of the output (autodetect) |
182 fps=<value> fps of the output (default: 25) | 183 fps=<value> fps of the output (default: 25) |
183 type=<value> type of input files (available types : jpeg, png) | 184 type=<value> type of input files (available types : jpeg, png) |
184 .TP | 185 .TP |
185 .B \-ni | 186 .B \-ni (.AVI only) |
186 Force usage of non\-interleaved AVI parser (fixes playing | 187 Force usage of non\-interleaved AVI parser (fixes playing |
187 of some bad AVI files). | 188 of some bad AVI files). |
188 .TP | 189 .TP |
189 .B \-nobps | 190 .B \-nobps (.AVI only) |
190 Don't use avg. byte/sec value for A\-V sync (AVI). | 191 Don't use avg. byte/sec value for A\-V sync (AVI). |
191 Helps with some AVI files with broken header. | 192 Helps with some AVI files with broken header. |
192 .TP | 193 .TP |
193 .B \-skipopening | 194 .B \-skipopening |
194 Skip dvd opening (dvdnav only). | 195 Skip dvd opening (dvdnav only). |
275 Don't play/encode sound | 276 Don't play/encode sound |
276 .TP | 277 .TP |
277 .B \-npp <option1,option2,...> | 278 .B \-npp <option1,option2,...> |
278 This option allows to give more litterate options for postprocessing, | 279 This option allows to give more litterate options for postprocessing, |
279 and is another way of calling it (not with \-pp). | 280 and is another way of calling it (not with \-pp). |
281 .br | |
282 NOTE: -npp only controls the external postprocess filter, and you HAVE TO | |
283 load it manually by '-vop pp', it is not auto-loaded! | |
284 .br | |
285 So, the usage: -vop pp -npp <options> | |
280 | 286 |
281 .I EXAMPLE: | 287 .I EXAMPLE: |
282 '\-pp 0x2007f' <=> '\-npp hb,vb,dr,al,lb' | 288 '\-pp 0x2007f' <=> '\-npp hb,vb,dr,al,lb' |
283 '\-pp 0x7f' <=> '\-npp hb,vb,dr,al' | 289 '\-pp 0x7f' <=> '\-npp hb,vb,dr,al' |
284 | 290 |
307 .B \-pp <quality> (see \-npp option too!) | 313 .B \-pp <quality> (see \-npp option too!) |
308 Apply postprocess filter on decoded image | 314 Apply postprocess filter on decoded image |
309 | 315 |
310 Value given by -pp is sent to the codec, if the codec has built-in postprocess | 316 Value given by -pp is sent to the codec, if the codec has built-in postprocess |
311 filter (newer win32 DShow DLLs, divx4linux) otherwise the external postprocess | 317 filter (newer win32 DShow DLLs, divx4linux) otherwise the external postprocess |
312 filter plugin (-vop pp) is auto-loaded and used. Note, that -npp only works | 318 filter plugin (-vop pp) is auto-loaded and used. |
313 with external pp. Also note, that you can use the built-in and external pp at the | 319 Note, that you can use the built-in and external pp at the |
314 same time, use -pp to set internal pp, and -vop pp=value to set up the external! | 320 same time, use -pp to set internal pp, and -vop pp=value to set up the external! |
315 | 321 |
316 The valid range of -pp value for built-in pp filters vary on codecs, mostly | 322 The valid range of -pp value for built-in pp filters vary on codecs, mostly |
317 0-6, where 0=disable 6=slowest/best. | 323 0-6, where 0=disable 6=slowest/best. |
318 | 324 |
319 For the external pp filter, this is the numerical mode to use postprocessing. The '\-npp' option described | 325 For the external pp filter, this is the numerical mode to use postprocessing. The '\-npp' option described |
320 below has the same effects but with letters. To have several filters at the | 326 above has the same effects but with letters. To have several filters at the |
321 same time, simply add the hexadecimal values. | 327 same time, simply add the hexadecimal values. |
322 | 328 |
323 .I EXAMPLE: | 329 .I EXAMPLE: |
324 The following values are known to give good results: | 330 The following values are known to give good results: |
325 \-pp 0x20000 <=> \-npp lb (deinterlacing \- for DVD/MPEG2 playback e.g.) | 331 \-pp 0x20000 <=> \-npp lb (deinterlacing \- for DVD/MPEG2 playback e.g.) |
326 \-pp 0x7f <=> \-npp hb,vb,dr,al (smooth the images) | 332 \-pp 0x7f <=> \-npp hb,vb,dr,al (deblocking filter - for DivX) |
327 .TP | 333 .TP |
328 .B \-ssf <mode> (BETA CODE) | 334 .B \-ssf <mode> (BETA CODE) |
329 Specifies SwScaler parameters. Available options are: | 335 Specifies SwScaler parameters. Available options are: |
330 | 336 |
331 lgb=[0..100] gaussian blur filter (luma) | 337 lgb=[0..100] gaussian blur filter (luma) |
385 If libdivxdecore support was compiled in, then type 3 and 7 now contains | 391 If libdivxdecore support was compiled in, then type 3 and 7 now contains |
386 just the same DivX4 codec, but different APIs to reach it. For difference | 392 just the same DivX4 codec, but different APIs to reach it. For difference |
387 between them and when to use which, check the DivX4 section in the | 393 between them and when to use which, check the DivX4 section in the |
388 documentation. | 394 documentation. |
389 .TP | 395 .TP |
390 .B \-vop <plugin3, plugin2, plugin1, ...> | 396 .B \-vop <plugin3[=options], plugin2, plugin1, ...> |
391 Activate coma separated list of video filters (see documentation!). | 397 Activate coma separated list of video filters (see documentation!). |
392 Available plugins are: | 398 Available plugins are: |
393 | 399 |
394 crop[=w:h:x:y] simple cropping plugin | 400 crop[=w:h:x:y] cropping |
395 expand[=w:h:x:y:o] expanding and (optional) OSD rendering plugin | 401 expand[=w:h:x:y:o] expanding and OSD |
396 flip flips image upside-down | 402 flip flips upside-down |
397 mirror horizontal mirroring | 403 mirror horizontal mirroring |
398 rotate[=x] rotate image +/\- 90 degrees | 404 rotate[=direction] rotate image |
399 scale[=w:h] software scaling (zoom) and yuv<\->rgb colorspace conversion | 405 scale[=w:h] software scaling |
400 yuy2 forced software YV12/I420 \-> YUY2 conversion | 406 yuy2 YV12/I420 \-> YUY2 |
401 rgb2bgr[=swap] RGB 24/32 <\-> BGR 24/32 colorspace conversion (default) | 407 rgb2bgr[=swap] RGB 24/32 <\-> BGR 24/32 |
402 optional with R<\->B swapping | 408 palette RGB/BGR 8 \-> 15/16/24/32 bpp |
403 palette RGB/BGR 8 \-> RGB/BGR 15/16/24/32 colorspace conversion using palette | 409 format[=fourcc] restrict colorspace |
404 format[=fourcc] restrict the list of supported colorspaces to a single fourcc | 410 pp[=flags] postprocessing (see \-pp) |
405 (default 'yuy2', may be rgb12, bgr24, yv12 etc...) | 411 lavc YV12\->MPEG1 (libavcodec) |
406 pp[=flags] postprocessing filter (see \-pp option) | 412 fame YV12\->MPEG1 (libfame) |
407 lavc fast software YV12\->MPEG1 conversion using libavcodec | 413 |
408 fame fast software YV12\->MPEG1 conversion using libfame | 414 .I parameters: |
415 .br | |
416 w,h destination width/height | |
417 value : w/h = value | |
418 0 and \-1: w/h = original (default) | |
419 \-value : w/h = original+value | |
420 x,y x/y position of the sub-image | |
421 value : x/y = value | |
422 \-1 : x/y = center image (default) | |
423 o en/disable OSD/SUB rendering | |
424 0 : disabled (default) | |
425 1 : enabled | |
426 | |
409 .TP | 427 .TP |
410 .B \-x <x> (MPLAYER only) | 428 .B \-x <x> (MPLAYER only) |
411 Scale image to x width (if sw/hw scaling available). Disables aspect calcs. | 429 Scale image to x width (if sw/hw scaling available). Disables aspect calcs. |
412 .TP | 430 .TP |
413 .B \-xy <x> (MPLAYER only) | 431 .B \-xy <x> |
414 x<=8 Scale image by factor <x> | 432 x<=8 Scale image by factor <x> |
415 x>8 Set width to <x> and calculate height to keep correct aspect ratio | 433 x>8 Set width to <x> and calculate height to keep correct aspect ratio |
416 .TP | 434 .TP |
417 .B \-y <y> | 435 .B \-y <y> (MPLAYER only) |
418 Scale image to y height (if sw/hw scaling available). Disables aspect calcs. | 436 Scale image to y height (if sw/hw scaling available). Disables aspect calcs. |
419 .TP | 437 .TP |
420 .B \-zoom | 438 .B \-zoom |
421 Allow software scaling, where available. Could be used to force scaling with -vop scale | 439 Allow software scaling, where available. Could be used to force scaling with -vop scale |
422 (-vop scale will IGNORE options -x/-y/-xy/-fs/-aspect without -zoom) | 440 (-vop scale will IGNORE options -x/-y/-xy/-fs/-aspect without -zoom) |
515 .TP | 533 .TP |
516 .B \-abs <value> [OBSOLETE] | 534 .B \-abs <value> [OBSOLETE] |
517 Override audio driver/card buffer size detection, -ao oss only | 535 Override audio driver/card buffer size detection, -ao oss only |
518 .TP | 536 .TP |
519 .B \-ao <driver>[:<device>] | 537 .B \-ao <driver>[:<device>] |
520 Select audio output driver and optinaly device. "device" is valid with | 538 Select audio output driver and optionaly device. "device" is valid with |
521 SDL too, it means sub\-driver then (for example: \-vo sdl:esd). | 539 SDL too, it means sub\-driver then (for example: \-vo sdl:esd). |
522 If using OSS, you can specify which sound device to use like this: | 540 If using OSS, you can specify which sound device to use like this: |
523 | 541 |
524 \-ao oss:/dev/dsp1 (replaces the old \-dsp option) | 542 \-ao oss:/dev/dsp1 (replaces the old \-dsp option) |
525 | 543 |
820 key=<value> maximum keyframe interval | 838 key=<value> maximum keyframe interval |
821 (in frames) | 839 (in frames) |
822 deinterlace enable deinterlacing | 840 deinterlace enable deinterlacing |
823 (don't use, DivX4 is buggy!) | 841 (don't use, DivX4 is buggy!) |
824 q=<1\-5> quality (1\-fastest, 5\-best) | 842 q=<1\-5> quality (1\-fastest, 5\-best) |
825 min_quant=<0\-32> minimum quantizer | 843 min_quant=<1\-31> minimum quantizer |
826 max_quant=<0\-32> maximum quantizer | 844 max_quant=<1\-31> maximum quantizer |
827 rc_period=<value> rate control period | 845 rc_period=<value> rate control period |
828 rc_reaction_period=<value> | 846 rc_reaction_period=<value> |
829 rate control reaction period | 847 rate control reaction period |
830 rc_reaction_ratio=<value> | 848 rc_reaction_ratio=<value> |
831 rate control reaction ratio | 849 rate control reaction ratio |
952 1.0 : average all past | 970 1.0 : average all past |
953 quantizers | 971 quantizers |
954 default = 0.5 | 972 default = 0.5 |
955 | 973 |
956 vqscale=<2\-31> gives each frame the same | 974 vqscale=<2\-31> gives each frame the same |
957 quantizer (selects fixed quantizer | 975 quantizer (selects fixed |
958 mode). | 976 quantizer mode). |
959 default = 0 (fixed quantizer mode | 977 default = 0 (fixed quantizer |
960 disabled) | 978 mode disabled) |
961 | 979 |
962 vrc_strategy=<0\-2> | 980 vrc_strategy=<0\-2> |
963 different strategies to | 981 different strategies to |
964 decide which frames should get | 982 decide which frames should get |
965 which quantizer. | 983 which quantizer. |
1319 .TP | 1337 .TP |
1320 .B Encoding multiple *.vob files | 1338 .B Encoding multiple *.vob files |
1321 cat *.vob | mencoder <options> - | 1339 cat *.vob | mencoder <options> - |
1322 | 1340 |
1323 | 1341 |
1324 ".SH "BUGS" | 1342 .SH "BUGS" |
1325 Probably. PLEASE, double-check the documentation (especially bugreports.html), | 1343 Probably. PLEASE, double-check the documentation (especially bugreports.html), |
1326 the FAQ and the mail archive before! | 1344 the FAQ and the mail archive before! |
1327 | 1345 |
1328 Send your complete bugreports to the MPlayer-users mailing list at | 1346 Send your complete bugreports to the MPlayer-users mailing list at |
1329 <mplayer-users@mplayerhq.hu>. We love complete bugreports :) | 1347 <mplayer-users@mplayerhq.hu>. We love complete bugreports :) |