comparison DOCS/en/mplayer.1 @ 10384:2623d03b98e5

Sort options alphabetically.

10383:d59f5760ff8d

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

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

.SH "OSD/SUB OPTIONS"
.I NOTE:
.br
See \-vf 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:

\-font ~/\:.mplayer/\:arialuni.ttf
.RE
.PD 1
.
.TP
.B \-noautosub
Turns off automatic loading of subtitle files.
.TP
.B \-overlapsub
Enables time wise overlapping subtitles support for all subtitles formats.
.TP
.B \-nooverlapsub
Disables time wise overlapping subtitles support for all subtitles formats 
(default behaviour is to enable the support only for specific formats).
.TP

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

.IPs "\-slang hu,en"
Selects Hungarian and falls back to English if Hungarian is not available.
.RE
.PD 1
.
.TP
.B \-sub <subtitle\-file1,subtitle\-file2,...>
Use/\:display these subtitle files.
Only one file can be displayed at the same time and the files can be
switched with 'j'. 
.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 \-vf 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 \-sub-fuzziness
Adjust matching fuzziness when searching for subtitles:
.PD 0
.RSs
.IPs 0
exact match
.IPs 1
load all subs containing movie name
.IPs 2
load all subs in the current directory
.RE
.PD 1
.
.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 -subalign, 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

uses swscaler gaussian blur (looks very good)
.RE
.PD 1
.
.TP
.B \-spugauss <0.0\-3.0>
Variance parameter of gaussian used by -spuaa 4.
Higher means more blur.
The default is 1.0.


.SH "AUDIO OUTPUT OPTIONS (MPLAYER ONLY)"
.TP
.B \-abs <value> (OBSOLETE)

.PD 1


.SH "GENERAL ENCODING OPTIONS (MENCODER ONLY)"
.TP
.B \-audio-density <1\-50>
Number of audio chunks per second (default is 2 for 0.5s long audio chunks).

.I NOTE:
.br
CBR only, VBR ignores this as it puts each packet in a new chunk.
.TP
.B \-audio-delay <0.0\-...>
Sets the audio delay field in the header.
Default is 0.0, negative values do not work.
This does not delay the audio while encoding, but the player will see the
default audio delay, sparing you the use of the \-delay option.
.TP
.B \-audio-preload <0.0\-2.0>
Sets up audio buffering time interval (default: 0.5s).
.TP
.B \-endpos <[[hh:]mm:]ss[.ms]|size[b|kb|mb]> (see \-ss and \-sb option too)

.B \-vobsubout <basename>
Specify the basename for the output .idx and .sub files.
This turns off subtitle rendering in the encoded movie and diverts it to
Vobsub subtitle files.
.TP
.B \-vobsuboutindex <index>
Specify the index of the subtitles in the output files.
(default: 0)
.TP
.B \-vobsuboutid <langid>
Specify the language two letter code for the subtitles.
This overrides what is read from the DVD or the .ifo file.


.SH "CODEC SPECIFIC ENCODING OPTIONS (MENCODER ONLY)"
You can specify codec specific encoding parameters using the following
syntax:

10384:2623d03b98e5

0 means forever.
.TP
.B \-menu (BETA CODE)
Turn on OSD menu support.
.TP
.B \-menu-cfg <file> (BETA CODE)
Use an alternative menu.conf.
.TP
.B \-menu-root <value> (BETA CODE)
Specify the main menu.
.TP
.B \-nojoystick
Turns off joystick support.
Default is on, if compiled in.
.TP

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 \-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 \-skipopening
Skip DVD opening (dvdnav only).
.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

.SH "OSD/SUB OPTIONS"
.I NOTE:
.br
See \-vf expand too.
.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.
.TP
.B \-dumpsub (MPLAYER only) (BETA CODE)
Dumps the subtitle substream from VOB streams.
See -dump*sub and -vobsubout* options too.
.TP
.B \-ffactor <number>
Resample alphamap of the font.
Can be:

\-font ~/\:.mplayer/\:arialuni.ttf
.RE
.PD 1
.
.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 loading of subtitle files.
.TP
.B \-nooverlapsub
Disables time wise overlapping subtitles support for all subtitles formats 
(default behaviour is to enable the support only for specific formats).
.TP

volume + seek + timer + percentage + total time
.RE
.PD 1
.
.TP
.B \-overlapsub
Enables time wise overlapping subtitles support for all subtitles formats.
.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

.IPs "\-slang hu,en"
Selects Hungarian and falls back to English if Hungarian is not available.
.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, for example to

uses swscaler gaussian blur (looks very good)
.RE
.PD 1
.
.TP
.B \-spualign <-1\-2>
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>
Variance parameter of gaussian used by -spuaa 4.
Higher means more blur.
The default is 1.0.
.TP
.B \-sub <subtitle\-file1,subtitle\-file2,...>
Use/\:display these subtitle files.
Only one file can be displayed at the same time and the files can be
switched with 'j'. 
.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 \-sub\-demuxer <number> (BETA CODE)
Force subtitle demuxer type for \-subfile.
.TP
.B \-sub-fuzziness
Adjust matching fuzziness when searching for subtitles:
.PD 0
.RSs
.IPs 0
exact match
.IPs 1
load all subs containing movie name
.IPs 2
load all subs in the current directory
.RE
.PD 1
.
.TP
.B \-sub-no-text-pp
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.
0 means align at top (original/default behavior), 1 means align at center, and
2 means align at bottom.
.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 \-subdelay <sec>
Delays subtitles by <sec> seconds.
Can be negative.
.TP
.B \-subfile <filename> (BETA CODE)
Currently useless.
Same as \-audiofile, but for subtitle streams (OggDS?).
.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 \-subpos <0\-100> (useful with \-vf 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 \-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 \-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.


.SH "AUDIO OUTPUT OPTIONS (MPLAYER ONLY)"
.TP
.B \-abs <value> (OBSOLETE)

.PD 1


.SH "GENERAL ENCODING OPTIONS (MENCODER ONLY)"
.TP
.B \-audio-delay <0.0\-...>
Sets the audio delay field in the header.
Default is 0.0, negative values do not work.
This does not delay the audio while encoding, but the player will see the
default audio delay, sparing you the use of the \-delay option.
.TP
.B \-audio-density <1\-50>
Number of audio chunks per second (default is 2 for 0.5s long audio chunks).

.I NOTE:
.br
CBR only, VBR ignores this as it puts each packet in a new chunk.
.TP
.B \-audio-preload <0.0\-2.0>
Sets up audio buffering time interval (default: 0.5s).
.TP
.B \-endpos <[[hh:]mm:]ss[.ms]|size[b|kb|mb]> (see \-ss and \-sb option too)

.B \-vobsubout <basename>
Specify the basename for the output .idx and .sub files.
This turns off subtitle rendering in the encoded movie and diverts it to
Vobsub subtitle files.
.TP
.B \-vobsuboutid <langid>
Specify the language two letter code for the subtitles.
This overrides what is read from the DVD or the .ifo file.
.TP
.B \-vobsuboutindex <index>
Specify the index of the subtitles in the output files.
(default: 0)


.SH "CODEC SPECIFIC ENCODING OPTIONS (MENCODER ONLY)"
You can specify codec specific encoding parameters using the following
syntax: