mplayer.1

uclinux下mplayer的源码

This option allows forcing 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.
<value> should be /dev/\:xxx for OSS and a hardware ID for ALSA.
You must replace any ':' by a '.' in the hardware ID for ALSA.
.IPs audioid=<value>
Choose an audio output of the capture card, if it has more than one.
.IPs "[volume|bass|treble|balance]=<0\-65535> (v4l1)"
.IPs "[volume|bass|treble|balance]=<0\-100> (v4l2)"
These options set parameters of the mixer on the video capture card.
They will have no effect, if your card does not have one.
For v4l2 50 maps to the default value of the
control, as reported by the driver.
.IPs "gain=<0\-100> (v4l2)"
Set gain control for video devices (usually webcams) to the desired
value and switch off automatic control.
A value of 0 enables automatic control.
If this option is omitted, gain control will not be modified.
.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 sound card.
.IPs mjpeg
Use hardware MJPEG compression (if the card supports it).
When using this option, you do not need to specify the width and height
of the output window, because MPlayer will determine it automatically
from the decimation value (see below).
.IPs decimation=<1|2|4>
choose the size of the picture that will be compressed by hardware
MJPEG compression:
.RSss
1: full size
    704x576    PAL
    704x480    NTSC
.br
2: medium size
    352x288    PAL
    352x240    NTSC
.br
4: small size
    176x144    PAL
    176x120    NTSC
.REss
.IPs quality=<0\-100>
Choose the quality of the JPEG compression
(< 60 recommended for full size).
.IPs tdevice=<value>
Specify TV teletext device (example: /dev/\:vbi0) (default: none).
.IPs tformat=<format>
Specify TV teletext display format (default: 0):
.RSss
0: opaque
.br
1: transparent
.br
2: opaque with inverted colors
.br
3: transparent with inverted colors
.REss
.IPs tpage=<100\-899>
Specify initial TV teletext page number (default: 100).
.IPs tlang=<\-1\-127>
Specify default teletext language code (default: 0), which will be used
as primary language until a type 28 packet is received.
Useful when the teletext system uses a non-latin character set, but language
codes are not transmitted via teletext type 28 packets for some reason.
To see a list of supported language codes set this option to \-1.
.IPs "hidden_video_renderer (dshow only)"
Terminate stream with video renderer instead of Null renderer (default: off).
Will help if video freezes but audio does not.
.I NOTE:
May not work with \-vo directx and \-vf crop combination.
.IPs "hidden_vp_renderer (dshow only)"
Terminate VideoPort pin stream with video renderer 
instead of removing it from the graph (default: off).
Useful if your card has a VideoPort pin and video is choppy.
.I NOTE:
May not work with \-vo directx and \-vf crop combination.
.IPs "system_clock (dshow only)"
Use the system clock as sync source instead of the default graph clock
(usually the clock from one of the live sources in graph).
.IPs "normalize_audio_chunks (dshow only)"
Create audio chunks with a time length equal to
video frame time length (default: off).
Some audio cards create audio chunks about 0.5s in size, resulting in
choppy video when using immediatemode=0.
.RE
.
.TP
.B \-tvscan <option1:option2:...> (TV and MPlayer only)
Tune the TV channel scanner.
MPlayer will also print value for "-tv channels=" option,
including existing and just found channels.
.sp 1
Available suboptions are:
.RSs
.IPs autostart
Begin channel scanning immediately after startup (default: disabled).
.IPs period=<0.1\-2.0>
Specify delay in seconds before switching to next channel (default: 0.5).
Lower values will cause faster scanning, but can detect
inactive TV channels as active.
.IPs threshold=<1\-100>
Threshold value for the signal strength (in percent), as reported
by the device (default: 50).
A signal strength higher than this value will indicate that the
currently scanning channel is active.
.RE
.
.TP
.B \-user <username> (also see \-passwd) (network only)
Specify username for HTTP authentication.
.
.TP
.B \-user\-agent <string>
Use <string> as user agent for HTTP streaming.
.
.TP
.B \-vid <ID>
Select video channel (MPG: 0\-15, ASF: 0\-255, MPEG-TS: 17\-8190).
When playing an MPEG-TS stream, MPlayer/\:MEncoder will use the first program
(if present) with the chosen video stream.
.
.TP
.B \-vivo <suboption> (DEBUG CODE)
Force audio parameters for the VIVO demuxer (for debugging purposes).
FIXME: Document this.
.
.
.
.SH "OSD/SUBTITLE OPTIONS"
.I NOTE:
Also see \-vf expand.
.
.TP
.B \-ass (FreeType only)
Turn on SSA/ASS subtitle rendering.
With this option, libass will be used for SSA/ASS
external subtitles and Matroska tracks.
You may also want to use \-embeddedfonts.
.
.TP
.B \-ass\-border\-color <value>
Sets the border (outline) color for text subtitles.
The color format is RRGGBBAA.
.
.TP
.B \-ass\-bottom\-margin <value>
Adds a black band at the bottom of the frame.
The SSA/ASS renderer can place subtitles there (with \-ass\-use\-margins).
.
.TP
.B \-ass\-color <value>
Sets the color for text subtitles.
The color format is RRGGBBAA.
.
.TP
.B \-ass\-font\-scale <value>
Set the scale coefficient to be used for fonts in the SSA/ASS renderer.
.
.TP
.B \-ass\-force\-style <[Style.]Param=Value[,...]>
Override some style parameters.
.sp
.I EXAMPLE:
.PD 0
.RSs
\-ass\-force\-style FontName=Arial,Default.Bold=1
.RE
.PD 1
.
.TP
.B \-ass\-hinting <type>
Set hinting type.
.PD 0
.RSs
.IPs <type>
0: No hinting.
.br
1: FreeType autohinter, light mode.
.br
2: FreeType autohinter, normal mode.
.br
3: Font native hinter.
.br
0\-3 + 4: The same, but hinting will only be performed if OSD is rendered at
screen resolution and, therefore, will not be scaled.
.br
The default value is 7 (use native hinter for unscaled OSD and no hinting otherwise).
.RE
.PD 1
.
.TP
.B \-ass\-line\-spacing <value>
Set line spacing value for SSA/ASS renderer.
.
.TP
.B \-ass\-styles <filename>
Load all SSA/ASS styles found in the specified file and use them for
rendering text subtitles.
The syntax of the file is exactly like the
[V4 Styles] / [V4+ Styles] section of SSA/ASS.
.
.TP
.B \-ass\-top\-margin <value>
Adds a black band at the top of the frame.
The SSA/ASS renderer can place toptitles there (with \-ass\-use\-margins).
.
.TP
.B \-ass\-use\-margins
Enables placing toptitles and subtitles in black borders when they
are available.
.
.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 \-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 \-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 \-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.
.br
.I NOTE:
Some broken hardware players choke on SRT subtitle files with Unix
line endings.
If you are unlucky enough to have such a box, pass your subtitle
files through unix2dos or a similar program to replace Unix line
endings with DOS/Windows line endings.
.
.TP
.B \-dumpsub (MPlayer only) (BETA CODE)
Dumps the subtitle substream from VOB streams.
Also see the \-dump*sub and \-vobsubout* options.
.
.TP
.B \-embeddedfonts (FreeType only)
Enables extraction of Matroska embedded fonts (default: disabled).
These fonts can be used for SSA/ASS subtitle
rendering (\-ass option).
Font files are created in the ~/.mplayer/\:fonts directory.
.br
.I NOTE:
With FontConfig 2.4.2 or newer, embedded fonts are opened directly from memory,
and this option is enabled by default.
.
.TP
.B \-ffactor <number>
Resample the font alphamap.
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 \-flip\-hebrew (FriBiDi only)
Turns on flipping subtitles using FriBiDi.
.
.TP
.B \-noflip\-hebrew\-commas
Change FriBiDi's assumptions about the placements of commas in subtitles.
Use this if commas in subtitles are shown at the start of a sentence
instead of at the end.
.
.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).
.br
.I NOTE:
With FreeType, this option determines the path to the text font file.
With fontconfig, this option determines the fontconfig font name.
.sp 1
.I EXAMPLE:
.PD 0
.RSs
\-font ~/\:.mplayer/\:arial-14/\:font.desc
.br
\-font ~/\:.mplayer/\:arialuni.ttf
.br
\-font 'Bitstream Vera Sans'
.RE
.PD 1
.
.TP
.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> (FriBiDi only)
Specifies the character set that will be passed to FriBiDi when
decoding non-UTF-8 subtitles (default: ISO8859-8).
.
.TP
.B \-ifo <VOBsub IFO file>
Indicate the file that will be used to load palette and frame size for VOBsub
subtitles.
.
.TP
.B \-noautosub
Turns off automatic subtitle file loading.
.
.TP
.B \-osd\-duration <time>
Set the duration of the OSD messages in ms (default: 1000).
.
.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 \-overlapsub
Allows the next subtitle to be displayed while the current one is
still visible (default is to enable the support only for specific
formats).
.
.TP
.B \-sid <ID> (also see \-slang, \-vobsubid)
Display the subtitle stream specified by <ID> (0\-31).
MPlayer prints the available subtitle IDs when run in verbose (\-v) mode.
If you cannot select one of the subtitles on a DVD, also try \-vobsubid.
.
.TP
.B \-slang <language code[,language code,...]> (also see \-sid)
Specify a priority list of subtitle languages to use.
Different container formats employ different language codes.
DVDs use ISO 639-1 two letter language codes, Matroska uses 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 \-slang hu,en"
Chooses the Hungarian subtitle track on a DVD and falls back on English if
Hungarian is not available.
.IPs "mplayer \-slang jpn example.mkv"
Plays a Matroska file with Japanese subtitles.
.RE
.PD 1
.
.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.
This can be employed to e.g.\& smooth subtitles with gaussian blur.
Available modes are:
.PD 0
.RSs
.IPs 0
none (fastest, very ugly)
.IPs 1
approximate (broken?)
.IPs 2
full (slow)
.IPs 3
bilinear (default, fast and not too bad)
.IPs 4
uses swscaler gaussian blur (looks very good)
.RE
.PD 1
.
.TP
.B \-spualign <\-1\-2>
Specify how SPU (DVD/\:VOBsub) subtitles should be aligned.
.PD 0
.RSs
.IPs "\-1"
original position
.IPs " 0"
Align at top (original behavior, default).
.IPs " 1"
Align at center.
.IPs " 2"
Align at bottom.
.RE
.PD 1
.
.TP
.B \-spugauss <0.0\-3.0>
Variance parameter of gaussian used by \-spuaa 4.
Higher means more blur (default: 1.0).
.
.TP
.B \-sub <subtitlefile1,subtitlefile2,...>
Use/\:display these subtitle files.
Only one file can be displayed at the same time.
.
.TP
.B \-sub\-bg\-alpha <0\-255>
Specify the alpha channel value for subtitles and OSD backgrounds.
Big values mean more transparency.
0 means completely 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 equivalent to the
intensity of the color.
255 means white and 0 black.
.
.TP
.B \-sub\-demuxer <[+]name> (\-subfile only) (BETA CODE)
Force subtitle demuxer type for \-subfile.