aboutsummaryrefslogtreecommitdiffhomepage
path: root/DOCS
diff options
context:
space:
mode:
authorGravatar diego <diego@b3059339-0415-0410-9bf9-f77b7e298cf2>2002-08-11 18:27:38 +0000
committerGravatar diego <diego@b3059339-0415-0410-9bf9-f77b7e298cf2>2002-08-11 18:27:38 +0000
commit58bba52aca7a03ff4a5ff81bac8be19e7811dd8b (patch)
tree30e9db6fd126d09c9f67148c8bb3a152c270c240 /DOCS
parent6287343f35cafb5778b2796a496a0d0fe1106529 (diff)
Another big batch of cosmetics *only*.
2 character indentation everywhere, 2 blank lines before new sections. The docs should now have a nice and uniform look. git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@6975 b3059339-0415-0410-9bf9-f77b7e298cf2
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/codecs.html170
-rw-r--r--DOCS/documentation.html1742
-rw-r--r--DOCS/encoding.html275
-rw-r--r--DOCS/formats.html8
-rw-r--r--DOCS/sound.html201
-rw-r--r--DOCS/users_against_developers.html223
-rw-r--r--DOCS/video.html342
7 files changed, 1432 insertions, 1529 deletions
diff --git a/DOCS/codecs.html b/DOCS/codecs.html
index b851a15ce7..e00b4b945e 100644
--- a/DOCS/codecs.html
+++ b/DOCS/codecs.html
@@ -15,8 +15,8 @@
<P><B><A NAME="video_codecs">2.2.1 Video codecs</A></B></P>
-<P>See the <A HREF="http://www.mplayerhq.hu/DOCS/codecs-status.html">codec status table</A> for the complete,
-daily generated list!!!</P>
+<P>See the <A HREF="http://www.mplayerhq.hu/DOCS/codecs-status.html">codec status table</A>
+ for the complete, daily generated list!!!</P>
<P>The most important ones above all:</P>
<UL>
@@ -34,13 +34,14 @@ daily generated list!!!</P>
<LI>RealVideo 1.0 codec from libavcodec, and RealVideo 2.0, 3.0 codecs using
RealPlayer libraries</LI>
<LI>native decoder for HuffYUV</LI>
- <LI>Various old simple RLE-like formats</LI>
+ <LI>various old simple RLE-like formats</LI>
</UL>
<P>If you have a Win32 codec not listed here which is not supported yet, please
read the <A HREF="#importing">codec importing HOWTO</A> and help us add support
for it!</P>
+
<P><B><A NAME="divx">2.2.1.1 DivX4/DivX5</A></B></P>
<P>This section contains information about the DivX4 and DivX5 codecs of
@@ -73,13 +74,13 @@ daily generated list!!!</P>
<P>DivX4Linux works in two modes:</P>
<TABLE BORDER=0>
-<TR><TD>&nbsp;&nbsp;</TD><TD VALIGN=top><CODE>-vc&nbsp;odivx</CODE></TD><TD>&nbsp;&nbsp;</TD>
-<TD>Uses the codec in OpenDivX fashion. In this case it
-produces YV12 images in its own buffer, and <B>MPlayer</B> does colorspace
-conversion via libvo. (<B>FAST, RECOMMENDED!</B>)</TD></TR>
-<TR><TD></TD><TD VALIGN=top><CODE>-vc&nbsp;divx4</CODE></TD><TD></TD>
-<TD>Uses the colorspace conversion of the codec.
-In this mode you can use YUY2/UYVY, too. (<B>SLOW</B>)</TD></TR>
+ <TR><TD>&nbsp;&nbsp;</TD><TD VALIGN=top><CODE>-vc&nbsp;odivx</CODE></TD><TD>&nbsp;&nbsp;</TD>
+ <TD>Uses the codec in OpenDivX fashion. In this case it
+ produces YV12 images in its own buffer, and <B>MPlayer</B> does colorspace
+ conversion via libvo. (<B>FAST, RECOMMENDED!</B>)</TD></TR>
+ <TR><TD></TD><TD VALIGN=top><CODE>-vc&nbsp;divx4</CODE></TD><TD></TD>
+ <TD>Uses the colorspace conversion of the codec.
+ In this mode you can use YUY2/UYVY, too. (<B>SLOW</B>)</TD></TR>
</TABLE>
<P>The <CODE>-vc odivx</CODE> method is usually faster, due to the fact that it
@@ -95,7 +96,7 @@ In this mode you can use YUY2/UYVY, too. (<B>SLOW</B>)</TD></TR>
<P><B><A NAME="libavcodec">2.2.1.2 FFmpeg DivX/libavcodec</A></B></P>
<P><A HREF="http://ffmpeg.sourceforge.net">FFmpeg</A> contains an
- <B>opensource</B> codec package, which is capable of decoding video streams
+ <B>open source</B> codec package, which is capable of decoding video streams
encoded with
H263/MJPEG/RV10/DivX3/DivX4/DivX5/MP41/MP42/WMV1
codecs. Not only some of them can be encoded with, but it also offers higher
@@ -143,24 +144,22 @@ In this mode you can use YUY2/UYVY, too. (<B>SLOW</B>)</TD></TR>
<UL>
<LI>Download the codecs you wish to use from the
- <A HREF="http://xanim.va.pubnix.com">XAnim site</A>. The <B>3ivx</B> codec
- is not there, but at the <A HREF="http://www.3ivx.com">3ivx site</A>.</LI>
-
+ <A HREF="http://xanim.va.pubnix.com">XAnim site</A>. The <B>3ivx</B> codec
+ is not there, but at the <A HREF="http://www.3ivx.com">3ivx site</A>.</LI>
<LI>Use the <CODE>--with-xanimlibdir</CODE> option to tell configure where
- to find the XAnim codecs. By default, it looks for them at
- <CODE>/usr/local/lib/xanim/mods, /usr/lib/xanim/mods and /usr/lib/xanim</CODE>.
- Alternatively you can set the environment variable <I>XANIM_MOD_DIR</I> to
- the directory of the XAnim codecs.</LI>
-
+ to find the XAnim codecs. By default, it looks for them at
+ <CODE>/usr/local/lib/xanim/mods, /usr/lib/xanim/mods and /usr/lib/xanim</CODE>.
+ Alternatively you can set the environment variable <I>XANIM_MOD_DIR</I> to
+ the directory of the XAnim codecs.</LI>
<LI>Rename/symlink the files, cutting out the architecture stuff, so they will
- have filenames like these: <CODE>vid_cvid.xa, vid_h263.xa, vid_iv50.xa</CODE>
-
+ have filenames like these: <CODE>vid_cvid.xa, vid_h263.xa, vid_iv50.xa</CODE>.</LI>
</UL>
<P>XAnim is video codec family number 10, so you may want to use the <CODE>-vfm 10</CODE>
option to tell <B>MPlayer</B> to use them if possible.</P>
-<P>Tested codecs include: <B>Indeo 3.2</B>, <B>4.1</B>, <B>5.0</B>, <B>CVID</B>, <B>3ivX</B>, <B>h263</B>.</P>
+<P>Tested codecs include: <B>Indeo 3.2</B>, <B>4.1</B>, <B>5.0</B>, <B>CVID</B>,
+ <B>3ivX</B>, <B>h263</B>.</P>
<P><B><A NAME="vivo_video">2.2.1.4 VIVO video</A></B></P>
@@ -203,6 +202,7 @@ In this mode you can use YUY2/UYVY, too. (<B>SLOW</B>)</TD></TR>
<P><B><A NAME="realvideo">2.2.1.8 RealVideo</A></B></P>
<B>MPlayer</B> supports decoding all versions of RealVideo:
+
<UL>
<LI>RealVideo 1.0 (fourcc RV10) - en/decoding supported by <B>libavcodec</B></LI>
<LI>RealVideo 2.0 (fourcc RV20) - decoding supported by <B>RealPlayer libraries</B></LI>
@@ -231,35 +231,38 @@ In this mode you can use YUY2/UYVY, too. (<B>SLOW</B>)</TD></TR>
have the same origin.</P>
<P><B>Advantages:</B></P>
- <UL>
- <LI>open source</LI>
- <LI>its API is compatible with DivX4 so adding support for
- it is easy</LI>
- <LI>2-pass encoding support</LI>
- <LI>nice encoding quality, higher speed than DivX4 (you can optimize it for
- your box while compiling)</LI>
- </UL>
+
+<UL>
+ <LI>open source</LI>
+ <LI>its API is compatible with DivX4 so adding support for
+ it is easy</LI>
+ <LI>2-pass encoding support</LI>
+ <LI>nice encoding quality, higher speed than DivX4 (you can optimize it for
+ your box while compiling)</LI>
+</UL>
<P><B>Disadvantages:</B></P>
- <UL>
- <LI>currently it does not properly <B>decode</B> all DivX/DivX4 files (no problem as libavcodec can play them)</LI>
- <LI>you have to choose between DivX4 <B>OR</B> XViD support at
- compiletime</LI>
- <LI>under development</LI>
- </UL>
+
+<UL>
+ <LI>currently it does not properly <B>decode</B> all DivX/DivX4 files (no problem as libavcodec can play them)</LI>
+ <LI>you have to choose between DivX4 <B>OR</B> XViD support at
+ compiletime</LI>
+ <LI>under development</LI>
+</UL>
<P><B>Installation:</B> It is currently available only from CVS. Here are the
download and installation instructions:</P>
- <OL>
- <LI><CODE>cvs -z3 -d:pserver:anonymous@cvs.xvid.org:/xvid login</CODE></LI>
- <LI><CODE>cvs -z3 -d:pserver:anonymous@cvs.xvid.org:/xvid co xvidcore</CODE></LI>
- <LI><CODE>cd xvidcore/build/generic</CODE></LI>
- <LI>Edit <CODE>Makefile.linux</CODE> to fit your needs.</LI>
- <LI><CODE>make -f Makefile.linux</CODE></LI>
- <LI>Get <CODE>encore2.h</CODE> and <CODE>decore.h</CODE> from the DivX4Linux
- package, and copy them to <CODE>/usr/local/include/</CODE>.</LI>
- <LI>Recompile <B>MPlayer</B> with <CODE>--with-xvidcore=/path/to/libcore.a</CODE>.</LI>
- </OL>
+
+<OL>
+ <LI><CODE>cvs -z3 -d:pserver:anonymous@cvs.xvid.org:/xvid login</CODE></LI>
+ <LI><CODE>cvs -z3 -d:pserver:anonymous@cvs.xvid.org:/xvid co xvidcore</CODE></LI>
+ <LI><CODE>cd xvidcore/build/generic</CODE></LI>
+ <LI>Edit <CODE>Makefile.linux</CODE> to fit your needs.</LI>
+ <LI><CODE>make -f Makefile.linux</CODE></LI>
+ <LI>Get <CODE>encore2.h</CODE> and <CODE>decore.h</CODE> from the DivX4Linux
+ package, and copy them to <CODE>/usr/local/include/</CODE>.</LI>
+ <LI>Recompile <B>MPlayer</B> with <CODE>--with-xvidcore=/path/to/libcore.a</CODE>.</LI>
+</OL>
<P><B><A NAME="sorenson">2.2.1.10 Sorenson</A></B></P>
@@ -268,14 +271,16 @@ In this mode you can use YUY2/UYVY, too. (<B>SLOW</B>)</TD></TR>
able to decode the first version (SVQ1) with a native decoder.</P>
<P><B>Advantages:</B></P>
- <UL>
- <LI>Fast, even old Macintosh machines were able to decode it.</LI>
- </UL>
+
+<UL>
+ <LI>Fast, even old Macintosh machines were able to decode it.</LI>
+</UL>
<P><B>Disadvantages:</B></P>
- <UL>
- <LI>SVQ3 is still not reverse engineered.</LI>
- </UL>
+
+<UL>
+ <LI>SVQ3 is still not reverse engineered.</LI>
+</UL>
<P><B>Installation:</B> it's compiled and usable per default.</P>
@@ -283,6 +288,7 @@ In this mode you can use YUY2/UYVY, too. (<B>SLOW</B>)</TD></TR>
<P><B><A NAME="audio_codecs">2.2.2 Audio codecs</A></B></P>
<P>The most important audio codecs above all:<BR></P>
+
<UL>
<LI>MPEG layer 2, and layer 3 (MP3) audio (<B>native</B> code, with
MMX/SSE/3DNow! optimization)</LI>
@@ -356,6 +362,7 @@ In this mode you can use YUY2/UYVY, too. (<B>SLOW</B>)</TD></TR>
<P><B><A NAME="realaudio">2.2.2.5 RealAudio</A></B></P>
<B>MPlayer</B> supports decoding nearly all versions of RealAudio:
+
<UL>
<LI>RealAudio DNET - decoding supported by <B>liba52</B></LI>
<LI>RealAudio Cook - decoding supported by <B>RealPlayer libraries</B></LI>
@@ -368,30 +375,32 @@ In this mode you can use YUY2/UYVY, too. (<B>SLOW</B>)</TD></TR>
<P><B><A NAME="importing">2.2.3 Win32 codec importing HOWTO</A></B></P>
+
<P><B><A NAME="importing_vfw">2.2.3.1 VFW codecs</A></B></P>
<P>VFW (Video for Windows) is the old Video API for Windows. Its codecs have
-the .DLL or (rarely) .DRV extension.
-If <B>MPlayer</B> fails at playing your AVI with this kind of message:</P>
+ the .DLL or (rarely) .DRV extension.
+ If <B>MPlayer</B> fails at playing your AVI with this kind of message:</P>
<P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE>UNKNOWN video codec: HFYU (0x55594648)</CODE></P>
<P>It means your AVI is encoded with a codec which has the HFYU fourcc (HFYU =
-HuffYUV codec, DIV3 = DivX Low Motion, etc...). Now that you know this, you
-have to find out which DLL Windows loads in order to play this file. In our
-case, the <CODE>system.ini</CODE> contains this information in a line that reads:</P>
+ HuffYUV codec, DIV3 = DivX Low Motion, etc...). Now that you know this, you
+ have to find out which DLL Windows loads in order to play this file. In our
+ case, the <CODE>system.ini</CODE> contains this information in a line that
+ reads:</P>
<P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE>VIDC.HFYU=huffyuv.dll</CODE></P>
<P>So you need the <CODE>huffyuv.dll</CODE> file. Note that the audio codecs are
-specified by the MSACM prefix:</P>
+ specified by the MSACM prefix:</P>
<P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE>msacm.l3acm=L3codeca.acm</CODE></P>
-<P>This is the MP3 codec.
-Now that you have all the necessary information (fourcc, codec file, sample AVI),
-submit your codec support request by mail, and upload these files to the FTP site:</P>
+<P>This is the MP3 codec. Now that you have all the necessary information
+ (fourcc, codec file, sample AVI), submit your codec support request by mail,
+ and upload these files to the FTP site:</P>
<P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE>ftp://ftp.mplayerhq.hu/MPlayer/incoming/[codecname]/</CODE></P>
@@ -399,34 +408,37 @@ submit your codec support request by mail, and upload these files to the FTP sit
<P><B><A NAME="importing_directshow">2.2.3.2 DirectShow codecs</A></B></P>
<P>DirectShow is the newer Video API, which is even worse than its predecessor.
-Things are harder with DirectShow, since</P>
+ Things are harder with DirectShow, since</P>
+
<UL>
-<LI><CODE>system.ini</CODE> does not contain the needed information, instead it
-is stored in the registry and
-<LI>we need the GUID of the codec.
+ <LI><CODE>system.ini</CODE> does not contain the needed information, instead it
+ is stored in the registry and
+ <LI>we need the GUID of the codec.
</UL>
<P>Take a deep breath and start searching the registry...</P>
+
<UL>
-<LI>Start <CODE>regedit</CODE>.
-<LI>Press <CODE>Ctrl-f</CODE>, disable the first two checkboxes, and enable the
-third. Type in the fourcc of the codec (e.g. TM20).
-<LI>You should see a field which contains the path and the filename
-(e.g. <CODE>C:\WINDOWS\SYSTEM\TM20DEC.AX</CODE>).
-<LI>Now that you have the file, we need the GUID. Try searching again, but
-now search for the codec's name, not the fourcc. Its name can be acquired
-when Media Player is playing the file, by checking File-&gt;Properties-&gt;Advanced.
-If not, you are out of luck. Try guessing (e.g. search for TrueMotion).
-<LI>If the GUID is found you should see a FriendlyName and a CLSID
-field. Write down the 16 byte CLSID, this is the GUID we need.
+ <LI>Start <CODE>regedit</CODE>.
+ <LI>Press <CODE>Ctrl-f</CODE>, disable the first two checkboxes, and enable
+ the third. Type in the fourcc of the codec (e.g. TM20).
+ <LI>You should see a field which contains the path and the filename
+ (e.g. <CODE>C:\WINDOWS\SYSTEM\TM20DEC.AX</CODE>).
+ <LI>Now that you have the file, we need the GUID. Try searching again, but
+ now search for the codec's name, not the fourcc. Its name can be acquired
+ when Media Player is playing the file, by checking File -&gt; Properties
+ -&gt; Advanced.
+ If not, you are out of luck. Try guessing (e.g. search for TrueMotion).
+ <LI>If the GUID is found you should see a FriendlyName and a CLSID
+ field. Write down the 16 byte CLSID, this is the GUID we need.
</UL>
<P><B>Note:</B> If searching fails, try enabling all the checkboxes. You may have
-false hits, but you may get lucky...</P>
+ false hits, but you may get lucky...</P>
<P>Now that you have all the necessary information (fourcc, GUID, codec file,
-sample AVI), submit your codec support request by mail, and upload these files
-to the FTP site:</P>
+ sample AVI), submit your codec support request by mail, and upload these files
+ to the FTP site:</P>
<P>&nbsp;&nbsp;&nbsp;&nbsp;<CODE>ftp://ftp.mplayerhq.hu/MPlayer/incoming/[codecname]/</CODE></P>
diff --git a/DOCS/documentation.html b/DOCS/documentation.html
index 23a549492e..32b25fa1bf 100644
--- a/DOCS/documentation.html
+++ b/DOCS/documentation.html
@@ -9,14 +9,15 @@
<BODY>
-<CENTER><B>MPlayer - Movie Player for LINUX (C) 2000-2002 Arpad Gereoffy (A'rpi/ESP-team)</B><BR>
-<BR><A HREF="http://www.mplayerhq.hu">http://www.mplayerhq.hu</A><BR><BR>
-[ English ]
-<A HREF="Hungarian/documentation.html">[ Hungarian ]</A>
-<A HREF="German/documentation.html">[ German ]</A>
-<A HREF="French/documentation.html">[ French ]</A>
-<A HREF="Polish/documentation.html">[ Polish ]</A>
-<A HREF="Italian/documentation.html">[ Italian ]</A>
+<CENTER>
+ <B>MPlayer - Movie Player for LINUX (C) 2000-2002 Arpad Gereoffy (A'rpi/ESP-team)</B><BR>
+ <BR><A HREF="http://www.mplayerhq.hu">http://www.mplayerhq.hu</A><BR><BR>
+ [ English ]
+ <A HREF="Hungarian/documentation.html">[ Hungarian ]</A>
+ <A HREF="German/documentation.html">[ German ]</A>
+ <A HREF="French/documentation.html">[ French ]</A>
+ <A HREF="Polish/documentation.html">[ Polish ]</A>
+ <A HREF="Italian/documentation.html">[ Italian ]</A>
</CENTER>
<HR>
@@ -300,6 +301,8 @@ Developer Cries
<HR>
+
+
<P><B><A NAME="reading">0. How to read this documentation</A></B></P>
<P>If you are a first-time installer: be sure to read everything from here to
@@ -325,98 +328,100 @@ Developer Cries
read the words on the OTHER side of the colon."</I></P>
+
<P><B><A NAME="introduction">1. Introduction</A></B></P>
+
<P><B><A NAME="overview">1.1 Overview</A></B></P>
<P><B>MPlayer</B> is a movie player for LINUX (runs on many other Unices, and
-<B>non-x86</B> CPUs, see the <A HREF="#ports">ports section</A>). It plays most
-MPEG, VOB, AVI, OGG, VIVO, ASF/WMV, QT/MOV, FLI, RM, NuppelVideo, yuv4mpeg,
-FILM, RoQ files, supported by many native, XAnim, RealPlayer, and
-Win32 DLL codecs. You can watch <B>VideoCD</B>, <B>SVCD</B>, <B>DVD</B>,
-<B>3ivx</B>, <B>RealMedia</B>, and <B>DivX</B> movies too (and you don't need
-the avifile
-library at all!). The another big 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 use GGI and SDL (and this way all their drivers)
-and some lowlevel card-specific drivers (for Matrox, 3Dfx and Radeon,
-Mach64, Permedia3) too! Most
-of them supports software or hardware scaling, so you can enjoy movies in
-fullscreen. <B>MPlayer</B> supports displaying through some hardware MPEG
-decoder boards, such as the <B><A HREF="video.html#dvb">DVB</A></B> and
-<B><A HREF="video.html#dxr3">DXR3/Hollywood+</A></B>! And what about the nice big antialiased
-shaded subtitles (<B>10 supported types!!!</B>) with european/ISO 8859-1,2
-(Hungarian, English, Czech, etc), Cyrillic, Korean fonts, and the onscreen
-display (OSD)?</P>
+ <B>non-x86</B> CPUs, see the <A HREF="#ports">ports section</A>). It plays most
+ MPEG, VOB, AVI, OGG, VIVO, ASF/WMV, QT/MOV, FLI, RM, NuppelVideo, yuv4mpeg,
+ FILM, RoQ files, supported by many native, XAnim, RealPlayer, and
+ Win32 DLL codecs. You can watch <B>VideoCD</B>, <B>SVCD</B>, <B>DVD</B>,
+ <B>3ivx</B>, <B>RealMedia</B>, and <B>DivX</B> movies too (and you don't need
+ the avifile
+ library at all!). The another big 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 use GGI and SDL (and this way all their drivers)
+ and some lowlevel card-specific drivers (for Matrox, 3Dfx and Radeon,
+ Mach64, Permedia3) too! Most
+ of them supports software or hardware scaling, so you can enjoy movies in
+ fullscreen. <B>MPlayer</B> supports displaying through some hardware MPEG
+ decoder boards, such as the <B><A HREF="video.html#dvb">DVB</A></B> and
+ <B><A HREF="video.html#dxr3">DXR3/Hollywood+</A></B>! And what about the nice big antialiased
+ shaded subtitles (<B>10 supported types!!!</B>) with european/ISO 8859-1,2
+ (Hungarian, English, Czech, etc), Cyrillic, Korean fonts, and the onscreen
+ display (OSD)?</P>
<P><B>MPlayer</B> is under GPL v2 license.</P>
<P>The player is rock solid playing damaged MPEG files (useful for some VCDs),
-and it plays bad AVI files which are unplayable with the famous
-windows media player. Even AVI files without index chunk are playable, and
-you can temporarily rebuild their indexes with the <CODE>-idx</CODE> option, or
-permanently with <B>MEncoder</B>, thus enabling seeking!
-As you see, stability and quality are the most important things,
-but the speed is also amazing.</P>
+ and it plays bad AVI files which are unplayable with the famous
+ windows media player. Even AVI files without index chunk are playable, and
+ you can temporarily rebuild their indexes with the <CODE>-idx</CODE> option, or
+ permanently with <B>MEncoder</B>, thus enabling seeking!
+ As you see, stability and quality are the most important things,
+ but the speed is also amazing.</P>
<P><B><A NAME="history">1.2 History</A></B></P>
<P>This began a year ago...
-I (A'rpi) have tried lots of players under linux (mtv,xmps,dvdview,livid/oms,videolan,
-xine,xanim,avifile,xmmp) but they all have some problem. Mostly with special
-files or with audio/video sync. Most of them is unable to play both MPEG1,
-MPEG2 and AVI (DivX) files. Many players have image quality or speed problems
-too. So I've decided to write/modify one...</P>
+ I (A'rpi) have tried lots of players under linux (mtv,xmps,dvdview,livid/oms,videolan,
+ xine,xanim,avifile,xmmp) but they all have some problem. Mostly with special
+ files or with audio/video sync. Most of them is unable to play both MPEG1,
+ MPEG2 and AVI (DivX) files. Many players have image quality or speed problems
+ too. So I've decided to write/modify one...</P>
<UL>
-<LI><B>mpg12play v0.1-v0.3:</B> Sep 22-25, 2000<BR>
+ <LI><B>mpg12play v0.1-v0.3:</B> Sep 22-25, 2000<BR>
The first try, hacked together in a half hour!
I've used libmpeg3 from www.heroinewarrior.com up to the version 0.3,
but there were image quality and speed problems with it.</LI>
-<LI><B>mpg12play v0.5-v0.87:</B> Sep 28-Oct 20, 2000<BR>
+ <LI><B>mpg12play v0.5-v0.87:</B> Sep 28-Oct 20, 2000<BR>
Mpeg codec replaced with DVDview by Dirk Farin, it was a great stuff,
but it was slow and was written in C++ (I hate C++!!!)</LI>
-<LI><B>mpg12play v0.9-v0.95pre5:</B> Oct 21-Nov 2, 2000<BR>
+ <LI><B>mpg12play v0.9-v0.95pre5:</B> Oct 21-Nov 2, 2000<BR>
Mpeg codec was libmpeg2 (mpeg2dec) by Aaron Holtzman & Michel Lespinasse.
It's great, optimized very fast C code with perfect image quality and
100% MPEG standard conformance.</LI>
-<LI><B>MPlayer v0.3-v0.9:</B> Nov 18-Dec 4, 2000<BR>
+ <LI><B>MPlayer v0.3-v0.9:</B> Nov 18-Dec 4, 2000<BR>
It was a pack of two programs: mpg12play v0.95pre6 and my new simple AVI
player 'avip' based on avifile's Win32 DLL loader.</LI>
-<LI><B>MPlayer v0.10:</B> Jan 1, 2001<BR>
+ <LI><B>MPlayer v0.10:</B> Jan 1, 2001<BR>
The MPEG and AVI player in a single binary!</LI>
-<LI><B>MPlayer v0.11pre series:</B><BR>
+ <LI><B>MPlayer v0.11pre series:</B><BR>
Some new developers joined and from 0.11 the mplayer project is a team-work!
Added .ASF file support, and OpenDivX (see www.projectmayo.com) en/decoding.</LI>
-<LI><B>MPlayer v0.17a "The IdegCounter"</B> Apr 27, 2001<BR>
+ <LI><B>MPlayer v0.17a "The IdegCounter"</B> Apr 27, 2001<BR>
The release version of the 0.11pre after 4 months of heavy development!
Try it, and be amazed! Thousands of new features added... and of course
old code was improved too, bugs removed etc.</LI>
-<LI><B>MPlayer 0.18 "The BugCounter"</B> Jul 9, 2001<BR>
+ <LI><B>MPlayer 0.18 "The BugCounter"</B> Jul 9, 2001<BR>
2 months since 0.17 and here's a new release.. Completed ASF support,
more subtitle formats, introduced libao (similar to libvo but to audio),
even more stable than ever, and so on. It's a MUST!</LI>
-<LI><B>MPlayer 0.50 "The Faszom(C)ounter"</B> Oct 8, 2001<BR>
+ <LI><B>MPlayer 0.50 "The Faszom(C)ounter"</B> Oct 8, 2001<BR>
Hmm. Release again. Tons of new features, beta GUI version, bugs fixed,
new vo and ao drivers, ported to many systems, including opensource DivX
codecs and much more. Try it!</LI>
-<LI><B>MPlayer 0.60 "The RTFMCounter"</B> Jan 3, 2002<BR>
+ <LI><B>MPlayer 0.60 "The RTFMCounter"</B> Jan 3, 2002<BR>
MOV/VIVO/RM/FLI/NUV fileformats support, native CRAM, Cinepak, ADPCM codecs,
and support for XAnim's binary codecs; DVD subtitles support, first
release of MEncoder, TV grabbing, cache, liba52, countless fixes.</LI>
-<LI><B>MPlayer 0.90 "?"</B> Aug? ??, 2002<BR>
- </LI>
+ <LI><B>MPlayer 0.90 "?"</B> Aug? ??, 2002</LI>
</UL>
+
<P><B><A NAME="installation">1.3 Installation</A></B></P>
<P>In this chapter I'll try to guide you through the compiling and
-configuring process of <B>MPlayer</B>. It's not easy, but it won't necessarily
-be hard. If you experience a different behavior than what I explain, please
-search through this documentation and you'll find your answers. If you
-see links, please follow them and read carefully what they contain. It
-will take some time, but it DOES worth it.</P>
+ configuring process of <B>MPlayer</B>. It's not easy, but it won't necessarily
+ be hard. If you experience a different behavior than what I explain, please
+ search through this documentation and you'll find your answers. If you
+ see links, please follow them and read carefully what they contain. It
+ will take some time, but it DOES worth it.</P>
<P>You need a fairly recent system. On Linux, 2.4.x kernels are recommended.</P>
@@ -463,154 +468,138 @@ will take some time, but it DOES worth it.</P>
<P><B>CODECS</B></P>
<UL>
-<LI><B>libavcodec</B>: This codec package is capable of decoding
- H263/MJPEG/RV10/DivX3/DivX4/DivX5/MP41/MP42/WMV1 encoded video streams, on
- multiple platforms. It is also known to be the fastest for this task.
- Details can be found <A HREF="codecs.html#libavcodec">here</A>. Features:<BR>
- <UL>
- <LI>gain decoding of videos mentioned above, on non-x86 machines</B></LI>
- <LI>encoding with most of the mentioned codecs</LI>
- <LI>this codec is the <B>fastest codec available</B> for DivX/3/4/5 and
- other MPEG4 types. Recommended!</LI>
- </UL>
-</LI>
-
-<LI><B>Win32 codecs</B>: If you plan to use <B>MPlayer</B> on x86
- architecture, you will possibly need them. Download and unzip w32codecs.zip
- to /usr/lib/win32 <B>BEFORE</B> compiling <B>MPlayer</B>, otherwise no Win32
- support will be compiled!<BR>
- <B>Note</B>: the avifile project has similar codecs package, but it differs
- from ours, so if you want to use all supported codecs, then use our package!
- However, you can use our codecs package with avifile. Features:<BR>
- <UL>
- <LI>you need this if you want to play or encode for example movies recorded
- with various hardware compressors, like tuner cards, digital cameras (example: DV, ATI VCR, MJPEG)</LI>
- <LI>needed if you want to play <B>WMV8 movies</B>. Not needed for old
- ASF's with MP41 or MP42 video (though VoxWare audio is frequent for these
- files - it's done by the Win32 codec), or WMV7.</LI>
- </UL>
-</LI>
-
-<LI><B>DivX4/DivX5</B>: information about this codec is available in the
- <A HREF="codecs.html#divx">DivX4/DivX5</A> section. You possibly don't want
- this codec as <B>libavcodec</B> (see above) is much faster and has better
- quality than this, for both decoding and encoding.<BR>
- Features:
- <UL>
- <LI>1 pass or 2 pass encoding with
- <A HREF="encoding.html">MEncoder</A></LI>
- <LI>can play old <B>DivX3</B> movies much faster than the Win32 DLL but
- slower than <B>libavcodec</B>!</LI>
- <LI>it's closed-source, and only an x86 version is available.</LI>
- </UL>
-</LI>
-
-<LI><B>XviD</B>: Open source encoding alternative to Divx4Linux<BR>
- Features:
- <UL>
- <LI>1 pass or 2 pass encoding with
- <A HREF="encoding.html">MEncoder</A></LI>
- <LI>it's open-source, so it's multiplatform.</LI>
- <LI>it's about 2 times faster than DivX4 when encoding - about the same
- quality</LI>
- </UL>
-</LI>
-
-<LI>The <A HREF="codecs.html#xanim">XAnim codecs</A> are the best (full
- screen, hardware YUV zoom) for decoding <B>3ivx</B> and Indeo 3/4/5 movies,
- and some old formats. And they are multiplatform, so this is the only way to
- play Indeo on non-x86 platforms (well, apart from using XAnim:). But for
- example Cinepak movies are best played with <B>MPlayer</B>'s own Cinepak
- decoder!</LI>
-
-<LI>For <B>Ogg Vorbis</B> audio decoding you need to install
- <CODE>libvorbis</CODE> properly. Use deb/rpm packages if available, or
- compile from
- <A HREF="http://ogg.org/ogg/vorbis/download/vorbis_nightly_cvs.tgz">source</A>
- (this is a nightly updated tarball of Vorbis CVS).</LI>
-
-<LI><B>MPlayer</B> can use the libraries of RealPlayer 8 or RealONE to play
- files with <B>RealVideo 2.0 and 3.0</B> video, and Sipro/Cook audio. See
- <A HREF="formats.html#real">RealMedia file format</A> section for
- installation instructions and more information!</LI>
+ <LI><B>libavcodec</B>: This codec package is capable of decoding
+ H263/MJPEG/RV10/DivX3/DivX4/DivX5/MP41/MP42/WMV1 encoded video streams, on
+ multiple platforms. It is also known to be the fastest for this task.
+ Details can be found <A HREF="codecs.html#libavcodec">here</A>. Features:<BR>
+ <UL>
+ <LI>gain decoding of videos mentioned above, on non-x86 machines</B></LI>
+ <LI>encoding with most of the mentioned codecs</LI>
+ <LI>this codec is the <B>fastest codec available</B> for DivX/3/4/5 and
+ other MPEG4 types. Recommended!</LI>
+ </UL>
+ </LI>
+ <LI><B>Win32 codecs</B>: If you plan to use <B>MPlayer</B> on x86
+ architecture, you will possibly need them. Download and unzip w32codecs.zip
+ to /usr/lib/win32 <B>BEFORE</B> compiling <B>MPlayer</B>, otherwise no Win32
+ support will be compiled!<BR>
+ <B>Note</B>: the avifile project has similar codecs package, but it differs
+ from ours, so if you want to use all supported codecs, then use our package!
+ However, you can use our codecs package with avifile. Features:<BR>
+ <UL>
+ <LI>you need this if you want to play or encode for example movies recorded
+ with various hardware compressors, like tuner cards, digital cameras
+ (example: DV, ATI VCR, MJPEG)</LI>
+ <LI>needed if you want to play <B>WMV8 movies</B>. Not needed for old
+ ASF's with MP41 or MP42 video (though VoxWare audio is frequent for these
+ files - it's done by the Win32 codec), or WMV7.</LI>
+ </UL>
+ </LI>
+ <LI><B>DivX4/DivX5</B>: information about this codec is available in the
+ <A HREF="codecs.html#divx">DivX4/DivX5</A> section. You possibly don't want
+ this codec as <B>libavcodec</B> (see above) is much faster and has better
+ quality than this, for both decoding and encoding.<BR>
+ Features:
+ <UL>
+ <LI>1 pass or 2 pass encoding with
+ <A HREF="encoding.html">MEncoder</A></LI>
+ <LI>can play old <B>DivX3</B> movies much faster than the Win32 DLL but
+ slower than <B>libavcodec</B>!</LI>
+ <LI>it's closed-source, and only an x86 version is available.</LI>
+ </UL>
+ </LI>
+ <LI><B>XviD</B>: Open source encoding alternative to Divx4Linux<BR>
+ Features:
+ <UL>
+ <LI>1 pass or 2 pass encoding with
+ <A HREF="encoding.html">MEncoder</A></LI>
+ <LI>it's open-source, so it's multiplatform.</LI>
+ <LI>it's about 2 times faster than DivX4 when encoding - about the same
+ quality</LI>
+ </UL>
+ </LI>
+ <LI>The <A HREF="codecs.html#xanim">XAnim codecs</A> are the best (full
+ screen, hardware YUV zoom) for decoding <B>3ivx</B> and Indeo 3/4/5 movies,
+ and some old formats. And they are multiplatform, so this is the only way to
+ play Indeo on non-x86 platforms (well, apart from using XAnim:). But for
+ example Cinepak movies are best played with <B>MPlayer</B>'s own Cinepak
+ decoder!</LI>
+ <LI>For <B>Ogg Vorbis</B> audio decoding you need to install
+ <CODE>libvorbis</CODE> properly. Use deb/rpm packages if available, or
+ compile from
+ <A HREF="http://ogg.org/ogg/vorbis/download/vorbis_nightly_cvs.tgz">source</A>
+ (this is a nightly updated tarball of Vorbis CVS).</LI>
+ <LI><B>MPlayer</B> can use the libraries of RealPlayer 8 or RealONE to play
+ files with <B>RealVideo 2.0 and 3.0</B> video, and Sipro/Cook audio. See
+ <A HREF="formats.html#real">RealMedia file format</A> section for
+ installation instructions and more information!</LI>
</UL>
<P><B>VIDEO CARDS</B></P>
<P>There are generally two kind of video cards. One kind (the newer cards) has
-<B>hardware scaling and YUV acceleration</B> support, the other cards don't.</P>
-
-<P>
-<B>YUV cards</B></P>
-
-<P>
-They can display and scale (zoom) the picture to any size that fits in
-their memory, with <B>small CPU usage</B> (zooming doesn't increase it!), thus
-you get a nice and very fast fullscreen playing.</P>
-
-<UL>
-<LI><B>Matrox G200/G400/G450/G550 cards</B>: although a
- <A HREF="video.html#vidix">Vidix driver</A> is provided, it is recommended
- to use the old mga_vid kernel module instead, for it works much better.
- Please see the <A HREF="video.html#mga_vid">mga_vid</A> section about its
- installation and usage. It is important to do these steps <I>before</I>
- compiling <B>MPlayer</B>, otherwise no mga_vid support will be built. Also
- check out the <A HREF="video.html#tv-out_matrox">Matrox TV-out</A> section.
- <U><B>If you are non-Linux user</B></U>, your only possibility is the Vidix
- driver: read <A HREF="video.html#vidix">VIDIX</A> documentation!</LI>
-
-<LI><B>3Dfx Voodoo3/Banshee cards</B>: please see the
- <A HREF="video.html#tdfxfb">tdfxfb</A> section in order to gain big
- speedup. It is important to do these steps <I>before</I> compiling
- <B>MPlayer</B>, otherwise no 3Dfx support will be built. Also see the <A
- HREF="video.html#tv-out_voodoo">3dfx TV-out section</A>. If you use X, use at
- least 4.2.0, as 3dfx Xv driver was broken in 4.1.0, and earlier
- releases!</LI>
-
-<LI><B>ATI cards</B>: <A HREF="video.html#vidix">Vidix driver</A> is
- provided for the following cards:
- <B>Radeon</B>, <B>Rage128</B>, <B>Mach64</B> (Rage XL/Mobility, Xpert98).
- Also see the <A HREF="video.html#tv-out_ati">ATI cards
- section</A> of the TV-out documentation, to know if you card's TV-out is
- supported under Linux/MPlayer.</LI>
-
-<LI><B>S3 cards</B>: the Savage and Virge/DX chips have hardware acceleration.
- Use as new XFree86 version as possible, older drivers are buggy. Savage chips
- have problems with YV12 display, see <A HREF="video.html#xv_s3">S3 Xv
- section</A> for details. Older, Trio cards have no, or slow hardware
- support.</LI>
-
-<LI><B>nVidia cards</B>: very bad choice for video playing (nVidia has
- <A HREF="users_against_developers.html#nvidia">different opinion</A>!).
- nVidia's cards have very cheap and bad quality chips. Moreover, <U>the
- built-in nVidia driver in XFree86 doesn't contain support for hardware YUV
- acceleration for all nVidia cards!</U> You have to download nVidia's
- closed-source drivers from nVidia.com. See details in <A
- HREF="video.html#xv_nvidia">nVidia Xv driver</A> section.</LI>
-
-<LI><B>3DLabs GLINT R3 and Permedia3</B>: a VIDIX driver is provided
- (pm3_vid). Please see the <A HREF="video.html#vidix">VIDIX
- instructions</A>.</LI>
-
-<LI><B>other cards</B>: none of the above?
- <UL>
- <LI>Try if the XFree86 driver (and your card) supports hardware
- acceleration. See the <A HREF="video.html#xv">Xv section</A> for
- details.</LI>
- <LI>If it doesn't, then your card's video features aren't supported under
- your OS :(<BR>
- If it does hardware scaling under Windows, it doesn't mean it will do the
- same under Linux or other OS, it depends on the drivers! Most
- manufacturers don't make Linux drivers nor release chip specs - so you're
- unlucky using their cards. See the next section:
- </LI>
- </UL>
-</LI>
-
+ <B>hardware scaling and YUV acceleration</B> support, the other cards don't.</P>
+
+<P><B>YUV cards</B></P>
+
+<P>They can display and scale (zoom) the picture to any size that fits in
+ their memory, with <B>small CPU usage</B> (zooming doesn't increase it!), thus
+ you get a nice and very fast fullscreen playing.</P>
+
+<UL>
+ <LI><B>Matrox G200/G400/G450/G550 cards</B>: although a
+ <A HREF="video.html#vidix">Vidix driver</A> is provided, it is recommended
+ to use the old mga_vid kernel module instead, for it works much better.
+ Please see the <A HREF="video.html#mga_vid">mga_vid</A> section about its
+ installation and usage. It is important to do these steps <I>before</I>
+ compiling <B>MPlayer</B>, otherwise no mga_vid support will be built. Also
+ check out the <A HREF="video.html#tv-out_matrox">Matrox TV-out</A> section.
+ <U><B>If you are non-Linux user</B></U>, your only possibility is the Vidix
+ driver: read <A HREF="video.html#vidix">VIDIX</A> documentation!</LI>
+ <LI><B>3Dfx Voodoo3/Banshee cards</B>: please see the
+ <A HREF="video.html#tdfxfb">tdfxfb</A> section in order to gain big
+ speedup. It is important to do these steps <I>before</I> compiling
+ <B>MPlayer</B>, otherwise no 3Dfx support will be built. Also see the <A
+ HREF="video.html#tv-out_voodoo">3dfx TV-out section</A>. If you use X, use at
+ least 4.2.0, as 3dfx Xv driver was broken in 4.1.0, and earlier
+ releases!</LI>
+ <LI><B>ATI cards</B>: <A HREF="video.html#vidix">Vidix driver</A> is
+ provided for the following cards:
+ <B>Radeon</B>, <B>Rage128</B>, <B>Mach64</B> (Rage XL/Mobility, Xpert98).
+ Also see the <A HREF="video.html#tv-out_ati">ATI cards
+ section</A> of the TV-out documentation, to know if you card's TV-out is
+ supported under Linux/MPlayer.</LI>
+ <LI><B>S3 cards</B>: the Savage and Virge/DX chips have hardware acceleration.
+ Use as new XFree86 version as possible, older drivers are buggy. Savage chips
+ have problems with YV12 display, see <A HREF="video.html#xv_s3">S3 Xv
+ section</A> for details. Older, Trio cards have no, or slow hardware
+ support.</LI>
+ <LI><B>nVidia cards</B>: very bad choice for video playing (nVidia has
+ <A HREF="users_against_developers.html#nvidia">different opinion</A>!).
+ nVidia's cards have very cheap and bad quality chips. Moreover, <U>the
+ built-in nVidia driver in XFree86 doesn't contain support for hardware YUV
+ acceleration for all nVidia cards!</U> You have to download nVidia's
+ closed-source drivers from nVidia.com. See details in <A
+ HREF="video.html#xv_nvidia">nVidia Xv driver</A> section.</LI>
+ <LI><B>3DLabs GLINT R3 and Permedia3</B>: a VIDIX driver is provided
+ (pm3_vid). Please see the <A HREF="video.html#vidix">VIDIX
+ instructions</A>.</LI>
+ <LI><B>other cards</B>: none of the above?
+ <UL>
+ <LI>Try if the XFree86 driver (and your card) supports hardware
+ acceleration. See the <A HREF="video.html#xv">Xv section</A> for
+ details.</LI>
+ <LI>If it doesn't, then your card's video features aren't supported under
+ your OS :(<BR>
+ If it does hardware scaling under Windows, it doesn't mean it will do the
+ same under Linux or other OS, it depends on the drivers! Most
+ manufacturers don't make Linux drivers nor release chip specs - so you're
+ unlucky using their cards. See the next section:</LI>
+ </UL>
+ </LI>
</UL>
-<P>
-<B>Non-YUV cards</B></P>
+<P><B>Non-YUV cards</B></P>
<P>Fullscreen playing can be achieved by either zooming <B>by software</B> (use
the option <CODE>-zoom</CODE> or <A HREF="#2.6.11"><CODE>-vop
@@ -618,8 +607,7 @@ you get a nice and very fast fullscreen playing.</P>
video mode, for example to 352x288. If you don't have YUV acceleration, this
latter method is the recommended one. Throughout <B>MPlayer</B>, <U>this
behavior can be switched on by using the <CODE>-vm</CODE> option</U> and with
- the following drivers:
-</P>
+ the following drivers:</P>
<UL>
<LI><B>using</B> XFree86: see details in
@@ -664,34 +652,28 @@ you get a nice and very fast fullscreen playing.</P>
<P><B>SOUND CARDS</B></P>
<UL>
-<LI><B>Soundblaster Live!</B>: with this card you can use 4 or 6 (<B>5.1</B>)
- channels AC3 decoding instead of 2. Read the
- <A HREF="codecs.html#software_ac3">Software AC3 decoding</A> section.
- For hardware AC3 passthrough you MUST use ALSA 0.9 oss emulation!</LI>
-
-<LI><B>C-Media with SP/DIF out</B>: hardware AC3 passthrough is possible
- with these cards, see
- <A HREF="codecs.html#hardware_ac3">Hardware AC3 decoding</A> section.</LI>
-
-<LI><B>other cards'</B> features aren't supported by <B>MPlayer</B>.
- <U>It's very recommended to read the <A HREF="sound.html">sound card
- section</A>!</U></LI>
+ <LI><B>Soundblaster Live!</B>: with this card you can use 4 or 6 (<B>5.1</B>)
+ channels AC3 decoding instead of 2. Read the
+ <A HREF="codecs.html#software_ac3">Software AC3 decoding</A> section.
+ For hardware AC3 passthrough you MUST use ALSA 0.9 oss emulation!</LI>
+ <LI><B>C-Media with SP/DIF out</B>: hardware AC3 passthrough is possible
+ with these cards, see
+ <A HREF="codecs.html#hardware_ac3">Hardware AC3 decoding</A> section.</LI>
+ <LI><B>other cards'</B> features aren't supported by <B>MPlayer</B>.
+ <U>It's very recommended to read the <A HREF="sound.html">sound card
+ section</A>!</U></LI>
</UL>
<P><B>FEATURES</B></P>
<UL>
-<LI>Decide if you need GUI. If you do, see the <A HREF="#gui">GUI section</A>
- before compiling.</LI>
-
-<LI>If you want to install <B>MEncoder</B> (our great all-purpose encoder),
- see the <A HREF="encoding.html">MEncoder section</A>.</LI>
-
-
-<LI>If you have a V4L compatible <B>TV tuner</B> card, and wish to watch/grab
- and encode movies with <B>MPlayer</B>, read the <A HREF="#tv">TV input</A>
- section.</LI>
-
+ <LI>Decide if you need GUI. If you do, see the <A HREF="#gui">GUI section</A>
+ before compiling.</LI>
+ <LI>If you want to install <B>MEncoder</B> (our great all-purpose encoder),
+ see the <A HREF="encoding.html">MEncoder section</A>.</LI>
+ <LI>If you have a V4L compatible <B>TV tuner</B> card, and wish to watch/grab
+ and encode movies with <B>MPlayer</B>, read the <A HREF="#tv">TV input</A>
+ section.</LI>
</UL>
<P>Then build <B>MPlayer</B>:</P>
@@ -762,6 +744,7 @@ you get a nice and very fast fullscreen playing.</P>
<CODE>-skin newskin</CODE> option, or the <CODE>skin=newskin</CODE> config
file directive to use the skin in <CODE>*/Skin/newskin</CODE> directory.</P>
+
<P><B><A NAME="subtitles_osd">1.5 Subtitles and OSD</A></B></P>
<P>
@@ -782,8 +765,7 @@ you get a nice and very fast fullscreen playing.</P>
The command line options differ slightly for the different formats:
-<P>
- <B>VobSub subtitles</B><BR>
+<P><B>VobSub subtitles</B><BR>
VobSub subtitles consist of a big (some megabytes) .SUB file, and optional
.IDX and/or .IFO files.<BR>
Usage: if you have files like <CODE>sample.sub</CODE>,
@@ -793,22 +775,18 @@ The command line options differ slightly for the different formats:
<CODE>-vobsubid</CODE> option is like <CODE>-sid</CODE> for DVDs, you can
choose between subtitle tracks (languages) with it.</P>
-<P>
- <B>Other subtitles</B><BR>
+<P><B>Other subtitles</B><BR>
The other formats consist of a single text file containing timing, placement
and text information.<BR>
Usage: if you have a file like <CODE>sample.txt</CODE>, you have to pass the
- option <CODE>-sub sample.txt</CODE> (optionally with pathname, of course).
-</P>
+ option <CODE>-sub sample.txt</CODE> (optionally with pathname, of course).</P>
-<P>
- <B>Adjusting subtitle timing and placement</B><BR>
+<P><B>Adjusting subtitle timing and placement</B><BR>
<CODE>-subdelay &lt;sec&gt;</CODE>: Delays subtitles by &lt;sec&gt; seconds.
Can be negative.<BR>
<CODE>-subfps &lt;rate&gt;</CODE>: Specify frame/sec rate of subtitle file
(float number)<BR>
- <CODE>-subpos &lt;0 - 100&gt;</CODE>: Specify the position of subtitles.<BR>
-</P>
+ <CODE>-subpos &lt;0 - 100&gt;</CODE>: Specify the position of subtitles.</P>
<P>If you experience a growing delay between the movie and the subtitles when
using a MicroDVD subtitle file, most likely the frame rate of the movie and
@@ -826,22 +804,19 @@ The command line options differ slightly for the different formats:
designed by me (Gabucino). Basically its main feature is being
<I>dynamically</I> time-based (although it has frame-based mode too). Example
(from
- <A HREF="tech/mpsub.sub">DOCS/tech/mpsub.sub</A>):
-</P>
-
-<P><CODE><I>
-# first number : wait this much after previous subtitle disappeared<BR>
-# second number : display the current subtitle for this many seconds<BR>
-<BR>
-15 3<BR>
-A long long, time ago...<BR>
-<BR>
-0 3<BR>
-in a galaxy far away...<BR>
-<BR>
-0 3<BR>
-Naboo was under an attack.<BR>
-</I></CODE></P>
+ <A HREF="tech/mpsub.sub">DOCS/tech/mpsub.sub</A>):</P>
+
+<P><CODE><I># first number : wait this much after previous subtitle disappeared<BR>
+ # second number : display the current subtitle for this many seconds<BR>
+ <BR>
+ 15 3<BR>
+ A long long, time ago...<BR>
+ <BR>
+ 0 3<BR>
+ in a galaxy far away...<BR>
+ <BR>
+ 0 3<BR>
+ Naboo was under an attack.<BR></I></CODE></P>
<P>So you see, the main goal was to <B>make subtitle
editing/timing/joining/cutting easy</B>. And, if you - say - get an SSA
@@ -880,11 +855,9 @@ Naboo was under an attack.<BR>
<LI><A HREF="http://realtime.ssu.ac.kr/~lethean/mplayer">http://realtime.ssu.ac.kr/~lethean/mplayer</A> - Korean fonts & RAW plugin</LI>
</UL>
</LI>
-
<LI>use the font generator tool at TOOLS/subfont-c
It's a complete tool to convert from TTF/Type1/etc font to mplayer font pkg.
(read TOOLS/subfont-c/README for details)</LI>
-
<LI>use the font generator GIMP plugin at TOOLS/subfont-GIMP
(note: you must have HSI RAW plugin too, see URL below)</LI>
</UL>
@@ -906,9 +879,11 @@ Naboo was under an attack.<BR>
<P>You can change default behaviour by setting <CODE>osdlevel=</CODE> variable
in config file.</P>
+
<P><B><A NAME="rtc">1.6 RTC</A></B></P>
There are three timing methods in <B>MPlayer</B>.
+
<UL>
<LI><B>To use the old method</B>, you don't have to do anything. It uses
<CODE>usleep()</CODE> to tune A/V sync, with +/- 10ms accuracy. However
@@ -953,6 +928,7 @@ There are three timing methods in <B>MPlayer</B>.
It's a clear way for everyone to become root.
+
<P><B><A NAME="features">2. Features</A></B></P>
@@ -996,7 +972,9 @@ TV tuner</B>.</P>
(<CODE>-vo sdl</CODE>) colorspaces.
You can specify these with the <CODE>outfmt=YV12</CODE> option, see below.</P>
+
<P><A NAME="tv_options"><B>2.5.3 Available options</B></A></P>
+
<TABLE BORDER=0>
<TR>
<TD>&nbsp;&nbsp;</TD>
@@ -1080,31 +1058,29 @@ TV tuner</B>.</P>
</TR>
</TABLE>
+
<P><A NAME="tv_keyboard"><B>2.5.4 Keyboard control</B></A></P>
<TABLE BORDER=0>
-<TR><TD>&nbsp;&nbsp;</TD><TD>h / k</TD><TD>&nbsp;&nbsp;</TD><TD>select previous/next channel</TD></TR>
-<TR><TD></TD><TD>n</TD><TD></TD><TD>change norm</TD></TR>
-<TR><TD></TD><TD>b</TD><TD></TD><TD>change channel list</TD></TR>
+ <TR><TD>&nbsp;&nbsp;</TD><TD>h / k</TD><TD>&nbsp;&nbsp;</TD><TD>select previous/next channel</TD></TR>
+ <TR><TD></TD><TD>n</TD><TD></TD><TD>change norm</TD></TR>
+ <TR><TD></TD><TD>b</TD><TD></TD><TD>change channel list</TD></TR>
</TABLE>
+
<P><A NAME="tv_examples"><B>2.5.5 Examples</B></A></P>
-<P>
-Dummy output, to AAlib :)<BR>
-<CODE>&nbsp;&nbsp;&nbsp;&nbsp;mplayer -tv on:driver=dummy:width=640:height=480 -vo aa</CODE><BR>
-<BR>
-Input from standard V4L<BR>
-<CODE>&nbsp;&nbsp;&nbsp;&nbsp;mplayer -tv on:driver=v4l:width=640:height=480:outfmt=i420 -vc rawi420 -vo xv</CODE><BR>
-</P>
+<P>Dummy output, to AAlib :)<BR>
+ <CODE>&nbsp;&nbsp;&nbsp;&nbsp;mplayer -tv on:driver=dummy:width=640:height=480 -vo aa</CODE><BR>
+ <BR>
+ Input from standard V4L<BR>
+ <CODE>&nbsp;&nbsp;&nbsp;&nbsp;mplayer -tv on:driver=v4l:width=640:height=480:outfmt=i420 -vc rawi420 -vo xv</CODE><BR></P>
-<P>
- <B>Note:</B><BR>
+<P><B>Note:</B><BR>
If you have a TV card with an external audio device and get only a black
screen, although input works with xawtv or similar, then try to use the
<CODE>-noaudio</CODE> option. For the example above this would be:<BR>
- <CODE>&nbsp;&nbsp;&nbsp;&nbsp;mplayer -tv on:noaudio:driver=v4l:width=640:height=480:outfmt=i420 -vc rawi420 -vo xv</CODE>
-</P>
+ <CODE>&nbsp;&nbsp;&nbsp;&nbsp;mplayer -tv on:noaudio:driver=v4l:width=640:height=480:outfmt=i420 -vc rawi420 -vo xv</CODE></P>
<P><A NAME="filters"><B>2.6 filters</B></A></P>
@@ -1130,6 +1106,7 @@ Input from standard V4L<BR>
<P>Note that the postprocessing code is now also a part of the layer. It
will be explained below.</P>
+
<P><A NAME="filters_usage"><B>2.6.2 Usage</B></A></P>
<P><CODE>&nbsp;&nbsp;mplayer/mencoder -vop filter1,filter2,filter3,...</CODE>
@@ -1334,8 +1311,10 @@ Input from standard V4L<BR>
<P><CODE>&nbsp;&nbsp;-vop rectangle[=width:height:x:y]</CODE></P>
+
<P><B><A NAME="usage">3. Usage</A></B></P>
+
<P><B><A NAME="command_line">3.1 Command line</A></B></P>
<P><B>MPlayer</B> utilizes a complex playtree. It consists of global options
@@ -1348,17 +1327,16 @@ Input from standard V4L<BR>
</P>
<TABLE BORDER=0>
-<TR><TD>&nbsp;&nbsp;</TD><TD>file</TD><TD>&nbsp;&nbsp;</TD><TD><CODE>mplayer [options] [path/]filename</CODE></TD></TR>
-<TR><TD></TD><TD>files</TD><TD></TD><TD><CODE>mplayer [default options] [path/]filename1 [options for filename1] filename2 [options for filename2] ...</CODE></TD></TR>
-<TR><TD></TD><TD>VCD</TD><TD></TD><TD><CODE>mplayer [options] -vcd trackno [-cdrom-device /dev/cdrom]</CODE></TD></TR>
-<TR><TD></TD><TD>DVD</TD><TD></TD><TD><CODE>mplayer [options] -dvd titleno [-dvd-device /dev/dvd]</CODE></TD></TR>
-<TR><TD></TD><TD>net</TD><TD></TD><TD><CODE>mplayer [options] http://site.com/file.asf (playlists can be used too)</CODE></TD></TR>
+ <TR><TD>&nbsp;&nbsp;</TD><TD>file</TD><TD>&nbsp;&nbsp;</TD><TD><CODE>mplayer [options] [path/]filename</CODE></TD></TR>
+ <TR><TD></TD><TD>files</TD><TD></TD><TD><CODE>mplayer [default options] [path/]filename1 [options for filename1] filename2 [options for filename2] ...</CODE></TD></TR>
+ <TR><TD></TD><TD>VCD</TD><TD></TD><TD><CODE>mplayer [options] -vcd trackno [-cdrom-device /dev/cdrom]</CODE></TD></TR>
+ <TR><TD></TD><TD>DVD</TD><TD></TD><TD><CODE>mplayer [options] -dvd titleno [-dvd-device /dev/dvd]</CODE></TD></TR>
+ <TR><TD></TD><TD>net</TD><TD></TD><TD><CODE>mplayer [options] http://site.com/file.asf (playlists can be used too)</CODE></TD></TR>
</TABLE>
<P>
-Latest versions of MPlayer also accepts VCD and DVD tracks in URL style, just like
-Xine does: <CODE>mplayer dvd://1</CODE> or <CODE>mplayer vcd://1</CODE>
-</P>
+ Latest versions of MPlayer also accepts VCD and DVD tracks in URL style, just like
+ Xine does: <CODE>mplayer dvd://1</CODE> or <CODE>mplayer vcd://1</CODE></P>
<PRE>
mplayer -vo x11 /mnt/Films/Contact/contact2.mpg
@@ -1368,65 +1346,66 @@ Xine does: <CODE>mplayer dvd://1</CODE> or <CODE>mplayer vcd://1</CODE>
mplayer -abs 65536 -delay -0.4 -nobps ~/movies/test.avi
</PRE>
+
<P><B><A NAME="control">3.2 Control</A></B></P>
<P><B>MPlayer</B> has a fully configurable, command driven, control layer which
lets you control <B>MPlayer</B> with keyboard, mouse, joystick or remote
control (using LIRC).</P>
+
<P><B><A NAME="default_controls">3.2.1 Default controls</A></B></P>
<P><B>Keyboard</B></P>
<TABLE BORDER=0>
-<TR><TD>&nbsp;&nbsp;</TD><TD>&lt;- or -&gt;</TD><TD>&nbsp;&nbsp;</TD><TD>seek backward/forward 10 seconds</TD></TR>
-<TR><TD></TD><TD>up or down</TD><TD></TD><TD>seek backward/forward 1 minute</TD></TR>
-<TR><TD></TD><TD>pgup/pgdown</TD><TD></TD><TD>seek backward/forward 10 minutes</TD></TR>
-<TR><TD></TD><TD>&lt; or &gt;</TD><TD></TD><TD>seek backward/forward in playlist</TD></TR>
-<TR><TD></TD><TD>p or SPACE</TD><TD></TD><TD>pause movie (press any key)</TD></TR>
-<TR><TD></TD><TD>q or ESC</TD><TD></TD><TD>stop playing and quit program</TD></TR>
-<TR><TD></TD><TD>+ or -</TD><TD></TD><TD>adjust audio delay by +/- 0.1 second</TD></TR>
-<TR><TD></TD><TD>/ or *</TD><TD></TD><TD>decrease/increase volume</TD></TR>
-<TR><TD></TD><TD>f</TD><TD></TD><TD>toggle fullscreen</TD></TR>
-<TR><TD></TD><TD>o</TD><TD></TD><TD>toggle OSD: none / seek / seek+timer</TD></TR>
-<TR><TD></TD><TD>z or x</TD><TD></TD><TD>adjust subtitle delay by +/- 0.1 second</TD></TR>
-<TR><TD></TD><TD>r or t</TD><TD></TD><TD>adjust subtitle position</TD></TR>
-<TR><TD></TD><TD>HOME or END</TD><TD></TD><TD>go to next/previous playtree entry in the parent list</TD></TR>
-<TR><TD></TD><TD>INSERT or DELETE</TD><TD></TD><TD>go to next/previous alternative source (only available in asx playlist)</TD></TR>
-
-<TR><TD COLSPAN=4><P><I>(the following keys are valid only when using <CODE>-vo xv</CODE>)</I></P></TD></TR>
-
-<TR><TD></TD><TD>1 or 2</TD><TD></TD><TD>adjust contrast</TD></TR>
-<TR><TD></TD><TD>3 or 4</TD><TD></TD><TD>adjust brightness</TD></TR>
-<TR><TD></TD><TD>5 or 6</TD><TD></TD><TD>adjust hue</TD></TR>
-<TR><TD></TD><TD>7 or 8</TD><TD></TD><TD>adjust saturation</TD></TR>
+ <TR><TD>&nbsp;&nbsp;</TD><TD>&lt;- or -&gt;</TD><TD>&nbsp;&nbsp;</TD><TD>seek backward/forward 10 seconds</TD></TR>
+ <TR><TD></TD><TD>up or down</TD><TD></TD><TD>seek backward/forward 1 minute</TD></TR>
+ <TR><TD></TD><TD>pgup/pgdown</TD><TD></TD><TD>seek backward/forward 10 minutes</TD></TR>
+ <TR><TD></TD><TD>&lt; or &gt;</TD><TD></TD><TD>seek backward/forward in playlist</TD></TR>
+ <TR><TD></TD><TD>p or SPACE</TD><TD></TD><TD>pause movie (press any key)</TD></TR>
+ <TR><TD></TD><TD>q or ESC</TD><TD></TD><TD>stop playing and quit program</TD></TR>
+ <TR><TD></TD><TD>+ or -</TD><TD></TD><TD>adjust audio delay by +/- 0.1 second</TD></TR>
+ <TR><TD></TD><TD>/ or *</TD><TD></TD><TD>decrease/increase volume</TD></TR>
+ <TR><TD></TD><TD>f</TD><TD></TD><TD>toggle fullscreen</TD></TR>
+ <TR><TD></TD><TD>o</TD><TD></TD><TD>toggle OSD: none / seek / seek+timer</TD></TR>
+ <TR><TD></TD><TD>z or x</TD><TD></TD><TD>adjust subtitle delay by +/- 0.1 second</TD></TR>
+ <TR><TD></TD><TD>r or t</TD><TD></TD><TD>adjust subtitle position</TD></TR>
+ <TR><TD></TD><TD>HOME or END</TD><TD></TD><TD>go to next/previous playtree entry in the parent list</TD></TR>
+ <TR><TD></TD><TD>INSERT or DELETE</TD><TD></TD><TD>go to next/previous alternative source (only available in asx playlist)</TD></TR>
+ <TR><TD COLSPAN=4><P><I>(the following keys are valid only when using <CODE>-vo xv</CODE>)</I></P></TD></TR>
+ <TR><TD></TD><TD>1 or 2</TD><TD></TD><TD>adjust contrast</TD></TR>
+ <TR><TD></TD><TD>3 or 4</TD><TD></TD><TD>adjust brightness</TD></TR>
+ <TR><TD></TD><TD>5 or 6</TD><TD></TD><TD>adjust hue</TD></TR>
+ <TR><TD></TD><TD>7 or 8</TD><TD></TD><TD>adjust saturation</TD></TR>
</TABLE>
<P><B>GUI</B></P>
<TABLE BORDER=0>
-<TR><TD>&nbsp;&nbsp;</TD><TD>, and .</TD><TD>&nbsp;&nbsp;</TD><TD>previous / next file</TD></TR>
-<TR><TD></TD><TD>gray - or +</TD><TD></TD><TD>decrease / increase volume</TD></TR>
-<TR><TD></TD><TD>enter</TD><TD></TD><TD>start playing</TD></TR>
-<TR><TD></TD><TD>space</TD><TD></TD><TD>pause</TD></TR>
-<TR><TD></TD><TD>s</TD><TD></TD><TD>stop</TD></TR>
-<TR><TD></TD><TD>a</TD><TD></TD><TD>about</TD></TR>
-<TR><TD></TD><TD>l</TD><TD></TD><TD>load file</TD></TR>
-<TR><TD></TD><TD>b</TD><TD></TD><TD>skin browser</TD></TR>
-<TR><TD></TD><TD>e</TD><TD></TD><TD>toggle equalizer</TD></TR>
-<TR><TD></TD><TD>p</TD><TD></TD><TD>toggle playlist</TD></TR>
-<TR><TD></TD><TD>f</TD><TD></TD><TD>toggle fullscreen</TD></TR>
-<TR><TD></TD><TD>m</TD><TD></TD><TD>toggle mute</TD>
+ <TR><TD>&nbsp;&nbsp;</TD><TD>, and .</TD><TD>&nbsp;&nbsp;</TD><TD>previous / next file</TD></TR>
+ <TR><TD></TD><TD>gray - or +</TD><TD></TD><TD>decrease / increase volume</TD></TR>
+ <TR><TD></TD><TD>enter</TD><TD></TD><TD>start playing</TD></TR>
+ <TR><TD></TD><TD>space</TD><TD></TD><TD>pause</TD></TR>
+ <TR><TD></TD><TD>s</TD><TD></TD><TD>stop</TD></TR>
+ <TR><TD></TD><TD>a</TD><TD></TD><TD>about</TD></TR>
+ <TR><TD></TD><TD>l</TD><TD></TD><TD>load file</TD></TR>
+ <TR><TD></TD><TD>b</TD><TD></TD><TD>skin browser</TD></TR>
+ <TR><TD></TD><TD>e</TD><TD></TD><TD>toggle equalizer</TD></TR>
+ <TR><TD></TD><TD>p</TD><TD></TD><TD>toggle playlist</TD></TR>
+ <TR><TD></TD><TD>f</TD><TD></TD><TD>toggle fullscreen</TD></TR>
+ <TR><TD></TD><TD>m</TD><TD></TD><TD>toggle mute</TD>
</TABLE>
<P><B>TV</B></P>
<TABLE BORDER=0>
-<TR><TD>&nbsp;&nbsp;</TD><TD>h or l</TD><TD>&nbsp;&nbsp;</TD><TD>select previous/next channel</TD></TR>
-<TR><TD></TD><TD>n</TD><TD></TD><TD>change norm</TD></TR>
-<TR><TD></TD><TD>b</TD><TD></TD><TD>change channel list</TD></TR>
+ <TR><TD>&nbsp;&nbsp;</TD><TD>h or l</TD><TD>&nbsp;&nbsp;</TD><TD>select previous/next channel</TD></TR>
+ <TR><TD></TD><TD>n</TD><TD></TD><TD>change norm</TD></TR>
+ <TR><TD></TD><TD>b</TD><TD></TD><TD>change channel list</TD></TR>
</TABLE>
+
<P><B><A NAME="controls_configuration">3.2.2 Controls configuration</A></B></P>
<P><B>MPlayer</B> allows you bind any key/button to any <B>MPlayer</B> command
@@ -1461,23 +1440,23 @@ ENTER pt_step 1 1
<P><B>Keyboard</B></P>
<UL>
-<LI>Any printable character</LI>
-<LI>SPACE</LI>
-<LI>ENTER</LI>
-<LI>TAB</LI>
-<LI>CTRL</LI>
-<LI>BS</LI>
-<LI>DEL</LI>
-<LI>INS</LI>
-<LI>HOME</LI>
-<LI>END</LI>
-<LI>PGUP</LI>
-<LI>PGDWN</LI>
-<LI>ESC</LI>
-<LI>RIGHT</LI>
-<LI>LEFT</LI>
-<LI>UP</LI>
-<LI>DOWN</LI>
+ <LI>Any printable character</LI>
+ <LI>SPACE</LI>
+ <LI>ENTER</LI>
+ <LI>TAB</LI>
+ <LI>CTRL</LI>
+ <LI>BS</LI>
+ <LI>DEL</LI>
+ <LI>INS</LI>
+ <LI>HOME</LI>
+ <LI>END</LI>
+ <LI>PGUP</LI>
+ <LI>PGDWN</LI>
+ <LI>ESC</LI>
+ <LI>RIGHT</LI>
+ <LI>LEFT</LI>
+ <LI>UP</LI>
+ <LI>DOWN</LI>
</UL>
<P><B>Mouse</B></P>
@@ -1485,13 +1464,13 @@ ENTER pt_step 1 1
<P>Note: mouse is only supported under X</P>
<UL>
-<LI>MOUSE_BTN0 (Left button)</LI>
-<LI>MOUSE_BTN1 (Right button)</LI>
-<LI>MOUSE_BTN2 (Middle button)</LI>
-<LI>MOUSE_BTN3 (Wheel)</LI>
-<LI>MOUSE_BTN4 (Wheel)</LI>
-<LI>...</LI>
-<LI>MOUSE_BTN9</LI>
+ <LI>MOUSE_BTN0 (Left button)</LI>
+ <LI>MOUSE_BTN1 (Right button)</LI>
+ <LI>MOUSE_BTN2 (Middle button)</LI>
+ <LI>MOUSE_BTN3 (Wheel)</LI>
+ <LI>MOUSE_BTN4 (Wheel)</LI>
+ <LI>...</LI>
+ <LI>MOUSE_BTN9</LI>
</UL>
<P><B>Joystick</B></P>
@@ -1499,15 +1478,15 @@ ENTER pt_step 1 1
<P>Note: joystick support must be enabled at compile time</P>
<UL>
-<LI>JOY_RIGHT or JOY_AXIS0_PLUS</LI>
-<LI>JOY_LEFT or JOY_AXIS0_MINUS</LI>
-<LI>JOY_UP or JOY_AXIS1_MINUS</LI>
-<LI>JOY_DOWN or JOY_AXIS1_PLUS</LI>
-<LI>JOY_AXIS2_PLUS</LI>
-<LI>JOY_AXIS2_MINUS</LI>
-<LI>....</LI>
-<LI>JOY_AXIS9_PLUS</LI>
-<LI>JOY_AXIS9_MINUS</LI>
+ <LI>JOY_RIGHT or JOY_AXIS0_PLUS</LI>
+ <LI>JOY_LEFT or JOY_AXIS0_MINUS</LI>
+ <LI>JOY_UP or JOY_AXIS1_MINUS</LI>
+ <LI>JOY_DOWN or JOY_AXIS1_PLUS</LI>
+ <LI>JOY_AXIS2_PLUS</LI>
+ <LI>JOY_AXIS2_MINUS</LI>
+ <LI>....</LI>
+ <LI>JOY_AXIS9_PLUS</LI>
+ <LI>JOY_AXIS9_MINUS</LI>
</UL>
@@ -1517,66 +1496,51 @@ ENTER pt_step 1 1
<UL>
<LI><B>seek</B> (int) val [(int) type=0]
- <P>Seek to some place in the movie.<BR>
- Type 0 is a relative seek of +/- val seconds.<BR>
- Type 1 seek to val % in the movie.</P>
- </LI>
+ <P>Seek to some place in the movie.<BR>
+ Type 0 is a relative seek of +/- val seconds.<BR>
+ Type 1 seek to val % in the movie.</P></LI>
<LI><B>audio_delay</B> (float) val
- <P>Adjust the audio delay of val seconds</P>
- </LI>
+ <P>Adjust the audio delay of val seconds</P></LI>
<LI><B>quit</B>
- <P>Quit <B>MPlayer</B></P>
- </LI>
+ <P>Quit <B>MPlayer</B></P></LI>
<LI><B>pause</B>
- <P>Pause/unpause the playback</P>
- </LI>
+ <P>Pause/unpause the playback</P></LI>
<LI><B>grap_frames</B>
- <P>Somebody know ?</P>
- </LI>
+ <P>Somebody know ?</P></LI>
<LI><B>pt_step</B> (int) val [(int) force=0]
- <P>Go to next/previous entry in playtree. Val sign tell the direction.<BR>
- If no other entry is available in the given direction it won't do anything unless force is non 0.
- </P>
- </LI>
+ <P>Go to next/previous entry in playtree. Val sign tell the direction.<BR>
+ If no other entry is available in the given direction it won't do anything
+ unless force is non 0.</P></LI>
<LI><B>pt_up_step</B> (int) val [(int) force=0]
- <P>Like pt_step but it jump to next/previous in the parent list. It's useful to break inner loop in the playtree.</P>
- </LI>
+ <P>Like pt_step but it jump to next/previous in the parent list. It's useful
+ to break inner loop in the playtree.</P></LI>
<LI><B>alt_src_step</B> (int) val
- <P>When more than one source is available it select the next/previous one (only supported by asx playlist).</P>
- </LI>
+ <P>When more than one source is available it select the next/previous one
+ (only supported by asx playlist).</P></LI>
<LI><B>sub_delay</B> (float) val [(int) abs=0]
- <P>Adjust the subtitles delay of +/- val seconds or set it to val seconds when abs is non zero.</P>
- </LI>
+ <P>Adjust the subtitles delay of +/- val seconds or set it to val seconds
+ when abs is non zero.</P></LI>
<LI><B>osd</B> [(int) level=-1]
- <P>Toggle osd mode or set it to level when level > 0.</P>
- </LI>
+ <P>Toggle osd mode or set it to level when level > 0.</P></LI>
<LI><B>volume</B> (int) dir
- <P>Increase/decrease volume</P>
- </LI>
+ <P>Increase/decrease volume</P></LI>
<LI><B>contrast</B> (int) val [(int) abs=0]</LI>
<LI><B>brightness</B> (int) val [(int) abs=0]</LI>
<LI><B>hue</B> (int) val [(int) abs=0]</LI>
<LI><B>saturation</B> (int) val [(int) abs=0]
- <P>Set/Adjust video parameters. Val range from -100 to 100.</P>
- </LI>
+ <P>Set/Adjust video parameters. Val range from -100 to 100.</P></LI>
<LI><B>frame_drop</B> [(int) type=-1]
- <P>Toggle/Set frame dropping mode.</P>
- </LI>
+ <P>Toggle/Set frame dropping mode.</P></LI>
<LI><B>sub_pos</B> (int) val
- <P>Adjust subtitles position.</P>
- </LI>
+ <P>Adjust subtitles position.</P></LI>
<LI><B>vo_fullscreen</B>
- <P>Switch fullscreen mode.</P>
- </LI>
+ <P>Switch fullscreen mode.</P></LI>
<LI><B>tv_step_channel</B> (int) dir
- <P>Select next/previous tv channel.</P>
- </LI>
+ <P>Select next/previous tv channel.</P></LI>
<LI><B>tv_step_norm</B>
- <P>Change TV norm.</P>
- </LI>
+ <P>Change TV norm.</P></LI>
<LI><B>tv_step_chanlist</B>
- <P>Change channel list.</P>
- </LI>
+ <P>Change channel list.</P></LI>
<LI><B>gui_loadfile</B></LI>
<LI><B>gui_loadsubtitle</B></LI>
<LI><B>gui_about</B></LI>
@@ -1585,15 +1549,15 @@ ENTER pt_step 1 1
<LI><B>gui_playlist</B></LI>
<LI><B>gui_preferences</B></LI>
<LI><B>gui_skinbrowser</B>
- <P>GUI actions</P>
- </LI>
+ <P>GUI actions</P></LI>
</UL>
+
<P><B><A NAME="lirc">3.2.3 Control from LIRC</A></B></P>
<P>Linux Infrared Remote Control - use an easy to build home-brewn IR-receiver,
-an (almost) arbitrary remote control and control your linux box with it!
-More about it at <A HREF="http://www.lirc.org">www.lirc.org</A>.</P>
+ an (almost) arbitrary remote control and control your linux box with it!
+ More about it at <A HREF="http://www.lirc.org">www.lirc.org</A>.</P>
<P>If you have installed the lirc-package, configure will autodetect it. If
everything went fine, <B>MPlayer</B> will print a message like "Setting up
@@ -1666,12 +1630,15 @@ end
<P><CODE>&nbsp;&nbsp;wget ftp://micorsops.com/something.avi -O - | mplayer -cache 8192 -</CODE></P>
+
<P><B><A NAME="faq"></A>4. <A HREF="faq.html">FAQ section</A></B></P>
+
<P><B><A NAME="cd/dvd"></A>5. <A HREF="cd-dvd.html">CD/DVD section</A></B></P>
+
<P><B><A NAME="ports">6. Ports</A></B></P>
@@ -1721,6 +1688,7 @@ end
<P>There's no DVD support for FreeBSD yet.</P>
+
<P><B><A NAME="solaris">6.3 Solaris</A></B></P>
<P>MPlayer should work on Solaris 2.6 or newer.</P>
@@ -1871,6 +1839,8 @@ end
make <B>MPlayer</B> compile. Otherwise it will complain about missing
<CODE>intypes.h</CODE>.</P>
+
+
<P><B><A NAME="authors">Appendix A - Authors</A></B></P>
<P>NOTE: Do *NOT* send bug reports, help &amp; feature requests directly to the authors!</P>
@@ -1880,448 +1850,393 @@ end
<P ALIGN=center><B><U>The <B>MPlayer</B> project:</U></B></P>
<UL>
-
-<LI><B><A HREF="mailto:send mail to mplayer-users!">Árpád Gereöffy (A'rpi/ESP-team)</A></B>
-<UL>
- <LI>player code (mpeg stream demultiplexer and avi/asf parser, A-V sync, seek...)</LI>
- <LI>mp3lib, based on mpglib sources [MP3 audio decoder]</LI>
- <LI>getch2 [keyboard handler]</LI>
- <LI>some changes in libmpeg2 code (progressive frames, bitrate &amp; fps support)</LI>
- <LI>libvo improvements: adding OpenGL support, bugfix in mga driver...</LI>
- <LI>triple buffering &amp; YUY2 support (for DivX/MPEG4) into mga_vid driver</LI>
- <LI>scripts in the TVout directory (TVout on Matrox G400DH, read documentation)</LI>
- <LI>hacking DivX/Mpeg4 VfW codecs to get YUV output</LI>
- <LI>opendivx decoder speed optimizations (see opendivx/ChangeLog)</LI>
- <LI>OSD &amp; SUB display code</LI>
- <LI>FFmpeg/libavcodec integration</LI>
- <LI>DivX4Linux (Project Mayo) support (see documentation)</LI>
- <LI>New DVD-Support using libdvdread</LI>
- <LI>DVB support</LI>
- <LI>MPEG PES output &amp; DVB card support</LI>
- <LI>anything that isn't mentioned elsewhere</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:pontscho@makacs.poliod.hu">Zoltán Ponekker (Pontscho/Fresh!)</A></B>
-<UL>
- <LI>configure script and Makefiles for easy compile</LI>
- <LI>GUI system</LI>
- <LI>3DNow! support into mp3lib</LI>
- <LI>3DNow! support into fastmemcpy.h</LI>
- <LI>various X11 driver changes (keyboard handling, fullscreen, bpp detect, etc)</LI>
- <LI>libvo: adding xmga driver, and fullscreen support to xv</LI>
- <LI>audio mixer (volume) support</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:lgb@lgb.hu">Gábor Lénárt (LGB)</A></B>
-<UL>
- <LI>configure script improvements</LI>
- <LI>Makefile improvements</LI>
- <LI>preliminary DVD support</LI>
- <LI>various X11 cleanups and fixes</LI>
- <LI>HTMLization of documentation</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:gabucino@mplayerhq.hu">Gábor Bérczi (Gabucino)</A></B>
-<UL>
- <LI>documentation writer & maintainer</LI>
- <LI>Hungarian translation of documentation, homepage, and help output</LI>
- <LI>second homepage design&amp;gfx</LI>
- <LI>homepage maintainer</LI>
- <LI>testing, codecs quality &amp; speed comparisons</LI>
- <LI>IRC channels operator (#MPlayer is user channel)</LI>
- <LI>experimental MINIX port :) (what's funny about it?)</LI>
- <LI>MPsub subtitle format design</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:szabi@inf.elte.hu">Szabolcs Berecz (Szabi)</A></B>
-<UL>
- <LI>codecs.conf file parser</LI>
- <LI>config file and command line parser</LI>
- <LI>mga_vid fixes, module option etc.</LI>
- <LI>fbdev support in libvo</LI>
- <LI>type #7 subtitle support</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:lez@sch.bme.hu">László Megyer (Lez, Laaz)</A></B>
-<UL>
- <LI>SUB reader</LI>
- <LI>screensaver+DPMS disable for libvo</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:chass-@freemail.hu">Gyula László (Chass, Tégla)</A></B>
-<UL>
- <LI>first fonts (mp_font1.zip)</LI>
- <LI>third homepage design&amp;gfx</LI>
- <LI>fourth (current) homepage design&amp;gfx</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:se7en@sch.bme.hu">Zoltán Márk Vicián (Se7en)</A></B>
-<UL>
- <LI>SVGAlib support in libvo</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:alex@naxine.org">Alex Beregszaszi (al3x)</A></B>
-<UL>
- <LI>ALSA output driver in libao2</LI>
- <LI>vo_ggi output driver in libvo (www.ggi-project.org)</LI>
- <LI>XAnim codecs support</LI>
- <LI>VIVO files support</LI>
- <LI>TV grabbing support</LI>
- <LI>Quicktime hackings</LI>
- <LI>libavcodec support in MEncoder</LI>
- <LI>RM file format demuxer</LI>
- <LI>mencoder framecopy</LI>
- <LI>yuv4mpeg1 support</LI>
- <LI>NuppelVideo demuxer changes</LI>
- <LI>subconfig</LI>
- <LI>VIDIX and libdha hackings</LI>
- <LI>Matrox driver port to Vidix</LI>
- <LI>XVidix video output driver</LI>
- <LI>and other various stuff (in libvo, libmad syncing, dec_audio/video and loader)</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:asackerm@stud.informatik.uni-erlangen.de">Andreas Ackermann (Acki)</A></B>
-<UL>
- <LI>LIRC support (see documentation)</LI>
- <LI>DGA support in libvo</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:atmosfear@users.sourceforge.net">Felix Bünemann (Atmos)</A></B>
-<UL>
- <LI>SDL driver maintainer</LI>
- <LI>Additional YUV formats fixes</LI>
- <LI>New font (mp_font2.zip)</LI>
- <LI>PNG file output support in libvo</LI>
- <LI>flipping support (for Indeo 3/4, etc)</LI>
- <LI>SDL audio driver in libao2</LI>
- <LI>RAW PCM/WAVE file writer for libao2</LI>
- <LI>Ogg Vorbis audio support</LI>
- <LI>Various aspect code</LI>
- <LI>Win32 (Cygwin) port</LI>
- <LI>priority support in codecs.conf (never used ;)</LI>
- <LI>DivX5Linux support</LI>
- <LI>AAC decoding support via libfaad2</LI>
- <LI>Darwin (MacOS X) port</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:telenieko@telenieko.com">TeLeNiEkO</A></B>
-<UL>
- <LI>Spanish translation of documentation</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:mgraffam@idsi.net">Michael Graffam</A></B>
-<UL>
- <LI>XF86VidMode support to vo_x11 and vo_dga</LI>
- <LI>Video mode switching code to vo_dga</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:hoffmajs@gmx.de">Jens Hoffmann</A></B>
-<UL>
- <LI>Additional YUV formats support</LI>
- <LI>found the big BITMAPINFOHEADER problem -> solved ASV2 pixelization</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:nickols_k@mail.ru">Nick Kurshev</A></B>
-<UL>
- <LI>memcpy optimizations for AMD K7 and Intel Pentium III (fastmemcpy.h)</LI>
- <LI>CD-ROM tune info</LI>
- <LI>further 3DNow! optimizations into mp3lib and libac3 and FFmpeg</LI>
- <LI>Russian translation of documentation</LI>
- <LI>radeon_vid, rage128_vid, radeonfb</LI>
- <LI>libvo driver: vo_vesa</LI>
- <LI>VIDIX and libdha design, programming</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:german@piraos.com">German Gomez Garcia</A></B>
-<UL>
- <LI>SPDIF AC3 output for SBLive!</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:eyck@incubus.ar.lublin.pl">Dariusz Pietrzak (Eyck)</A></B>
-<UL>
- <LI>Debian packaging support (see debian/* and this documentation)</LI>
- <LI>support for vplayer subtitle format</LI>
- <LI>preliminary support for .RT subtitle format</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:marcus@idonex.se">Marcus Comstedt</A></B>
-<UL>
- <LI>initial Solaris8-x86 support</LI>
- <LI>configure fixes</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:jk@tools.de">Jürgen Keil</A></B>
-<UL>
- <LI>patched <B>MPlayer</B> to work on Solaris 8 x86</LI>
- <LI>various fixes (win32, configure, etc)</LI>
- <LI>SUN audio driver in libao2</LI>
- <LI>mediaLib support in libavcodec</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:vkushnir@Alfacom.net">Vladimir Kushnir</A></B>
-<UL>
- <LI>patched <B>MPlayer</B> to work on FreeBSD x86</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:bertrand_baudet@yahoo.com">Bertrand BAUDET</A></B>
-<UL>
- <LI>network streaming support</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:djw@flinthills.com">Derek J Witt</A></B>
-<UL>
- <LI>MMS network streaming patches</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:albeu@free.fr">Alban Bedel</A></B>
-<UL>
- <LI>MMS network streaming patches</LI>
- <LI>Playtree and per-entry config</LI>
- <LI>Playlist parsers</LI>
- <LI>New input</LI>
- <LI>Audio only support</LI>
- <LI>MP3, WAV and Ogg demuxers</LI>
- <LI>Support for audio from external file</LI>
- <LI>DXR2 driver</LI>
- <LI>vo_aa improvements</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:zybi@fanthom.irc.pl">Artur Zaprzala</A></B>
-<UL>
- <LI>Complete font generator prog + OSD font (TOOLS/subfont-c)</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:lanzz@lanzz.org">lanzz@lanzz.org</A></B>
-<UL>
- <LI>GIMP font generator plugin (TOOLS/subfont-gimp)</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:atlka@pg.gda.pl">Adam Tla/lka</A></B>
-<UL>
- <LI>osd/sub review, fixes, optimization, utf8 support</LI>
- <LI>various fixes</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:folke@ashberg.de">Folke Ashberg</A></B>
-<UL>
- <LI>native AAlib driver (-vo aa)</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:ktoman@email.cz">Kamil Toman</A></B>
-<UL>
- <LI>Czech fonts</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:iive@yahoo.com">Ivan Kalvatchev</A></B>
-<UL>
- <LI>interlaced MPEG2 support (libmpeg2)</LI>
- <LI>libvo2 draft</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:p_l@gmx.fr">pl</A></B>
-<UL>
- <LI>new configure script</LI>
- <LI>general code maintaining, fixes, patch committing</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:michaelni@gmx.at">Michael Niedermayer</A></B>
-<UL>
- <LI>new postprocessing code (with deinterlacing etc...)</LI>
- <LI>software scaling C/MMX/MMX2/3DNow support (swscale.c)</LI>
- <LI>various rgb/yuv bpp converters</LI>
- <LI>new, better IDCT code for libavcodec</LI>
- <LI>runtime CPU detection</LI>
- <LI>SSE optimization of liba52</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:sgoethel@jausoft.com">Sven Goethel</A></B>
-<UL>
- <LI>libvo driver: vo_gl2</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:joy@pingfm.org">joy_ping</A></B>
-<UL>
- <LI>ao_alsa9 fixes</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:eanholt@gladstone.uoregon.edu">Eric Anholt</A></B>
-<UL>
- <LI>CPU detection code</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:Jiri.Svoboda@seznam.cz">Jiri Svoboda</A></B>
-<UL>
- <LI>AQT type subtitles support</LI>
- <LI>CRTC2 YUV support in mga_vid</LI>
- <LI>DirectFB video output driver</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:oliver.schoenbrunner@jku.at">Oliver Schoenbrunner</A></B>
-<UL>
- <LI>SGI audio driver</LI>
- <LI>MIPS support</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:jeroen.dobbelaere@acunia.com">Jeroen Dobbelaere</A></B>
-<UL>
- <LI><A HREF="http://mad.sourceforge.net">libmad</A> support</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:dholm@telia.com">David Holm</A></B>
-<UL>
- <LI>DXR3 support</LI>
- <LI>libmp1e import</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:takis@lumumba.luc.ac.be">Panagiotis Issaris</A></B>
-<UL>
- <LI>-playlist option</LI>
- <LI>NuppelVideo support</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:melanson@pcisys.net">Mike Melanson</A></B>
-<UL>
- <LI>MS Video1 codec open-source implementation</LI>
- <LI>FLI demuxer, decoder</LI>
- <LI>Unified ADPCM Decoder (supports IMA/DVI, MS ADPCM, several others)</LI>
- <LI>FILM (.cpk) file demuxer</LI>
- <LI>RoQ file demuxer</LI>
- <LI>RoQ Audio/Video decoder</LI>
- <LI>QT SMC decoder</LI>
- <LI>QT RLE decoder</LI>
- <LI>MS RLE decoder</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:ranma@gmx.at">Tobias Diedrich</A></B>
-<UL>
- <LI>NAS audio output driver</LI>
- <LI>DXR2 driver</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:foth@informatik.uni-hamburg.de">Kilian A. Foth</A></B>
-<UL>
- <LI>-slave mode</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:timf@mail.csse.monash.edu.au">Tim Ferguson</A></B>
-<UL>
- <LI>Open source Cinepak decoder</LI>
- <LI>Open source CYUV decoder</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:itrs@softwell.com.tw">Sam Lin</A></B>
-<UL>
- <LI>-wid (plugger) patch</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:johannes.feigl@aon.at">Johannes Feigl</A></B>
-<UL>
- <LI>original German docs translation</LI>
- <LI>some improvements in configure, small patches</LI>
- <LI>found somebody (Thilo Wunderlich) who sent a DVB card</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:kmkaplan@selfoffice.com">Kim Minh Kaplan</A></B>
-<UL>
- <LI>DVD and VobSub subtitles display support</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:bkuschak@yahoo.com">Brian Kuschak</A></B>
-<UL>
- <LI>RTP streaming support (reading)</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:steve@daviesfam.org">Stephen Davies</A></B>
-<UL>
- <LI>support for large video files (&gt;2^32 bytes in size)</LI>
- <LI>surround sound</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:rsnel@cube.dyndns.org">Rik Snel</A></B>
-<UL>
- <LI><CODE>zr</CODE> video output driver</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:ajh@atri.curtin.edu.au">Anders Johansson</A></B>
-<UL>
- <LI>audio plugin system, some effect plugins</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:rtogni@freemail.it">Roberto Togni</A></B>
-<UL>
- <LI>Open source QT RPZA decoder</LI>
- <LI>Open source HuffYUV decoder</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:wojtekka@bydg.pdi.net">Wojtek Kaniewski</A></B>
-<UL>
- <LI>Mouse wheel support</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:freku045@student.liu.se">Fredrik Kuivinen</A></B>
-<UL>
- <LI>OSD/subtitles outside movie - for SDL</LI>
-</UL>
-</LI>
-
-<LI><B><A HREF="mailto:flo-mplayer-dev@gmx.net">Florian Schneider</A></B>
-<UL>
- <LI>RealVideo libraries loader</LI>
-</UL>
-</LI>
-
+ <LI><B><A HREF="mailto:send mail to mplayer-users!">Árpád Gereöffy (A'rpi/ESP-team)</A></B>
+ <UL>
+ <LI>player code (mpeg stream demultiplexer and avi/asf parser, A-V sync, seek...)</LI>
+ <LI>mp3lib, based on mpglib sources [MP3 audio decoder]</LI>
+ <LI>getch2 [keyboard handler]</LI>
+ <LI>some changes in libmpeg2 code (progressive frames, bitrate &amp; fps support)</LI>
+ <LI>libvo improvements: adding OpenGL support, bugfix in mga driver...</LI>
+ <LI>triple buffering &amp; YUY2 support (for DivX/MPEG4) into mga_vid driver</LI>
+ <LI>scripts in the TVout directory (TVout on Matrox G400DH, read documentation)</LI>
+ <LI>hacking DivX/Mpeg4 VfW codecs to get YUV output</LI>
+ <LI>opendivx decoder speed optimizations (see opendivx/ChangeLog)</LI>
+ <LI>OSD &amp; SUB display code</LI>
+ <LI>FFmpeg/libavcodec integration</LI>
+ <LI>DivX4Linux (Project Mayo) support (see documentation)</LI>
+ <LI>New DVD-Support using libdvdread</LI>
+ <LI>DVB support</LI>
+ <LI>MPEG PES output &amp; DVB card support</LI>
+ <LI>anything that isn't mentioned elsewhere</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:pontscho@makacs.poliod.hu">Zoltán Ponekker (Pontscho/Fresh!)</A></B>
+ <UL>
+ <LI>configure script and Makefiles for easy compile</LI>
+ <LI>GUI system</LI>
+ <LI>3DNow! support into mp3lib</LI>
+ <LI>3DNow! support into fastmemcpy.h</LI>
+ <LI>various X11 driver changes (keyboard handling, fullscreen, bpp detect, etc)</LI>
+ <LI>libvo: adding xmga driver, and fullscreen support to xv</LI>
+ <LI>audio mixer (volume) support</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:lgb@lgb.hu">Gábor Lénárt (LGB)</A></B>
+ <UL>
+ <LI>configure script improvements</LI>
+ <LI>Makefile improvements</LI>
+ <LI>preliminary DVD support</LI>
+ <LI>various X11 cleanups and fixes</LI>
+ <LI>HTMLization of documentation</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:gabucino@mplayerhq.hu">Gábor Bérczi (Gabucino)</A></B>
+ <UL>
+ <LI>documentation writer & maintainer</LI>
+ <LI>Hungarian translation of documentation, homepage, and help output</LI>
+ <LI>second homepage design&amp;gfx</LI>
+ <LI>homepage maintainer</LI>
+ <LI>testing, codecs quality &amp; speed comparisons</LI>
+ <LI>IRC channels operator (#MPlayer is user channel)</LI>
+ <LI>experimental MINIX port :) (what's funny about it?)</LI>
+ <LI>MPsub subtitle format design</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:szabi@inf.elte.hu">Szabolcs Berecz (Szabi)</A></B>
+ <UL>
+ <LI>codecs.conf file parser</LI>
+ <LI>config file and command line parser</LI>
+ <LI>mga_vid fixes, module option etc.</LI>
+ <LI>fbdev support in libvo</LI>
+ <LI>type #7 subtitle support</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:lez@sch.bme.hu">László Megyer (Lez, Laaz)</A></B>
+ <UL>
+ <LI>SUB reader</LI>
+ <LI>screensaver+DPMS disable for libvo</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:chass-@freemail.hu">Gyula László (Chass, Tégla)</A></B>
+ <UL>
+ <LI>first fonts (mp_font1.zip)</LI>
+ <LI>third homepage design&amp;gfx</LI>
+ <LI>fourth (current) homepage design&amp;gfx</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:se7en@sch.bme.hu">Zoltán Márk Vicián (Se7en)</A></B>
+ <UL>
+ <LI>SVGAlib support in libvo</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:alex@naxine.org">Alex Beregszaszi (al3x)</A></B>
+ <UL>
+ <LI>ALSA output driver in libao2</LI>
+ <LI>vo_ggi output driver in libvo (www.ggi-project.org)</LI>
+ <LI>XAnim codecs support</LI>
+ <LI>VIVO files support</LI>
+ <LI>TV grabbing support</LI>
+ <LI>Quicktime hackings</LI>
+ <LI>libavcodec support in MEncoder</LI>
+ <LI>RM file format demuxer</LI>
+ <LI>mencoder framecopy</LI>
+ <LI>yuv4mpeg1 support</LI>
+ <LI>NuppelVideo demuxer changes</LI>
+ <LI>subconfig</LI>
+ <LI>VIDIX and libdha hackings</LI>
+ <LI>Matrox driver port to Vidix</LI>
+ <LI>XVidix video output driver</LI>
+ <LI>and other various stuff (in libvo, libmad syncing, dec_audio/video and loader)</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:asackerm@stud.informatik.uni-erlangen.de">Andreas Ackermann (Acki)</A></B>
+ <UL>
+ <LI>LIRC support (see documentation)</LI>
+ <LI>DGA support in libvo</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:atmosfear@users.sourceforge.net">Felix Bünemann (Atmos)</A></B>
+ <UL>
+ <LI>SDL driver maintainer</LI>
+ <LI>Additional YUV formats fixes</LI>
+ <LI>New font (mp_font2.zip)</LI>
+ <LI>PNG file output support in libvo</LI>
+ <LI>flipping support (for Indeo 3/4, etc)</LI>
+ <LI>SDL audio driver in libao2</LI>
+ <LI>RAW PCM/WAVE file writer for libao2</LI>
+ <LI>Ogg Vorbis audio support</LI>
+ <LI>Various aspect code</LI>
+ <LI>Win32 (Cygwin) port</LI>
+ <LI>priority support in codecs.conf (never used ;)</LI>
+ <LI>DivX5Linux support</LI>
+ <LI>AAC decoding support via libfaad2</LI>
+ <LI>Darwin (MacOS X) port</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:telenieko@telenieko.com">TeLeNiEkO</A></B>
+ <UL>
+ <LI>Spanish translation of documentation</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:mgraffam@idsi.net">Michael Graffam</A></B>
+ <UL>
+ <LI>XF86VidMode support to vo_x11 and vo_dga</LI>
+ <LI>Video mode switching code to vo_dga</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:hoffmajs@gmx.de">Jens Hoffmann</A></B>
+ <UL>
+ <LI>Additional YUV formats support</LI>
+ <LI>found the big BITMAPINFOHEADER problem -> solved ASV2 pixelization</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:nickols_k@mail.ru">Nick Kurshev</A></B>
+ <UL>
+ <LI>memcpy optimizations for AMD K7 and Intel Pentium III (fastmemcpy.h)</LI>
+ <LI>CD-ROM tune info</LI>
+ <LI>further 3DNow! optimizations into mp3lib and libac3 and FFmpeg</LI>
+ <LI>Russian translation of documentation</LI>
+ <LI>radeon_vid, rage128_vid, radeonfb</LI>
+ <LI>libvo driver: vo_vesa</LI>
+ <LI>VIDIX and libdha design, programming</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:german@piraos.com">German Gomez Garcia</A></B>
+ <UL>
+ <LI>SPDIF AC3 output for SBLive!</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:eyck@incubus.ar.lublin.pl">Dariusz Pietrzak (Eyck)</A></B>
+ <UL>
+ <LI>Debian packaging support (see debian/* and this documentation)</LI>
+ <LI>support for vplayer subtitle format</LI>
+ <LI>preliminary support for .RT subtitle format</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:marcus@idonex.se">Marcus Comstedt</A></B>
+ <UL>
+ <LI>initial Solaris8-x86 support</LI>
+ <LI>configure fixes</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:jk@tools.de">Jürgen Keil</A></B>
+ <UL>
+ <LI>patched <B>MPlayer</B> to work on Solaris 8 x86</LI>
+ <LI>various fixes (win32, configure, etc)</LI>
+ <LI>SUN audio driver in libao2</LI>
+ <LI>mediaLib support in libavcodec</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:vkushnir@Alfacom.net">Vladimir Kushnir</A></B>
+ <UL>
+ <LI>patched <B>MPlayer</B> to work on FreeBSD x86</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:bertrand_baudet@yahoo.com">Bertrand BAUDET</A></B>
+ <UL>
+ <LI>network streaming support</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:djw@flinthills.com">Derek J Witt</A></B>
+ <UL>
+ <LI>MMS network streaming patches</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:albeu@free.fr">Alban Bedel</A></B>
+ <UL>
+ <LI>MMS network streaming patches</LI>
+ <LI>Playtree and per-entry config</LI>
+ <LI>Playlist parsers</LI>
+ <LI>New input</LI>
+ <LI>Audio only support</LI>
+ <LI>MP3, WAV and Ogg demuxers</LI>
+ <LI>Support for audio from external file</LI>
+ <LI>DXR2 driver</LI>
+ <LI>vo_aa improvements</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:zybi@fanthom.irc.pl">Artur Zaprzala</A></B>
+ <UL>
+ <LI>Complete font generator prog + OSD font (TOOLS/subfont-c)</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:lanzz@lanzz.org">lanzz@lanzz.org</A></B>
+ <UL>
+ <LI>GIMP font generator plugin (TOOLS/subfont-gimp)</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:atlka@pg.gda.pl">Adam Tla/lka</A></B>
+ <UL>
+ <LI>osd/sub review, fixes, optimization, utf8 support</LI>
+ <LI>various fixes</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:folke@ashberg.de">Folke Ashberg</A></B>
+ <UL>
+ <LI>native AAlib driver (-vo aa)</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:ktoman@email.cz">Kamil Toman</A></B>
+ <UL>
+ <LI>Czech fonts</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:iive@yahoo.com">Ivan Kalvatchev</A></B>
+ <UL>
+ <LI>interlaced MPEG2 support (libmpeg2)</LI>
+ <LI>libvo2 draft</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:p_l@gmx.fr">pl</A></B>
+ <UL>
+ <LI>new configure script</LI>
+ <LI>general code maintaining, fixes, patch committing</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:michaelni@gmx.at">Michael Niedermayer</A></B>
+ <UL>
+ <LI>new postprocessing code (with deinterlacing etc...)</LI>
+ <LI>software scaling C/MMX/MMX2/3DNow support (swscale.c)</LI>
+ <LI>various rgb/yuv bpp converters</LI>
+ <LI>new, better IDCT code for libavcodec</LI>
+ <LI>runtime CPU detection</LI>
+ <LI>SSE optimization of liba52</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:sgoethel@jausoft.com">Sven Goethel</A></B>
+ <UL>
+ <LI>libvo driver: vo_gl2</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:joy@pingfm.org">joy_ping</A></B>
+ <UL>
+ <LI>ao_alsa9 fixes</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:eanholt@gladstone.uoregon.edu">Eric Anholt</A></B>
+ <UL>
+ <LI>CPU detection code</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:Jiri.Svoboda@seznam.cz">Jiri Svoboda</A></B>
+ <UL>
+ <LI>AQT type subtitles support</LI>
+ <LI>CRTC2 YUV support in mga_vid</LI>
+ <LI>DirectFB video output driver</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:oliver.schoenbrunner@jku.at">Oliver Schoenbrunner</A></B>
+ <UL>
+ <LI>SGI audio driver</LI>
+ <LI>MIPS support</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:jeroen.dobbelaere@acunia.com">Jeroen Dobbelaere</A></B>
+ <UL>
+ <LI><A HREF="http://mad.sourceforge.net">libmad</A> support</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:dholm@telia.com">David Holm</A></B>
+ <UL>
+ <LI>DXR3 support</LI>
+ <LI>libmp1e import</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:takis@lumumba.luc.ac.be">Panagiotis Issaris</A></B>
+ <UL>
+ <LI>-playlist option</LI>
+ <LI>NuppelVideo support</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:melanson@pcisys.net">Mike Melanson</A></B>
+ <UL>
+ <LI>MS Video1 codec open-source implementation</LI>
+ <LI>FLI demuxer, decoder</LI>
+ <LI>Unified ADPCM Decoder (supports IMA/DVI, MS ADPCM, several others)</LI>
+ <LI>FILM (.cpk) file demuxer</LI>
+ <LI>RoQ file demuxer</LI>
+ <LI>RoQ Audio/Video decoder</LI>
+ <LI>QT SMC decoder</LI>
+ <LI>QT RLE decoder</LI>
+ <LI>MS RLE decoder</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:ranma@gmx.at">Tobias Diedrich</A></B>
+ <UL>
+ <LI>NAS audio output driver</LI>
+ <LI>DXR2 driver</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:foth@informatik.uni-hamburg.de">Kilian A. Foth</A></B>
+ <UL>
+ <LI>-slave mode</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:timf@mail.csse.monash.edu.au">Tim Ferguson</A></B>
+ <UL>
+ <LI>Open source Cinepak decoder</LI>
+ <LI>Open source CYUV decoder</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:itrs@softwell.com.tw">Sam Lin</A></B>
+ <UL>
+ <LI>-wid (plugger) patch</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:johannes.feigl@aon.at">Johannes Feigl</A></B>
+ <UL>
+ <LI>original German docs translation</LI>
+ <LI>some improvements in configure, small patches</LI>
+ <LI>found somebody (Thilo Wunderlich) who sent a DVB card</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:kmkaplan@selfoffice.com">Kim Minh Kaplan</A></B>
+ <UL>
+ <LI>DVD and VobSub subtitles display support</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:bkuschak@yahoo.com">Brian Kuschak</A></B>
+ <UL>
+ <LI>RTP streaming support (reading)</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:steve@daviesfam.org">Stephen Davies</A></B>
+ <UL>
+ <LI>support for large video files (&gt;2^32 bytes in size)</LI>
+ <LI>surround sound</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:rsnel@cube.dyndns.org">Rik Snel</A></B>
+ <UL>
+ <LI><CODE>zr</CODE> video output driver</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:ajh@atri.curtin.edu.au">Anders Johansson</A></B>
+ <UL>
+ <LI>audio plugin system, some effect plugins</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:rtogni@freemail.it">Roberto Togni</A></B>
+ <UL>
+ <LI>Open source QT RPZA decoder</LI>
+ <LI>Open source HuffYUV decoder</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:wojtekka@bydg.pdi.net">Wojtek Kaniewski</A></B>
+ <UL>
+ <LI>Mouse wheel support</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:freku045@student.liu.se">Fredrik Kuivinen</A></B>
+ <UL>
+ <LI>OSD/subtitles outside movie - for SDL</LI>
+ </UL>
+ </LI>
+ <LI><B><A HREF="mailto:flo-mplayer-dev@gmx.net">Florian Schneider</A></B>
+ <UL>
+ <LI>RealVideo libraries loader</LI>
+ </UL>
+ </LI>
</UL>
<P>Main testers:</P>
@@ -2397,7 +2312,7 @@ end
</UL>
<P>Their code is not used in current player version, but I've got some ideas or
-other technical help from:</P>
+ other technical help from:</P>
<UL>
<LI>John F. McGowan http://www.jmcgowan.com/
@@ -2417,6 +2332,8 @@ other technical help from:</P>
</LI>
</UL>
+
+
<P><B><A NAME="maintainers">Appendix A2 - MPlayer code and documentation maintainers</A></B></P>
Homepage
@@ -2536,53 +2453,54 @@ TOOLS:
</UL>
+
<P><B><A NAME="mailing_lists">Appendix B - Mailing lists</A></B></P>
<P>There are some public mailing lists on <B>MPlayer</B>. Subscribing can be
-achieved on the following addresses:</P>
+ achieved on the following addresses:</P>
<UL>
-<LI>MPlayer developers list:
-<A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-dev-eng">http://mplayerhq.hu/mailman/listinfo/mplayer-dev-eng</A><BR>
-This list is about mplayer development! Talking about interface/API changes,
-new libraries, code optimization, configure changes, and send patches here.
-Do NOT send bug reports, user questions, feature requests or flames here!
-This list should be kept low-traffic.
-</LI>
-<LI>MPlayer users list:
-<A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-users">http://mplayerhq.hu/mailman/listinfo/mplayer-users</A>
-<UL>
-<LI>Send bug reports here (after reading the <A HREF="#known_bugs">Known Bugs</A> section, and <A HREF="bugreports.html">Appendix C</A>).</LI>
-<LI>Send feature requests here (after reading the WHOLE documentation).</LI>
-<LI>Send user questions here (after reading the WHOLE documentation).</LI>
-</UL>
-</LI>
-<LI>MPlayer Hungarian users list:
-<A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-felhasznalok">http://mplayerhq.hu/mailman/listinfo/mplayer-felhasznalok</A>
-<UL>
-<LI>Hungarian language list</LI>
-<LI>topic? We'll see about it... mostly flame and RTFM questions up to now :(</LI>
-</UL>
-</LI>
-<LI>MPlayer &amp; Matrox G200/G400/G450/G550 users:<BR>
-<A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-matrox">http://mplayerhq.hu/mailman/listinfo/mplayer-matrox</A>
-Send Matrox related questions here
-<UL>
-<LI>things about mga_vid</LI>
-<LI>Matrox's official beta drivers (for X 4.x.x)</LI>
-<LI>and about matroxfb-TVout stuff.</LI>
-</UL>
-</LI>
-<LI>MPlayer &amp; DVB card users:
-<A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-dvb">http://mplayerhq.hu/mailman/listinfo/mplayer-dvb</A><BR>
-Things related to the hardware decoder card called DVB (NOT DXR3!).
-</LI>
-<LI>MPlayer CVS-log:
-<A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-cvslog">http://mplayerhq.hu/mailman/listinfo/mplayer-cvslog</A><BR>
-Send only questions about CVS changes here (if you do not understand why a
-change is required or you have a better fix or you have noticed a possible
-bug/problem in the committed patch). Be sure in that your target developer reads this list!
-</LI>
+ <LI>MPlayer developers list:
+ <A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-dev-eng">http://mplayerhq.hu/mailman/listinfo/mplayer-dev-eng</A><BR>
+ This list is about mplayer development! Talking about interface/API changes,
+ new libraries, code optimization, configure changes, and send patches here.
+ Do NOT send bug reports, user questions, feature requests or flames here!
+ This list should be kept low-traffic.</LI>
+ <LI>MPlayer users list:
+ <A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-users">http://mplayerhq.hu/mailman/listinfo/mplayer-users</A>
+ <UL>
+ <LI>Send bug reports here (after reading the <A HREF="#known_bugs">Known Bugs</A>
+ section, and <A HREF="bugreports.html">Appendix C</A>).</LI>
+ <LI>Send feature requests here (after reading the WHOLE documentation).</LI>
+ <LI>Send user questions here (after reading the WHOLE documentation).</LI>
+ </UL>
+ </LI>
+ <LI>MPlayer Hungarian users list:
+ <A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-felhasznalok">http://mplayerhq.hu/mailman/listinfo/mplayer-felhasznalok</A>
+ <UL>
+ <LI>Hungarian language list</LI>
+ <LI>topic? We'll see about it... mostly flame and RTFM questions up to now :(</LI>
+ </UL>
+ </LI>
+ <LI>MPlayer &amp; Matrox G200/G400/G450/G550 users:<BR>
+ <A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-matrox">http://mplayerhq.hu/mailman/listinfo/mplayer-matrox</A>
+ Send Matrox related questions here
+ <UL>
+ <LI>things about mga_vid</LI>
+ <LI>Matrox's official beta drivers (for X 4.x.x)</LI>
+ <LI>and about matroxfb-TVout stuff.</LI>
+ </UL>
+ </LI>
+ <LI>MPlayer &amp; DVB card users:
+ <A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-dvb">http://mplayerhq.hu/mailman/listinfo/mplayer-dvb</A><BR>
+ Things related to the hardware decoder card called DVB (NOT DXR3!).
+ </LI>
+ <LI>MPlayer CVS-log:
+ <A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-cvslog">http://mplayerhq.hu/mailman/listinfo/mplayer-cvslog</A><BR>
+ Send only questions about CVS changes here (if you do not understand why a
+ change is required or you have a better fix or you have noticed a possible
+ bug/problem in the committed patch). Be sure in that your target developer
+ reads this list!</LI>
</UL>
<P><B>Note:</B> The Languages of above lists are ENGLISH, unless explicitly
@@ -2592,8 +2510,11 @@ bug/problem in the committed patch). Be sure in that your target developer reads
<A HREF="http://www.mplayerhq.hu/cgi-bin/htsearch">here</A>.
+
<P><B><A NAME="bug_reports"></A><A HREF="bugreports.html">Appendix C</A> - How to report bugs</B></P>
+
+
<P><B><A NAME="known_bugs">Appendix D - Known bugs</A></B></P>
<P>Special system/CPU-specific bugs/problems:</P>
@@ -2628,68 +2549,69 @@ bug/problem in the committed patch). Be sure in that your target developer reads
General audio delay or jerky sound (exists with all or many files):
<UL>
-<LI>most common: buggy audio driver! - try to use different drivers, try
-ALSA 0.9 OSS emulation with -ao oss, also try -ao sdl, sometimes it helps.
-If your file plays fine with -nosound, then you can be sure it's sound card
-(driver) problem.</LI>
-<LI>audio buffer problems (buffer size badly detected)<BR>
- Workaround: mplayer -abs option</LI>
-<LI>samplerate problems - maybe your card doesn't support the samplerate
-used in your files - try the resampling plugin (-aop)</LI>
-<LI>slow machine (CPU or VGA)<BR>
- try with -vo null, if it plays well, then you have slow VGA card/driver<BR>
- Workaround: buy a faster card or read this documentation about how to speed up<BR>
- Also try -framedrop</LI>
-</UL><BR>
+ <LI>most common: buggy audio driver! - try to use different drivers, try
+ ALSA 0.9 OSS emulation with -ao oss, also try -ao sdl, sometimes it helps.
+ If your file plays fine with -nosound, then you can be sure it's sound card
+ (driver) problem.</LI>
+ <LI>audio buffer problems (buffer size badly detected)<BR>
+ Workaround: mplayer -abs option</LI>
+ <LI>samplerate problems - maybe your card doesn't support the samplerate
+ used in your files - try the resampling plugin (-aop)</LI>
+ <LI>slow machine (CPU or VGA)<BR>
+ try with -vo null, if it plays well, then you have slow VGA card/driver<BR>
+ Workaround: buy a faster card or read this documentation about how to speed up<BR>
+ Also try -framedrop</LI>
+</UL>
Audio delay/de-sync specific to one or a few files:
<UL>
-<LI>bad file<BR>
- Workaround:
- <UL>
- <LI>-ni or -nobps option (for non-interleaved or bad files)<BR>
- and/or</LI>
- <LI>-mc 0 (required for files with badly interleaved VBR audio)<BR>
- and/or</LI>
- <LI>-delay option or +/- keys at runtime to adjust delay</LI>
- </UL>
- If none of these help, please upload the file, we'll check (and fix).
-</LI>
-<LI>your sound card doesn't support 48kHz playback<BR>
- Workaround: buy a better sound card... or try to decrease fps by 10% (use -fps 27 for a 30fps movie)
- or use the resampler plugin</LI>
-<LI>slow machine<BR>
- (if A-V is not around 0, and the last number in the status line increasing)<BR>
- Workaround: -framedrop</LI>
+ <LI>bad file<BR>
+ Workaround:
+ <UL>
+ <LI>-ni or -nobps option (for non-interleaved or bad files)<BR>
+ and/or</LI>
+ <LI>-mc 0 (required for files with badly interleaved VBR audio)<BR>
+ and/or</LI>
+ <LI>-delay option or +/- keys at runtime to adjust delay</LI>
+ </UL>
+ If none of these help, please upload the file, we'll check (and fix).
+ </LI>
+ <LI>your sound card doesn't support 48kHz playback<BR>
+ Workaround: buy a better sound card... or try to decrease fps by 10% (use
+ -fps 27 for a 30fps movie) or use the resampler plugin</LI>
+ <LI>slow machine<BR>
+ (if A-V is not around 0, and the last number in the status line increasing)<BR>
+ Workaround: -framedrop</LI>
</UL>
No sound at all:
<UL>
-<LI>your file uses an unsupported audio codec<BR>
- Workaround: read the documentation and help us adding support for it</LI>
+ <LI>your file uses an unsupported audio codec<BR>
+ Workaround: read the documentation and help us adding support for it</LI>
</UL>
No picture at all (just plain grey/green window):
<UL>
-<LI>your file uses an unsupported video codec<BR>
- Workaround: read the documentation and help us adding support for it</LI>
-<LI>auto-selected codec can't decode the file, try to select another using -vc or -vfm options</LI>
-<LI>you try to play DivX 3.x file with OpenDivX decoder or XviD (-vc odivx) - install Divx4Linux and recompile player</LI>
+ <LI>your file uses an unsupported video codec<BR>
+ Workaround: read the documentation and help us adding support for it</LI>
+ <LI>auto-selected codec can't decode the file, try to select another using -vc
+ or -vfm options</LI>
+ <LI>you try to play DivX 3.x file with OpenDivX decoder or XviD (-vc odivx)
+ - install Divx4Linux and recompile player</LI>
</UL>
<P>Video-out problems:</P>
<P>First note: options -fs -vm and -zoom are just recommendations, not (yet)
-supported by all drivers. So it isn't a bug if it doesn't work.
-Only a few driver supports scaling/zooming, don't expect this from x11 or dga.</P>
+ supported by all drivers. So it isn't a bug if it doesn't work.
+ Only a few driver supports scaling/zooming, don't expect this from x11 or dga.</P>
<P>OSD/sub flickering:<BR>
-- x11 driver: sorry, it can't be fixed now<BR>
-- xv driver: use -double option</P>
+ - x11 driver: sorry, it can't be fixed now<BR>
+ - xv driver: use -double option</P>
<P>Green image using mga_vid (-vo mga / -vo xmga):<BR>
-- mga_vid misdetected your card's RAM amount, reload it using mga_ram_size option<BR>
-</P>
+ - mga_vid misdetected your card's RAM amount, reload it using mga_ram_size option</P>
</BODY>
</HTML>
diff --git a/DOCS/encoding.html b/DOCS/encoding.html
index e5105068ac..6d71936577 100644
--- a/DOCS/encoding.html
+++ b/DOCS/encoding.html
@@ -12,6 +12,7 @@
<P><B><A NAME="encoding">2.4 Encoding with MEncoder</A></B></P>
+
<P><B><A NAME="overview">2.4.1 Overview</A></B></P>
<P><B>MEncoder</B> (<B>MPlayer</B>'s Movie Encoder) is a simple movie encoder,
@@ -22,6 +23,7 @@
<B>PCM</B>/<B>MP3</B>/<B>VBR MP3</B> audio. Also has powerful plugin system
for video manipulation.</P>
+
<P><B><A NAME="compilation">2.4.2 Compilation</A></B></P>
<UL>
@@ -55,6 +57,7 @@
<P>You are ready. As you probably know, other encoding tools need the
<I>avifile</I> library installed. <B>MEncoder</B> doesn't need it at all.</P>
+
<P><B><A NAME="features">2.4.3 MEncoder features</A></B></P>
<UL>
@@ -86,6 +89,7 @@
<LI>audio encoding from v4l (DONE for FreeBSD ?)</LI>
</UL>
+
<P><B><A NAME="2pass">2.4.3.1 Encoding 2 or 3-pass DivX4</A></B></P>
<P><U><B>2-pass encoding:</B></U> the name comes from the fact that this method
@@ -113,34 +117,34 @@
audio is encoded only once, unlike in 2-pass mode. The schematics:</P>
<TABLE>
-<TR>
- <TD> <CODE>rm frameno.avi</CODE></TD>
- <TD> <B>remove conflicting temporary file</B></TD>
-</TR>
-<TR>
- <TD> <CODE>mencoder &lt;file/DVD&gt; -ovc frameno -o
+ <TR>
+ <TD><CODE>rm frameno.avi</CODE></TD>
+ <TD><B>remove conflicting temporary file</B></TD>
+ </TR>
+ <TR>
+ <TD><CODE>mencoder &lt;file/DVD&gt; -ovc frameno -o
frameno.avi</CODE></TD>
- <TD> <B><U>First pass:</U> an audio-only avi file will be created, containing
- ONLY the requested audio stream. Don't forget <CODE>-lameopts</CODE>, if
- you need to set it. If you were encoding a long movie, MEncoder prints
- the recommended bitrate values for 650Mb, 700Mb, and 800Mb destination
- sizes, after this pass finishes.</B></TD>
-</TR>
-<TR>
- <TD> <CODE>mencoder &lt;file/DVD&gt; -oac copy -pass 1
+ <TD><B><U>First pass:</U> an audio-only avi file will be created, containing
+ ONLY the requested audio stream. Don't forget <CODE>-lameopts</CODE>, if
+ you need to set it. If you were encoding a long movie, MEncoder prints
+ the recommended bitrate values for 650Mb, 700Mb, and 800Mb destination
+ sizes, after this pass finishes.</B></TD>
+ </TR>
+ <TR>
+ <TD><CODE>mencoder &lt;file/DVD&gt; -oac copy -pass 1
-ovc divx4 -divx4opts br=&lt;bitrate&gt;</CODE></TD>
- <TD> <B><U>Second pass:</U> alias the first pass of DivX4 video encoding.
- Optionally specify the video bitrate MEncoder printed at the end of the
- previous pass.</B></TD>
-</TR>
-<TR>
- <TD> <CODE>mencoder &lt;file/DVD&gt; -oac copy -pass 2
+ <TD><B><U>Second pass:</U> alias the first pass of DivX4 video encoding.
+ Optionally specify the video bitrate MEncoder printed at the end of the
+ previous pass.</B></TD>
+ </TR>
+ <TR>
+ <TD><CODE>mencoder &lt;file/DVD&gt; -oac copy -pass 2
-ovc divx4 -divx4opts br=&lt;bitrate&gt;</CODE></TD>
- <TD> <B><U>Third pass:</U> alias the second pass of DivX4 video encoding.
- Optionally specify the video bitrate MEncoder printed at the end of the
- previous pass. In this pass, audio from <CODE>frameno.avi</CODE> will be
- inserted into the destination file.. and it's all ready!</B></TD>
-</TR>
+ <TD><B><U>Third pass:</U> alias the second pass of DivX4 video encoding.
+ Optionally specify the video bitrate MEncoder printed at the end of the
+ previous pass. In this pass, audio from <CODE>frameno.avi</CODE> will be
+ inserted into the destination file.. and it's all ready!</B></TD>
+ </TR>
</TABLE>
<P><B>Example for 3-pass encoding:</B></P>
@@ -153,8 +157,7 @@
&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2
-lavcopts vcodec=mpeg4:more_options -oac copy -o movie.avi -pass 1<BR>
&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2
- -lavcopts vcodec=mpeg4:more_options -oac copy -o movie.avi -pass 2</CODE>
-</P>
+ -lavcopts vcodec=mpeg4:more_options -oac copy -o movie.avi -pass 2</CODE></P>
<P><U><B>2 or 3-pass encoding using internal libavcodec controller:</B></U>
Optionally you can use libavcodec's internal 2 or 3-pass mode, it may give
@@ -177,6 +180,7 @@
movie.avi</CODE></LI>
</UL>
+
<P><B><A NAME="rescaling">2.4.3.2 Rescaling movies</A></B></P>
<P>Often the need to resize movie images' size emerges. Its reasons can be many,
@@ -265,8 +269,7 @@
<P><B>Explanation of the process</B></P>
<P><B>MEncoder</B> <I>decodes</I> the input image(s) with <CODE>libjpeg</CODE>
- (when decoding PNGs, it will use <B>libpng</B>).
-</P>
+ (when decoding PNGs, it will use <B>libpng</B>).</P>
<P><B>MEncoder</B> then feeds the decoded image to the chosen video compressor
(DivX4, Xvid, ffmpeg msmpeg4, etc...). Watch for the PNG decoder, as
@@ -349,116 +352,118 @@
<P>NOTE: for all available options, <B>read the man page!</B></P>
-<P>
- As <B>MEncoder</B> is built on the same codebase as <B>MPlayer</B>, there
+<P>As <B>MEncoder</B> is built on the same codebase as <B>MPlayer</B>, there
are many <B>MPlayer</B> options that have function in <B>MEncoder</B> too!
See, you can use <CODE>-sid</CODE> to rip a DVD with subtitles, or
- <CODE>-noidx</CODE> to disregard buggy index of input AVI. <B>Be smart!</B>
-</P>
+ <CODE>-noidx</CODE> to disregard buggy index of input AVI. <B>Be smart!</B></P>
<TABLE BORDER=1>
-<TR>
- <TD> <CODE>-ss</CODE> time</TD>
- <TD> start encoding from the given time (can start only from keyframes!)
- </TD>
-</TR>
-<TR>
- <TD> <CODE>-endpos</CODE> time</TD>
- <TD> stop encoding at the given time. See the man page for examples!
- </TD>
-</TR>
-<TR>
- <TD> <CODE>-o</CODE> filename</TD>
- <TD> specify output filename
- </TD>
-</TR>
-<TR>
- <TD> <CODE>-sws</CODE> 0-2</TD>
- <TD> type of scaling method<BR>
- &nbsp;&nbsp;0 - fast bilinear<BR>
- &nbsp;&nbsp;1 - bilinear<BR>
- &nbsp;&nbsp;2 - bicubic (best quality)<BR>
- </TD>
-</TR>
-<TR>
- <TD> <CODE>-ovc</CODE> codecname</TD>
- <TD> Encode with the given codec (codec names are from codecs.conf). Examples:<BR>
- &nbsp;&nbsp;<B>help</B> - get list of available codecs<BR>
- &nbsp;&nbsp;<B>rawrgb</B> - ?<BR>
- &nbsp;&nbsp;<B>copy</B> - no encoding, just copy the stream (only from AVI/ASF now)<BR>
- &nbsp;&nbsp;<B>divx4</B> - encode to DivX4<BR>
- &nbsp;&nbsp;<B>lavc</B> - encode with a codec from libavcodec<BR>
- &nbsp;&nbsp;<B>vfw</B> - encode with a Windows DLL<BR>
- </TD>
-</TR>
-<TR>
- <TD> <CODE>-oac</CODE> codecname</TD>
- <TD> Encode with the given codec (codec names are from codecs.conf). Examples:<BR>
- &nbsp;&nbsp;<B>help</B> - get list of available codecs<BR>
- &nbsp;&nbsp;<B>copy</B> - no encoding, just copy the stream (only from AVI/ASF now)<BR>
- &nbsp;&nbsp;<B>pcm</B> - encode to uncompressed PCM<BR>
- &nbsp;&nbsp;<B>mp3lame</B> - encode to MP3 (using Lame)<BR>
- </TD>
-</TR>
-<TR>
- <TD> <CODE>-mf</CODE> multifile options</TD>
- <TD> Used when encoding from multiple JPEG files. Its sub-options are:<BR>
- &nbsp;&nbsp;<B>on</B> - turns on multifile support<BR>
- &nbsp;&nbsp;<B>w</B>=&lt;value&gt; - width of the output file<BR>
- &nbsp;&nbsp;<B>h</B>=&lt;value&gt; - height of the output file<BR>
- &nbsp;&nbsp;<B>fps</B>=&lt;value&gt; - fps of the output file<BR>
- &nbsp;&nbsp;<B>type</B>=&lt;value&gt; - type of input files (available types: <CODE>jpeg</CODE>, <CODE>png</CODE>)<BR>
- </TD>
-</TR>
-
-<TR>
- <TD> <CODE>-divx4opts</CODE></TD>
- <TD> If encoding to DivX4, you can specify its parameters here, like:<BR>
- &nbsp;&nbsp;<CODE>-divx4opts br=1800:deinterlace:key=250</CODE><BR>
- Common options: <B>(for full list, check the man page!)</B><BR>
- &nbsp;&nbsp;<B>help</B> - get help<BR>
- &nbsp;&nbsp;<B>br</B>=&lt;value&gt; - specify bitrate in kbit &lt;4-16000&gt; or bit &lt;16001-24000000&gt;<BR>
- &nbsp;&nbsp;<B>q</B>=&lt;value&gt; - quality (1-fastest, 5-best - default 5)<BR>
- &nbsp;&nbsp;<B>key</B>=&lt;value&gt; - keyframe interval<BR>
- </TD>
-</TR>
-<TR>
- <TD> <CODE>-lavcopts</CODE></TD>
- <TD> If encoding with libavcodec, you can specify its parameters here, like:<BR>
- &nbsp;&nbsp;<CODE>-lavcopts vcodec=msmpeg4:vbitrate=1800:vhq:keyint=250</CODE><BR>
- Common options: <B>(for full list, check the man page!)</B><BR>
- &nbsp;&nbsp;<B>help</B> - get help<BR>
- &nbsp;&nbsp;<B>vcodec</B>=&lt;value&gt; - select videocodec (for the full list, see the libavcodec section above)<BR>
- &nbsp;&nbsp;<B>vbitrate</B>=&lt;value&gt; - specify bitrate in kbit &lt;4-16000&gt; or bit &lt;16001-24000000&gt;<BR>
- &nbsp;&nbsp;<B>vhq</B> - high quality<BR>
- &nbsp;&nbsp;<B>keyint</B>=&lt;value&gt; - keyframe interval<BR>
- </TD>
-</TR>
-<TR>
- <TD> <CODE>-lameopts</CODE></TD>
- <TD> If encoding to MP3 with libmp3lame, you can specify its parameters here, like:<BR>
- &nbsp;&nbsp;<CODE>-lameopts q=3</CODE><BR>
- &nbsp;&nbsp;<CODE>-lameopts br=192:cbr</CODE><BR>
- Common options: <B>(for full list, check the man page!)</B><BR>
- &nbsp;&nbsp;<B>help</B> - get help<BR>
- &nbsp;&nbsp;<B>cbr</B> - select <B>CBR</B> MP3 (default is <B>VBR</B>)<BR>
- &nbsp;&nbsp;<B>br</B>=&lt;value&gt; - specify bitrate in kbit &lt;0-1024&gt; (this is for <B>CBR</B> only!)<BR>
- &nbsp;&nbsp;<B>q</B>=&lt;value&gt; - quality (0-highest, 9-fastest - default 0) (this is for <B>VBR</B> only!)<BR>
- &nbsp;&nbsp;<B>vbr</B>=&lt;value&gt; - VBR sub-mode (3-ABR, best quality/speed) (this is for <B>VBR</B> only!)<BR>
- </TD>
-</TR>
-<TR>
- <TD> <CODE>-vobsubout</CODE> basename</TD>
- <TD> Specify the basename for the output <CODE>.idx</CODE> and <CODE>.sub</CODE> files. This turns off subtitle rendering on the encoded movie.</TD>
-</TR>
-<TR>
- <TD> <CODE>-vobsuboutindex</CODE> index</TD>
- <TD> Specify the index of the subtitles in the output files. Defaults to 0.</TD>
-</TR>
-<TR>
- <TD> <CODE>-vobsuboutid</CODE> langid</TD>
- <TD> Specify the language two letter code for the subtitles. This overrides what is read from the DVD or the <CODE>.ifo</CODE> file.</TD>
-</TR>
+ <TR>
+ <TD><CODE>-ss</CODE> time</TD>
+ <TD>start encoding from the given time (can start only from keyframes!)
+ </TD>
+ </TR>
+ <TR>
+ <TD><CODE>-endpos</CODE> time</TD>
+ <TD>stop encoding at the given time. See the man page for examples!
+ </TD>
+ </TR>
+ <TR>
+ <TD><CODE>-o</CODE> filename</TD>
+ <TD>specify output filename
+ </TD>
+ </TR>
+ <TR>
+ <TD><CODE>-sws</CODE> 0-2</TD>
+ <TD>type of scaling method<BR>
+ &nbsp;&nbsp;0 - fast bilinear<BR>
+ &nbsp;&nbsp;1 - bilinear<BR>
+ &nbsp;&nbsp;2 - bicubic (best quality)<BR>
+ </TD>
+ </TR>
+ <TR>
+ <TD><CODE>-ovc</CODE> codecname</TD>
+ <TD>Encode with the given codec (codec names are from codecs.conf). Examples:<BR>
+ &nbsp;&nbsp;<B>help</B> - get list of available codecs<BR>
+ &nbsp;&nbsp;<B>rawrgb</B> - ?<BR>
+ &nbsp;&nbsp;<B>copy</B> - no encoding, just copy the stream (only from AVI/ASF now)<BR>
+ &nbsp;&nbsp;<B>divx4</B> - encode to DivX4<BR>
+ &nbsp;&nbsp;<B>lavc</B> - encode with a codec from libavcodec<BR>
+ &nbsp;&nbsp;<B>vfw</B> - encode with a Windows DLL<BR>
+ </TD>
+ </TR>
+ <TR>
+ <TD><CODE>-oac</CODE> codecname</TD>
+ <TD>Encode with the given codec (codec names are from codecs.conf). Examples:<BR>
+ &nbsp;&nbsp;<B>help</B> - get list of available codecs<BR>
+ &nbsp;&nbsp;<B>copy</B> - no encoding, just copy the stream (only from AVI/ASF now)<BR>
+ &nbsp;&nbsp;<B>pcm</B> - encode to uncompressed PCM<BR>
+ &nbsp;&nbsp;<B>mp3lame</B> - encode to MP3 (using Lame)<BR>
+ </TD>
+ </TR>
+ <TR>
+ <TD><CODE>-mf</CODE> multifile options</TD>
+ <TD>Used when encoding from multiple JPEG files. Its sub-options are:<BR>
+ &nbsp;&nbsp;<B>on</B> - turns on multifile support<BR>
+ &nbsp;&nbsp;<B>w</B>=&lt;value&gt; - width of the output file<BR>
+ &nbsp;&nbsp;<B>h</B>=&lt;value&gt; - height of the output file<BR>
+ &nbsp;&nbsp;<B>fps</B>=&lt;value&gt; - fps of the output file<BR>
+ &nbsp;&nbsp;<B>type</B>=&lt;value&gt; - type of input files (available types:
+ <CODE>jpeg</CODE>, <CODE>png</CODE>)<BR>
+ </TD>
+ </TR>
+
+ <TR>
+ <TD><CODE>-divx4opts</CODE></TD>
+ <TD>If encoding to DivX4, you can specify its parameters here, like:<BR>
+ &nbsp;&nbsp;<CODE>-divx4opts br=1800:deinterlace:key=250</CODE><BR>
+ Common options: <B>(for full list, check the man page!)</B><BR>
+ &nbsp;&nbsp;<B>help</B> - get help<BR>
+ &nbsp;&nbsp;<B>br</B>=&lt;value&gt; - specify bitrate in kbit &lt;4-16000&gt;
+ or bit &lt;16001-24000000&gt;<BR>
+ &nbsp;&nbsp;<B>q</B>=&lt;value&gt; - quality (1-fastest, 5-best - default 5)<BR>
+ &nbsp;&nbsp;<B>key</B>=&lt;value&gt; - keyframe interval<BR>
+ </TD>
+ </TR>
+ <TR>
+ <TD><CODE>-lavcopts</CODE></TD>
+ <TD>If encoding with libavcodec, you can specify its parameters here, like:<BR>
+ &nbsp;&nbsp;<CODE>-lavcopts vcodec=msmpeg4:vbitrate=1800:vhq:keyint=250</CODE><BR>
+ Common options: <B>(for full list, check the man page!)</B><BR>
+ &nbsp;&nbsp;<B>help</B> - get help<BR>
+ &nbsp;&nbsp;<B>vcodec</B>=&lt;value&gt; - select videocodec (for the full list, see the libavcodec section above)<BR>
+ &nbsp;&nbsp;<B>vbitrate</B>=&lt;value&gt; - specify bitrate in kbit &lt;4-16000&gt; or bit &lt;16001-24000000&gt;<BR>
+ &nbsp;&nbsp;<B>vhq</B> - high quality<BR>
+ &nbsp;&nbsp;<B>keyint</B>=&lt;value&gt; - keyframe interval<BR>
+ </TD>
+ </TR>
+ <TR>
+ <TD><CODE>-lameopts</CODE></TD>
+ <TD>If encoding to MP3 with libmp3lame, you can specify its parameters here, like:<BR>
+ &nbsp;&nbsp;<CODE>-lameopts q=3</CODE><BR>
+ &nbsp;&nbsp;<CODE>-lameopts br=192:cbr</CODE><BR>
+ Common options: <B>(for full list, check the man page!)</B><BR>
+ &nbsp;&nbsp;<B>help</B> - get help<BR>
+ &nbsp;&nbsp;<B>cbr</B> - select <B>CBR</B> MP3 (default is <B>VBR</B>)<BR>
+ &nbsp;&nbsp;<B>br</B>=&lt;value&gt; - specify bitrate in kbit &lt;0-1024&gt; (this is for <B>CBR</B> only!)<BR>
+ &nbsp;&nbsp;<B>q</B>=&lt;value&gt; - quality (0-highest, 9-fastest - default 0) (this is for <B>VBR</B> only!)<BR>
+ &nbsp;&nbsp;<B>vbr</B>=&lt;value&gt; - VBR sub-mode (3-ABR, best quality/speed) (this is for <B>VBR</B> only!)<BR>
+ </TD>
+ </TR>
+ <TR>
+ <TD><CODE>-vobsubout</CODE> basename</TD>
+ <TD>Specify the basename for the output <CODE>.idx</CODE> and <CODE>.sub</CODE>
+ files. This turns off subtitle rendering on the encoded movie.</TD>
+ </TR>
+ <TR>
+ <TD><CODE>-vobsuboutindex</CODE> index</TD>
+ <TD>Specify the index of the subtitles in the output files. Defaults to 0.</TD>
+ </TR>
+ <TR>
+ <TD><CODE>-vobsuboutid</CODE> langid</TD>
+ <TD>Specify the language two letter code for the subtitles. This overrides
+ what is read from the DVD or the <CODE>.ifo</CODE> file.</TD>
+ </TR>
</TABLE>
<P><B><A NAME="examples">2.4.6 Examples</A></B></P>
diff --git a/DOCS/formats.html b/DOCS/formats.html
index d771c2655f..c66c751151 100644
--- a/DOCS/formats.html
+++ b/DOCS/formats.html
@@ -19,8 +19,7 @@
<P>You see, a <B>codec</B> is not the same as a <B>file format</B>.<BR>
Examples of video <B>codecs</B> are: MPEG1, MPEG2, DivX, Indeo5, 3ivx.<BR>
- Examples of file <B>formats</B> are: MPG, AVI, ASF.<BR>
-</P>
+ Examples of file <B>formats</B> are: MPG, AVI, ASF.</P>
<P>In theory, you can put an OpenDivX video and MP3 audio into an <B>MPG</B>
format file. However, most players will not play it, since they expect MPEG1
@@ -72,7 +71,7 @@
supports one video stream and 0 to 99 audio streams. File size is limited to
2GB, but there exists an extension allowing bigger files called
<B>OpenDMS</B>. Microsoft currently strongly discourages its use and
- encourages ASF/WMV. Not that anybody cares.<BR>
+ encourages ASF/WMV. Not that anybody cares.</P>
<P>There is a hack that allows AVI files to contain an Ogg Vorbis audio
stream, but makes them incompatible with standard AVI. <B>MPlayer</B>
@@ -194,8 +193,7 @@
format used by the <A HREF="http://mjpeg.sf.net">mjpegtools programs</A>.
You can grab, produce, filter or encode video in this format using these
tools. The file format is really a sequence of uncompressed YUV 4:2:0
- images.
-</P>
+ images.</P>
<P><B><A NAME="film">2.1.1.10 FILM files</A></B></P>
diff --git a/DOCS/sound.html b/DOCS/sound.html
index e3952c2d95..68e355b1bc 100644
--- a/DOCS/sound.html
+++ b/DOCS/sound.html
@@ -13,24 +13,21 @@
<P><B><A NAME="audio">2.3.2 Audio output devices</A></B></P>
<P><B>MPlayer</B>'s audio interface is called <I>libao2</I>. It currently
-contains these drivers:</P>
+ contains these drivers:</P>
<TABLE BORDER=0>
-
-<TR><TD COLSPAN=4><P><B>General:</B></P></TD></TR>
-
-<TR><TD>&nbsp;&nbsp;</TD><TD VALIGN=top>oss</TD><TD>&nbsp;&nbsp;</TD><TD>OSS (ioctl) driver (supports hardware AC3 passthrough)</TD></TR>
-<TR><TD></TD><TD VALIGN=top>sdl</TD><TD></TD><TD>SDL driver (supports up/downsampling, <B>ESD</B>, <B>ARTS</B> etc)</TD></TR>
-<TR><TD></TD><TD VALIGN=top>nas</TD><TD></TD><TD>NAS (Network Audio System) driver</TD></TR>
-<TR><TD></TD><TD VALIGN=top>alsa5</TD><TD></TD><TD>native ALSA 0.5 driver</TD></TR>
-<TR><TD></TD><TD VALIGN=top>alsa9</TD><TD></TD><TD>native ALSA 0.9 driver (supports hardware AC3 passthrough)</TD></TR>
-<TR><TD></TD><TD VALIGN=top>sun</TD><TD></TD><TD>SUN audio driver (<CODE>/dev/audio</CODE>) for BSD and Solaris8 users</TD></TR>
-<TR><TD></TD><TD VALIGN=top>arts</TD><TD></TD><TD>native ARTS driver (mostly for KDE users)</TD></TR>
-
+ <TR><TD COLSPAN=4><P><B>General:</B></P></TD></TR>
+ <TR><TD>&nbsp;&nbsp;</TD><TD VALIGN=top>oss</TD><TD>&nbsp;&nbsp;</TD><TD>OSS (ioctl) driver (supports hardware AC3 passthrough)</TD></TR>
+ <TR><TD></TD><TD VALIGN=top>sdl</TD><TD></TD><TD>SDL driver (supports up/downsampling, <B>ESD</B>, <B>ARTS</B> etc)</TD></TR>
+ <TR><TD></TD><TD VALIGN=top>nas</TD><TD></TD><TD>NAS (Network Audio System) driver</TD></TR>
+ <TR><TD></TD><TD VALIGN=top>alsa5</TD><TD></TD><TD>native ALSA 0.5 driver</TD></TR>
+ <TR><TD></TD><TD VALIGN=top>alsa9</TD><TD></TD><TD>native ALSA 0.9 driver (supports hardware AC3 passthrough)</TD></TR>
+ <TR><TD></TD><TD VALIGN=top>sun</TD><TD></TD><TD>SUN audio driver (<CODE>/dev/audio</CODE>) for BSD and Solaris8 users</TD></TR>
+ <TR><TD></TD><TD VALIGN=top>arts</TD><TD></TD><TD>native ARTS driver (mostly for KDE users)</TD></TR>
</TABLE>
<P>Fact is, Linux sound card drivers have compatibility problems.
-It <B>may</B> take a while to find your optimal settings.</P>
+ It <B>may</B> take a while to find your optimal settings.</P>
<UL>
<LI>If you have an OSS driver, first try <CODE>-ao oss</CODE> (this is the
@@ -55,70 +52,70 @@ It <B>may</B> take a while to find your optimal settings.</P>
<P><B><A NAME="experiences">2.3.2.1 Sound Card experiences, recommendations</A></B></P>
<TABLE BORDER=0 WIDTH="100%">
-<TR><TD COLSPAN=3><B>VIA onboard chipset (via82cxxx) 48kHz only</B></TD><TR>
-<TD></TD><TD>Driver:</TD><TD> from <A HREF="http://sourceforge.net/project/showfiles.php?group_id=3242&amp;release_id=59602">here</A></TD><TR>
-
-<TD COLSPAN=3><B>Aureal Vortex 2</B></TD><TR>
-<TD>&nbsp;&nbsp;&nbsp;&nbsp;</TD><TD>OSS:</TD><TD>no driver</TD><TR>
-<TD></TD><TD>OSS/Pro:</TD><TD>OK</TD><TR>
-<TD></TD><TD>ALSA:</TD><TD>no driver</TD><TR>
-<TD></TD><TD>Max kHz:</TD><TD>48</TD><TR>
-<TD></TD><TD>Driver:</TD><TD><A HREF="http://aureal.sourceforge.net">aureal.sourceforge.net</A></TD><TR>
-<TD></TD><TD>Driver2:</TD><TD> from <A HREF="http://makacs.poliod.hu/~pontscho/aureal/au88xx-1.1.3.tar.bz2">here</A><BR>
-(<I>buffer size increased to 32k</I>)</TD><TR>
-
-<TD COLSPAN=3><B>GUS PnP</B></TD><TR>
-<TD></TD><TD>OSS:</TD><TD>no driver</TD><TR>
-<TD></TD><TD>OSS/Pro:</TD><TD>OK</TD><TR>
-<TD></TD><TD>ALSA:</TD><TD>OK</TD><TR>
-<TD></TD><TD>Max kHz:</TD><TD>48</TD><TR>
-
-<TD COLSPAN=3><B>SB Live!</B></TD><TR>
-<TD></TD><TD>OSS:</TD><TD>Analog OK, SP/DIF not working</TD><TR>
-<TD></TD><TD>ALSA:</TD><TD>Both OK</TD><TR>
-<TD></TD><TD>Max kHz:</TD><TD>192</TD><TR>
-
-<TD COLSPAN=3><B>SB AWE 64</B></TD><TR>
-<TD></TD><TD>OSS:</TD><TD>max 44kHz</TD><TR>
-<TD></TD><TD>ALSA:</TD><TD>48kHz sounds bad</TD><TR>
-<TD></TD><TD>Max kHz:</TD><TD>48</TD><TR>
-
-<TD COLSPAN=3><B>Gravis UltraSound ACE</B></TD><TR>
-<TD></TD><TD>OSS:</TD><TD>not OK</TD><TR>
-<TD></TD><TD>ALSA:</TD><TD>OK</TD><TR>
-<TD></TD><TD>Max kHz:</TD><TD>44</TD><TR>
-
-<TD COLSPAN=3><B>Gravis UltraSound MAX</B></TD><TR>
-<TD></TD><TD>OSS:</TD><TD>OK</TD><TR>
-<TD></TD><TD>ALSA:</TD><TD>OK (?)</TD><TR>
-<TD></TD><TD>Max kHz:</TD><TD>48</TD><TR>
-
-<TD COLSPAN=3><B>ESS 688</B></TD><TR>
-<TD></TD><TD>OSS:</TD><TD>OK</TD><TR>
-<TD></TD><TD>ALSA:</TD><TD>OK (?)</TD><TR>
-<TD></TD><TD>Max kHz:</TD><TD>48</TD><TR>
-
-<TD COLSPAN=3><B>C-Media cards (which ones?)</B></TD><TR>
-<TD></TD><TD>OSS:</TD><TD>not OK (hissing) (?)</TD><TR>
-<TD></TD><TD>ALSA:</TD><TD>OK (?)</TD><TR>
-<TD></TD><TD>Max kHz:</TD><TD>?</TD><TR>
-
-<TD COLSPAN=3><B>Yamaha cards (*ymf*)</B></TD><TR>
-<TD></TD><TD>OSS:</TD><TD>not OK (?) (maybe <CODE>-ao sdl</CODE>)</TD><TR>
-<TD></TD><TD>ALSA:</TD><TD>OK only with ALSA 0.5 with OSS emulation <B>AND</B> <CODE>-ao sdl</CODE> (!) (?)</TD><TR>
-<TD></TD><TD>Max kHz:</TD><TD>?</TD><TR>
-
-<TD COLSPAN=3><B>Cards with envy24 chips (like Terratec EWS88MT)</B></TD><TR>
-<TD></TD><TD>OSS:</TD><TD>?</TD><TR>
-<TD></TD><TD>OSS/Pro:</TD><TD>OK</TD><TR>
-<TD></TD><TD>ALSA:</TD><TD>?</TD><TR>
-<TD></TD><TD>Max kHz:</TD><TD>?</TD><TR>
-
-<TD COLSPAN=3><B>PC Speaker or DAC</B></TD><TR>
-<TD></TD><TD>OSS:</TD><TD>OK (Use the SDL driver: <CODE>-ao sdl</CODE>)</TD><TR>
-<TD></TD><TD>ALSA:</TD><TD>no driver</TD><TR>
-<TD></TD><TD>Max kHz:</TD><TD>The driver emulates 44.1, maybe more.</TD><TR>
-<TD></TD><TD>Driver:</TD><TD><A HREF="ftp://ftp.infradead.org/pub/pcsp">ftp://ftp.infradead.org/pub/pcsp</A></TD>
+ <TR><TD COLSPAN=3><B>VIA onboard chipset (via82cxxx) 48kHz only</B></TD><TR>
+ <TD></TD><TD>Driver:</TD><TD> from <A HREF="http://sourceforge.net/project/showfiles.php?group_id=3242&amp;release_id=59602">here</A></TD><TR>
+
+ <TD COLSPAN=3><B>Aureal Vortex 2</B></TD><TR>
+ <TD>&nbsp;&nbsp;&nbsp;&nbsp;</TD><TD>OSS:</TD><TD>no driver</TD><TR>
+ <TD></TD><TD>OSS/Pro:</TD><TD>OK</TD><TR>
+ <TD></TD><TD>ALSA:</TD><TD>no driver</TD><TR>
+ <TD></TD><TD>Max kHz:</TD><TD>48</TD><TR>
+ <TD></TD><TD>Driver:</TD><TD><A HREF="http://aureal.sourceforge.net">aureal.sourceforge.net</A></TD><TR>
+ <TD></TD><TD>Driver2:</TD><TD> from <A HREF="http://makacs.poliod.hu/~pontscho/aureal/au88xx-1.1.3.tar.bz2">here</A><BR>
+ (<I>buffer size increased to 32k</I>)</TD><TR>
+
+ <TD COLSPAN=3><B>GUS PnP</B></TD><TR>
+ <TD></TD><TD>OSS:</TD><TD>no driver</TD><TR>
+ <TD></TD><TD>OSS/Pro:</TD><TD>OK</TD><TR>
+ <TD></TD><TD>ALSA:</TD><TD>OK</TD><TR>
+ <TD></TD><TD>Max kHz:</TD><TD>48</TD><TR>
+
+ <TD COLSPAN=3><B>SB Live!</B></TD><TR>
+ <TD></TD><TD>OSS:</TD><TD>Analog OK, SP/DIF not working</TD><TR>
+ <TD></TD><TD>ALSA:</TD><TD>Both OK</TD><TR>
+ <TD></TD><TD>Max kHz:</TD><TD>192</TD><TR>
+
+ <TD COLSPAN=3><B>SB AWE 64</B></TD><TR>
+ <TD></TD><TD>OSS:</TD><TD>max 44kHz</TD><TR>
+ <TD></TD><TD>ALSA:</TD><TD>48kHz sounds bad</TD><TR>
+ <TD></TD><TD>Max kHz:</TD><TD>48</TD><TR>
+
+ <TD COLSPAN=3><B>Gravis UltraSound ACE</B></TD><TR>
+ <TD></TD><TD>OSS:</TD><TD>not OK</TD><TR>
+ <TD></TD><TD>ALSA:</TD><TD>OK</TD><TR>
+ <TD></TD><TD>Max kHz:</TD><TD>44</TD><TR>
+
+ <TD COLSPAN=3><B>Gravis UltraSound MAX</B></TD><TR>
+ <TD></TD><TD>OSS:</TD><TD>OK</TD><TR>
+ <TD></TD><TD>ALSA:</TD><TD>OK (?)</TD><TR>
+ <TD></TD><TD>Max kHz:</TD><TD>48</TD><TR>
+
+ <TD COLSPAN=3><B>ESS 688</B></TD><TR>
+ <TD></TD><TD>OSS:</TD><TD>OK</TD><TR>
+ <TD></TD><TD>ALSA:</TD><TD>OK (?)</TD><TR>
+ <TD></TD><TD>Max kHz:</TD><TD>48</TD><TR>
+
+ <TD COLSPAN=3><B>C-Media cards (which ones?)</B></TD><TR>
+ <TD></TD><TD>OSS:</TD><TD>not OK (hissing) (?)</TD><TR>
+ <TD></TD><TD>ALSA:</TD><TD>OK (?)</TD><TR>
+ <TD></TD><TD>Max kHz:</TD><TD>?</TD><TR>
+
+ <TD COLSPAN=3><B>Yamaha cards (*ymf*)</B></TD><TR>
+ <TD></TD><TD>OSS:</TD><TD>not OK (?) (maybe <CODE>-ao sdl</CODE>)</TD><TR>
+ <TD></TD><TD>ALSA:</TD><TD>OK only with ALSA 0.5 with OSS emulation <B>AND</B> <CODE>-ao sdl</CODE> (!) (?)</TD><TR>
+ <TD></TD><TD>Max kHz:</TD><TD>?</TD><TR>
+
+ <TD COLSPAN=3><B>Cards with envy24 chips (like Terratec EWS88MT)</B></TD><TR>
+ <TD></TD><TD>OSS:</TD><TD>?</TD><TR>
+ <TD></TD><TD>OSS/Pro:</TD><TD>OK</TD><TR>
+ <TD></TD><TD>ALSA:</TD><TD>?</TD><TR>
+ <TD></TD><TD>Max kHz:</TD><TD>?</TD><TR>
+
+ <TD COLSPAN=3><B>PC Speaker or DAC</B></TD><TR>
+ <TD></TD><TD>OSS:</TD><TD>OK (Use the SDL driver: <CODE>-ao sdl</CODE>)</TD><TR>
+ <TD></TD><TD>ALSA:</TD><TD>no driver</TD><TR>
+ <TD></TD><TD>Max kHz:</TD><TD>The driver emulates 44.1, maybe more.</TD><TR>
+ <TD></TD><TD>Driver:</TD><TD><A HREF="ftp://ftp.infradead.org/pub/pcsp">ftp://ftp.infradead.org/pub/pcsp</A></TD>
</TABLE>
<UL>
@@ -144,28 +141,23 @@ It <B>may</B> take a while to find your optimal settings.</P>
card. They are enabled using the <CODE>-aop</CODE> switch which takes a
<CODE>list=plugin1,plugin2,...</CODE> argument. The <CODE>list</CODE> argument
is required and determines which plugins should be used and in which order they
- should be executed. Example:
-</P>
+ should be executed. Example:</P>
<P>&nbsp;&nbsp;<CODE>mplayer media.avi -aop list=resample,format</CODE></P>
<P>would run the sound through the resampling plugin followed by the format
- plugin.
-</P>
+ plugin.</P>
<P>The plugins can also have switches that change their behavior. These
switches are explained in detail in the sections below. A plugin will execute
using default settings if its switches are omitted. Here is an example of how
- to use plugins in combination with plugin specific switches:
-</P>
+ to use plugins in combination with plugin specific switches:</P>
<P>&nbsp;&nbsp;<CODE>mplayer media.avi -aop
- list=resample,format:fout=44100:format=0x8</CODE>
-</P>
+ list=resample,format:fout=44100:format=0x8</CODE></P>
<P>would set the output frequency of the resample plugin to 44100Hz and the
- output format of the format plugin to AFMT_U8.
-</P>
+ output format of the format plugin to AFMT_U8.</P>
<P>Currently audio plugins can not be used in <B>MEncoder</B>.</P>
@@ -179,26 +171,26 @@ It <B>may</B> take a while to find your optimal settings.</P>
the sample frequency explicitly. This plugin has one switch:
<CODE>fout</CODE> which is used for setting the desired output sample
frequency. It defaults to 48kHz, and is given in
- &lt;Hz&gt;.
-</P>
+ &lt;Hz&gt;.</P>
<P>Usage:<BR>
-&nbsp;&nbsp;<CODE>mplayer media.avi -aop list=resample:fout=&lt;required
+ &nbsp;&nbsp;<CODE>mplayer media.avi -aop list=resample:fout=&lt;required
frequency in Hz, like 44100&gt;</CODE></P>
<P>Note that the output frequency should not be scaled up from the default value.
Scaling up will cause the audio and video streams to be played in slow motion
in addition to audio distortion.</P>
+
<P><B><A NAME="surround_decoding">2.3.2.2.2 Surround Sound decoding</A></B></P>
<P><B>MPlayer</B> has an audio plugin that can decode matrix encoded
-surround sound. Dolby Surround is an example of a matrix encoded format.
-Many files with 2 channel audio actually contain matrixed surround sound.
-To use this feature you need a sound card supporting at least 4 channels.</P>
+ surround sound. Dolby Surround is an example of a matrix encoded format.
+ Many files with 2 channel audio actually contain matrixed surround sound.
+ To use this feature you need a sound card supporting at least 4 channels.</P>
<P>Usage:<BR>
-&nbsp;&nbsp;<CODE>mplayer media.avi -aop list=surround</CODE></P>
+ &nbsp;&nbsp;<CODE>mplayer media.avi -aop list=surround</CODE></P>
<P><B><A NAME="format">2.3.2.2.3 Sample format converter</A></B></P>
@@ -209,13 +201,11 @@ To use this feature you need a sound card supporting at least 4 channels.</P>
has one switch, <CODE>format</CODE>, which can be set to one of the numbers
found in <CODE>libao2/afmt.h</CODE>. This plugin is hardly ever needed and is
intended for advanced users. Keep in mind that this plugin only changes the
- sample format and not the sample frequency or the number of channels.
-</P>
+ sample format and not the sample frequency or the number of channels.</P>
<P>Usage:<BR>
&nbsp;&nbsp;<CODE>mplayer media.avi -aop
- list=format:format=&lt;required output format&gt;</CODE>
-</P>
+ list=format:format=&lt;required output format&gt;</CODE></P>
<P><B><A NAME="delay">2.3.2.2.4 Delay</A></B></P>
@@ -241,33 +231,28 @@ To use this feature you need a sound card supporting at least 4 channels.</P>
external amplifier connected to the computer (this is almost always
the case), the noise level can be minimized by adjusting the master
level and the volume knob on the amplifier until the hissing noise
- in the background is gone.
-</P>
+ in the background is gone.</P>
<P>Usage:<BR>
&nbsp;&nbsp;<CODE>mplayer media.avi -aop
- list=volume:volume=&lt;0-255&gt;</CODE>
-</P>
+ list=volume:volume=&lt;0-255&gt;</CODE></P>
<P>This plugin also has compressor or "soft-clipping" capabilities.
Compression can be used if the dynamic range of the sound is very
high or if the dynamic range of the loudspeakers is very
low. Be aware that this feature creates distortion and should be
- considered a last resort.
-</P>
+ considered a last resort.</P>
<P>Usage:<BR>
&nbsp;&nbsp;<CODE>mplayer media.avi -aop
- list=volume:softclip</CODE>
-</P>
+ list=volume:softclip</CODE></P>
<P><B><A NAME="extrastereo">2.3.2.2.6 Extrastereo</A></B></P>
<P>This plugin (linearly) increases the difference between left and right
channels (like the XMMS extrastereo plugin) which gives some sort of "live"
- effect to playback.
-</P>
+ effect to playback.</P>
<P>Usage:<BR>
&nbsp;&nbsp;<CODE>mplayer media.avi -aop list=extrastereo</CODE><BR>
diff --git a/DOCS/users_against_developers.html b/DOCS/users_against_developers.html
index 43656efea4..d7a1c5f5da 100644
--- a/DOCS/users_against_developers.html
+++ b/DOCS/users_against_developers.html
@@ -13,65 +13,66 @@
<P><B>In medias res</B></P>
<P>There are two major topics which always cause huge dispute and flame on the
-<A HREF="http://mplayerhq.hu/pipermail/mplayer-users/">mplayer-users</A>
-mailing list. Number one is the topic of the</P>
+ <A HREF="http://mplayerhq.hu/pipermail/mplayer-users/">mplayer-users</A>
+ mailing list. Number one is the topic of the</P>
-<P><A NAME=gcc><B>GCC 2.96 series</B></A></P>
+
+<P><A NAME="gcc"><B>GCC 2.96 series</B></A></P>
<P><B>The background:</B> The GCC <B>2.95</B> series is an official GNU release
-and version 2.95.3 of GCC is the most bug-free in that series.
-We have never noticed compilation problems that we could trace to gcc-2.95.3.
-Starting with Red Hat Linux 7.0, <B>Red Hat</B> included a heavily
-patched CVS version of GCC in their distribution and named it <B>2.96</B>. Red
-Hat included this version in the distribution because GCC 3.0 was not finished at
-the time, and they needed a compiler that worked well on all of their supported
-platforms, including IA64 and s390. The Linux distributor <B>Mandrake</B>
-also followed Red Hat's example and started shipping GCC 2.96 with their
-Linux-Mandrake 8.0 series. </P>
-
-<P><B>The statements:</B> The GCC team disclaimed any link with GCC 2.96 and issued an
-<A HREF="http://gcc.gnu.org/gcc-2.96.html">official response</A> to GCC 2.96.
-Many developers around the world began having problems with GCC 2.96, and
-started recommending other compilers. Examples are
-<A HREF="http://www.apachelabs.org/apr-mbox/200106.mbox/%3c20010623194228.C25512@ebuilt.com%3e">Apache</A>,
-<A HREF="http://www.mysql.com/downloads/mysql-3.23.html">MySQL</A>,
-<A HREF="http://avifile.sourceforge.net/news-old1.htm">avifile</A> and
-<A HREF="http://www.winehq.com/news/?view=92#RH 7.1 gcc fixes compiler bug">Wine</A>.
-Other interesting links are
-<A HREF="http://www.realtimelinux.org/archives/rtai/20017/0144.html">Real time Linux</A>,
-<A HREF="http://www.atnf.csiro.au/people/rgooch/linux/docs/kernel-newsflash.html">
-Linux kernel news flash about kernel 2.4.17</A> and
-<A HREF="http://www.voy.com/3516/572.html">Voy Forum</A>.
-<B>MPlayer</B> also suffered from intermittent problems that were all solved by
-switching to a different version of GCC. Several projects started implementing
-workarounds for some of the 2.96 issues, but we refused to fix other people's
-bugs, especially since some workarounds may imply a performance penalty.</P>
+ and version 2.95.3 of GCC is the most bug-free in that series.
+ We have never noticed compilation problems that we could trace to gcc-2.95.3.
+ Starting with Red Hat Linux 7.0, <B>Red Hat</B> included a heavily
+ patched CVS version of GCC in their distribution and named it <B>2.96</B>. Red
+ Hat included this version in the distribution because GCC 3.0 was not finished
+ at the time, and they needed a compiler that worked well on all of their
+ supported platforms, including IA64 and s390. The Linux distributor
+ <B>Mandrake</B> also followed Red Hat's example and started shipping GCC 2.96
+ with their Linux-Mandrake 8.0 series.</P>
+
+<P><B>The statements:</B> The GCC team disclaimed any link with GCC 2.96 and
+ issued an <A HREF="http://gcc.gnu.org/gcc-2.96.html">official response</A> to
+ GCC 2.96. Many developers around the world began having problems with GCC 2.96,
+ and started recommending other compilers. Examples are
+ <A HREF="http://www.apachelabs.org/apr-mbox/200106.mbox/%3c20010623194228.C25512@ebuilt.com%3e">Apache</A>,
+ <A HREF="http://www.mysql.com/downloads/mysql-3.23.html">MySQL</A>,
+ <A HREF="http://avifile.sourceforge.net/news-old1.htm">avifile</A> and
+ <A HREF="http://www.winehq.com/news/?view=92#RH 7.1 gcc fixes compiler bug">Wine</A>.
+ Other interesting links are
+ <A HREF="http://www.realtimelinux.org/archives/rtai/20017/0144.html">Real time Linux</A>,
+ <A HREF="http://www.atnf.csiro.au/people/rgooch/linux/docs/kernel-newsflash.html">
+ Linux kernel news flash about kernel 2.4.17</A> and
+ <A HREF="http://www.voy.com/3516/572.html">Voy Forum</A>.
+ <B>MPlayer</B> also suffered from intermittent problems that were all solved by
+ switching to a different version of GCC. Several projects started implementing
+ workarounds for some of the 2.96 issues, but we refused to fix other people's
+ bugs, especially since some workarounds may imply a performance penalty.</P>
<P>You can read about the other side of the story
-<A HREF="http://www.bero.org/gcc296.html">here</A>.
-GCC 2.96 does not allow | (pipe) characters in assembler comments
-because it supports Intel as well as AT&amp;T Syntax and the | character is a
-symbol in the Intel variant. The problem is that it <B>silently</B> ignores the
-whole assembler block. This is supposedly fixed now, GCC prints a warning instead
-of skipping the block.</P>
+ <A HREF="http://www.bero.org/gcc296.html">here</A>.
+ GCC 2.96 does not allow | (pipe) characters in assembler comments
+ because it supports Intel as well as AT&amp;T Syntax and the | character is a
+ symbol in the Intel variant. The problem is that it <B>silently</B> ignores the
+ whole assembler block. This is supposedly fixed now, GCC prints a warning instead
+ of skipping the block.</P>
<P><B>The present:</B> Red Hat says that GCC 2.96-85 and above is fixed. The
-situation has indeed improved, yet we still see problem reports on our
-mailing lists that disappear with a different compiler. In any case it does not
-matter any longer. Hopefully a maturing GCC 3.x will solve the issue for good.
-If you want to compile with 2.96 give the <CODE>--disable-gcc-checking</CODE>
-flag to configure. Remember that you are on your own and <B>do not report any
-bugs</B>. If you do, you will only get banned from our mailing list because
-we have had more than enough flame wars over GCC 2.96. Please let the matter rest.</P>
+ situation has indeed improved, yet we still see problem reports on our
+ mailing lists that disappear with a different compiler. In any case it does not
+ matter any longer. Hopefully a maturing GCC 3.x will solve the issue for good.
+ If you want to compile with 2.96 give the <CODE>--disable-gcc-checking</CODE>
+ flag to configure. Remember that you are on your own and <B>do not report any
+ bugs</B>. If you do, you will only get banned from our mailing list because
+ we have had more than enough flame wars over GCC 2.96. Please let the matter rest.</P>
<P>If you have problems with GCC 2.96, you can get 2.96-85 packages from the
-Red Hat <A HREF="ftp://updates.redhat.com">ftp server</A>, or just go for the
-3.0.4 packages offered for version 7.2 and later. You can also get gcc-3.1
-packages (unofficial, but working fine)
-<A HREF="ftp://people.redhat.com/jakub/gcc3/3.1-1/">here</A> and you can
-install them along the gcc-2.96 you already have. MPlayer will detect it and
-use 3.1 instead of 2.96. If you do not want to or cannot use the binary
-packages, here is how you can compile GCC 3.1 from source:</P>
+ Red Hat <A HREF="ftp://updates.redhat.com">ftp server</A>, or just go for the
+ 3.0.4 packages offered for version 7.2 and later. You can also get gcc-3.1
+ packages (unofficial, but working fine)
+ <A HREF="ftp://people.redhat.com/jakub/gcc3/3.1-1/">here</A> and you can
+ install them along the gcc-2.96 you already have. MPlayer will detect it and
+ use 3.1 instead of 2.96. If you do not want to or cannot use the binary
+ packages, here is how you can compile GCC 3.1 from source:</P>
<UL>
<LI>Go to the <A HREF="http://gcc.gnu.org/mirrors.html">GCC mirrors page</A>
@@ -95,92 +96,94 @@ packages, here is how you can compile GCC 3.1 from source:</P>
<CODE>make install</CODE></LI>
</UL>
-<P><A NAME=binary><B>Binary distribution of MPlayer</B></A></P>
+
+<P><A NAME="binary"><B>Binary distribution of MPlayer</B></A></P>
<P>This was the second big problem but has been solved as of version
-0.90-pre1. <B>MPlayer</B> previously contained source from the OpenDivX project,
-which disallows binary redistribution. This code has been removed and you are now
-welcome to create binary packages as you see fit.</P>
+ 0.90-pre1. <B>MPlayer</B> previously contained source from the OpenDivX project,
+ which disallows binary redistribution. This code has been removed and you are now
+ welcome to create binary packages as you see fit.</P>
<P>Another impediment to binary redistribution was compiletime optimizations
-for CPU architecture. <B>MPlayer</B> now supports runtime CPU detection
-(specify the <CODE>--enable-runtime-cpudetection</CODE> option when
-compiling). It is disabled by default because it implies a small speed
-sacrifice, it is now possible to create binaries that run on different
-members of the Intel CPU family.</P>
+ for CPU architecture. <B>MPlayer</B> now supports runtime CPU detection
+ (specify the <CODE>--enable-runtime-cpudetection</CODE> option when
+ compiling). It is disabled by default because it implies a small speed
+ sacrifice, it is now possible to create binaries that run on different
+ members of the Intel CPU family.</P>
-<P><A NAME=nvidia><B>nVidia</B></A></P>
+
+<P><A NAME="nvidia"><B>nVidia</B></A></P>
<P>We dislike the fact that <A HREF="http://www.nvidia.com">nVidia</A>
- only provides binary drivers (for use with XFree86), which are often buggy.
-We have had many reports on
-<A HREF="http://mplayerhq.hu/pipermail/mplayer-users/">mplayer-users</A>
-about problems related to these closed-source drivers
-and their poor quality, instability and poor user and expert support.
-Here is an example from the
-<A HREF="http://www.nvnews.net/forum/showthread.php?s=fda5725bc2151e29453b2da3bd5d2930&amp;threadid=14306">
-nVidia Linux Forum</A>.
-Many of these problems/issues keep appearing repeatedly.
-We have been contacted by nVidia lately, and they said these bugs
-do not exist, instability is caused by bad AGP chips, and they received
-no reports of driver bugs (like the purple line). So if you have a
-problem with your nVidia card, you are advised to update the nVidia driver
-and/or buy a new motherboard or ask nVidia to supply open-source drivers.
-In any case, if you are using the nVidia binary drivers and facing driver related problems,
-please be aware that you will receive very little help from our side because we have
-little power to help in this matter.</P>
+ only provides binary drivers (for use with XFree86), which are often buggy.
+ We have had many reports on
+ <A HREF="http://mplayerhq.hu/pipermail/mplayer-users/">mplayer-users</A>
+ about problems related to these closed-source drivers
+ and their poor quality, instability and poor user and expert support.
+ Here is an example from the
+ <A HREF="http://www.nvnews.net/forum/showthread.php?s=fda5725bc2151e29453b2da3bd5d2930&amp;threadid=14306">
+ nVidia Linux Forum</A>.
+ Many of these problems/issues keep appearing repeatedly.
+ We have been contacted by nVidia lately, and they said these bugs
+ do not exist, instability is caused by bad AGP chips, and they received
+ no reports of driver bugs (like the purple line). So if you have a
+ problem with your nVidia card, you are advised to update the nVidia driver
+ and/or buy a new motherboard or ask nVidia to supply open-source drivers.
+ In any case, if you are using the nVidia binary drivers and facing driver related problems,
+ please be aware that you will receive very little help from our side because we have
+ little power to help in this matter.</P>
+
<P><A NAME="barr"><B>Joe Barr</B></A></P>
<P>Joe Barr became infamous by writing a less than favorable
-<A HREF="http://www.linuxworld.com/site-stories/2001/1214.mplayer.html">
-<B>MPlayer</B> review</A>. He found <B>MPlayer</B> hard to install, but then
-again he is not very fond of
-<A HREF="http://www.linuxworld.com/linuxworld/lw-2000-06/lw-06-exam.html">reading documentation</A>.
-He also concluded that the developers were unfriendly and the documentation
-incomplete and insulting. You be the judge.
-He went on to mention <B>MPlayer</B> negatively in his
-<A HREF="http://www.linuxworld.com/site-stories/2001/1227.predictions.html">10 Linux predictions for 2002</A>
-In a followup
-<A HREF="http://www.linuxworld.com/site-stories/2002/0125.xine.html">review of xine</A>
-he continued stirring up controversy. Ironically at the end of that article he
-quotes his exchange with Günter Bartsch, the original author of xine, that
-perfectly summarizes the whole situation:</P>
+ <A HREF="http://www.linuxworld.com/site-stories/2001/1214.mplayer.html">
+ <B>MPlayer</B> review</A>. He found <B>MPlayer</B> hard to install, but then
+ again he is not very fond of
+ <A HREF="http://www.linuxworld.com/linuxworld/lw-2000-06/lw-06-exam.html">reading documentation</A>.
+ He also concluded that the developers were unfriendly and the documentation
+ incomplete and insulting. You be the judge.
+ He went on to mention <B>MPlayer</B> negatively in his
+ <A HREF="http://www.linuxworld.com/site-stories/2001/1227.predictions.html">10 Linux predictions for 2002</A>
+ In a followup
+ <A HREF="http://www.linuxworld.com/site-stories/2002/0125.xine.html">review of xine</A>
+ he continued stirring up controversy. Ironically at the end of that article he
+ quotes his exchange with Günter Bartsch, the original author of xine, that
+ perfectly summarizes the whole situation:</P>
<BLOCKQUOTE>
-However, he also went on to say that he was "surprised" by my column about
-Mplayer and thought it was unfair, reminding me that it is a free software
-project. "If you don't like it," Bartsch said, "you're free not to use it."
+ However, he also went on to say that he was "surprised" by my column about
+ Mplayer and thought it was unfair, reminding me that it is a free software
+ project. "If you don't like it," Bartsch said, "you're free not to use it."
</BLOCKQUOTE>
<P>He does not reply to our mails. His editor does not reply to our mails.
-Here are some quotes from different people about Joe Barr, so you can form your
-own opinion:</P>
+ Here are some quotes from different people about Joe Barr, so you can form your
+ own opinion:</P>
<P>Marc Rassbach has <A HREF="http://daily.daemonnews.org/view_story.php3?story_id=2102">something to say</A>
-about the man
-</P>
+ about the man.</P>
<BLOCKQUOTE>
-You may all remember the LinuxWorld 2000, when he claimed that Linus T said
-that 'FreeBSD is just a handful of programmers'. Linus said NOTHING of the
-sort. When Joe was called on this, his reaction was to call BSD supporters
-assholes and jerks.
+ You may all remember the LinuxWorld 2000, when he claimed that Linus T said
+ that 'FreeBSD is just a handful of programmers'. Linus said NOTHING of the
+ sort. When Joe was called on this, his reaction was to call BSD supporters
+ assholes and jerks.
</BLOCKQUOTE>
<P>A <A HREF="http://www.mplayerhq.hu/pipermail/mplayer-users/2001-December/009118.html">quote</A>
-from Robert Munro on the
-<A HREF="http://mplayerhq.hu/pipermail/mplayer-users/">mplayer-users</A>
-mailing list:</P>
+ from Robert Munro on the
+ <A HREF="http://mplayerhq.hu/pipermail/mplayer-users/">mplayer-users</A>
+ mailing list:</P>
<BLOCKQUOTE>
-<P>He's interesting, but not good at avoiding, um... controversy. Joe Barr
-used to be one of the regulars on Will Zachmann's Canopus forum on Compuserve,
-years ago. He was an OS/2 advocate then (I was an OS/2 fan too).<P>
+ <P>He's interesting, but not good at avoiding, um... controversy. Joe Barr
+ used to be one of the regulars on Will Zachmann's Canopus forum on Compuserve,
+ years ago. He was an OS/2 advocate then (I was an OS/2 fan too).<P>
-<P>He used to go over-the-top, flaming people, and I suspect he had some hard
-times, then. He's mellowed some, judging by his columns recently. Moderately
-subtle humor was not his mode in those earlier days, not at all.</P>
+ <P>He used to go over-the-top, flaming people, and I suspect he had some hard
+ times, then. He's mellowed some, judging by his columns recently. Moderately
+ subtle humor was not his mode in those earlier days, not at all.</P>
</BLOCKQUOTE>
</HTML>
diff --git a/DOCS/video.html b/DOCS/video.html
index 8fc7ff49df..8b33a3256b 100644
--- a/DOCS/video.html
+++ b/DOCS/video.html
@@ -23,8 +23,7 @@
<P><CODE>
--($:~)-- cat /proc/mtrr<BR>
reg00: base=0xe4000000 (3648MB), size= 16MB: write-combining, count=9<BR>
- reg01: base=0xd8000000 (3456MB), size= 128MB: write-combining, count=1<BR>
-</CODE></P>
+ reg01: base=0xd8000000 (3456MB), size= 128MB: write-combining, count=1</CODE></P>
<P>It's right, shows my Matrox G400 with 16MB memory. I did this from
XFree 4.x.x , which sets up MTRR registers automatically.</P>
@@ -49,12 +48,12 @@
size to hexadecimal, or use this table:</P>
<TABLE BORDER=0>
-<TR><TD>&nbsp;&nbsp;</TD><TD>1 MB</TD><TD WIDTH="10%"></TD><TD>0x100000</TD></TR>
-<TR><TD></TD><TD>2 MB</TD><TD></TD><TD>0x200000</TD></TR>
-<TR><TD></TD><TD>4 MB</TD><TD></TD><TD>0x400000</TD></TR>
-<TR><TD></TD><TD>8 MB</TD><TD></TD><TD>0x800000</TD></TR>
-<TR><TD></TD><TD>16 MB</TD><TD></TD><TD>0x1000000</TD></TR>
-<TR><TD></TD><TD>32 MB</TD><TD></TD><TD>0x2000000</TD></TR>
+ <TR><TD>&nbsp;&nbsp;</TD><TD>1 MB</TD><TD WIDTH="10%"></TD><TD>0x100000</TD></TR>
+ <TR><TD></TD><TD>2 MB</TD><TD></TD><TD>0x200000</TD></TR>
+ <TR><TD></TD><TD>4 MB</TD><TD></TD><TD>0x400000</TD></TR>
+ <TR><TD></TD><TD>8 MB</TD><TD></TD><TD>0x800000</TD></TR>
+ <TR><TD></TD><TD>16 MB</TD><TD></TD><TD>0x1000000</TD></TR>
+ <TR><TD></TD><TD>32 MB</TD><TD></TD><TD>0x2000000</TD></TR>
</TABLE>
@@ -70,6 +69,7 @@
stepping 0] doesn't support MTRR, but stepping 12's do ('<CODE>cat
/proc/cpuinfo</CODE>' to check it').</P>
+
<P><B><A NAME="xv">2.3.1.2 Xv</A></B></P>
<P>Under XFree86 4.0.2 or newer, you can use your card's hardware YUV routines
@@ -94,11 +94,9 @@
is always loaded, and doesn't mean that the _card's_ XVideo support is
loaded!</P>
</LI>
-
<LI>Your card has Xv support under Linux. To check, try 'xvinfo', it is the
part of the XFree86 distribution. It should display a long text, similar
to this:
-
<PRE>
X-Video Extension version 2.2
screen #0
@@ -124,16 +122,14 @@
type: YUV (planar)
(...etc...)
</PRE>
-
<P>It must support YUY2 packed, and YV12 planar pixel formats to be
usable with <B>MPlayer</B>.</P>
</LI>
-
<LI>And finally, check if <B>MPlayer</B> was compiled with 'xv' support.
./configure prints this.</LI>
-
</UL>
+
<P><B><A NAME="xv_3dfx">2.3.1.2.1 3dfx cards</A></B></P>
<P>Older 3dfx drivers were known to have problems with XVideo acceleration, it
@@ -185,7 +181,6 @@
default. It means that decoding speed (!) is synced to the monitor's
refresh rate. If playing seems to be slow, try disabling VSYNC somehow, or
set refresh rate to n*(fps of the movie) Hz.</LI>
-
<LI>Radeon VE - currently only XFree86 CVS has driver for this card, version
4.1.0 doesn't. And no TV out support. Of course with <B>MPlayer</B> you can
happily get <B>accelerated</B> display, with or without <B>TV output</B>, and
@@ -202,14 +197,12 @@
<P>To allow playback of DVD sized content change your XF86Config like this:</P>
-<P>
- Section "Device"<BR>
+<P>Section "Device"<BR>
&nbsp; &nbsp; <I>[...]</I><BR>
&nbsp; &nbsp; Driver "neomagic"<BR>
&nbsp; &nbsp; <B>Option "OverlayMem" "829440"</B><BR>
&nbsp; &nbsp; <I>[...]</I><BR>
- EndSection
-</P>
+ EndSection</P>
<P><B><A NAME="xv_trident">2.3.1.2.6 Trident cards</A></B></P>
@@ -219,8 +212,10 @@
The latest CVS adds support for fullscreen xv support with the
Cyberblade XP card.</P>
+
<P><B><A NAME="dga">2.3.1.3 DGA</A></B></P>
+
<P><B><A NAME="dga_summary">2.3.1.3.1 Summary</A></B></P>
<P>This document tries to explain in some words what DGA is in general and what
@@ -278,10 +273,8 @@
&nbsp;&nbsp;&nbsp;&nbsp;chmod 750 /usr/local/bin/mplayer<BR>
&nbsp;&nbsp;&nbsp;&nbsp;chmod +s /usr/local/bin/mplayer</CODE></P>
-
<P>Now it works as a simple user, too.</P>
-
<P><B>!!!! BUT STAY TUNED !!!!</B><BR>
This is a <B>BIG</B> security risk! Never do this on a server or on a
computer can be accessed by more people than only you because they can gain
@@ -292,6 +285,7 @@
You should also try if the '-vo sdl:dga' option works for you! It's much
faster!!!</P>
+
<P><B><A NAME="dga_resolution">2.3.1.3.4 Resolution switching</A></B></P>
<P>The DGA driver allows for switching the resolution of the output signal.
@@ -309,6 +303,7 @@
<P>See appendix A for some sample modeline definitions.</P>
+
<P><B><A NAME="dga_mplayer">2.3.1.3.5 DGA &amp; MPlayer</A></B></P>
<P>DGA is used in two places with <B>MPlayer</B>: The SDL driver can be made to
@@ -316,6 +311,7 @@
said is true for both; in the following sections I'll explain how the DGA
driver for <B>MPlayer</B> works.</P>
+
<P><B><A NAME="dga_features">2.3.1.3.6 Features of the DGA driver</A></B></P>
<P>The DGA driver is invoked by specifying -vo dga at the command line.
@@ -379,6 +375,7 @@
<P>I've seen some AVI files already be replayed on a Pentium MMX 266. AMD K6-2
CPUs might work at 400 MHZ and above.</P>
+
<P><B><A NAME="dga_bugs">2.3.1.3.8 Known bugs</A></B></P>
<P>Well, according to some developers of XFree, DGA is quite a beast. They
@@ -401,6 +398,7 @@
<LI>OSD only works with doublebuffering enabled.</LI>
</UL>
+
<P><B><A NAME="dga_future">2.3.1.3.9 Future work</A></B></P>
<UL>
@@ -439,7 +437,6 @@
and your CPU type. The X11 driver module (defined in XF86-Config) might
also help. Thanks!</P>
-
<P><I>Acki (acki@acki-netz.de, www.acki-netz.de)</I></P>
@@ -466,23 +463,19 @@
<P>Here are some notes about SDL out in <B>MPlayer</B>.</P>
-
-
<TABLE BORDER=0>
-<TR><TD COLSPAN=4><P><B>There are several command line switches for SDL:</B></P></TD></TR>
-<TR><TD>&nbsp;&nbsp;</TD><TD><CODE>-vo sdl:name</CODE></TD><TD>&nbsp;&nbsp;</TD><TD>
-specifies sdl video driver to use (i.e.. aalib, dga, x11)</TD></TR>
-<TR><TD></TD><TD><CODE>-ao sdl:name</CODE></TD><TD></TD><TD>specifies sdl audio driver to use (i.e.. dsp,
-esd, arts)</TD></TR>
-<TR><TD></TD><TD><CODE>-noxv</CODE></TD><TD></TD><TD>disables XVideo hardware acceleration</TD></TR>
-<TR><TD></TD><TD><CODE>-forcexv</CODE></TD><TD></TD><TD>tries to force XVideo acceleration</TD></TR>
-
-<TR><TD COLSPAN=4><P><B>SDL Keys:</B></P></TD></TR>
-
-<TR><TD></TD><TD><CODE>F</CODE></TD><TD></TD><TD>toggles fullscreen/windowed mode</TD></TR>
-<TR><TD></TD><TD><CODE>C</CODE></TD><TD></TD><TD>cycles available fullscreen modes</TD></TR>
-<TR><TD></TD><TD><CODE>W/S</CODE></TD><TD></TD><TD>mappings for * and / (mixer control)</TD></TR>
-
+ <TR><TD COLSPAN=4><P><B>There are several command line switches for SDL:</B></P></TD></TR>
+ <TR><TD>&nbsp;&nbsp;</TD><TD><CODE>-vo sdl:name</CODE></TD><TD>&nbsp;&nbsp;</TD><TD>
+ specifies sdl video driver to use (i.e.. aalib, dga, x11)</TD></TR>
+ <TR><TD></TD><TD><CODE>-ao sdl:name</CODE></TD><TD></TD><TD>specifies sdl audio driver to use (i.e.. dsp,
+ esd, arts)</TD></TR>
+ <TR><TD></TD><TD><CODE>-noxv</CODE></TD><TD></TD><TD>disables XVideo hardware acceleration</TD></TR>
+ <TR><TD></TD><TD><CODE>-forcexv</CODE></TD><TD></TD><TD>tries to force XVideo acceleration</TD></TR>
+
+ <TR><TD COLSPAN=4><P><B>SDL Keys:</B></P></TD></TR>
+ <TR><TD></TD><TD><CODE>F</CODE></TD><TD></TD><TD>toggles fullscreen/windowed mode</TD></TR>
+ <TR><TD></TD><TD><CODE>C</CODE></TD><TD></TD><TD>cycles available fullscreen modes</TD></TR>
+ <TR><TD></TD><TD><CODE>W/S</CODE></TD><TD></TD><TD>mappings for * and / (mixer control)</TD></TR>
</TABLE>
<P><B>KNOWN BUGS:</B></P>
@@ -492,6 +485,7 @@ esd, arts)</TD></TR>
It's bug in SDL, I can't change it (tested with SDL 1.2.1).</LI>
</UL>
+
<P><B><A NAME="svgalib">2.3.1.5 SVGAlib</A></B></P>
<P><B><U>Installation</U></B><BR>
@@ -522,8 +516,7 @@ esd, arts)</TD></TR>
For that we need fast but bad quality scaling routine:<BR>
&nbsp;&nbsp;<CODE>-sws 4</CODE><BR>
Maybe automatic aspect correction has to be shut off:<BR>
- &nbsp;&nbsp;<CODE>-noaspect</CODE><BR>
-</P>
+ &nbsp;&nbsp;<CODE>-noaspect</CODE></P>
<P><B><A NAME="fbdev">2.3.1.6 Framebuffer output (FBdev)</A></B></P>
@@ -541,13 +534,13 @@ esd, arts)</TD></TR>
<P>The FBdev output takes some additional parameters above the others:</P>
<TABLE BORDER=0>
-<TR><TD>&nbsp;&nbsp;</TD><TD><CODE>-fb</CODE></TD><TD>&nbsp;&nbsp;</TD><TD>
-specify the framebuffer device to use (/dev/fb0)</TD></TR>
-<TR><TD></TD><TD><CODE>-fbmode</CODE></TD><TD></TD><TD>mode name to use (according to /etc/fb.modes)</TD></TR>
-<TR><TD></TD><TD><CODE>-fbmodeconfig</CODE></TD><TD></TD><TD> config file of modes (default /etc/fb.modes)</TD></TR>
-<TR><TD></TD><TD><CODE>-monitor_hfreq</CODE></TD><TD></TD><TD ROWSPAN=3>IMPORTANT values, see example.conf</TD></TR>
-<TR><TD></TD><TD><CODE>-monitor_vfreq</CODE></TD><TD></TD></TR>
-<TR><TD></TD><TD><CODE>-monitor_dotclock</CODE></TD><TD></TD></TR>
+ <TR><TD>&nbsp;&nbsp;</TD><TD><CODE>-fb</CODE></TD><TD>&nbsp;&nbsp;</TD><TD>
+ specify the framebuffer device to use (/dev/fb0)</TD></TR>
+ <TR><TD></TD><TD><CODE>-fbmode</CODE></TD><TD></TD><TD>mode name to use (according to /etc/fb.modes)</TD></TR>
+ <TR><TD></TD><TD><CODE>-fbmodeconfig</CODE></TD><TD></TD><TD> config file of modes (default /etc/fb.modes)</TD></TR>
+ <TR><TD></TD><TD><CODE>-monitor_hfreq</CODE></TD><TD></TD><TD ROWSPAN=3>IMPORTANT values, see example.conf</TD></TR>
+ <TR><TD></TD><TD><CODE>-monitor_vfreq</CODE></TD><TD></TD></TR>
+ <TR><TD></TD><TD><CODE>-monitor_dotclock</CODE></TD><TD></TD></TR>
</TABLE>
<P>If you want to change to a specific mode, then use</P>
@@ -572,6 +565,7 @@ specify the framebuffer device to use (/dev/fb0)</TD></TR>
<P>NOTE: FBdev video mode changing _does not work_ with the VESA framebuffer,
and don't ask for it, since it's not an <B>MPlayer</B> limitation.</P>
+
<P><B><A NAME="mga_vid">2.3.1.7 Matrox framebuffer (mga_vid)</A></B></P>
<P>This section is about the Matrox G200/G400/G450/G550 BES (Back-End Scaler)
@@ -632,12 +626,14 @@ specify the framebuffer device to use (/dev/fb0)</TD></TR>
updated after the mga_vid changes, so it's outdated now. Volunteers
needed to test it and bring the code up-to-date.</P>
+
<P><B><A NAME="tdfxfb">2.3.1.9 3dfx YUV support (tdfxfb)</A></B></P>
<P>This driver uses the kernel's tdfx framebuffer driver to play movies with
YUV acceleration. You'll need a kernel with tdfxfb support, and recompile
with <CODE>./configure --enable-tdfxfb</CODE></P>
+
<P><B><A NAME="opengl">2.3.1.10 OpenGL output</A></B></P>
<P><B>MPlayer</B> supports displaying movies using OpenGL, but if your
@@ -655,6 +651,7 @@ specify the framebuffer device to use (/dev/fb0)</TD></TR>
<A HREF="http://dri.sourceforge.net">http://dri.sourceforge.net</A>
for download and installation instructions.</P>
+
<P><B><A NAME="aalib">2.3.1.11 AAlib - text mode displaying</A></B></P>
<P><B>AAlib</B> is a library for displaying graphics in text mode, using powerful
@@ -664,29 +661,27 @@ specify the framebuffer device to use (/dev/fb0)</TD></TR>
built.</P>
<TABLE BORDER=0>
-<TR><TD COLSPAN=4><P><B>You can use some keys in the AA Window to change rendering options:</B></P></TD></TR>
-<TR><TD>&nbsp;&nbsp;</TD><TD><CODE>1</CODE></TD><TD>&nbsp;&nbsp;</TD><TD>decrease contrast</TD></TR>
-<TR><TD></TD><TD><CODE>2</CODE></TD><TD></TD><TD>increase contrast</TD></TR>
-<TR><TD></TD><TD><CODE>3</CODE></TD><TD></TD><TD>decrease brightness</TD></TR>
-<TR><TD></TD><TD><CODE>4</CODE></TD><TD></TD><TD>increase brightness</TD></TR>
-<TR><TD></TD><TD><CODE>5</CODE></TD><TD></TD><TD>switch fast rendering on/off</TD></TR>
-<TR><TD></TD><TD><CODE>6</CODE></TD><TD></TD><TD>set dithering mode (none, error distribution, Floyd Steinberg)</TD></TR>
-<TR><TD></TD><TD><CODE>7</CODE></TD><TD></TD><TD>invert image</TD></TR>
-<TR><TD></TD><TD><CODE>a</CODE></TD><TD></TD><TD>toggles between aa and <B>MPlayer</B> control)</TD></TR>
-
-<TR><TD COLSPAN=4><P><B>The following command line options can be used:</B></P></TD></TR>
-
-<TR><TD></TD><TD><CODE>-aaosdcolor=V</CODE></TD><TD></TD><TD>change OSD color</TD></TR>
-<TR><TD></TD><TD><CODE>-aasubcolor=V</CODE></TD><TD></TD><TD>change subtitle color</TD></TR>
-<TR><TD COLSPAN=3></TD><TD><P><I>where V can be: (0/normal, 1/dark, 2/bold, 3/bold font, 4/reverse, 5/special)</I></P></TD></TR>
-
-<TR><TD COLSPAN=4><P><B>AAlib itself provides a large sum of options.
-Here are some important:</B></P></TD></TR>
-
-<TR><TD></TD><TD><CODE>-aadriver</CODE></TD><TD></TD><TD>set recommended aa driver (X11, curses, Linux)</TD></TR>
-<TR><TD></TD><TD><CODE>-aaextended</CODE></TD><TD></TD><TD>use all 256 characters</TD></TR>
-<TR><TD></TD><TD><CODE>-aaeight</CODE></TD><TD></TD><TD>use eight bit ASCII</TD></TR>
-<TR><TD></TD><TD><CODE>-aahelp</CODE></TD><TD></TD><TD>prints out all aalib options</TD></TR>
+ <TR><TD COLSPAN=4><P><B>You can use some keys in the AA Window to change rendering options:</B></P></TD></TR>
+ <TR><TD>&nbsp;&nbsp;</TD><TD><CODE>1</CODE></TD><TD>&nbsp;&nbsp;</TD><TD>decrease contrast</TD></TR>
+ <TR><TD></TD><TD><CODE>2</CODE></TD><TD></TD><TD>increase contrast</TD></TR>
+ <TR><TD></TD><TD><CODE>3</CODE></TD><TD></TD><TD>decrease brightness</TD></TR>
+ <TR><TD></TD><TD><CODE>4</CODE></TD><TD></TD><TD>increase brightness</TD></TR>
+ <TR><TD></TD><TD><CODE>5</CODE></TD><TD></TD><TD>switch fast rendering on/off</TD></TR>
+ <TR><TD></TD><TD><CODE>6</CODE></TD><TD></TD><TD>set dithering mode (none, error distribution, Floyd Steinberg)</TD></TR>
+ <TR><TD></TD><TD><CODE>7</CODE></TD><TD></TD><TD>invert image</TD></TR>
+ <TR><TD></TD><TD><CODE>a</CODE></TD><TD></TD><TD>toggles between aa and <B>MPlayer</B> control)</TD></TR>
+
+ <TR><TD COLSPAN=4><P><B>The following command line options can be used:</B></P></TD></TR>
+ <TR><TD></TD><TD><CODE>-aaosdcolor=V</CODE></TD><TD></TD><TD>change OSD color</TD></TR>
+ <TR><TD></TD><TD><CODE>-aasubcolor=V</CODE></TD><TD></TD><TD>change subtitle color</TD></TR>
+ <TR><TD COLSPAN=3></TD><TD><P><I>where V can be: (0/normal, 1/dark, 2/bold,
+ 3/bold font, 4/reverse, 5/special)</I></P></TD></TR>
+ <TR><TD COLSPAN=4><P><B>AAlib itself provides a large sum of options.
+ Here are some important:</B></P></TD></TR>
+ <TR><TD></TD><TD><CODE>-aadriver</CODE></TD><TD></TD><TD>set recommended aa driver (X11, curses, Linux)</TD></TR>
+ <TR><TD></TD><TD><CODE>-aaextended</CODE></TD><TD></TD><TD>use all 256 characters</TD></TR>
+ <TR><TD></TD><TD><CODE>-aaeight</CODE></TD><TD></TD><TD>use eight bit ASCII</TD></TR>
+ <TR><TD></TD><TD><CODE>-aahelp</CODE></TD><TD></TD><TD>prints out all aalib options</TD></TR>
</TABLE>
<P>NOTE: the rendering is very CPU intensive, especially when using AA-on-X
@@ -715,7 +710,7 @@ Here are some important:</B></P></TD></TR>
70) says:</P>
<BLOCKQUOTE>
-<B>Dual-Controller Designs</B><BR>
+ <B>Dual-Controller Designs</B><BR>
VBE 3.0 supports the dual-controller design by assuming that since both
controllers are typically provided by the same OEM, under control of a
single BIOS ROM on the same graphics card, it is possible to hide the fact
@@ -745,26 +740,30 @@ Here are some important:</B></P></TD></TR>
calls <B>real</B> things of <B>real</B> BIOS in <B>real</B>-mode. (Finely -
in vm86 mode).<BR>
- You can use Vidix with it, thus getting accelerated video display
- <B>AND</B> TV output at the same time! (recommended for ATI cards)
-</P>
+ <B>AND</B> TV output at the same time! (recommended for ATI cards)</P>
<P><B>What are minuses:</B><BR>
- It works only on <B>x86 systems</B>.<BR>
- It can be used only by <B>ROOT</B>.<BR>
- - Currently it's available only for <B>Linux</B>.<BR>
-</P>
+ - Currently it's available only for <B>Linux</B>.</P>
<P>Don't use this driver with <B>GCC 2.96</B>! It won't work!</P>
<TABLE BORDER=0>
-<TR><TD COLSPAN=4><P><B>These switches of command line currently are available for VESA:</B></P></TD></TR>
-<TR><TD>&nbsp;&nbsp;</TD><TD VALIGN="top"><CODE>-vo vesa:opts</CODE></TD><TD></TD><TD>currently recognized: <B>dga</B> to force dga mode and <B>nodga</B> to disable dga mode. Note: you may omit these parameters to enable <B>autodetect</B> of dga mode. (In the future also will specify mode parameters such as refresh rate, interlacing, doublescan and so on. Samples: i43, 85, d100)</TD></TR>
-<TR><TD></TD><TD VALIGN="top"><CODE>-screenw, -screenh, -bpp</CODE></TD><TD></TD><TD>force userdefined mode</TD></TR>
-<TR><TD></TD><TD VALIGN="top"><CODE>-x, -y</CODE></TD><TD></TD><TD>set userdefined prescaling</TD></TR>
-<TR><TD></TD><TD VALIGN="top"><CODE>-zoom</CODE></TD><TD></TD><TD>enables userdefined prescaling</TD></TR>
-<TR><TD></TD><TD VALIGN="top"><CODE>-fs</CODE></TD><TD></TD><TD>scales image to fullscreen</TD></TR>
-<TR><TD></TD><TD VALIGN="top"><CODE>-fs -zoom</CODE></TD><TD></TD><TD>scales userdefined prescaling to fullscreen</TD></TR>
-<TR><TD></TD><TD VALIGN="top"><CODE>-double</CODE></TD><TD></TD><TD>enables double buffering mode. (Available only in DGA mode). Should be slower of single buffering, but has no flickering effects.</TD></TR>
+ <TR><TD COLSPAN=4><P><B>These switches of command line currently are available for VESA:</B></P></TD></TR>
+ <TR><TD>&nbsp;&nbsp;</TD><TD VALIGN="top"><CODE>-vo vesa:opts</CODE></TD><TD></TD>
+ <TD>currently recognized: <B>dga</B> to force dga mode and <B>nodga</B> to
+ disable dga mode. Note: you may omit these parameters to enable <B>autodetect</B>
+ of dga mode. (In the future also will specify mode parameters such as refresh
+ rate, interlacing, doublescan and so on. Samples: i43, 85, d100)</TD></TR>
+ <TR><TD></TD><TD VALIGN="top"><CODE>-screenw, -screenh, -bpp</CODE></TD><TD></TD><TD>force userdefined mode</TD></TR>
+ <TR><TD></TD><TD VALIGN="top"><CODE>-x, -y</CODE></TD><TD></TD><TD>set userdefined prescaling</TD></TR>
+ <TR><TD></TD><TD VALIGN="top"><CODE>-zoom</CODE></TD><TD></TD><TD>enables userdefined prescaling</TD></TR>
+ <TR><TD></TD><TD VALIGN="top"><CODE>-fs</CODE></TD><TD></TD><TD>scales image to fullscreen</TD></TR>
+ <TR><TD></TD><TD VALIGN="top"><CODE>-fs -zoom</CODE></TD><TD></TD><TD>scales userdefined prescaling to fullscreen</TD></TR>
+ <TR><TD></TD><TD VALIGN="top"><CODE>-double</CODE></TD><TD></TD><TD>enables
+ double buffering mode. (Available only in DGA mode). Should be slower of
+ single buffering, but has no flickering effects.</TD></TR>
</TABLE>
<P><B>Known problems and workaround:</B><BR>
@@ -783,8 +782,7 @@ Here are some important:</B></P></TD></TR>
<B>Alt-Fx</B>) then switch to your previous console by the same way.<BR>
- To get <B>working TV-out</B> you need have plugged TV-connector in before
booting your PC since video BIOS initializes itself only once during POST
- procedure.
-</P>
+ procedure.</P>
<P><B><A NAME="x11">2.3.1.13 X11</A></B></P>
@@ -833,8 +831,7 @@ Here are some important:</B></P></TD></TR>
scalers) or OV (Video Overlays). It doesn't provide lowlevel interface to
things which are known as graphics servers. (I don't want to compete with X11
team in graphics mode switching). I.e. main goal of this interface is to
- maximize the speed of video playback.
-</P>
+ maximize the speed of video playback.</P>
<P><B>USAGE</B></P>
@@ -846,6 +843,7 @@ Here are some important:</B></P></TD></TR>
drivers, such as:<BR>
<CODE>-vo vesa:vidix</CODE> (<B>LINUX ONLY</B>) and <CODE>-vo fbdev:vidix</CODE></LI>
</UL>
+
Indeed it doesn't matter which video output driver is used with <B>VIDIX</B>.
<P><B>REQUIREMENTS</B></P>
@@ -859,6 +857,7 @@ Indeed it doesn't matter which video output driver is used with <B>VIDIX</B>.
<LI><B>MPlayer</B>'s video output driver should know active video mode and be
able to tell to VIDIX subdevice some video characteristics of server.</LI>
</UL>
+
I hope that probably every video output driver of <B>MPlayer</B> will
recognize <CODE>:vidix</CODE> subdevice.
@@ -871,8 +870,7 @@ recognize <CODE>:vidix</CODE> subdevice.
<CODE>-double</CODE> key as globally visible parameter. (I recommend using
this key with VIDIX at least for ATI's card).<BR>
As for <CODE>-vo xvidix</CODE>: currently it recognizes the following
- options: <CODE>-fs -zoom -x -y -double</CODE>.<BR>
-</P>
+ options: <CODE>-fs -zoom -x -y -double</CODE>.</P>
<P>Also you can specify VIDIX's driver directly as third subargument in command
line:<BR>
@@ -888,68 +886,59 @@ recognize <CODE>:vidix</CODE> subdevice.
computer). You should do that ONLY if you are absolutely sure it will work,
and <B>MPlayer</B> doesn't do it automatically. Please tell about it to the
developers. The Right Way is to use VIDIX without arguments to enable driver
- autodetection.
-</P>
+ autodetection.</P>
-<P>
- VIDIX is very new technology and it's extremely possible that on your system
+<P>VIDIX is very new technology and it's extremely possible that on your system
(OS=abc CPU=xyz) it won't work. In this case only solution for you it's port
it (mainly libdha). But there is hope that it will work on those systems
- where X11 does.
-</P>
+ where X11 does.</P>
<P>And the last <B>WARNING</B>: (un)fortunately you <B>MUST</B> have
<B>ROOT</B> privileges to use VIDIX due to direct hardware access. At least
- set the <B>SUID</B> bit on the <B>MPlayer</B> executable.
-</P>
+ set the <B>SUID</B> bit on the <B>MPlayer</B> executable.</P>
<P><B>VIDEO EQUALIZER</B></P>
-<P>
- This is a video equalizer implemented especially for VIDIX. You can use
+<P>This is a video equalizer implemented especially for VIDIX. You can use
it either with <B>1-8</B> keys as described in the man page, or
by command line arguments. <B>MPlayer</B> recognizes the
- following options:
-</P>
+ following options:</P>
<TABLE>
-<TR><TD>&nbsp;&nbsp;</TD><TD VALIGN="top"><CODE>-brightness</CODE></TD><TD>&nbsp;&nbsp;</TD>
- <TD>Adjust <B>BRIGHTNESS</B> of video output. It's not equal to brightness
- adjusting on monitor panel or on TV. It changes intensity of RGB components of
- video signal from black to white screen.</TD></TR>
-<TR><TD></TD><TD VALIGN="top"><CODE>-contrast</CODE></TD><TD></TD>
- <TD>Adjust <B>CONTRAST</B> of video output. Works in similar manner as
- brightness.</TD></TR>
-<TR><TD></TD><TD VALIGN="top"><CODE>-saturation</CODE></TD>
- <TD></TD><TD>Adjust <B>SATURATION</B> of video output. You can get grayscale
- output with this option.</TD></TR>
-<TR><TD></TD><TD VALIGN="top"><CODE>-hue</CODE></TD>
- <TD></TD><TD>Adjust <B>HUE</B> of video signal. You can get colored negative
- of image with this option.</TD></TR>
-<TR><TD></TD><TD VALIGN="top"><CODE>-red_intensity</CODE></TD>
- <TD></TD><TD>Adjust intensity of <B>RED</B> component of video signal.</TD></TR>
-<TR><TD></TD><TD VALIGN="top"><CODE>-green_intensity</CODE></TD>
- <TD></TD><TD>Adjust intensity of <B>GREEN</B> component of video signal.</TD></TR>
-<TR><TD></TD><TD VALIGN="top"><CODE>-blue_intensity</CODE></TD>
- <TD></TD><TD>Adjust intensity of <B>BLUE</B> component of video signal.</TD></TR>
+ <TR><TD>&nbsp;&nbsp;</TD><TD VALIGN="top"><CODE>-brightness</CODE></TD><TD>&nbsp;&nbsp;</TD>
+ <TD>Adjust <B>BRIGHTNESS</B> of video output. It's not equal to brightness
+ adjusting on monitor panel or on TV. It changes intensity of RGB components of
+ video signal from black to white screen.</TD></TR>
+ <TR><TD></TD><TD VALIGN="top"><CODE>-contrast</CODE></TD><TD></TD>
+ <TD>Adjust <B>CONTRAST</B> of video output. Works in similar manner as
+ brightness.</TD></TR>
+ <TR><TD></TD><TD VALIGN="top"><CODE>-saturation</CODE></TD>
+ <TD></TD><TD>Adjust <B>SATURATION</B> of video output. You can get grayscale
+ output with this option.</TD></TR>
+ <TR><TD></TD><TD VALIGN="top"><CODE>-hue</CODE></TD>
+ <TD></TD><TD>Adjust <B>HUE</B> of video signal. You can get colored negative
+ of image with this option.</TD></TR>
+ <TR><TD></TD><TD VALIGN="top"><CODE>-red_intensity</CODE></TD>
+ <TD></TD><TD>Adjust intensity of <B>RED</B> component of video signal.</TD></TR>
+ <TR><TD></TD><TD VALIGN="top"><CODE>-green_intensity</CODE></TD>
+ <TD></TD><TD>Adjust intensity of <B>GREEN</B> component of video signal.</TD></TR>
+ <TR><TD></TD><TD VALIGN="top"><CODE>-blue_intensity</CODE></TD>
+ <TD></TD><TD>Adjust intensity of <B>BLUE</B> component of video signal.</TD></TR>
</TABLE>
-<P>
- Each parameter can accept values from <B>-1000</B> to <B>+1000</B>.<BR>
- Default value for each parameter is <B>0</B>.
-</P>
-<P>
- <B>Note:</B> Not every driver provides support for each of those parameters.
+<P>Each parameter can accept values from <B>-1000</B> to <B>+1000</B>.<BR>
+ Default value for each parameter is <B>0</B>.</P>
+
+<P><B>Note:</B> Not every driver provides support for each of those parameters.
Currently only <B>radeon_vid.so</B> provides full support for video equalizing.
- Other drivers only partly support these options.
-</P>
+ Other drivers only partly support these options.</P>
+
<P><B>Examples:</B><BR>
<CODE>mplayer -vo vesa:vidix -brightness -300 -contrast 200
filename.avi</CODE><BR>
or<BR>
<CODE>mplayer -vo xvidix -red_intensity -50 -saturation 400 -hue 300
- filename.vob</CODE>
-</P>
+ filename.vob</CODE></P>
<P><B><A NAME="zr">2.3.1.15 Zr</A></B></P>
@@ -1102,36 +1091,36 @@ for 16:9 TV: -vop lavc,expand=-1:576:-1:-1:1,scale=-1:0,dvbscale=1024
<P><B>USAGE</B></P>
<TABLE>
-<TR><TD>&nbsp;&nbsp;</TD><TD VALIGN="top"><CODE>-vo dxr3:&lt;noprebuf&gt;:&lt;codec&gt;:&lt;device&gt;</CODE></TD><TD>&nbsp;&nbsp;</TD>
- <TD>Where <CODE>&lt;noprebuf&gt;</CODE> specifies turning off prebuffering.
- This is done automatically on Athlons. If playback is out of sync try
- disabling prebuffering. If noprebuf is left out prebuffering is enabled
- (except on Athlons).
- <BR>
- <CODE>&lt;codec&gt;</CODE> = fame/avcodec, avcodec produces better quality
- output, but fame is faster for those of you with slow machines. The default is
- to use libavcodec. Note that you need libavcodec properly installed (read
- DOCS/codecs.html).
- <BR>
- <CODE>&lt;device&gt;</CODE> = device number to use if you have more than one
- em8300 card.
- <BR>
- Any of these options may be left out, but they must be specified in this
- order, i.e. <CODE>dxr3:fame</CODE> works, <CODE>dxr3:1</CODE> works, but
- <CODE>dxr3:1:avcodec</CODE> will not.</TD></TR>
-<TR><TD></TD><TD VALIGN="top"><CODE>-ao oss:/dev/em8300_ma-X</CODE></TD>
- <TD></TD><TD>For audio output, where <CODE>X</CODE> is the device number
- (0 if one card).</TD></TR>
-<TR><TD></TD><TD VALIGN="top"><CODE>-ac hwac3</CODE></TD>
- <TD></TD><TD>For digital instead of analog audio output.</TD></TR>
-<TR><TD></TD><TD VALIGN="top"><CODE>-vc mpegpes</CODE></TD>
- <TD></TD><TD>Force hardware acceleration, only works with MPEG1/2.</TD></TR>
-<TR><TD></TD><TD VALIGN="top"><CODE>-aop list=resample:fout=xxxxx</CODE></TD>
- <TD></TD><TD>If sample rate is below 44100Hz, select either 44100Hz or 48000Hz
- depending on which one matches closest. I.e. if the movie uses 22050Hz use
- 44100Hz as 44100 / 2 = 22050, if it is 24000Hz use 48000Hz as 48000 / 2 = 24000
- and so on. This does not work with digital audio output
- (<CODE>-ac hwac3</CODE>).</TD></TR>
+ <TR><TD>&nbsp;&nbsp;</TD><TD VALIGN="top"><CODE>-vo dxr3:&lt;noprebuf&gt;:&lt;codec&gt;:&lt;device&gt;</CODE></TD><TD>&nbsp;&nbsp;</TD>
+ <TD>Where <CODE>&lt;noprebuf&gt;</CODE> specifies turning off prebuffering.
+ This is done automatically on Athlons. If playback is out of sync try
+ disabling prebuffering. If noprebuf is left out prebuffering is enabled
+ (except on Athlons).
+ <BR>
+ <CODE>&lt;codec&gt;</CODE> = fame/avcodec, avcodec produces better quality
+ output, but fame is faster for those of you with slow machines. The default is
+ to use libavcodec. Note that you need libavcodec properly installed (read
+ DOCS/codecs.html).
+ <BR>
+ <CODE>&lt;device&gt;</CODE> = device number to use if you have more than one
+ em8300 card.
+ <BR>
+ Any of these options may be left out, but they must be specified in this
+ order, i.e. <CODE>dxr3:fame</CODE> works, <CODE>dxr3:1</CODE> works, but
+ <CODE>dxr3:1:avcodec</CODE> will not.</TD></TR>
+ <TR><TD></TD><TD VALIGN="top"><CODE>-ao oss:/dev/em8300_ma-X</CODE></TD>
+ <TD></TD><TD>For audio output, where <CODE>X</CODE> is the device number
+ (0 if one card).</TD></TR>
+ <TR><TD></TD><TD VALIGN="top"><CODE>-ac hwac3</CODE></TD>
+ <TD></TD><TD>For digital instead of analog audio output.</TD></TR>
+ <TR><TD></TD><TD VALIGN="top"><CODE>-vc mpegpes</CODE></TD>
+ <TD></TD><TD>Force hardware acceleration, only works with MPEG1/2.</TD></TR>
+ <TR><TD></TD><TD VALIGN="top"><CODE>-aop list=resample:fout=xxxxx</CODE></TD>
+ <TD></TD><TD>If sample rate is below 44100Hz, select either 44100Hz or 48000Hz
+ depending on which one matches closest. I.e. if the movie uses 22050Hz use
+ 44100Hz as 44100 / 2 = 22050, if it is 24000Hz use 48000Hz as 48000 / 2 = 24000
+ and so on. This does not work with digital audio output
+ (<CODE>-ac hwac3</CODE>).</TD></TR>
</TABLE>
<P><B>Overlay</B><P>
@@ -1157,6 +1146,7 @@ for 16:9 TV: -vop lavc,expand=-1:576:-1:-1:1,scale=-1:0,dvbscale=1024
<P><B><A NAME="tv-out">2.3.1.A TV-out support</A></B></P>
+
<P><B><A NAME="tv-out_matrox">2.3.1.A.1 Matrox G400 cards</A></B></P>
<P>Under Linux you have 2 methods to get G400 TV out working:</P>
@@ -1202,35 +1192,28 @@ for 16:9 TV: -vop lavc,expand=-1:576:-1:-1:1,scale=-1:0,dvbscale=1024
items randomly and it'll be OK :)</LI>
</UL>
- <P>
- Yoh. Next task is to make the cursor on tty1 (or whatever) to disappear,
+ <P>Yoh. Next task is to make the cursor on tty1 (or whatever) to disappear,
and turn off screen blanking. Execute the following commands:</P>
- <P>
- <CODE>echo -e '\033[?25l'</CODE> or <CODE>setterm -cursor off<BR>
- setterm -blank 0</CODE>
- </P>
+ <P><CODE>echo -e '\033[?25l'</CODE> or <CODE>setterm -cursor off<BR>
+ setterm -blank 0</CODE></P>
- <P>
- You possibly want to put the above into a script, and also clear
+ <P>You possibly want to put the above into a script, and also clear
the screen.. To turn the cursor back:<BR><CODE>echo -e '\033[?25h'</CODE>
- or <CODE>setterm -cursor on</CODE>
- </P>
+ or <CODE>setterm -cursor on</CODE></P>
<P>Yeah kewl. Start movie playing with <CODE>mplayer -vo mga -fs -screenw 640
-screenh 512 &lt;filename&gt;</CODE><BR>
(if you use X, now change to matroxfb with for example CTRL-ALT-F1!)<BR>
Change 640x512 if you set the resolution to other..<BR>
- <B>Enjoy the ultra-fast ultra-featured Matrox TV output (better than Xv)!</B>
- </P>
+ <B>Enjoy the ultra-fast ultra-featured Matrox TV output (better than Xv)!</B></P>
</LI>
</UL>
<P><B><A NAME="tv-out_ati">2.3.1.A.2 ATI cards</A></B></P>
-<P>
-<B><U>PREAMBLE</U></B><BR>
+<P><B><U>PREAMBLE</U></B><BR>
Currently ATI doesn't want to support any of its TV-out chips under Linux,
because of their licensed Macrovision technology.</P>
@@ -1246,22 +1229,17 @@ for 16:9 TV: -vop lavc,expand=-1:576:-1:-1:1,scale=-1:0,dvbscale=1024
sections.</LI>
</UL>
-<P>
- On other cards, just use the <a href="#vesa">VESA driver</a>, without
- VIDIX. Powerful CPU is needed, though.
-</P>
+<P>On other cards, just use the <a href="#vesa">VESA driver</a>, without
+ VIDIX. Powerful CPU is needed, though.</P>
<P>Only thing you need to do - <B>have TV connector plugged in before
booting your PC</B> since video BIOS initializes itself only once during
- POST procedure.
-</P>
+ POST procedure.</P>
<P><B><A NAME="tv-out_voodoo">2.3.1.A.3 Voodoo 3</A></B></P>
-<P>
- Check <A HREF="http://www.iki.fi/too/tvout-voodoo3-3000-xfree">this URL</A>.
-</P>
+<P>Check <A HREF="http://www.iki.fi/too/tvout-voodoo3-3000-xfree">this URL</A>.</P>
</BODY>
</HTML>