[MPlayer-dev-eng] mplayer.1 (big) update
pl
p_l at tfz.net
Thu Dec 27 03:17:12 CET 2001
Hi,
Here is a big update of DOC/mplayer.1.
All options not obsoleted are in it - of course I may have missed some...
The options I don't know/use/(feel like writing doc now :) contain a
'TODO' appended so it will be easier to know what's left to document.
Gabucino, please check & apply.
Michael can you check the -pp and -npp flags as I'm not 100% sure
they're accurate (caffein is currently quite low in my reality 8)
Changelog:
+ added GUI section
+ added DVD section
+ added missing options
+ added doc for -wid -pp -npp (thx to arpi & michael)
+ several other changes
--
Best regards,
pl
-------------- next part --------------
Index: mplayer.1
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/mplayer.1,v
retrieving revision 1.117
diff -u -r1.117 mplayer.1
--- mplayer.1 24 Dec 2001 23:00:06 -0000 1.117
+++ mplayer.1 27 Dec 2001 02:08:13 -0000
@@ -1,137 +1,208 @@
.\" MPlayer (C) 2000-2001 Arpad Gereoffy <arpi at esp-team.scene.hu>
.\" This manpage was/is done by Gabucino
+.\" Updates by pl
.\"
.TH MPlayer
.SH NAME
mplayer \- Movie Player for Linux
.SH SYNOPSIS
+
+.I NOTE:
+.RB -opt !
+indicates -noopt exists (for instance: -gui and -nogui)
+
+.I NOTE:
+.RB TODO
+indicates a lack of documentation 8)
+
.B mplayer
-.RB [ \-gui ]
-.RB [ \-v ]
+.RB [ \-gui !]
+.RB [ \-skin\ <skin> ]
+.RB [ \-v\ |\ -verbose ]
+.RB [ \-help\ |\ \-h |\ \--help ]
.RB [ \-quiet ]
.RB [ \-vo\ <driver>[:<device>] ]
.RB [ \-ao\ <driver>[:<device>] ]
-.RB [ \-vcd\ track\ number ]
-.RB [ \-sb\ byte\ position ]
-.RB [ \-nosound ]
-.RB [ \-abs\ bytes ]
-.RB [ \-delay\ secs ]
-.RB [ \-nobps ]
-.RB [ \-aid\ id ]
-.RB [ \-vid\ id ]
-.RB [ \-fps\ rate ]
-.RB [ \-mc\ seconds/5f ]
-.RB [ \-fs ]
-.RB [ \-vm ]
+.RB [ \-vcd\ <track\ number> ]
+.RB [ \-sb\ <byte\ position> ]
+.RB [ \-nosound ! ]
+.RB [ \-abs\ <bytes> ]
+.RB [ \-delay\ <secs> ]
+.RB [ \-nobps ! ]
+.RB [ \-ni ! TODO ]
+.RB [ \-aid\ <id> ]
+.RB [ \-vid\ <id> ]
+.RB [ \-fps\ <rate> ]
+.RB [ \-mc\ <seconds/5f> ]
+.RB [ \-fs ! ]
+.RB [ \-vm ! ]
.RB [ \-zoom ]
-.RB [ \-x\ x ]
-.RB [ \-y\ y ]
-.RB [ \-sws\ software\ scaler\ type ]
-.RB [ \-xy\ factor ]
-.RB [ \-pp\ quality ]
-.RB [ \-include\ configfile ]
-.RB [ \-lircconf\ configfile ]
-.RB [ \-ffactor\ number ]
-.RB [ \-sub\ file ]
-.RB [ \-subfps\ rate ]
-.RB [ \-subdelay\ sec ]
+.RB [ \-x\ <x> ]
+.RB [ \-y\ <y> ]
+.RB [ \-sws\ <software\ scaler\ type> ]
+.RB [ \-xy\ <factor> ]
+.RB [ \-pp\ <quality> ]
+.RB [ \-npp\ <quality> ]
+.RB [ \-include\ <config\ file> ]
+.RB [ \-lircconf\ <config\ file> ]
+.RB [ \-ffactor\ <number> ]
+.RB [ \-sub\ <filename> ]
+.RB [ \-subfps\ <rate> ]
+.RB [ \-subdelay\ <seconds> ]
.RB [ \-z\ <0-8> ]
.RB [ \-idx ]
.RB [ \-forceidx ]
-.RB [ \-nodshow ]
+.RB [ \-nodshow ! ]
.RB [ \-noxv ]
.RB [ \-forcexv ]
-.RB [ \-ss\ time ]
+.RB [ \-ss\ <time> ]
.RB [ \-dumpaudio ]
.RB [ \-dumpvideo ]
.RB [ \-dumpstream ]
-.RB [ \-noframedrop ]
-.RB [ \-framedrop ]
-.RB [ \-nodouble ]
-.RB [ \-double ]
-.RB [ \-stereo\ mode ]
-.RB [ \-channels\ n ]
-.RB [ \-srate\ Hz ]
-.RB [ \-osdlevel\ level ]
-.RB [ \-config\ file ]
-.RB [ \-display\ name ]
+.RB [ \-noframedrop ! ]
+.RB [ \-hardframedrop ]
+.RB [ \-nodouble ! ]
+.RB [ \-stereo\ <mode> ]
+.RB [ \-channels\ <n> ]
+.RB [ \-srate\ <Hz> ]
+.RB [ \-osdlevel\ <level> ]
+.RB [ \-config\ <file> ]
+.RB [ \-display\ <name> ]
+.RB [ \-wid\ <window\ id> ]
.RB [ \-unicode ]
-.RB [ \-utf8 ]
-.RB [ \-fsmode\ mode ]
-.RB [ \-vc\ video\ codec\ name ]
-.RB [ \-ac\ audio\ codec\ name ]
-.RB [ \-vfm\ video\ codec\ family ]
-.RB [ \-afm\ audio\ codec\ family ]
-.RB [ \-frames\ number ]
-.RB [ \-autoq\ quality ]
-.RB [ \-fb\ device ]
-.RB [ \-fbmode\ modename ]
-.RB [ \-fbmodeconfig\ filename ]
+.RB [ \-utf8 ! ]
+.RB [ \-fsmode\ <mode> ]
+.RB [ \-vc\ <video\ codec\ name> ]
+.RB [ \-ac\ <audio\ codec\ name> ]
+.RB [ \-frames\ <number> ]
+.RB [ \-autoq\ <quality> ]
+.RB [ \-fb\ <device> ]
+.RB [ \-fbmode\ <modename> ]
+.RB [ \-fbmodeconfig\ <filename> ]
+.RB [ \-monitor_hfreq\ <horizontal\ frequency\ range> ]
+.RB [ \-monitor_vfreq\ <vertical\ frequency\ range> ]
+.RB [ \-monitor_dotclock\ <dotclock\ (or\ pixelclock)\ range> ]
.RB [ \-benchmark ]
-.RB [ \-dvd\ titleid ]
-.RB [ \-chapter\ chapterid ]
-.RB [ \-dvdangle\ angleid ]
-.RB [ \-dvdkey\ key ]
-.RB [ \-skin\ skin ]
-.RB [ \-aspect\ ratio ]
-.RB [ \-monitoraspect\ ratio ]
-.RB [ \-subcp\ codepage ]
+.RB [ \-dvd\ <title\ id> ]
+.RB [ \-chapter\ <chapter\ id> ]
+.RB [ \-dvdangle\ <angle\ id> ]
+.RB [ \-alang\ <language\ code> ]
+.RB [ \-slang\ <language\ code> ]
+.RB [ \-dvdkey\ <key> ]
+.RB [ \-dvdauth\ <option> TODO]
+.RB [ \-aspect\ <ratio> !]
+.RB [ \-monitoraspect\ <ratio> ]
+.RB [ \-subcp\ <codepage> ]
.RB [ \-dumpmpsub ]
-.RB [ \-screenw\ pixels ]
-.RB [ \-screenh\ pixels ]
-.RB [ \-cache\ kbytes ]
-.RB [ \-bpp\ depth ]
+.RB [ \-dumpfile ]
+.RB [ \-dumpsub ]
+.RB [ \-screenw\ <pixels> ]
+.RB [ \-screenh\ <pixels> ]
+.RB [ \-cache\ <size\ in\ Kbytes> ]
+.RB [ \-bpp\ <depth> ]
.RB [ \-flip ]
.RB [ \-playlist\ <filename> ]
.RB [ \-slave ]
-.RB [ \-loop\ <num>]
-.I - or file or device
+.RB [ \-loop\ <num> ]
+.RB [ \-noloop ]
+.RB [ \-aop TODO ]
+.RB [ \-mixer TODO ]
+.RB [ \-master TODO ]
+.RB [ \-vivo TODO_EXPERIMENTAL ]
+.RB [ \-tv TODO ]
+.RB [ \-noautosub ! TODO ]
+.RB [ \-font TODO ]
+.RB [ \-sstep TODO ]
+.RB [ \-aofile TODO ]
+.RB [ \-waveheader ! TODO ]
+.RB [ \-aa*\ TODO ]
+.RB [ \-dapsync ! TODO ]
+.RB [ \-softsleep ! TODO ]
+.RB [ \-vfm\ <video\ codec\ family\ TODO> ]
+.RB [ \-afm\ <audio\ codec\ family\ TODO> ]
+.I < - | file | device >
+
.PP
.SH DESCRIPTION
-.I mplayer
-MPlayer is a movie player for LINUX (runs on many other Unices, and
-non-x86 CPUs, see section 6). It plays most MPEG, AVI and ASF/WMV files,
-supported by many native and Win32 DLL codecs. You can watch VideoCD,
-SVCD, DVD and even DivX movies too (and you don't need the avifile library
-at all!). The another big feature of mplayer is the wide range of
-supported output drivers. It works with X11, Xv, DGA, OpenGL, SVGAlib,
-fbdev, AAlib, but you can use SDL (and this way all drivers of SDL) and
-some lowlevel card-specific drivers (for Matrox, 3Dfx and Radeon) too!
-Most of them supports software or hardware scaling, so you can enjoy
-movies in fullscreen. And what about the nice big antialiased shaded
-subtitles (7 supported types!!!) with european/ISO 8859-1,2 (hungarian,
-english, czech, etc), cyrillic, korean fonts, and OSD?
+
+MPlayer is a movie player for LINUX and runs on several other Unices, and
+non-x86 CPUs... It plays most MPEG, AVI (including DivX ;-) without
+libavifile) and ASF/WMV files by means of native and Win32 DLL codecs. It also
+reads VideoCD, SVCD, DVD.
+
+Another big feature of MPlayer is the wide range of supported output drivers:
+X11, Xv, DGA, OpenGL, SVGAlib, FBDev, AAlib, DirectFB, SDL (and all the
+drivers it supports !). There are also several lowlevel card-specific drivers
+for Matrox, 3Dfx and Radeon ! Most of them support software or hardware
+scaling, so enjoy your movies in fullscreen !
+
+Several subtitles types are supported (curently 9 !) and the fonts are
+rendered with nice big antialiased shaded fonts ! Of course there is support
+for european/ISO 8859-1,2 (hungarian, english, czech, etc), cyrillic, korean
+fonts.
+
+
.LP
-.SH "GENERAL OPTIONS"
-.TP
-.I NOTE
-Every "flag" option has "noflag" pair, e.g. -fs opposite is -nofs
+.SH "GUI OPTIONS"
.TP
.B \-gui
-start MPlayer with the GUI mode. You have to compile it in, for details
+start MPlayer with the GUI mode. You have to compile it _explicitely_, for details
see the documentation.
.TP
-.B \-dvd\ titleid
+.B \-skin <skin directory>
+load skin from this directory (WITHOUT path name !). For example
+ '-skin fittyfene' tries these:
+ /usr/local/share/mplayer/Skin/fittyfene
+ ~/.mplayer/Skin/fittyfene
+
+
+.LP
+.SH "DVD OPTIONS"
+.TP
+.B \-dvd\ <titleid>
tell MPlayer which movies (marked with titleid) to play. For example
sometimes '1' are trailers, and '2' is the real movie.
+
+Hint: see -pp option
.TP
-.B \-sid\ id
+.B \-sid\ <id> (EXPERIMENTAL)
Turns on DVD subtitle displaying. Also, you MUST specify a number which
-corresponds to a DVD subtitle language (0-...). For the list of available
-subtitles, use with the -v switch and look at the output. (EXPERIMENTAL)
+corresponds to a DVD subtitle language (0-31).
+For the list of available subtitles, use with the -v switch and look at the output.
.TP
-.B \-chapter\ chapterid
-specify which chapter to start playing at. Examples can be found below.
+.B \-chapter\ <chapter id>
+specify which chapter to start playing at.
.TP
-.B \-dvdangle\ angleid
+.B \-dvdangle\ <angle id>
some DVD discs contain scenes that can be viewed from multiple angles.
-Here you can tell MPlayer which angles to use. Examples can be found below.
+Here you can tell MPlayer which angles to use.
.TP
+.B \-alang <language code>
+<language> corresponds to the first audio language you want for DVD playback
+(two-letter code)
+For instance use: -alang fr for French audio.
+For the list of available audio streams, use with the -v switch and look at the output.
+.TP
+.B \-slang <language>
+<language> corresponds to the first subtitle language you want for DVD playback
+(two-letter code)
+For instance use: -slang hu for Hungarian subtitles.
+For the list of available subtitles, use with the -v switch and look at the output.
+.TP
+.B \-dvdkey <key>
+key to decrypt stream encrypted with CSS. For example: -dvdkey F169072699
+.I NOTE:
+This is NOT for DVD playing ! For DVD use the -dvd option !
+
+
+.LP
+.SH "GENERAL OPTIONS"
+.TP
+
.B \-vo\ <driver>[:<device>]
select video output driver and optinaly device. "device" is valid with
SDL and GGI too, it means sub-driver then (for example: -vo sdl:aalib).
-
-you can get the list of available drivers executing
+The full list of available drivers is displayed by executing:
.I mplayer -vo help
.TP
@@ -146,7 +217,7 @@
.I mplayer -ao help
.TP
-.B \-vcd\ track
+.B \-vcd\ <track>
play video cd track from device instead of plain file
.TP
.B \-nosound
@@ -168,13 +239,13 @@
flip image (useful for example for old Indeo codecs). Supported only(?)
by the 'sdl' and 'x11' outputs.
.TP
-.B \-x\ x
-scale image to x width [if driver suppports!]
+.B \-x\ <x>
+scale image to x width (if the driver supports it ! )
.TP
-.B \-y\ y
+.B \-y\ <y>
scale image to y height
.TP
-.B \-sws\ software\ scaler\ type
+.B \-sws\ <software\ scaler\ type>
this option sets the quality (and speed, respectively) of the software scaler,
with the -zoom option. For example with x11 or other outputs which lack
hardware acceleration. Possible settings are :
@@ -183,29 +254,72 @@
1 - bilinear
2 - bicubic (best quality)
.TP
-.B \-xy\ factor
+.B \-xy\ <factor>
scale image by <factor>
-.TP
-.B \-pp\ quality
-apply postprocess filter on decoded image.
-You need a STRONG CPU in order to use this!
-The supported formats and settings are:
-
- MPEG 1/2 0 (none), TODO
- OpenDivX 0 (none), TODO
- DivX4 0 (none), TODO
- DivX 0 (none), TODO
-
- -pp 0x20000 TODO
.TP
-.B \-autoq\ quality
+.B \-autoq\ <quality>
dynamically changes the level of postprocess, depending on spare CPU
time available. Uses the same value ranges as -pp . The number you
specify will be the maximum level used. Usually you can use some big
number. You don't have to (and don't) use together with -pp !
+
+.TP
+.B \-pp\ <quality>
+apply postprocess filter on decoded image.
+
+Postprocessing effect depends on the codec and works only for MPEG, OpenDivX,
+DivX4, DivX. Quality is an hexadecimal number built as below:
+
+0x 00 TX hv YZ
+ ^^ ^^ ^^
+ || | ||
+ || | |\- postprocessing flag for luminance:
+ || | | 1/2: v/h deblock 4: dering 8: auto contrast/brightness correction
+ || | |
+ || | \-- postproc flags for color:
+ || | 1/2: v/h deblock 4: dering
+ || |
+ || \---- experimental deblocking filters:
+ || 11: X's filter 22: x1 filter
+ ||
+ |\------- deinterlacing modes
+ | 1: linear interpolation 2: linear blend
+ | 4: cubic interpolation 8: median
+ |
+ \-------- temporal denoise filter: 1 enabled
+
+.I HINT:
+0x2007f or 0x7f are known to give good results.
+.I NOTE:
+0x20000 may be required for DVD playback
+
+.TP
+.B \-npp\ <options>
+Options is a coma separated list of the keywords below:
+ hb or hdeblock : TODO
+ vb or vdeblock : TODO
+ vr or rkvdeblock : TODO
+ h1 or x1hdeblock : TODO
+ v1 or x1vdeblock : TODO
+ dr or dering : TODO
+ al or autolevels : TODO
+ lb or linblenddeint : linear blend deinterlacing (0x20000)
+ li or linipoldeint : linear interpolation deinterlacing (0x10000)
+ ci or cubicipoldeint : cubic interpolation deinterlacing (0x40000)
+ md or mediandeint : median deinterlacing (0x80000)
+ tn or tmpnoise : temporal denoise filter (0x100000)
+
+.I EXAMPLES:
+ '-pp 0x2007f' <=> '-npp hb,vb,dr,al,lb'
+ '-pp 0x7f' <=> '-npp hb,vb,dr,al'
+
+.I HINT:
+the following values are known to give good results:
+-npp default -autoq 6 and -npp tn:150:200:400 for the denoiser
+
.TP
-.B \-ffactor\ number
+.B \-ffactor\ <number>
resample alphamap of the font. Can be:
0 plain white fonts
@@ -213,26 +327,27 @@
1 narrow black outline
10 bold black outline
.TP
-.B \-sub\ file
+.B \-sub\ <file>
use/display this subtitle file
.TP
-.B \-subfps\ rate
-specify frame/sec rate of subtitle file
-(ONLY for frame-based SUB files, i.e. NOT MicroDVD format!)
-(default: the same as the movie)
+.B \-subfps\ <rate>
+specify frame/sec rate (float number) of subtitle file. This ONLY works for
+frame-based SUB files (NOT MicroDVD format for instance) Default is to use the
+same rate as the one of the movie.
.TP
-.B \-subdelay\ sec
+.B \-subdelay\ <sec>
delays subtitles by <sec> seconds. Can be negative.
.TP
-.B \-osdlevel\ level
-specifies which mode the OSD should start in (0 : none, 1 : seek, 2: seek+timer)
+.B \-osdlevel\ <level>
+specifies which mode the OSD should start in (0: none, 1: seek, 2: seek+timer)
(default = 2)
.TP
-.B \-lircconf\ configfile
+.B \-lircconf\ <config file>
specifies a configfile for LIRC (see http://www.lirc.org) if you don't like the default ~/.lircrc
.TP
-.B \-v
-enable verbose output (more -v means more verbose)
+.B \-v or --verbose
+enable verbose output. Add several times this option to increase verbosity
+level.
.TP
.B \-quiet
display less output, status messages.
@@ -240,20 +355,12 @@
.B \-benchmark
used in combination with -nosound and -vo null for benchmarking.
.TP
-.B \-skin skin directory
-load skin from this directory (WITHOUT path name!). For example '-skin fittyfene' tries these :
-
- /usr/local/share/mplayer/Skin/fittyfene
- ~/.mplayer/Skin/fittyfene
-.TP
.B \-aspect ratio
set aspect ratio of movies. It's autodetected on MPEG files, and can't be
autodetected on AVI files. Examples:
-aspect 4:3 or -aspect 1.3333
-aspect 16:9 or -aspect 1.7777
-
-(has -noaspect pair)
.TP
.B \-monitoraspect ratio
set aspect ratio of your screen. Examples:
@@ -266,15 +373,18 @@
play files according to this filelist (1 file/row).
.TP
.B \-slave
-This option switches on slave mode. This is intended for use
-of MPlayer as a backend to other programs. Instead of intercepting keyboard
-events, MPlayer will read simplistic command lines from its stdin.
+swicth to slave mode. Another program may use MPlayer as a backend: instead of
+intercepting keyboard events, MPlayer will read simplistic command lines from
+its stdin.
See section
.B SLAVE MODE PROTOCOL
for the syntax.
.TP
.B \-loop\ <num>
-Loops movie playback <num> times. 0 means forever.
+loops movie playback <num> times. 0 means forever.
+.IP
+.B \-noloop
+don't loop
.IP
.SH "ADVANCED OPTIONS"
.TP
@@ -292,7 +402,7 @@
-vc ffmpeg12 use libavcodec's MPEG1/2 codec
-vc divx4 use ProjectMayo's DivX codec
-See -vc help for FULL list !
+See '-vc help' for the FULL list !
.TP
.B \-ac <name>
force usage of a specific audio codec, according to its name in codecs.conf,
@@ -306,9 +416,9 @@
-ac vorbis use libvorbis
-ac ffmp3 use ffmpeg's MP3 decoder (SLOW)
-See -ac help for FULL list !
+See '-ac help' for the FULL list !
.TP
-.B \-vfm <1-12>
+.B \-vfm <1-12> (OBSOLETED see -vc)
force usage of a specific codec FAMILY, and FALLBACK to default if failed.
For example:
@@ -321,18 +431,16 @@
(same as -vc divx4 but fallback)
-vfm 10 use XAnim codecs
-See -vc help for FULL list !
-
-NOTE : if libdivxdecore support was compiled in, then type 3 and 7 now contains
+.I NOTE:
+if libdivxdecore support was compiled in, then type 3 and 7 now contains
just the same DivX4 codec, but different APIs to reach it. For difference
between them and when to use which, check the DivX4 section in the
documentation.
.TP
-.B \-afm <1-12>
+.B \-afm <1-12> (OBSOLETED see -ac)
force usage of a specific audio format. For example:
- -afm 1 use libmp3 (mp2/mp3,
- but not mp1)
+ -afm 1 use libmp3 (mp2/mp3, but not mp1)
-afm 2 suppose raw PCM audio
-afm 3 use libac3
-afm 4 use a matching Win32 codec
@@ -340,53 +448,55 @@
-afm 10 use libvorbis
-afm 11 use ffmpeg's MP3 decoder (even mp1)
-See -ac help for FULL list !
.TP
-.B \-sb\ position
+.B \-sb\ <byte position>
seek to byte position
.TP
-.B \-ss\ time
+.B \-ss\ <time>
seek to given time position. For example :
- -ss 56
- -ss 01:10:00
+ -ss 56 seeks to 56 seconds
+ -ss 01:10:00 seeks to 1 hour 10 min
.TP
-.B \-bpp\ depth
+.B \-bpp\ <depth>
use different color depth than autodetect. Not all -vo drivers support
it (fbdev, dga2, svga, vesa).
.TP
-.B \-abs\ bytes
+.B \-abs\ <bytes>
sound card audio buffer size (in bytes, default: measuring)
.TP
-.B \-delay\ secs
+.B \-delay\ <secs>
audio delay in seconds (may be +/- float value)
.TP
.B \-nobps
don't use avg. byte/sec value for A-V sync (AVI)
.TP
-.B \-aid\ id
+.B \-aid\ <id>
select audio channel [MPG: 0-31 AVI: 1-99 ASF: 0-127 VOB: 128-...]
.TP
-.B \-vid\ id
+
+.B \-vid\ <id>
select video channel [MPG: 0-15 AVI: -- ]
.TP
-.B \-fps\ value
-force frame rate (if value is wrong in the header)
+
+.B \-fps\ <value>
+force frame rate (float number). Useful if the value found in the movie header
+is wrong.
.TP
-.B \-mc\ seconds/5frame
+.B \-mc\ <seconds/5frame>
maximum sync correction per 5 frames (in seconds)
.TP
.B \-ni
force usage of non-interleaved AVI parser
.TP
-.B \-include configfile
+.B \-include <config file>
specify config file to be parsed after the default
.TP
.B \-z\ <0-8>
specifies compression level for PNG output
- 0 : no compression
- 8 : max compression
+ 0: no compression
+ 8: max compression
.TP
.B \-idx
rebuilds INDEX of the AVI. Useful with broken downloads, or badly
@@ -399,67 +509,65 @@
.B \-nodshow
disables usage of DirectShow video codecs
.TP
-.B \-noxv
+.B \-noxv (SDL only)
disable XVideo hardware acceleration (with SDL only!)
.TP
-.B \-forcexv
-force using XVideo (SDL!)
+.B \-forcexv (SDL only)
+force using XVideo
.TP
.B \-dumpaudio
writes audio stream of the file to ./stream.dump (mostly usable
with mpeg/ac3)
.TP
+.B \-dumpvideo
+dump video stream to ./stream.dump (only with MPEG-PS) (not very usable)
+.TP
.B \-dumpstream
-dumps the file to ./stream.dump . Useful for example
-when ripping from DVD.
+dump the file to ./stream.dump. Useful when ripping from DVD.
.TP
.B \-noframedrop
-no frame dropping : every frame is played, audio and video may be out of
+no frame dropping: every frame is played, audio and video may be out of
sync (default)
.TP
.B \-framedrop
-frame dropping : decode all frames, video may skip
+frame dropping: decode all frames, video may skip
.TP
.B \-nodouble
-disable doublebuffering (default). Currently this is only honoured by the Xv and the DGA driver.
+disable doublebuffering (default). Currently this is only supported by the Xv and the DGA driver.
With the DGA driver this also disables OSD support but yields some speed gain.
.TP
-.B \-double
-enable doublebuffering. Currently this is only honoured by the Xv and the DGA driver.
-.TP
-.B \-dvdkey key
-key to decrypt stream encrypted with CSS. For example : -dvdkey F169072699
-(this is NOT for DVD playing! For DVD use the -dvd option!)
-.TP
.B \-stereo mode
select type of MP2/MP3 stereo output.
- Stereo 0
- Left channel 1
- Right channel 2
+ Stereo 0
+ Left channel 1
+ Right channel 2
.TP
.B \-channels n
select number of audio output channels to be used
- Stereo 2
- Surround 4
- Full 5.1 6
+ Stereo 2
+ Surround 4
+ Full 5.1 6
Currently this option is only honoured for AC3 audio.
.TP
-.B \-srate Hz
+.B \-srate <Hz>
specifies Hz to playback audio on. Has effect on playback speed!
.TP
-.B \-config configfile
+.B \-config <config file>
specifies where to search for config file
.TP
-.B \-display name
+.B \-display <name>
specify the hostname and display number of the X server you want
-to display on. For example : -display xtest.localdomain:0
+to display on. For example: -display xtest.localdomain:0
.TP
+.B \-wid\ <window id>
+This tells MPlayer to use a X11 window, which is useful to embed MPlayer in a
+browser (with Fredrik H?binette's plugger extension for instance)
+.IP
.B \-unicode
tells MPlayer to handle the subtitle file as UNICODE.
-Contrary: -nounicode
.TP
.B \-utf8
tells MPlayer to handle the subtitle file as UTF8.
@@ -479,76 +587,59 @@
.B \-frames\ number
MPlayer plays <number> frames, then quits.
.TP
-.B \-fb\ device
+
+
+
+.B \-fb\ <device> (FBdev or DirectFB only)
Specifies the framebuffer device to use. By default it uses /dev/fb0 .
-Only valid for the fbdev driver.
.TP
-.B \-fbmode\ modename
+.B \-fbmode\ <modename> (FBdev only)
Change videomode to the one that is labelled as <modename> in /etc/fb.modes .
-Only valid for the fbdev driver.
.TP
.I NOTE
VESA framebuffer doesn't support mode changing.
.TP
-.B \-fbmodeconfig\ filename
+.B \-fbmodeconfig\ <filename> (FBdev only)
Use this config file instead of the default /etc/fb.modes .
-Only valid for the fbdev driver.
+.TP
+.B \-monitor_hfreq <horizontal frequency range> (FBdev only)
+.B \-monitor_vfreq <vertical frequency range> (FBdev only)
+.B \-monitor_dotclock <dotclock (or pixelclock) range> (FBdev only)
+Look into etc/example.conf for further information and in DOC/video.html.
.TP
.B \-subcp\ codepage
If your system supports iconv(3), you can use this option to
-specify codepage of the subtitle. Examples:
-
- -subcp latin2
- -subcp cp1250
-
+specify codepage of the subtitle.
+.I EXAMPLES:
+ -subcp latin2
+ -subcp cp1250
.TP
.B \-dumpmpsub
Convert the given subtitle (specified with the -sub switch) to MPlayer's
subtitle format, MPsub. Dumps a dump.mpsub file to current directory.
.TP
-.B \-screenw\ pixels
+.B \-screenw\ <pixels>
If you use an output driver which can't know the resolution of the screen
(mga/fbdev/x11 and/or TVout) this is where you can specify the horizontal
resolution.
.TP
-.B \-screenh\ pixels
+.B \-screenh\ <pixels>
If you use an output driver which can't know the resolution of the screen
(mga/fbdev/x11 and/or TVout) this is where you can specify the vertical
resolution.
.TP
-.B \-cache\ kbytes
-This option specifies how much memory to use when precaching a file/URL .
+.B \-cache\ <size in Kbytes>
+This option specifies how much memory to use when precaching a file/URL.
Especially useful on slow media. Default is off.
.IP
-.SH "ALPHA/BETA CODE"
-.TP
-.I NOTE
-These are included in this manpage just for completeness! These may or may NOT
-work! If you don't know what are these, you DON'T need these! In either case,
-double-check the documentation !
-.TP
-.B \-br\ rate
-used with '-vo odivx' .
-Specifies the bitrate to encode OpenDivx at
-(in bits! e.g: 780000).
-.TP
-.I NOTE
-You CAN'T encode sound, only video right now! Don't ask for it,
-it's on the TODO list.
-.TP
-.B \-encode\ file
-used with '-vo odivx' .
-Specifies the output OpenDivX file. Won't overwrite.
-.TP
-.B \-dumpvideo
-dump video stream to ./stream.dump (only with MPEG-PS) (not very usable)
+
.IP
.SH KEYBOARD CONTROL
.TP
.I NOTE
These keys may/may not work, depending on your video output driver.
.TP
- <- or -> seek backward/forward 10 seconds
+ <- or -> seek backward/forward 10 seconds
up or down seek backward/forward 1 minute
@@ -581,10 +672,10 @@
.IP
.SH SLAVE MODE PROTOCOL
-If the -slave switch is given, playback is controlled by a
+If the -slave switch is given, playback is controlled by a
line-based protocol with the following tokens:
.TP
- stop pause playback
+stop pause playback
play resume playback
@@ -592,7 +683,7 @@
skip <NUM> skip NUM seconds (may be negative)
-quit exit mplayer
+quit exit MPlayer
.IP
.SH FILES AND DIRECTORIES
@@ -607,9 +698,10 @@
file, and files with .RAW extension.
.TP
.I SUBTITLE FILES
-MPlayer currently supports 9 subtitle formats : MicroDVD, SubRip, unnamed,
-SAMI (smi), vplayer, RealMedia RT, ssa (Sub Station Alpha), AQT, and our own: MPsub.
-Sub files are searched in this priority : (for example /mnt/cdrom/movie.avi)
+MPlayer currently supports 9 subtitle formats: MicroDVD, SubRip, SubViewer,
+SAMI (smi), vplayer, RealMedia RT, ssa (Sub Station Alpha), DunnoWhat (well
+not a real format :), AQT, and our own: MPsub.
+Sub files are searched in this priority: (for example /mnt/cdrom/movie.avi)
/mnt/cdrom/movie.sub
(utf/UTF/sub/SUB/srt/SRT/smi/SMI/rt/RT/txt/TXT/ssa/SSA)
$HOME/.mplayer/sub/movie.sub
@@ -635,10 +727,11 @@
.SH BUGS
Probably. Check the documentation.
-Bugreports should be addressed to the MPlayer-users mailing list
-(mplayer-users at mplayerhq.hu) ! If you want to submit a bugreport
-(which we love to receive!), please double-check the bugreports.html, and
-tell us all that we need to know to identify your problem.
+Send your complete bugreports to the MPlayer-users mailing list at
+<mplayer-users at mplayerhq.hu>. We love complete bugreports :)
+
+PLEASE, double-check the documentation (especially bugreports.html) and the
+FAQ before !
.LP
.SH AUTHORS
@@ -651,7 +744,7 @@
.I Gabucino .
.LP
.SH STANDARD DISCLAIMER
-Use only at your own risk! There may be errors and inaccuracies that could
-be damaging to your system or your eye. Proceed with caution, and although
-this is highly unlikely, the author doesn't take any responsibility for that!
+Use only at your own risk ! There may be errors and inaccuracies that could
+cause damages to your system or your eyes. Proceed with caution, and although
+this is highly unlikely, the authors don't take any responsibility for that !
.\" end of file
More information about the MPlayer-dev-eng
mailing list