[MPlayer-DOCS] CVS: main/DOCS/man/en mplayer.1,1.576,1.577
Diego Biurrun CVS
syncmail at mplayerhq.hu
Wed Apr 28 01:17:24 CEST 2004
CVS change done by Diego Biurrun CVS
Update of /cvsroot/mplayer/main/DOCS/man/en
In directory mail:/var2/tmp/cvs-serv22157/en
Modified Files:
mplayer.1
Log Message:
Mark all options that work only in combination with XXX as (XXX only).
Index: mplayer.1
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/man/en/mplayer.1,v
retrieving revision 1.576
retrieving revision 1.577
diff -u -r1.576 -r1.577
--- mplayer.1 27 Apr 2004 01:35:46 -0000 1.576
+++ mplayer.1 27 Apr 2004 23:17:22 -0000 1.577
@@ -310,6 +310,9 @@
Every 'flag' option has a 'noflag' counterpart, e.g.\& the opposite of the
\-fs option is \-nofs.
.PP
+If an option is marked as (XXX only), it will only work in combination with
+the XXX option or if XXX is compiled in.
+.PP
You can put all of the options in a configuration file which will be read
every time MPlayer is run.
The system-wide configuration file 'mplayer.conf' is in your configuration
@@ -504,7 +507,7 @@
.PD 1
.
.TP
-.B \-lircconf <file>
+.B \-lircconf <file> (LIRC only)
Specifies a configuration file for LIRC (Linux Infrared Remote Control, see
http://www.lirc.org) if you don't like the default ~/\:.lircrc.
.TP
@@ -515,13 +518,13 @@
Loops movie playback <number> times.
0 means forever.
.TP
-.B \-menu (BETA CODE)
+.B \-menu (OSD menu only)
Turn on OSD menu support.
.TP
-.B \-menu-cfg <file> (BETA CODE)
+.B \-menu-cfg <file> (OSD menu only)
Use an alternative menu.conf.
.TP
-.B \-menu-root <value> (BETA CODE)
+.B \-menu-root <value> (OSD menu only)
Specify the main menu.
.TP
.B \-nojoystick
@@ -531,11 +534,11 @@
.B \-nolirc
Turns off LIRC support.
.TP
-.B \-nomouseinput
+.B \-nomouseinput (X11 only)
Disable mouse button press/release input (mozplayerxp's context menu relies
on this option).
.TP
-.B \-nortc \ \
+.B \-nortc (RTC only)
Turns off usage of the Linux RTC (real-time clock \- /dev/\:rtc) as timing
mechanism.
.TP
@@ -611,7 +614,7 @@
When playing an MPEG-TS stream, MPlayer/Mencoder will use the first program
(if present) with the chosen audio stream.
.TP
-.B \-alang <two letter\ country\ code> (also see \-aid option)
+.B \-alang <two letter\ country\ code> (also see \-aid option) (DVD only)
Works only for DVD playback.
It selects the DVD audio language and always tries to play audio streams whose
language matches the given code.
@@ -640,7 +643,7 @@
Enables caching for the stream used by \-audiofile, using the specified
amount of memory.
.TP
-.B \-bandwidth <value>
+.B \-bandwidth <value> (network only)
Specify the maximum bandwidth for network streaming (for servers that are
able to send content in different bitrates).
Useful if you want to watch live streamed media behind a slow connection.
@@ -653,7 +656,7 @@
file/\:URL.
Especially useful on slow media (default is \-nocache).
.TP
-.B \-cdda <option1:option2>
+.B \-cdda <option1:option2> (CDDA only)
This option can be used to tune the CD Audio reading feature of MPlayer.
Available options are:
@@ -722,15 +725,15 @@
.PD 1
.
.TP
-.B \-chapter <chapter\ id>[\-<end\ chapter\ id>]
+.B \-chapter <chapter\ id>[\-<end\ chapter\ id>] (DVD only)
Specify which chapter to start playing at.
Optionally specify which chapter to end playing at (default: 1).
Examples can be found below.
.TP
-.B \-cookies
+.B \-cookies (network only)
Send cookies when making HTTP requests.
.TP
-.B \-cookies-file <filename>
+.B \-cookies-file <filename> (network only)
Read HTTP cookies from this file.
The file is assumed to be in Netscape format.
If you use this option, MPlayer will not look for cookies in ~/.netscape/
@@ -755,7 +758,7 @@
.B \-dumpvideo (MPLAYER only)
Dump raw compressed video stream to ./\:stream.dump (not very usable).
.TP
-.B \-dvbin <options>
+.B \-dvbin <options> (DVB only)
Pass the following parameters to the DVB input module, in order to override
the default ones:
@@ -771,10 +774,10 @@
.PD 1
.
.TP
-.B \-dvd-device <path\ to\ device>
+.B \-dvd-device <path\ to\ device> (DVD only)
Override default DVD device name /dev/\:dvd.
.TP
-.B \-dvdangle <angle\ id>
+.B \-dvdangle <angle\ id> (DVD only)
Some DVD discs contain scenes that can be viewed from multiple angles.
Here you can tell MPlayer which angles to use (default: 1).
Examples can be found below.
@@ -812,7 +815,7 @@
You can only use this option if the underlying media supports seeking
(i.e.\& not with stdin, pipe, etc).
.TP
-.B \-ipv4-only-proxy
+.B \-ipv4-only-proxy (network only)
Skip the proxy for IPv6 addresses.
It will still be used for IPv4 connections.
.TP
@@ -863,14 +866,14 @@
extension is used to select demuxer. It always falls back to content-based
demuxer selection.
.TP
-.B \-passwd <password> (see \-user option too)
+.B \-passwd <password> (see \-user option too) (network only)
Specify password for http authentication.
.TP
-.B \-prefer-ipv4
+.B \-prefer-ipv4 (network only)
Use IPv4 on network connections.
Falls back to IPv6 automatically.
.TP
-.B \-prefer-ipv6
+.B \-prefer-ipv6 (IPv6 network only)
Use IPv6 on network connections.
Falls back to IPv4 automatically.
.TP
@@ -925,7 +928,7 @@
.PD 1
.
.TP
-.B \-rtsp-stream-over-tcp
+.B \-rtsp-stream-over-tcp (live.com only)
Used with 'rtsp://' URLs to specify that the resulting incoming RTP and RTCP
packets be streamed over TCP (using the same TCP connection as RTSP).
This option may be useful if you have a broken Internet connection that does
@@ -977,7 +980,7 @@
audio and video pids.
.
.TP
-.B \-tv <option1:option2:...>
+.B \-tv <option1:option2:...> (TV only)
This option tunes various properties of the TV capture module.
For watching TV with MPlayer, use 'tv://' or 'tv://<channel_number>'
or even 'tv://<channel_name> (see option channels for channel_name below)
@@ -1111,7 +1114,7 @@
.RE
.
.TP
-.B \-user <user name> (see \-passwd option too)
+.B \-user <user name> (see \-passwd option too) (network only)
Specify user name for http authentication.
.TP
.B \-user-agent <string>
@@ -1159,7 +1162,7 @@
Dumps the subtitle substream from VOB streams.
See \-dump*sub and \-vobsubout* options too.
.TP
-.B \-ffactor <number>
+.B \-ffactor <number> (OSD only)
Resample alphamap of the font.
Can be:
.
@@ -1177,10 +1180,10 @@
.PD 1
.
.TP
-.B \-flip-hebrew
+.B \-flip-hebrew (FriBiDi only)
Turns on flipping subtitles using FriBiDi.
.TP
-.B \-font <path\ to\ font.desc\ file>
+.B \-font <path\ to\ font.desc\ file> (OSD only)
Search for the OSD/\:SUB fonts in an alternative directory (default for normal
fonts: ~/\:.mplayer/\:font/\:font.desc, default for FreeType fonts:
~/.mplayer/\:subfont.ttf).
@@ -1202,14 +1205,14 @@
.PD 1
.
.TP
-.B \-fontconfig
+.B \-fontconfig (fontconfig only)
Enables the usage of fontconfig managed fonts.
.TP
.B \-forcedsubsonly
Display only forced subtitles for the DVD subtitle stream selected by e.g.\&
\-slang.
.TP
-.B \-fribidi-charset <charset\ name>
+.B \-fribidi-charset <charset\ name> (FriBiDi only)
Specifies the charset that will be passed to FriBiDi when decoding a non-UTF8
subtitles (default: ISO8859-8).
.TP
@@ -1266,7 +1269,7 @@
.PD 1
.
.TP
-.B \-spuaa <mode>
+.B \-spuaa <mode> (OSD only)
Antialiasing/scaling mode for DVD/VobSub.
A value of 16 may be added to mode in order to force scaling even
when original and scaled frame size already match, for example to
@@ -1288,12 +1291,12 @@
.PD 1
.
.TP
-.B \-spualign <-1\-2>
+.B \-spualign <-1\-2> (OSD only)
Specify how spu (DVD/VobSub) subtitles should be aligned.
Values are the same as for \-subalign, with the extra choice -1 for original
position.
.TP
-.B \-spugauss <0.0\-3.0>
+.B \-spugauss <0.0\-3.0> (OSD only)
Variance parameter of gaussian used by \-spuaa 4.
Higher means more blur.
The default is 1.0.
@@ -1336,8 +1339,8 @@
Disables any kind of text post processing done after loading the subtitles.
Used for debug purposes.
.TP
-.B \-subalign <0\-2>
-Specify how subtitles should be aligned with subpos.
+.B \-subalign <0\-2> (OSD only)
+Specify how subtitles should be aligned with \-subpos.
0 means align at top (original/default behavior), 1 means align at center, and
2 means align at bottom.
.TP
@@ -1347,7 +1350,7 @@
hearing impaired encoded in the VOB userdata stream on most region 1 DVDs.
CC subtitles have not been spotted on DVDs from other regions so far.
.TP
-.B \-subcp <codepage>
+.B \-subcp <codepage> (iconv only)
If your system supports iconv(3), you can use this option to
specify codepage of the subtitle.
@@ -1416,11 +1419,11 @@
.I NOTE:
ONLY for frame-based SUB files, i.e.\& NOT MicroDVD format.
.TP
-.B \-subpos <0\-100> (useful with \-vf expand)
+.B \-subpos <0\-100> (useful with \-vf expand) (OSD only)
Specify the position of subtitles on the screen.
The value is the vertical position of the subtitle in % of the screen height.
.TP
-.B \-subwidth <10\-100>
+.B \-subwidth <10\-100> (OSD only)
Specify the maximum width of subtitles on the screen.
Useful for TV-out.
The value is the width of the subtitle in % of the screen width.
@@ -1577,7 +1580,7 @@
.B \-dfbopts <value> (\-vo directfb only)
Specify a parameter list for the directfb driver.
.TP
-.B \-display <name>
+.B \-display <name> (X11 only)
Specify the hostname and display number of the X server you want to display
on.
@@ -1712,7 +1715,7 @@
.B \-fsmode-dontuse <0\-31> (OBSOLETE) (use \-fs option)
Try this option if you still experience fullscreen problems.
.TP
-.B \-fstype <type1,type2,...>
+.B \-fstype <type1,type2,...> (X11 only)
Specify a priority list of fullscreen layer setting modes to be
used.
The available types are:
@@ -1783,7 +1786,7 @@
.PD 1
.
.TP
-.B \-guiwid <window\ id>
+.B \-guiwid <window\ id> (GUI only)
This tells the GUI to also use an X11 window and stick itself to the bottom
of the video, which is useful to embed a mini-GUI in a browser (with the
MPlayer plugin for instance).
@@ -1841,7 +1844,7 @@
Do not grab mouse pointer after VidMode change (\-vm), useful for multihead
setup.
.TP
-.B \-nokeepaspect
+.B \-nokeepaspect (X11 only)
Do not keep window aspect ratio when resizing X11 windows (Works currently only
with \-vo x11, xv, xmga and xvidix and your window manager needs to understand
window aspect hints.).
@@ -1865,7 +1868,7 @@
Set the monitor refreshrate in Hz.
Currently only supported by \-vo directx combined with the \-vm option.
.TP
-.B \-rootwin
+.B \-rootwin (X11 only)
Play movie in the root window (desktop background) instead of opening
a new one.
Works only with x11, xv, xmga and xvidix drivers.
@@ -1879,7 +1882,7 @@
(fbdev/\:x11 and/\:or TVout) this is where you can specify the horizontal and
vertical resolution.
.TP
-.B \-stop-xscreensaver
+.B \-stop-xscreensaver (X11 only)
Turns off xscreensaver at startup and turns it on again on exit.
.TP
.B \-vm \ \ \
@@ -1892,7 +1895,7 @@
.B \-vsync \ \
Enables VBI for vesa.
.TP
-.B \-wid <window\ id>
+.B \-wid <window\ id> (X11 only)
This tells MPlayer to use a X11 window, which is useful to embed MPlayer in a
browser (with the plugger extension for instance).
.TP
@@ -1900,8 +1903,8 @@
In Xinerama configurations (i.e.\& a single desktop that spans across multiple
displays) this option tells MPlayer which screen to display movie on.
.TP
-.B \-z <0\-9>
-Specifies compression level for PNG output (\-vo png)
+.B \-z <0\-9> (-vo png only)
+Specifies compression level for PNG output.
.
.PD 0
.RSs
@@ -2252,7 +2255,7 @@
.B \-novideo
Do not play/\:encode video.
.TP
-.B \-oldpp <quality> (OBSOLETE)
+.B \-oldpp <quality> (OBSOLETE) (OpenDivX only)
Use the opendivx postprocessing code instead of the internal one.
Superseded by \-pp, the internal postprocessing offers better
quality and performance.
More information about the MPlayer-DOCS
mailing list