mplayer.1

uclinux下mplayer的源码

.
.TP
.B \-menu\-chroot <path> (OSD menu only)
Chroot the file selection menu to a specific location.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
.IPs "\-menu\-chroot /home"
Will restrict the file selection menu to /\:home and downward (i.e.\& no
access to / will be possible, but /home/user_name will).
.RE
.PD 1
.
.TP
.B \-menu\-keepdir (OSD menu only)
File browser starts from the last known location instead of current directory.
.
.TP
.B \-menu\-root <value> (OSD menu only)
Specify the main menu.
.
.TP
.B \-menu\-startup (OSD menu only)
Display the main menu at MPlayer startup.
.
.TP
.B \-mouse\-movements
Permit MPlayer to receive pointer events reported by the video
output driver (currently only derivatives of X11 are supported).
Necessary to select the buttons in DVD menus.
.
.TP
.B \-noconsolecontrols
Prevent MPlayer from reading key events from standard input.
Useful when reading data from standard input.
This is automatically enabled when \- is found on the command line.
There are situations where you have to set it manually, e.g.\&
if you open /dev/\:stdin (or the equivalent on your system), use stdin
in a playlist or intend to read from stdin later on via the loadfile or
loadlist slave commands.
.
.TP
.B \-nojoystick
Turns off joystick support.
.
.TP
.B \-nolirc
Turns off LIRC support.
.
.TP
.B \-nomouseinput
Disable mouse button press/\:release input (mozplayerxp's context menu relies
on this option).
.
.TP
.B \-rtc (RTC only)
Turns on usage of the Linux RTC (realtime clock \- /dev/\:rtc) as timing
mechanism.
This wakes up the process every 1/1024 seconds to check the current time.
Useless with modern Linux kernels configured for desktop use as they already
wake up the process with similar accuracy when using normal timed sleep.
.
.TP
.B \-playing\-msg <string>
Print out a string before starting playback.
The following expansions are supported:
.RSs
.IPs ${NAME}
Expand to the value of the property NAME.
.IPs $(NAME:TEXT)
Expand TEXT only if the property NAME is available.
.RE
.
.TP
.B \-playlist <filename>
Play files according to a playlist file (ASX, Winamp, SMIL, or
one-file-per-line format).
.br
.I NOTE:
This option is considered an entry so options found after it will apply
only to the elements of this playlist.
.br
FIXME: This needs to be clarified and documented thoroughly.
.
.TP
.B \-rtc\-device <device>
Use the specified device for RTC timing.
.
.TP
.B \-shuffle
Play files in random order.
.
.TP
.B \-skin <name> (GUI only)
Loads a skin from the directory given as parameter below the default skin
directories, /usr/\:local/\:share/\:mplayer/\:skins/\: and ~/.mplayer/\:skins/.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
.IPs "\-skin fittyfene"
Tries /usr/\:local/\:share/\:mplayer/\:skins/\:fittyfene
and afterwards ~/.mplayer/\:skins/\:fittyfene.
.RE
.PD 1
.
.TP
.B \-slave (also see \-input)
Switches on slave mode, in which MPlayer works as a backend for other programs.
Instead of intercepting keyboard events, MPlayer will read commands separated
by a newline (\\n) from stdin.
.br
.I NOTE:
See \-input cmdlist for a list of slave commands and DOCS/tech/slave.txt
for their description.
.
.TP
.B \-softsleep
Time frames by repeatedly checking the current time instead of asking the
kernel to wake up MPlayer at the correct time.
Useful if your kernel timing is imprecise and you cannot use the RTC either.
Comes at the price of higher CPU consumption.
.
.TP
.B \-sstep <sec>
Skip <sec> seconds after every frame.
The normal framerate of the movie is kept, so playback is accelerated.
Since MPlayer can only seek to the next keyframe this may be inexact.
.
.
.
.SH "DEMUXER/STREAM OPTIONS"
.
.TP
.B \-a52drc <level>
Select the Dynamic Range Compression level for AC-3 audio streams.
<level> is a float value ranging from 0 to 1, where 0 means no compression
and 1 (which is the default) means full compression (make loud passages more
silent and vice versa).
This option only shows an effect if the AC-3 stream contains the required range
compression information.
.
.TP
.B \-aid <ID> (also see \-alang)
Select audio channel (MPEG: 0\-31, AVI/\:OGM: 1\-99, ASF/\:RM: 0\-127,
VOB(AC-3): 128\-159, VOB(LPCM): 160\-191, MPEG-TS 17\-8190).
MPlayer prints the available audio IDs when run in verbose (\-v) mode.
When playing an MPEG-TS stream, MPlayer/\:MEncoder will use the first program
(if present) with the chosen audio stream.
.
.TP
.B \-alang <language code[,language code,...]> (also see \-aid)
Specify a priority list of audio languages to use.
Different container formats employ different language codes.
DVDs use ISO 639-1 two letter language codes, Matroska, MPEG-TS and NUT
use ISO 639-2 three letter language codes while OGM uses a free-form identifier.
MPlayer prints the available languages when run in verbose (\-v) mode.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
.IPs "mplayer dvd://1 \-alang hu,en"
Chooses the Hungarian language track on a DVD and falls back on English if
Hungarian is not available.
.IPs "mplayer \-alang jpn example.mkv"
Plays a Matroska file in Japanese.
.RE
.PD 1
.
.TP
.B \-audio\-demuxer <[+]name> (\-audiofile only)
Force audio demuxer type for \-audiofile.
Use a '+' before the name to force it, this will skip some checks!
Give the demuxer name as printed by \-audio\-demuxer help.
For backward compatibility it also accepts the demuxer ID as defined in
libmpdemux/\:demuxer.h.
\-audio\-demuxer audio or \-audio\-demuxer 17 forces MP3.
.
.TP
.B \-audiofile <filename>
Play audio from an external file (WAV, MP3 or Ogg Vorbis) while viewing a
movie.
.
.TP
.B \-audiofile\-cache <kBytes>
Enables caching for the stream used by \-audiofile, using the specified
amount of memory.
.
.TP
.B \-reuse\-socket (udp:// only)
Allows a socket to be reused by other processes as soon as it is closed.
.
.TP
.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.
With Real RTSP streaming, it is also used to set the maximum delivery
bandwidth allowing faster cache filling and stream dumping.
.
.TP
.B \-cache <kBytes>
This option specifies how much memory (in kBytes) to use when precaching a
file or URL.
Especially useful on slow media.
.
.TP
.B \-nocache
Turns off caching.
.
.TP
.B \-cache\-min <percentage>
Playback will start when the cache has been filled up to <percentage>
of the total.
.
.TP
.B \-cache\-seek\-min <percentage>
If a seek is to be made to a position within <percentage> of the cache size
from the current position, MPlayer will wait for the cache to be filled to
this position rather than performing a stream seek (default: 50).
.
.TP
.B \-cdda <option1:option2> (CDDA only)
This option can be used to tune the CD Audio reading feature of MPlayer.
.sp 1
Available options are:
.RSs
.IPs speed=<value>
Set CD spin speed.
.IPs paranoia=<0\-2>
Set paranoia level.
Values other than 0 seem to break playback of anything but the first track.
.RSss
0: disable checking (default)
.br
1: overlap checking only
.br
2: full data correction and verification
.REss
.IPs generic-dev=<value>
Use specified generic SCSI device.
.IPs sector-size=<value>
Set 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 \-cdrom\-device <path to device>
Specify the CD-ROM device (default: /dev/\:cdrom).
.
.TP
.B \-channels <number> (also see \-af channels)
Request the number of playback channels (default: 2).
MPlayer asks the decoder to decode the audio into as many channels as
specified.
Then it is up to the decoder to fulfill the requirement.
This is usually only important when playing videos with AC-3 audio (like DVDs).
In that case liba52 does the decoding by default and correctly downmixes the
audio into the requested number of channels.
To directly control the number of output channels independently of how many
channels are decoded, use the channels filter.
.br
.I NOTE:
This option is honored by codecs (AC-3 only), filters (surround) and audio
output drivers (OSS at least).
.sp 1
Available options are:
.sp 1
.PD 0
.RSs
.IPs 2
stereo
.IPs 4
surround
.IPs 6
full 5.1
.RE
.PD 1
.
.TP
.B \-chapter <chapter ID>[\-<endchapter ID>] (dvd:// and dvdnav:// only)
Specify which chapter to start playing at.
Optionally specify which chapter to end playing at (default: 1).
.
.TP
.B \-cookies (network only)
Send cookies when making HTTP requests.
.
.TP
.B \-cookies\-file <filename> (network only)
Read HTTP cookies from <filename> (default: ~/.mozilla/ and ~/.netscape/)
and skip reading from default locations.
The file is assumed to be in Netscape format.
.
.TP
.B \-delay <sec>
audio delay in seconds (positive or negative float value)
.br
Negative values delay the audio, and positive values delay the video.
Note that this is the exact opposite of the \-audio\-delay MEncoder option.
.br
.I NOTE:
When used with MEncoder, this is not guaranteed to work correctly
with \-ovc copy; use \-audio\-delay instead.
.
.TP
.B \-ignore\-start
Ignore the specified starting time for streams in AVI files.
In MPlayer, this nullifies stream delays in files encoded with
the \-audio\-delay option.
During encoding, this option prevents MEncoder from transferring
original stream start times to the new file; the \-audio\-delay option is
not affected.
Note that MEncoder sometimes adjusts stream starting times
automatically to compensate for anticipated decoding delays, so do not
use this option for encoding without testing it first.
.
.TP
.B \-demuxer <[+]name>
Force demuxer type.
Use a '+' before the name to force it, this will skip some checks!
Give the demuxer name as printed by \-demuxer help.
For backward compatibility it also accepts the demuxer ID as defined in
libmpdemux/\:demuxer.h.
.
.TP
.B \-dumpaudio (MPlayer only)
Dumps raw compressed audio stream to ./stream.dump (useful with MPEG/\:AC-3,
in most other cases the resulting file will not be playable).
If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
on the command line only the last one will work.
.
.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.
If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
on the command line only the last one will work.
.
.TP
.B \-dumpvideo (MPlayer only)
Dump raw compressed video stream to ./stream.dump (not very usable).
If you give more than one of \-dumpaudio, \-dumpvideo, \-dumpstream
on the command line only the last one will work.
.
.TP
.B \-dvbin <options> (DVB only)
Pass the following parameters to the DVB input module, in order to override
the default ones:
.sp 1
.PD 0
.RSs
.IPs card=<1\-4>
Specifies using card number 1\-4 (default: 1).
.IPs file=<filename>
Instructs MPlayer to read the channels list from <filename>.
Default is ~/.mplayer/\:channels.conf.{sat,ter,cbl,atsc} (based on your card type)
or ~/.mplayer/\:channels.conf as a last resort.
.IPs timeout=<1\-30>
Maximum number of seconds to wait when trying to tune a
frequency before giving up (default: 30).
.RE
.PD 1
.
.TP
.B \-dvd\-device <path to device> (DVD only)
Specify the DVD device (default: /dev/\:dvd).
You can also specify a directory that contains files previously copied directly
from a DVD (with e.g.\& vobcopy).
Note that using \-dumpstream is usually a better way to
copy DVD titles in the first place (see the examples).
.
.TP
.B \-dvd\-speed <factor or speed in KB/s> (DVD only)
Try to limit DVD speed (default: 0, no change).
DVD base speed is about 1350KB/s, so a 8x drive can read at speeds up to
10800KB/s.
Slower speeds make the drive more quiet, for watching DVDs 2700KB/s should be
quiet and fast enough.
MPlayer resets the speed to the drive default value on close.
Values less than 100 mean multiples of 1350KB/s, i.e.\& \-dvd\-speed 8 selects
10800KB/s.
.br
.I NOTE:
You need write access to the DVD device to change the speed.
.
.TP
.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).
.
.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 http://www.mplayerhq.hu/\:DOCS/\:HTML/\:en/\:edl.html for details
on how to use this.
.
.TP
.B \-endpos <[[hh:]mm:]ss[.ms]|size[b|kb|mb]> (also see \-ss and \-sb)
Stop at given time or byte position.
.br
.I NOTE:
Byte position is enabled only for MEncoder and will not be accurate, as it can
only stop at a frame boundary.
When used in conjunction with \-ss option, \-endpos time will shift forward by
seconds specified with \-ss.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
.IPs "\-endpos 56"
Stop at 56 seconds.
.IPs "\-endpos 01:10:00"
Stop at 1 hour 10 minutes.
.IPs "\-ss 10 \-endpos 56"
Stop at 1 minute 6 seconds.
.IPs "\-endpos 100mb"
Encode only 100 MB.
.RE
.PD 1
.
.TP
.B \-forceidx
Force index rebuilding.
Useful for files with broken index (A/V desync, etc).
This will enable seeking in files where seeking was not possible.
You can fix the index permanently with MEncoder (see the documentation).
.br
.I NOTE:
This option only works if the underlying media supports seeking
(i.e.\& not with stdin, pipe, etc).
.
.TP
.B \-fps <float value>
Override video framerate.
Useful if the original value is wrong or missing.
.
.TP
.B \-frames <number>
Play/\:convert only first <number> frames, then quit.
.
.TP