summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authordiego <diego@b3059339-0415-0410-9bf9-f77b7e298cf2>2002-08-11 18:27:38 +0000
committerdiego <diego@b3059339-0415-0410-9bf9-f77b7e298cf2>2002-08-11 18:27:38 +0000
commit58bba52aca7a03ff4a5ff81bac8be19e7811dd8b (patch)
tree30e9db6fd126d09c9f67148c8bb3a152c270c240 /DOCS
parent6287343f35cafb5778b2796a496a0d0fe1106529 (diff)
downloadmpv-58bba52aca7a03ff4a5ff81bac8be19e7811dd8b.tar.bz2
mpv-58bba52aca7a03ff4a5ff81bac8be19e7811dd8b.tar.xz
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