summaryrefslogtreecommitdiffstats
path: root/DOCS/mplayer.1
diff options
context:
space:
mode:
authordiego <diego@b3059339-0415-0410-9bf9-f77b7e298cf2>2003-02-10 00:00:00 +0000
committerdiego <diego@b3059339-0415-0410-9bf9-f77b7e298cf2>2003-02-10 00:00:00 +0000
commit41198d0c024dc57d005f839ddcde2e323b278b29 (patch)
treec2f5ab2ace2fce23bcc095330ac8c16d929677de /DOCS/mplayer.1
parent3e718780f2dd3375f272c6e28becedd5f792f192 (diff)
downloadmpv-41198d0c024dc57d005f839ddcde2e323b278b29.tar.bz2
mpv-41198d0c024dc57d005f839ddcde2e323b278b29.tar.xz
Move English files to en/ subdirectory.
git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@9383 b3059339-0415-0410-9bf9-f77b7e298cf2
Diffstat (limited to 'DOCS/mplayer.1')
-rw-r--r--DOCS/mplayer.13524
1 files changed, 0 insertions, 3524 deletions
diff --git a/DOCS/mplayer.1 b/DOCS/mplayer.1
deleted file mode 100644
index 4656290603..0000000000
--- a/DOCS/mplayer.1
+++ /dev/null
@@ -1,3524 +0,0 @@
-.\" MPlayer (C) 2000-2003 Arpad Gereoffy
-.\" This man page was/is done by Gabucino, Diego Biurrun, Jonas Jermann
-.\"
-.\" Run this to get a html version of the man page:
-.\" cat mplayer.1 | sed s/SS\ 20/SS\ 4/ | groff -man -Thtml - > manpage.html
-.\" Run this to get a text version of the man page:
-.\" groff -m man -Tascii mplayer.1 | col -bx > manpage.txt
-.\"
-.
-.\" --------------------------------------------------------------------------
-.\" Macro definitions
-.\" --------------------------------------------------------------------------
-.
-.\" default indentation is 7, don't change!
-.nr IN 7
-.\" define indentation for suboptions
-.nr SS 20
-.\" add new suboption
-.de IPs
-.IP "\\$1" \n(SS
-..
-.\" begin of first level suboptions, end with .RE
-.de RSs
-.RS \n(IN+3
-..
-.\" begin of 2nd level suboptions
-.de RSss
-.PD 0
-.RS \n(SS+3
-..
-.\" end of 2nd level suboptions
-.de REss
-.RE
-.PD 1
-..
-.
-.\" --------------------------------------------------------------------------
-.\" Title
-.\" --------------------------------------------------------------------------
-.
-.TH MPlayer 1 "2003-01-11"
-.
-.SH NAME
-mplayer \- Movie Player for Linux
-.br
-mencoder \- Movie Encoder for Linux
-
-.\" --------------------------------------------------------------------------
-.\" Synopsis
-.\" --------------------------------------------------------------------------
-.
-.SH SYNOPSIS
-.na
-.nh
-.B mplayer
-.RI [options]\ [ \ file\ | \ URL\ | \ playlist\ | \ -\ ]
-.br
-.B mplayer
-'in +\n[.k]u
-[global options]
-.I file1
-[specific options] [file2] [specific options]
-.br
-.in
-.B mplayer
-'in +\n[.k]u
-[global options]
-.RI { "group of files and options" }
-[group specific options]
-.br
-.in
-.B mplayer
-'in +\n[.k]u
-.RI [ dvd | vcd | cdda | cddb | tv ] ://title
-[options]
-.br
-.in
-.B mplayer
-'in +\n[.k]u
-.RI [ mms[t] | http | http_proxy | rt[s]p ] ://
-[user:passwd@]\fIURL\fP[:port] [options]
-.br
-.in
-.B mencoder
-[options]
-.RI [ \ file\ | \ URL\ | \ -\ ]
-[\-o\ file]
-.br
-.B gmplayer
-[options]
-[\-skin\ skin]
-.ad
-.hy
-
-.\" --------------------------------------------------------------------------
-.\" Description
-.\" --------------------------------------------------------------------------
-.
-.SH DESCRIPTION
-.B mplayer
-is a movie player for LINUX (runs on many other Unices and non\-x86 CPUs, see
-the documentation).
-It plays most MPEG/\:VOB, AVI, ASF/\:WMA/\:WMV, RM, QT/\:MOV/\:MP4, OGG/\:OGM,
-VIVO, FLI, NuppelVideo, yuv4mpeg, FILM and RoQ files, supported by many
-native, XAnim, and Win32 DLL codecs.
-You can watch VideoCD, SVCD, DVD, 3ivx, DivX\ 3/\:4/\:5 and even WMV movies,
-too (without using the avifile library).
-.PP
-Another great feature of MPlayer is the wide range of supported output
-drivers.
-It works with X11, XV, DGA, OpenGL, SVGAlib, fbdev, AAlib, DirectFB, but you
-can also use GGI, SDL (and this way all their drivers), VESA (on every VESA
-compatible card, even without X11), some low level card-specific drivers (for
-Matrox, 3Dfx and ATI) and some hardware MPEG decoder boards, such as the
-Siemens DVB, DXR2 and DXR3/\:Hollywood+.
-Most of them support software or hardware scaling, so you can enjoy movies in
-fullscreen.
-.PP
-MPlayer has an onscreen display (OSD) for status information, nice big
-antialiased shaded subtitles and visual feedback for keyboard controls.
-European/\:ISO 8859-1,2 (Hungarian, English, Czech, etc), Cyrillic and Korean
-fonts are supported along with 10 subtitle formats (MicroDVD, SubRip,
-SubViewer, Sami, VPlayer, RT, SSA, AQTitle, JACOsub and our own: MPsub) and
-DVD subtitles (SPU streams, VobSub and Closed Captions).
-.PP
-.B mencoder
-(MPlayer's Movie Encoder) is a simple movie encoder, designed to encode
-MPlayer-playable movies (see above) to other MPlayer-playable formats (see
-below).
-It encodes to DivX4, XviD, one of the libavcodec codecs and PCM/\:MP3/\:VBRMP3
-audio in 1, 2 or 3\ passes.
-Furthermore it has stream copying abilities, a powerful plugin system (crop,
-expand, flip, postprocess, rotate, scale, noise, rgb/\:yuv conversion) and
-more.
-.PP
-.B gmplayer
-is MPlayer with a graphical user interface.
-It has the same options as MPlayer.
-
-
-.\" --------------------------------------------------------------------------
-.\" Options
-.\" --------------------------------------------------------------------------
-.
-.SH "GENERAL NOTES"
-.B Also see the HTML documentation!
-.PP
-Every 'flag' option has a 'noflag' counterpart, e.g.\& the opposite of the
-\-fs option is \-nofs.
-.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
-directory (e.g.\& /etc/\:mplayer or /usr/\:local/\:etc/\:mplayer), the user
-specific one is '~/\:.mplayer/\:config'.
-User specific options override system\-wide options and options given on the
-command line override either.
-The syntax of the configuration files is 'option=<value>', everything after a
-\'#' is considered a comment.
-Options that work without values can be enabled by setting them to 'yes' or
-\'1' and disabled by setting them to 'no' or '0'.
-Even suboptions can be specified in this way.
-
-.I EXAMPLE:
-.br
-# Use Matrox driver by default.
-.br
-vo=xmga
-.br
-# I love practicing handstands while watching videos.
-.br
-flip=yes
-.br
-# Decode/\:encode multiple files from png, start with -mf on
-.br
-mf= type=png:fps=25
-
-You can also write file-specific configuration files.
-If you wish to have a config file for a file called 'movie.avi', create a file
-named 'movie.avi.conf' with the file-specific options in it and put it in
-~/.mplayer or in the same directory as the file.
-
-.SH "PLAYER OPTIONS (MPLAYER ONLY)"
-.TP
-.B \-, \-use-stdin
-Read data from stdin.
-The \-idx option does not work in conjunction with this.
-.TP
-.B \-autoq <quality> (use with \-vop pp)
-Dynamically changes the level of postprocessing depending on available spare
-CPU time.
-The number you specify will be the maximum level used.
-Usually you can use some big number.
-You have to use \-vop pp without parameters in order to use this.
-.TP
-.B \-autosync <factor>
-Gradually adjusts the A/\:V sync based on audio delay measurements.
-Specifying \-autosync\ 0, the default, will cause frame timing to be based
-entirely on audio delay measurements.
-Specifying \-autosync\ 1 will do the same, but will subtly change the A/\:V
-correction algorithm used.
-An uneven video frame rate in a movie which plays fine with \-nosound can
-often be helped by setting this to an integer value greater than 1.
-The higher the value, the closer the timing will be to -nosound.
-Try \-autosync\ 30 to smooth out problems with sound drivers which do
-not implement a perfect audio delay measurement.
-With this value, if large A/\:V sync offsets occur, they will only take about
-1 or 2\ seconds to settle out.
-This delay in reaction time to sudden A/\:V offsets should be the only
-side-effect of turning this option on, for all sound drivers.
-.TP
-.B \-benchmark
-Prints some statistics on CPU usage and dropped frames at the end.
-Use in combination with \-nosound and \-vo null for benchmarking only the
-video codec.
-.TP
-.B \-edl <filename>
-Enables edit decision list (EDL) actions during playback.
-Video will be skipped over and audio will be muted and unmuted according to
-the entries in the given file.
-See DOCS/documentation.html#edl for details on how to use this.
-.TP
-.B \-edlout <filename>
-Creates a new file and writes edit decision list (EDL) records to that file.
-During playback, when the user hits 'i', an entry to skip over the last two
-seconds of playback will be written to the file.
-This provides a starting point from which the user can fine-tune EDL entries
-later.
-See DOCS/documentation.html#edl for details.
-.TP
-.B \-enqueue (GUI only)
-Enqueue files given on the command line in the playlist instead of playing them
-immediately.
-.TP
-.B \-fixed-vo (BETA CODE!)
-Enforces a fixed video system for multiple files (one (un)initialisation for
-all files).
-Therefore only one window will be opened for all files.
-Currently the following drivers are fixed-vo compliant: x11, xv, xvidix, xmga,
-gl2, and svga.
-.TP
-.B \-framedrop (also see \-hardframedrop)
-Skip displaying some frames to maintain A/\:V sync on slow systems.
-Video filters are not applied to such frames.
-For B frames even decoding is skipped completely.
-.TP
-.B \-h, \-help, \-\-help
-Show short summary of options.
-.TP
-.B \-hardframedrop
-More intense frame dropping (breaks decoding).
-Leads to image distortion!
-.TP
-.B \-identify
-Show file parameters in easy parsable format.
-The wrapper script TOOLS/midentify suppresses the other mplayer output and
-(hopefully) shellescapes the filenames.
-.TP
-.B \-input <commands>
-This option can be used to configure certain parts of the input system.
-Paths are relative to ~/\:.mplayer/.
-
-.I NOTE:
-.br
-Autorepeat is currently only supported by joysticks.
-.br
-Available commands are:
-
-.PD 0
-.RSs
-.IPs conf=<file>
-Read alternative input.conf.
-If given without pathname, ~/\:.mplayer is assumed.
-.IPs ar\-delay
-Delay in msec before we start to autorepeat a key (0 to disable).
-.IPs ar\-rate
-How many key presses per second when we autorepeat.
-.IPs keylist
-Prints all keys that can be bound.
-.IPs cmdlist
-Prints all commands that can be bound.
-.IPs js\-dev
-Specifies the joystick device to use (default is /dev/\:input/\:js0).
-.IPs file
-Read commands from the given file.
-Mostly useful with a fifo.
-.RE
-.PD 1
-.
-.TP
-.B \-lircconf <file>
-Specifies a configuration file for LIRC (Linux Infrared Remote Control, see
-http://www.lirc.org) if you don't like the default ~/\:.lircrc.
-.TP
-.B \-loop <number>
-Loops movie playback <number> times.
-0 means forever.
-.TP
-.B \-menu (BETA CODE)
-Turn on OSD menu support.
-.TP
-.B \-menu-root <value> (BETA CODE)
-Specify the main menu.
-.TP
-.B \-menu-cfg <file> (BETA CODE)
-Use an alternative menu.conf.
-.TP
-.B \-nojoystick
-Turns off joystick support.
-Default is on, if compiled in.
-.TP
-.B \-nolirc
-Turns off LIRC support.
-.TP
-.B \-nortc \ \
-Turns off usage of the Linux RTC (real-time clock \- /dev/\:rtc) as timing
-mechanism.
-.TP
-.B \-playlist <file>
-Play files according to a playlist (1 file per row or Winamp or ASX format).
-.TP
-.B \-quiet \ \
-Display less output and status messages.
-.TP
-.B \-really\-quiet \ \
-Display even less output and status messages.
-.TP
-.B \-sdp
-Specifies that the input file is a SDP ('Session Description Protocol')
-file that describes an RTP session (see http://www.live.com/mplayer/).
-.TP
-.B \-shuffle \ \
-Play files in random order.
-.TP
-.B \-skin <skin\ directory> (BETA CODE)
-Load skin from the given directory (WITHOUT path name).
-
-.I EXAMPLE:
-.PD 0
-.RSs
-.IPs "\-skin fittyfene"
-tries Skin/fittyfene.
-It first checks
-/usr/local/share/mplayer/
-and afterwards ~/.mplayer/.
-.RE
-.PD 1
-.
-.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.
-The section
-.B SLAVE MODE PROTOCOL
-explains the syntax.
-.TP
-.B \-softsleep
-Uses high quality software timers.
-As precise as the RTC without requiring special privileges.
-Comes at the price of higher CPU consumption.
-.TP
-.B \-speed <0.01\-100>
-Set playback speed rate.
-.TP
-.B \-sstep <sec>
-Specifies seconds between displayed frames.
-Useful for slideshows.
-
-
-.SH "DEMUXER/STREAM OPTIONS"
-.TP
-.B \-aid <id> (also see \-alang option)
-Select audio channel [MPEG: 0\-31 AVI/\:OGM: 1\-99 ASF/\:RM: 0\-127
-VOB(AC3): 128\-159 VOB(LPCM): 160\-191]
-MPlayer prints the available IDs when running in verbose (-v) mode.
-.TP
-.B \-alang <two letter\ country\ code> (also see \-aid option)
-Works only for DVD playback.
-It selects the DVD audio language and always tries to play audio streams whose
-language matches the given code.
-For the list of available languages, use with the \-v option and look at the
-output.
-
-.I EXAMPLE:
-.PD 0
-.RSs
-.IPs "\-alang hu,en"
-Plays Hungarian and falls back to English if Hungarian is not available.
-.RE
-.PD 1
-.
-.TP
-.B \-audio\-demuxer <number> (\-audiofile only)
-Force audio demuxer type for \-audiofile.
-Give the demuxer ID as defined in demuxers.h.
-Use \-audio\-demuxer 17 to force .mp3 detection.
-.TP
-.B \-audiofile <filename>
-Play audio from an external file (WAV, MP3 or Ogg Vorbis) while viewing a
-movie.
-.TP
-.B \-bandwidth <value>
-Specify the maximum bandwidth for network streaming (for servers that are
-able to send content in different bitrates).
-Usefull if you want to watch live streamed media behind a slow connection.
-.TP
-.B \-cdrom\-device <path\ to\ device>
-Override default CDROM drive name /dev/\:cdrom.
-.TP
-.B \-cache <kbytes>
-This option specifies how much memory (in kbytes) to use when precaching a
-file/\:URL.
-Especially useful on slow media (default is \-nocache).
-.TP
-.B \-cdda <option1:option2>
-This option can be used to tune the CD Audio reading feature of MPlayer.
-.br
-Available options are:
-.
-.RSs
-.IPs speed=<value>
-set CD spin speed
-.IPs paranoia=<0\-2>
-set paranoia level
-.RSss
-0: disable checking
-.br
-1: overlap checking only (default)
-.br
-2: full data correction and verification
-.REss
-.IPs generic-dev=<value>
-use specified generic SCSI device
-.IPs sector-size=<value>
-atomic read size
-.IPs overlap=<value>
-force minimum overlap search during verification to <value> sectors.
-.IPs toc-bias
-Assume that the beginning offset of track 1 as reported in the TOC will be
-addressed as LBA\ 0.
-Some Toshiba drives need this for getting track boundaries correct.
-.IPs toc-offset=<value>
-Add <value> sectors to the values reported when addressing tracks.
-May be negative.
-.IPs (no)skip
-(never) accept imperfect data reconstruction.
-.RE
-.
-.TP
-.B \-channels <number>
-Change the number of playback channels, defaults to '2' if not specified.
-If the number of output channels is bigger than the number of input channels
-empty channels are inserted (unless mixing from mono to stereo, then the mono
-channel is repeated in both output channels).
-If the number of output channels is smaller than the number of input channels,
-results depend on the audio decoder (\-afm).
-MPlayer asks the decoder to decode the audio into as many channels as
-specified.
-Now it's up to the decoder to fulfill the requirement.
-If the decoder outputs more channels than requested, the exceeding channels
-are truncated.
-This is usually only important when playing videos with AC3 audio (like DVDs).
-In that case liba52 does the decoding by default and correctly downmixes the
-audio into the requested number of channels.
-
-.I NOTE:
-.br
-This option is honored by codecs (AC3 only) filters (surround) and ao drivers
-(OSS at least).
-.br
-Available options are:
-
-.PD 0
-.RSs
-.IPs 2
-Stereo
-.IPs 4
-Surround
-.IPs 6
-Full 5.1
-.RE
-.PD 1
-.
-.TP
-.B \-chapter <chapter\ id>[-<end\ chapter\ id>]
-Specify which chapter to start playing at.
-Optionally specify which chapter to end playing at (default: 1).
-Examples can be found below.
-.TP
-.B \-csslib <filename>
-(old-style DVD option) This option is used to override the default location of
-libcss.so.
-.TP
-.B \-cuefile <filename> (see \-vcd too)
-Play (S)VCD from CDRwin's (bin/cue fileformat) disk image, described by the
-specified file.
-.TP
-.B \-demuxer <number>
-Force demuxer type.
-Give the demuxer ID as defined in demuxers.h.
-Use \-demuxer 17 to force .mp3 detection.
-.TP
-.B \-dumpaudio (MPLAYER only)
-Dumps raw compressed audio stream to ./\:stream.dump (useful with mpeg/\:ac3).
-.TP
-.B \-dumpfile <filename> (MPLAYER only)
-Specify which file MPlayer should dump to.
-Should be used together with \-dumpaudio / \-dumpvideo / \-dumpstream.
-.TP
-.B \-dumpstream (MPLAYER only)
-Dumps the raw stream to ./\:stream.dump.
-Useful when ripping from DVD or network.
-.TP
-.B \-dumpvideo (MPLAYER only)
-Dump raw compressed video stream to ./\:stream.dump (not very usable).
-.TP
-.B \-dvd <title\ id>
-Tell MPlayer which movies (specified by title id) to play.
-For example sometimes '1' is a trailer, and '2' is the real movie.
-
-.I NOTE:
-.br
-Sometimes deinterlacing is required for DVD playback,
-see the \-vop pp=0x20000 option.
-.TP
-.B \-dvd\-device <path\ to\ device>
-Override default DVD device name /dev/\:dvd.
-.TP
-.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 (default: 1).
-Examples can be found below.
-.TP
-.B \-dvdauth <DVD\ device>
-(old-style DVD option) Turns on DVD authentication using the given device.
-.TP
-.B \-dvdkey <CSS\ key>
-(old-style DVD option) When decoding a VOB file copied undecrypted from DVD,
-this option gives the CSS key needed to decrypt the VOB (the key is printed
-when authenticating with the DVD drive using \-dvdauth).
-.TP
-.B \-dvdnav (BETA CODE!)
-Force usage of libdvdnav.
-.TP
-.B \-forceidx
-Force rebuilding of INDEX.
-Useful for files with broken index (desyncs, etc).
-Seeking will be possible.
-You can fix the index permanently with MEncoder (see the documentation).
-.TP
-.B \-fps <value>
-Override video framerate (if value is wrong/\:missing in the header) (float
-number).
-.TP
-.B \-frames <number>
-Play/\:convert only first <number> frames, then quit.
-.TP
-.B \-hr\-mp3\-seek (.MP3 only)
-Hi\-res mp3 seeking.
-Default is: enabled when playing from external MP3 file, as we need to seek
-to the very exact position to keep A/\:V sync. It can be slow especially when
-seeking backwards \- it has to rewind to the beginning to find the exact
-frame.
-.TP
-.B \-idx (also see \-forceidx)
-Rebuilds INDEX of the AVI if no INDEX was found,
-thus allowing seeking.
-Useful with broken/\:incomplete downloads, or badly created AVIs.
-.TP
-.B \-mc <seconds/frame>
-Maximum A-V sync correction per frame (in seconds).
-.TP
-.B \-mf <option1:option2:...>
-Used when decoding from multiple PNG or JPEG files.
-.br
-Available options are:
-
-.PD 0
-.RSs
-.IPs on\ \ \
-turns on multifile support
-.IPs w=<value>
-width of the output (autodetect)
-.IPs h=<value>
-height of the output (autodetect)
-.IPs fps=<value>
-fps of the output (default: 25)
-.IPs type=<value>
-type of input files (available types: jpeg, png, tga)
-.RE
-.PD 1
-.
-.TP
-.B \-ni (.AVI only)
-Force usage of non\-interleaved AVI parser (fixes playing
-of some bad AVI files).
-.TP
-.B \-nobps (.AVI only)
-Do not use average byte/\:sec value for A\-V sync (AVI).
-Helps with some AVI files with broken header.
-.TP
-.B \-noextbased
-Disables filename-extension based demuxer selection.
-By default, when file type (demuxer) cannot be detected reliably
-(the file has no header or it is not reliable enough), the filename
-extension is used to select demuxer. It always falls back to content-based
-demuxer selection.
-.TP
-.B \-passwd <password> (see \-user option too)
-Specify password for http authentication.
-.TP
-.B \-rawaudio <option1:option2:...>
-This option lets you play raw audio files.
-It may also be used to play audio CDs which are not 44KHz 16Bit stereo.
-.br
-Available options are:
-
-.PD 0
-.RSs
-.IPs on\ \ \
-use raw audio demuxer
-.IPs channels=<value>
-number of channels
-.IPs rate=<value>
-rate in samples per second
-.IPs samplesize=<value>
-sample size in byte
-.IPs format=<value>
-fourcc in hex
-.RE
-.PD 1
-.
-.TP
-.B \-rawvideo <option1:option2:...>
-This option lets you play raw video files.
-.br
-Available options are:
-
-.PD 0
-.RSs
-.IPs on\ \ \
-use raw video demuxer
-.IPs fps=<value>
-rate in frames per second, default 25.0
-.IPs sqcif|qcif|cif|4cif|pal|ntsc
-set standard image size
-.IPs w=<value>
-image width in pixels
-.IPs h=<value>
-image height in pixels
-.IPs y420|yv12|yuy2|y8
-set colorspace
-.IPs format=<value>
-colorspace (fourcc) in hex
-.IPs size=<value>
-frame size in bytes
-.RE
-.PD 1
-.
-.TP
-.B \-rtsp-stream-over-tcp
-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
-not pass incoming UDP packets (see http://www.live.com/mplayer/).
-.TP
-.B \-skipopening
-Skip DVD opening (dvdnav only).
-.TP
-.B \-sb <byte\ position> (see \-ss option too)
-Seek to byte position.
-Useful for playback from CDROM images / .VOB files with junk at the beginning.
-.TP
-.B \-srate <Hz>
-Forces the given audio playback rate, changing video speed to keep a-v sync.
-MEncoder passes this value to lame for resampling.
-.TP
-.B \-ss <time> (see \-sb option too)
-Seek to given time position.
-
-.I EXAMPLE:
-.PD 0
-.RSs
-.IPs "\-ss 56"
-seeks to 56 seconds
-.IPs "\-ss 01:10:00"
-seeks to 1\ hour 10\ min
-.RE
-.PD 1
-.
-.TP
-.B \-tv <option1:option2:...>
-This option enables the TV grabbing feature of MPlayer.
-
-.I NOTE:
-.br
-MPlayer doesn't accept colons so type dots instead in the device ID
-(e.g.\& hw.0,0 instead of hw:0,0).
-.br
-Be advised that although you can select any samplerate when using ALSA,
-the LAME audio codec is able to encode only the 'standard' samplerates.
-You'll get an .avi file with no sound when you choose an odd
-samplerate and use this codec.
-.br
-Available options are:
-.
-.RSs
-.IPs on\ \ \
-use TV input
-.IPs noaudio
-no sound
-.IPs driver=<value>
-available: dummy, v4l, bsdbt848
-.IPs device=<value>
-Specify other device than the default /dev/\:video0.
-.IPs input=<value>
-Specify other input than the default 0 (Television) (see output for a list)
-.IPs freq=<value>
-Specify the frequency to set the tuner to (e.g.\& 511.250).
-Not compatible with channels parameter.
-.IPs outfmt=<value>
-output format of the tuner (yv12, rgb32, rgb24, rgb16, rgb15, uyvy, yuy2,
-i420)
-.IPs width=<value>
-width of the output window
-.IPs height=<value>
-height of the output window
-.IPs fps=<value>
-framerate at which to capture video (frames per second)
-.IPs buffersize=<value>
-maximum size of the capture buffer in megabytes (default: dynamical)
-.IPs norm=<value>
-available: PAL, SECAM, NTSC
-.IPs channel=<value>
-Set tuner to <value> channel.
-.IPs chanlist=<value>
-available: europe-east, europe-west, us-bcast, us-cable, etc
-.IPs channels=<channel>\-<name>,<channel>\-<name>,...
-Set names for channels.
-Use _ for spaces in names (or play with quoting ;-).
-The channel names will then be written using OSD, and the commands tv_step_channel,
-tv_set_channel and tv_last_channel will then be usable using a remote (see lirc).
-Not compatible with frequency parameter.
-Warning: The channel number will then be the position in the 'channels' list,
-beginning with 1.
-Example: use tv://1, tv://2, tv_set_channel 1, tv_set_channel 2, etc.
-.IPs audiorate=<value>
-set audio capture bitrate
-.IPs forceaudio
-capture audio even if there are no audio sources reported by v4l
-.IPs alsa
-capture from ALSA
-.IPs amode=<0\-3>
-choose an audio mode:
-.RSss
-0: mono
-.br
-1: stereo
-.br
-2: language 1
-.br
-3: language 2
-.REss
-.IPs forcechan=<1\-2>
-By default, the count of recorded audio channels is determined automatically
-by querying the audio mode from the tv card.
-This option allows to force stereo/\:mono recording regardless of the amode
-option and the values returned by v4l.
-This can be used for troubleshooting when the tv card is unable to report the
-current audio mode.
-.IPs adevice=<value>
-set an audio device
-.RSss
-/dev/\:...\& for OSS
-.br
-hardware ID for ALSA
-.REss
-.IPs audioid=<value>
-choose an audio output of the capture card, if it has more of them
-.IPs "[volume|bass|treble|balance]=<0\-65535>"
-These options set parameters of the mixer on the video capture card.
-They will have no effect, if your card doesn't have one.
-.IPs immediatemode=<bool>
-A value of 0 means capture and buffer audio and video together
-(default for mencoder).
-A value of 1 (default for mplayer) means to do video capture only and let the
-audio go through a loopback cable from the TV card to the soundcard.
-.RE
-.
-.TP
-.B \-user <user name> (see \-passwd option too)
-Specify user name for http authentication.
-.TP
-.B \-vcd <track>
-Play video CD track from a device or image file (see \-cuefile).
-.TP
-.B \-vid <id>
-Select video channel [MPG: 0\-15 ASF: 0\-255].
-.TP
-.B \-vivo <sub\-options> (DEBUG CODE)
-Force audio parameters for the .vivo demuxer (for debugging purposes).
-
-
-.SH "OSD/SUB OPTIONS"
-.I NOTE:
-.br
-See \-vop expand too.
-.TP
-.B \-dumpmicrodvdsub (MPLAYER only)
-Convert the given subtitle (specified with the \-sub option) to the
-MicroDVD subtitle format.
-Creates a dumpsub.sub file in the current directory.
-.TP
-.B \-dumpmpsub (MPLAYER only)
-Convert the given subtitle (specified with the \-sub option) to MPlayer's
-subtitle format, MPsub.
-Creates a dump.mpsub file in the current directory.
-.TP
-.B \-dumpsrtsub (MPLAYER only)
-Convert the given subtitle (specified with the \-sub option) to the time-based
-SubViewer (SRT) subtitle format.
-Creates a dumpsub.srt file in the current directory.
-.TP
-.B \-dumpjacosub (MPLAYER only)
-Convert the given subtitle (specified with the \-sub option) to the time-based
-JACOsub subtitle format.
-Creates a dumpsub.js file in the current directory.
-.TP
-.B \-dumpsami (MPLAYER only)
-Convert the given subtitle (specified with the \-sub option) to the time-based
-SAMI subtitle format.
-Creates a dumpsub.smi file in the current directory.
-.TP
-.B \-dumpsub (MPLAYER only) (BETA CODE)
-Dumps the subtitle substream from VOB streams.
-See -dump*sub and -vobsubout* options too.
-.TP
-.B \-ifo <vobsub\ ifo\ file>
-Indicate the file that will be used to load palette and frame size for VOBSUB
-subtitles.
-.TP
-.B \-ffactor <number>
-Resample alphamap of the font.
-Can be:
-
-.PD 0
-.RSs
-.IPs 0\ \ \ \
-plain white fonts
-.IPs 0.75\ \
-very narrow black outline (default)
-.IPs 1\ \ \ \
-narrow black outline
-.IPs 10\ \ \
-bold black outline
-.RE
-.PD 1
-.
-.TP
-.B \-font <path\ to\ font.desc\ file>
-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).
-
-.I NOTE:
-.br
-With FreeType, this option determines path to the text font file.
-.br
-The \-subfont-* options are available only with FreeType support compiled in.
-
-.I EXAMPLE:
-.PD 0
-.RSs
-\-font ~/\:.mplayer/\:arial\-14/\:font.desc
-.br
-\-font ~/\:.mplayer/\:arialuni.ttf
-.RE
-.PD 1
-.
-.TP
-.B \-noautosub
-Turns off automatic loading of subtitle files.
-.TP
-.B \-overlapsub
-Enables overlapping subtitles support for all subtitles formats.
-.TP
-.B \-nooverlapsub
-Disables overlapping subtitles support for all subtitles formats (default
-behaviour is to enable the support only for specific formats).
-.TP
-.B \-osdlevel <0\-3> (MPLAYER only)
-Specifies which mode the OSD should start in.
-
-.PD 0
-.RSs
-.IPs 0
-subtitles only
-.IPs 1
-volume + seek (default)
-.IPs 2
-volume + seek + timer + percentage
-.IPs 3
-volume + seek + timer + percentage + total time
-.RE
-.PD 1
-.
-.TP
-.B \-sid <id> (also see \-slang option)
-Turns on DVD subtitle displaying.
-Also, you MUST specify a number which corresponds to a DVD subtitle language
-(0\-31).
-For the list of available subtitles, use with the \-v option and look at the
-output.
-.TP
-.B \-slang <two\ letter\ country\ code> (also see \-sid option)
-Works only for DVD playback.
-Turns on/\:selects DVD subtitle language.
-For the list of available subtitles, use with the \-v option and look at the
-output.
-
-.I EXAMPLE:
-.PD 0
-.RSs
-.IPs "\-slang hu,en"
-Selects Hungarian and falls back to English if Hungarian is not available.
-.RE
-.PD 1
-.
-.TP
-.B \-sub <subtitle\ file>
-Use/\:display this subtitle file.
-.TP
-.B \-sub-bg-alpha <0\-255>
-Specify the alpha channel value for subtitles and OSD backgrounds.
-Big values mean more transparency.
-The 0 value is an exception and means completly transparent.
-.TP
-.B \-sub-bg-color <0\-255>
-Specify the color value for subtitles and OSD backgrounds.
-Currently subtitles are grayscale so this value is equivalente to the
-intensity of the color.
-The 255 value means white and 0 black.
-.TP
-.B \-subcc \
-Display DVD Closed Caption (CC) subtitles.
-These are NOT the VOB subtitles, these are special ASCII subtitles for the
-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>
-If your system supports iconv(3), you can use this option to
-specify codepage of the subtitle.
-
-.I EXAMPLE:
-.PD 0
-.RSs
-\-subcp latin2
-.br
-\-subcp cp1250
-.RE
-.PD 1
-.
-.TP
-.B \-sub\-demuxer <number> (BETA CODE)
-Force subtitle demuxer type for \-subfile.
-.TP
-.B \-subdelay <sec>
-Delays subtitles by <sec> seconds.
-Can be negative.
-.TP
-.B \-subfont-autoscale <0\-3>
-Sets the autoscale mode.
-
-.I NOTE:
-.br
-Zero means that text-scale and osd-scale are font heights in points.
-.br
-The mode can be:
-
-.PD 0
-.RSs
-.IPs 0
-no autoscale
-.IPs 1
-proportional to movie height
-.IPs 2
-proportional to movie width
-.IPs 3
-proportional to movie diagonal (default)
-.RE
-.PD 1
-.
-.TP
-.B \-subfont-blur <0\-8>
-Sets the font blur radius (default: 2).
-.TP
-.B \-subfont-encoding <value>
-Sets the font encoding.
-When set to 'unicode', all the glyphs from the font file will be rendered and
-unicode will be used (default: unicode).
-.TP
-.B \-subfont-osd-scale <0\-100>
-Sets the osd elements autoscale coefficient (default: 6).
-.TP
-.B \-subfont-outline <0\-8>
-Sets the font outline thickness (default: 2).
-.TP
-.B \-subfont-text-scale <0\-100>
-Sets the subtitle text autoscale coefficient (percentage of the
-screen size) (default: 5).
-.TP
-.B \-subfps <rate>
-Specify frame/\:sec rate of subtitle file (float number),
-default: the same fps as the movie.
-
-.I NOTE:
-.br
-ONLY for frame\-based SUB files, i.e.\& NOT MicroDVD format.
-.TP
-.B \-subfile <filename> (BETA CODE)
-Currently useless.
-Same as \-audiofile, but for subtitle streams (OggDS?).
-.TP
-.B \-subpos <0\-100> (useful with \-vop expand)
-Specify the position of subtitles on the screen.
-The value is the vertical position of the subtitle in % of the screen height.
-.TP
-.B \-subalign <0\-2>
-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
-.B \-subwidth <10\-100>
-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.
-.TP
-.B \-unicode
-Tells MPlayer to handle the subtitle file as UNICODE.
-.TP
-.B \-utf8 \ \
-Tells MPlayer to handle the subtitle file as UTF8.
-.TP
-.B \-sub-no-text-pp
-Disables any kind of text post processing done after loading the subtitles.
-Used for debug purposes.
-.TP
-.B \-vobsub <vobsub\ file\ without\ extension>
-Specify the VobSub files that are to be used for subtitle.
-This is the full pathname without extensions, i.e.\& without the '.idx',
-\'.ifo' or '.sub'.
-.TP
-.B \-vobsubid <0-31>
-Specify the VobSub subtitle id.
-.TP
-.B \-spualign <-1\-2>
-Specify how spu (DVD/VobSub) subtitles should be aligned.
-Values are the same as for -subpos, with the extra choice -1 for original
-position.
-.TP
-.B \-spuaa <mode>
-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 smooth subtitles with the gaussian
-blur. The available modes are:
-.PD 0
-.RSs
-.IPs 0
-none (fastest, very ugly)