comparison DOCS/mplayer.1 @ 7181:ad1f6cb4cee5

afm/vfm migration, suboption config example, 2 typos

7180:28677d779205

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 config
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'.

.I EXAMPLE
.br
# Use Matrox driver by default.
.br
vo=xmga
.br
# I love practicing handstands while watching videos.
.br
flip=yes


.SH "DEMUXER/STREAM OPTIONS"
.TP
.B \-aid <id> (also see \-alang option)

.SH "DECODING/FILTERING OPTIONS"
.TP
.B \-ac <codec name>
Force usage of a specific audio codec, according to its name in codecs.conf.

.I EXAMPLE:
    \-ac mp3     use libmp3 MP3 codec
    \-ac mp3acm  use l3codeca.acm MP3 codec
    \-ac ac3     use AC3 codec

    \-ac vorbis  use libvorbis
    \-ac ffmp3   use ffmpeg's MP3 decoder (SLOW)

See \-ac help for a full list of available codecs.
.TP
.B \-afm <1\-12> (OBSOLETE)
Force usage of a specific audio format family.

.I EXAMPLE:
    \-afm 1   use libmp3 (mp2/mp3, but not mp1)
    \-afm 2   suppose raw PCM audio
    \-afm 3   use libac3
    \-afm 4   use a matching Win32 codec
    \-afm 5   use aLaw/uLaw driver
    \-afm 10  use libvorbis
    \-afm 11  use ffmpeg's MP3 decoder (even mp1)
.TP
.B \-aspect <ratio>
Override aspect ratio of movies. It's autodetected on MPEG files, but can't be
autodetected on most AVI files.

For \-sws 2 and 7, the sharpness can be set with the scaling parameter (p)
of \-vop scale (0 (soft) \- 100 (sharp)), for \-sws 9, it specifies the filter
length (1 \- 10).
.TP
.B \-vc <codec name>
Force usage of a specific video codec, according to its name in codecs.conf,

.I EXAMPLE:
    \-vc divx      use VFW DivX codec
    \-vc divxds    use DirectShow DivX codec
    \-vc ffdivx    use libavcodec's DivX codec
    \-vc ffmpeg12  use libavcodec's MPEG1/2 codec
    \-vc divx4     use Project Mayo's DivX codec

See '\-vc help' for FULL list!
.TP
.B \-vfm <1\-12> (OBSOLETE)
Force usage of a specific codec FAMILY, and FALLBACK to default if failed.

.I EXAMPLE:
    \-vfm 2   use VFW (Win32) codecs
    \-vfm 3   use OpenDivX/DivX4 codec (YV12)
             (same as \-vc odivx but fallback)
    \-vfm 4   use DirectShow (Win32) codecs
    \-vfm 5   use libavcodec codecs
    \-vfm 7   use DivX4 codec (YUY2)
             (same as \-vc divx4 but fallback)
    \-vfm 10  use XAnim codecs

.I NOTE:
If libdivxdecore support was compiled in, then type 3 and 7 now contains
just the same DivX4 codec, but different APIs to reach it. For difference
between them and when to use which, check the DivX4 section in the

.br
up and down     seek backward/forward   1 minute
.br
pgup and pgdown seek backward/forward  10 minutes
.br
< and >		 backward/forward in playlist
.br
HOME and END    go to next/previous playtree entry
                in the parent list
.br
INS and DEL     go to next/previous alternative

7181:ad1f6cb4cee5

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 config
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
this way.

.I EXAMPLE:
.br
# Use Matrox driver by default.
.br
vo=xmga
.br
# I love practicing handstands while watching videos.
.br
flip=yes
# Always encode/decode multiple files from png with 25fps, start it with -mf on
.br
mf= type=png:fps=25


.SH "DEMUXER/STREAM OPTIONS"
.TP
.B \-aid <id> (also see \-alang option)

.SH "DECODING/FILTERING OPTIONS"
.TP
.B \-ac <codec name>
Force usage of a specific audio codec, according to its codec name in
codecs.conf.

.I EXAMPLE:
    \-ac mp3     use libmp3 MP3 codec
    \-ac mp3acm  use l3codeca.acm MP3 codec
    \-ac ac3     use AC3 codec

    \-ac vorbis  use libvorbis
    \-ac ffmp3   use ffmpeg's MP3 decoder (SLOW)

See \-ac help for a full list of available codecs.
.TP
.B \-afm <driver name>
Force usage of a specific audio codec family, according to its driver name
in codecs.conf and fall back to default if it failed.

.I EXAMPLE:
    \-afm mp3lib     use libmp3 (mp2/3, but not mp1)
    \-afm libmad     use libmad (mp1/2/3, slow)
    \-afm ffmpeg     use ffmpeg's decoder (mp1/2/3)
    \-afm liba52     use liba52 (ac3)
    \-afm libvorbis  use libvorbis
.TP
.B \-aspect <ratio>
Override aspect ratio of movies. It's autodetected on MPEG files, but can't be
autodetected on most AVI files.

For \-sws 2 and 7, the sharpness can be set with the scaling parameter (p)
of \-vop scale (0 (soft) \- 100 (sharp)), for \-sws 9, it specifies the filter
length (1 \- 10).
.TP
.B \-vc <codec name>
Force usage of a specific video codec, according to its codec name in codecs.conf,

.I EXAMPLE:
    \-vc divx      use VFW DivX codec
    \-vc divxds    use DirectShow DivX codec
    \-vc ffdivx    use libavcodec's DivX codec
    \-vc ffmpeg12  use libavcodec's MPEG1/2 codec
    \-vc divx4     use Project Mayo's DivX codec

See '\-vc help' for FULL list!
.TP
.B \-vfm <driver name>
Force usage of a specific video codec family, according to its driver name
in codecs.conf and fall back to default if it failed.

.I EXAMPLE:
    \-vfm ffmpeg  use libavcodec codecs
    \-vfm vfw     use VFW (Win32) codecs
    \-vfm odivx   use OpenDivX/DivX4 codec (YV12)
                  (same as \-vc odivx but fallback)
    \-vfm dshow   use DirectShow (Win32) codecs
    \-vfm divx4   use DivX4 codec (YUY2)
                  (same as \-vc divx4 but fallback)
    \-vfm xanim   use XAnim codecs

.I NOTE:
If libdivxdecore support was compiled in, then type 3 and 7 now contains
just the same DivX4 codec, but different APIs to reach it. For difference
between them and when to use which, check the DivX4 section in the

.br
up and down     seek backward/forward   1 minute
.br
pgup and pgdown seek backward/forward  10 minutes
.br
< and >         backward/forward in playlist
.br
HOME and END    go to next/previous playtree entry
                in the parent list
.br
INS and DEL     go to next/previous alternative