Mercurial > mplayer.hg

diff DOCS/documentation.html @ 2745:62bcea66003e

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
oh my god what have i done... format.html, codecs, video, sound.html renumbered, etc
author gabucino
date Tue, 06 Nov 2001 17:04:56 +0000
parents a2bb142ce67d
children 24797a1d36d6
line wrap: on
line diff
--- a/DOCS/documentation.html	Tue Nov 06 17:04:13 2001 +0000
+++ b/DOCS/documentation.html	Tue Nov 06 17:04:56 2001 +0000
@@ -29,72 +29,88 @@
   </UL>
   <LI><A HREF="#2">2. Features</A></LI>
   <UL>
-    <LI><A HREF="codecs.html">2.1 Video Formats, Audio & Video Codecs</A></LI>
+    <LI><A HREF="formats.html">2.1 Supported formats</A></LI>
     <UL>
-      <LI><A HREF="codecs.html#2.1.1">2.1.1 Supported input formats</A></LI>
-      <LI><A HREF="codecs.html#2.1.2">2.1.2 Supported audio & video codecs</A></LI>
+      <LI><A HREF="formats.html#2.1.1">2.1.1 Video</A></LI>
+      <UL>
+	<LI><A HREF="formats.html#2.1.1.1">2.1.1.1 MPG, VOB, DAT files</A></LI>
+	<LI><A HREF="formats.html#2.1.1.2">2.1.1.2 AVI files</A></LI>
+	<LI><A HREF="formats.html#2.1.1.3">2.1.1.3 ASF/WMV files</A></LI>
+	<LI><A HREF="formats.html#2.1.1.4">2.1.1.4 QT/MOV files</A></LI>
+	<LI><A HREF="formats.html#2.1.1.5">2.1.1.5 VIV files</A></LI>
+      </UL>
+      <LI><A HREF="formats.html#2.1.2">2.1.2 Audio</A></LI>
+    </UL>
+    <LI><A HREF="codecs.html#2.2">2.2 Supported codecs</A></LI>
+    <UL>
+      <LI><A HREF="codecs.html#2.2.1">2.2.1 Video</A></LI>
       <UL>
-	<LI><A HREF="codecs.html#2.1.2.1">2.1.2.1 DivX4</A></LI>
-	<LI><A HREF="codecs.html#2.1.2.2">2.1.2.2 ffmpeg's DivX/libavcodec</A></LI>
-	<LI><A HREF="codecs.html#2.1.2.3">2.1.2.3 Hardware AC3 decoding</A></LI>
-	<LI><A HREF="codecs.html#2.1.2.4">2.1.2.4 XAnim codecs</A></LI>
-	<LI><A HREF="codecs.html#2.1.2.5">2.1.2.5 libmad support</A></LI>
+	<LI><A HREF="codecs.html#2.2.1.1">2.2.1.1 DivX4</A></LI>
+	<LI><A HREF="codecs.html#2.2.1.2">2.2.1.2 ffmpeg's DivX/libavcodec</A></LI>
+	<LI><A HREF="codecs.html#2.2.1.3">2.2.1.3 XAnim codecs</A></LI>
+	<LI><A HREF="codecs.html#2.2.1.4">2.2.1.4 VIVO video</A></LI>
+	<LI><A HREF="codecs.html#2.2.1.5">2.2.1.5 MPEG1/2 video</A></LI>
       </UL>
-      <LI><A HREF="codecs.html#2.1.3">2.1.3 Codec importing howto</A></LI>
+      <LI><A HREF="codecs.html#2.2.2">2.2.2 Audio</A></LI>
       <UL>
-	<LI><A HREF="codecs.html#2.1.3.1">2.1.3.1 VFW codecs</A></LI>
-	<LI><A HREF="codecs.html#2.1.3.2">2.1.3.2 DirectShow codecs</A></LI>
+	<LI><A HREF="codecs.html#2.2.2.1">2.2.2.1 Hardware AC3 decoding</A></LI>
+	<LI><A HREF="codecs.html#2.2.2.2">2.2.2.2 libmad support</A></LI>
+      </UL>
+      <LI><A HREF="codecs.html#2.2.3">2.2.3 Win32 codec importing howto</A></LI>
+      <UL>
+	<LI><A HREF="codecs.html#2.2.3.1">2.2.3.1 VFW codecs</A></LI>
+	<LI><A HREF="codecs.html#2.2.3.2">2.2.3.2 DirectShow codecs</A></LI>
       </UL>
     </UL>
-    <LI><A HREF="video.html">2.2 Video & Audio output devices</A></LI>
+    <LI><A HREF="video.html">2.3 Output devices</A></LI>
     <UL>
-      <LI><A HREF="video.html#2.2.1">2.2.1 Video output devices</A></LI>
+      <LI><A HREF="video.html#2.3.1">2.3.1 Video</A></LI>
       <UL>
-	<LI><A HREF="video.html#2.2.1.1">2.2.1.1 MTRR</A></LI>
-	<LI><A HREF="video.html#2.2.1.2">2.2.1.2 Xv</A></LI>
+	<LI><A HREF="video.html#2.3.1.1">2.3.1.1 Setting up MTRR</A></LI>
+	<LI><A HREF="video.html#2.3.1.2">2.3.1.2 Xv</A></LI>
 	<UL>
-	  <LI><A HREF="video.html#2.2.1.2.1">2.2.1.2.1 3dfx cards</A></LI>
-	  <LI><A HREF="video.html#2.2.1.2.2">2.2.1.2.2 S3 cards</A></LI>
-	  <LI><A HREF="video.html#2.2.1.2.3">2.2.1.2.3 nVidia cards</A></LI>
-	  <LI><A HREF="video.html#2.2.1.2.4">2.2.1.2.4 ATI cards</A></LI>
-	  <LI><A HREF="video.html#2.2.1.2.5">2.2.1.2.5 NeoMagic cards</A></LI>
+	  <LI><A HREF="video.html#2.3.1.2.1">2.3.1.2.1 3dfx</A></LI>
+	  <LI><A HREF="video.html#2.3.1.2.2">2.3.1.2.2 S3</A></LI>
+	  <LI><A HREF="video.html#2.3.1.2.3">2.3.1.2.3 nVidia</A></LI>
+	  <LI><A HREF="video.html#2.3.1.2.4">2.3.1.2.4 ATI</A></LI>
+	  <LI><A HREF="video.html#2.3.1.2.5">2.3.1.2.5 NeoMagic</A></LI>
 	</UL>
-	<LI><A HREF="video.html#2.2.1.3">2.2.1.3 DGA</A></LI>
+	<LI><A HREF="video.html#2.3.1.3">2.3.1.3 DGA</A></LI>
 	<UL>
-	  <LI><A HREF="video.html#2.2.1.3.1">2.2.1.3.1 Summary</A></LI>
-	  <LI><A HREF="video.html#2.2.1.3.2">2.2.1.3.2 What is DGA</A></LI>
-	  <LI><A HREF="video.html#2.2.1.3.3">2.2.1.3.3 Installing DGA support for MPlayer</A></LI>
-	  <LI><A HREF="video.html#2.2.1.3.4">2.2.1.3.4 Resolution switching</A></LI>
-	  <LI><A HREF="video.html#2.2.1.3.5">2.2.1.3.5 DGA & MPlayer</A></LI>
-	  <LI><A HREF="video.html#2.2.1.3.6">2.2.1.3.6 Features of the DGA driver</A></LI>
-	  <LI><A HREF="video.html#2.2.1.3.7">2.2.1.3.7 Speed issues</A></LI>
-	  <LI><A HREF="video.html#2.2.1.3.8">2.2.1.3.8 Known bugs</A></LI>
-	  <LI><A HREF="video.html#2.2.1.3.9">2.2.1.3.9 Future work</A></LI>
-	  <LI><A HREF="video.html#2.2.1.3.A">2.2.1.3.A Some modelines</A></LI>
-	  <LI><A HREF="video.html#2.2.1.3.B">2.2.1.3.B Bug Reports</A></LI>
+	  <LI><A HREF="video.html#2.3.1.3.1">2.3.1.3.1 Summary</A></LI>
+	  <LI><A HREF="video.html#2.3.1.3.2">2.3.1.3.2 What is DGA</A></LI>
+	  <LI><A HREF="video.html#2.3.1.3.3">2.3.1.3.3 Installing DGA support for MPlayer</A></LI>
+	  <LI><A HREF="video.html#2.3.1.3.4">2.3.1.3.4 Resolution switching</A></LI>
+	  <LI><A HREF="video.html#2.3.1.3.5">2.3.1.3.5 DGA & MPlayer</A></LI>
+	  <LI><A HREF="video.html#2.3.1.3.6">2.3.1.3.6 Features of the DGA driver</A></LI>
+	  <LI><A HREF="video.html#2.3.1.3.7">2.3.1.3.7 Speed issues</A></LI>
+	  <LI><A HREF="video.html#2.3.1.3.8">2.3.1.3.8 Known bugs</A></LI>
+	  <LI><A HREF="video.html#2.3.1.3.9">2.3.1.3.9 Future work</A></LI>
+	  <LI><A HREF="video.html#2.3.1.3.A">2.3.1.3.A Some modelines</A></LI>
+	  <LI><A HREF="video.html#2.3.1.3.B">2.3.1.3.B Bug Reports</A></LI>
 	</UL>
-	<LI><A HREF="video.html#2.2.1.4">2.2.1.4 SDL</A></LI>
-	<LI><A HREF="video.html#2.2.1.5">2.2.1.5 SVGAlib</A></LI>
-	<LI><A HREF="video.html#2.2.1.6">2.2.1.6 Framebuffer output (FBdev)</A></LI>
-	<LI><A HREF="video.html#2.2.1.7">2.2.1.7 Matrox framebuffer (mga_vid)</A></LI>
-	<LI><A HREF="video.html#2.2.1.8">2.2.1.8 SiS 6326 framebuffer (sis_vid)</A></LI>
-	<LI><A HREF="video.html#2.2.1.9">2.2.1.9 3dfx YUV support (tdfxfb)</A></LI>
-	<LI><A HREF="video.html#2.2.1.10">2.2.1.10 OpenGL output</A></LI>
-	<LI><A HREF="video.html#2.2.1.11">2.2.1.11 AAlib - text mode displaying</A></LI>
-	<LI><A HREF="video.html#2.2.1.12">2.2.1.12 VESA - output to VESA BIOS</A></LI>
-	<LI><A HREF="video.html#2.2.1.A">2.2.1.A TVout</A></LI>
+	<LI><A HREF="video.html#2.3.1.4">2.3.1.4 SDL</A></LI>
+	<LI><A HREF="video.html#2.3.1.5">2.3.1.5 SVGAlib</A></LI>
+	<LI><A HREF="video.html#2.3.1.6">2.3.1.6 Framebuffer output (FBdev)</A></LI>
+	<LI><A HREF="video.html#2.3.1.7">2.3.1.7 Matrox framebuffer (mga_vid)</A></LI>
+	<LI><A HREF="video.html#2.3.1.8">2.3.1.8 SiS 6326 framebuffer (sis_vid)</A></LI>
+	<LI><A HREF="video.html#2.3.1.9">2.3.1.9 3dfx YUV support (tdfxfb)</A></LI>
+	<LI><A HREF="video.html#2.3.1.10">2.3.1.10 OpenGL output</A></LI>
+	<LI><A HREF="video.html#2.3.1.11">2.3.1.11 AAlib - text mode displaying</A></LI>
+	<LI><A HREF="video.html#2.3.1.12">2.3.1.12 VESA - output to VESA BIOS</A></LI>
+	<LI><A HREF="video.html#2.3.1.A">2.3.1.A TVout</A></LI>
 	<UL>
-	  <LI><A HREF="video.html#2.2.1.A.1">2.2.1.A.1 Matrox cards</A></LI>
-	  <LI><A HREF="video.html#2.2.1.A.2">2.2.1.A.2 ATI cards</A></LI>
-	  <LI><A HREF="video.html#2.2.1.A.3">2.2.1.A.3 Voodoo 3</A></LI>
+	  <LI><A HREF="video.html#2.3.1.A.1">2.3.1.A.1 Matrox</A></LI>
+	  <LI><A HREF="video.html#2.3.1.A.2">2.3.1.A.2 ATI</A></LI>
+	  <LI><A HREF="video.html#2.3.1.A.3">2.3.1.A.3 Voodoo 3/Banshee</A></LI>
 	</UL>
       </UL>
-      <LI><A HREF="sound.html#2.2.2">2.2.2 Soundcards, audio output devices</A></LI>
+      <LI><A HREF="sound.html#2.3.2">2.3.2 Audio</A></LI>
       <UL>
-	<LI><A HREF="sound.html#2.2.2.1">2.2.2.1 Soundcard experiences, recommendations</A></LI>
+	<LI><A HREF="sound.html#2.3.2.1">2.3.2.1 Soundcard experiences, recommendations</A></LI>
       </UL>
     </UL>
-    <LI><A HREF="encoding.html#2.3">2.3 Encoding with MEncoder</A></LI>
+    <LI><A HREF="encoding.html#2.4">2.4 MEncoder - An Encoder based on MPlayer</A></LI>
   </UL>
   <LI><A HREF="#3">3. Usage</A></LI>
     <UL>
@@ -153,10 +169,13 @@
 drivers. It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev, AAlib, but you can
 use SDL (and this way all drivers of SDL) and some lowlevel card-specific
 drivers (for Matrox, 3Dfx and Radeon) too! Most of them supports software or
-hardware scaling, so you can enjoy movies in fullscreen. And what about the
-nice big antialiased shaded subtitles (<B>9 supported types!!!</B>) with
-european/ISO 8859-1,2 (hungarian, english, czech, etc), cyrillic, korean fonts,
-and OSD?</P>
+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="http://www.mplayerhq.hu/DOCS/DVB">DVB</A></B> and <B> <A
+HREF="http://www.mplayerhq.hu/DOCS/DXR3">DXR3/Hollywood+</A></B> ! And what
+about the nice big antialiased shaded subtitles (<B>9 supported types!!!</B>)
+with european/ISO 8859-1,2 (hungarian, english, czech, etc), cyrillic, korean
+fonts, and OSD?</P>
 
 <P><B>MPlayer</B> is basically GPL, but contains some non-GPL code which is not
 allowed to be distributed in binary form, and also contains the OpenDivX
@@ -226,7 +245,8 @@
   <LI><B>gcc</B> - suggested version is from <B>2.95.2</B> to <B>2.95.4</B>.
   <B>NEVER</B> use 2.96 or 3.x.x !!! They generate faulty code.</LI>
   <LI><B>XFree86</B> - suggested version is <B>always the newest (4.1.0)</B>. Normally
-  everyone wants this. If you don't know why, you <B>do</B> need it.</LI>
+  everyone wants this. If you don't know why, you <B>do</B> need it. Make
+  sure its <B>development package</B> is installed too !</LI>
   <LI><B>make</B> - suggested version is <B>always the newest</B> (at least 3.79.x). This
   usually isn't important.</LI>
   <LI><B>SDL</B> - it's not mandatory, but can help in some cases. Always
@@ -241,36 +261,42 @@
 THIS!!!</I></B></A></LI>
 
 <LI>If you plan to use <B>MPlayer</B> on x86 architecture, you possibly want to use
-Win32 codecs. Download and unzip w32codecs.zip to /usr/lib/win32 .
+Win32 codecs. If you only want to play DVDs and DivXes, you probably don't
+want these, since the <B>libavcodec</B>'s DivX decoder (see below) is the
+fastest decoder available, and DVD is decoded with the <B>libmpeg2</B>
+library.<BR>
+If you want to play or encode for example movies recorded with digital cameras (example:
+DV), you must install them. Download and unzip w32codecs.zip to /usr/lib/win32 .
 Note: 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.</LI>
 
-<LI>If you own a Matrox G200/G400/G450/G550 card, then please see the <A HREF="video.html#2.2.1.7">2.2.1.7</A>
+<LI>If you own a Matrox G200/G400/G450/G550 card, then please see the <A HREF="video.html#2.3.1.7">mga_vid</A>
 section in order to gain big speedup. It is important to do these steps
 <I>before</I> compiling <B>MPlayer</B>, otherwise no Matrox-specific support will be
-built. Also check out the <A HREF="video.html#2.2.1.A.1">Matrox TV-out</A>
+built. Also check out the <A HREF="video.html#2.3.1.A.1">Matrox TV-out</A>
 section.</LI>
 
 <LI>If you own a 3Dfx Voodoo3/Banshee card, then please see the <A
-HREF="video.html#2.2.1.9">2.2.1.9</A> section in order to gain big speedup. It
+HREF="video.html#2.3.1.9">2.3.1.9</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#2.2.1.A.3">3dfx
+otherwise no 3Dfx support will be built. Also see the <A HREF="video.html#2.3.1.A.3">3dfx
 TV out section</A>.</LI>
 
-<LI>If you own an ATI card, see the <A HREF="video.html#2.2.1.A.2">2.2.1.A.2
-section</A> to know what features of your card is supported under Linux/MPlayer.</LI>
+<LI>If you own an ATI card, see the <A HREF="video.html#2.3.1.A.2">ATI cards
+section</A> of the TV-out documentation, to know what features of your card is supported under Linux/MPlayer.</LI>
 
 <LI>If you plan to use the ProjectMayo's <B>DivX4</B> codec, check the
-<A HREF="codecs.html#2.1.2.1">2.1.2.1</A> section before compiling.
+<A HREF="codecs.html#2.2.1.1">2.2.1.1</A> section before compiling.
 This codec can play old <B>DivX</B> movies much faster than the Win32 DLL.
 If you want to play movies with the new <B>DivX4</B> codec, it's
 <B>recommended</B> to use this library, instead the DivX.dll in the
 w32codecs.zip package. The codec itself is closed-source, and only an x86
-version is available.</LI>
+version is available. <I>You also need this codec for <B>MEncoder</B>, see
+below !</I></LI>
 
 <LI>If you plan to use ffmpeg's <B>libavcodec</B>, check the
-<A HREF="codecs.html#2.1.2.2">2.1.2.2</A> section before compiling.
+<A HREF="codecs.html#2.2.1.2">2.2.1.2</A> section before compiling.
 You'll need this to <B>gain <I>DivX/DivX4</I> playing on non-x86 machines</B>,
 and this codec has the <B>greatest decoding speed</B> for DivX and DivX4
 movies (even faster than the original DivX4 library itself) !</LI>
@@ -281,8 +307,11 @@
 <LI>Decide if you need GUI. If you do, see the <A HREF=#1.4>1.4 section</A>
 before compiling.</LI>
 
-<LI>If you want to play <B>3ivx</B> movies, check the <A HREF=codecs.html#2.1.2.4>
-2.1.2.4 section</A>.</LI>
+<LI>If you want to install <B>MEncoder</B> (our great all-purpose encoder),
+see the <A HREF="encoding.html#2.4">MEncoder section</A> .</LI>
+
+<LI>If you want to play <B>3ivx</B> movies, check the <A HREF=codecs.html#2.2.1.3>
+XAnim codecs section</A>.</LI>
 </UL>
 
 <P>Then build <B>MPlayer</B>:</P>
@@ -291,7 +320,7 @@
     make
     make install</PRE>
 
-<P>It is recommended to browse the output of ./configure , it contains info
+<P><B><I>ALWAYS browse the output of ./configure</I></B> , it contains info
 about what will be built, and what won't. You may also want to view
 config.h and config.mak files.</P>
 
@@ -305,7 +334,9 @@
     unzip mp-arial-iso-8859-1.zip</PRE>
 
 <P>Only one thing remains: copy the <B>codecs.conf</B> file from the <CODE>etc</CODE>
-directory (relative to the <B>MPlayer</B> tree) to $HOME/.mplayer/codecs.conf.</P>
+directory (relative to the <B>MPlayer</B> tree) to <CODE>$HOME/.mplayer/codecs.conf</CODE> .
+You should also check the manpage and <CODE>example.conf</CODE> for available options, and insert them
+into your config file, <CODE>$HOME/.mplayer/config</CODE> .</P>
 
 
 <P><B><A NAME=1.4>1.4. What about the GUI?</A></B></P>
@@ -410,11 +441,21 @@
 
 <P>You can change default behaviour by setting <CODE>osdlevel=</CODE> variable in config file.</P>
 
+
 <P><B><A NAME=2>2. Features</A></B></P>
 
-<P><A NAME=2.1>2.1. <A HREF="codecs.html">Video Formats, Audio & Video Codecs</A></P>
+
+<P><A NAME=2.1>2.1. <A HREF="formats.html">Supported formats</A></P>
+
+
+<P><A NAME=2.2>2.2. <A HREF="codecs.html">Supported codecs</A></P>
 
-<P><A NAME=2.2>2.2. <A HREF="video.html">Video</A> & <A HREF="sound.html">Audio</A> output devices</P>
+
+<P><A NAME=2.3>2.3. <A HREF="video.html">Video</A> & <A HREF="sound.html">Audio</A> output devices</P>
+
+
+<P><A NAME=2.4>2.4. <A HREF="encoding.html">MEncoder - An All-Purpose Encoder</P>
+
 
 <P><B><A NAME=3>3. Usage</A></B></P>