# HG changeset patch # User diego # Date 1083107842 0 # Node ID 343568042bfa27ebd8b738efd554dbdab4120d1c # Parent 3c23de96a9362f3694683147404eeb64d612e772 Mark all options that work only in combination with XXX as (XXX only). diff -r 3c23de96a936 -r 343568042bfa DOCS/man/en/mplayer.1 --- a/DOCS/man/en/mplayer.1 Tue Apr 27 23:08:46 2004 +0000 +++ b/DOCS/man/en/mplayer.1 Tue Apr 27 23:17:22 2004 +0000 @@ -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 +.B \-lircconf (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 times. 0 means forever. .TP -.B \-menu (BETA CODE) +.B \-menu (OSD menu only) Turn on OSD menu support. .TP -.B \-menu-cfg (BETA CODE) +.B \-menu-cfg (OSD menu only) Use an alternative menu.conf. .TP -.B \-menu-root (BETA CODE) +.B \-menu-root (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 (also see \-aid option) +.B \-alang (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 +.B \-bandwidth (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 +.B \-cdda (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 [\-] +.B \-chapter [\-] (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 +.B \-cookies-file (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 +.B \-dvbin (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 +.B \-dvd-device (DVD only) Override default DVD device name /dev/\:dvd. .TP -.B \-dvdangle +.B \-dvdangle (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 (see \-user option too) +.B \-passwd (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 +.B \-tv (TV only) This option tunes various properties of the TV capture module. For watching TV with MPlayer, use 'tv://' or 'tv://' or even 'tv:// (see option channels for channel_name below) @@ -1111,7 +1114,7 @@ .RE . .TP -.B \-user (see \-passwd option too) +.B \-user (see \-passwd option too) (network only) Specify user name for http authentication. .TP .B \-user-agent @@ -1159,7 +1162,7 @@ Dumps the subtitle substream from VOB streams. See \-dump*sub and \-vobsubout* options too. .TP -.B \-ffactor +.B \-ffactor (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 +.B \-font (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 +.B \-fribidi-charset (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 +.B \-spuaa (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 +.B \-subcp (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 (\-vo directfb only) Specify a parameter list for the directfb driver. .TP -.B \-display +.B \-display (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 +.B \-fstype (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 +.B \-guiwid (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 +.B \-wid (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 (OBSOLETE) +.B \-oldpp (OBSOLETE) (OpenDivX only) Use the opendivx postprocessing code instead of the internal one. Superseded by \-pp, the internal postprocessing offers better quality and performance.