[Mplayer-cvslog] CVS: main/DOCS documentation.html,1.328,1.329 formats.html,1.47,1.48 sound.html,1.54,1.55 video.html,1.114,1.115

Winner of tha face compo gabucino at mplayerhq.hu
Wed Nov 13 06:14:15 CET 2002


Update of /cvsroot/mplayer/main/DOCS
In directory mail:/var/tmp.root/cvs-serv19971

Modified Files:
	documentation.html formats.html sound.html video.html 
Log Message:
some TOC reorder
new sections
updates
fixes
girls
etc


Index: documentation.html
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/documentation.html,v
retrieving revision 1.328
retrieving revision 1.329
diff -u -r1.328 -r1.329
--- documentation.html	9 Nov 2002 02:07:14 -0000	1.328
+++ documentation.html	13 Nov 2002 05:13:51 -0000	1.329
@@ -63,6 +63,7 @@
               <LI><A HREF="formats.html#roq">2.1.1.11 RoQ files</A></LI>
               <LI><A HREF="formats.html#ogg">2.1.1.12 OGG/OGM files</A></LI>
               <LI><A HREF="formats.html#sdp">2.1.1.13 SDP files</A></LI>
+              <LI><A HREF="formats.html#pva">2.1.1.14 PVA files</A></LI>
             </UL>
           </LI>
           <LI><A HREF="formats.html#audio_formats">2.1.2 Audio formats</A>
@@ -72,6 +73,7 @@
               <LI><A HREF="formats.html#ogg_vorbis">2.1.2.3 OGG/OGM files (Vorbis)</A></LI>
               <LI><A HREF="formats.html#wma">2.1.2.4 WMA/ASF files</A></LI>
               <LI><A HREF="formats.html#mp4">2.1.2.5 MP4 files</A></LI>
+              <LI><A HREF="formats.html#cdda">2.1.2.6 CD audio</A></LI>
             </UL>
           </LI>
         </UL>
@@ -114,65 +116,79 @@
           <LI><A HREF="video.html">2.3.1 Video output devices</A>
             <UL>
               <LI><A HREF="video.html#mtrr">2.3.1.1 Setting up MTRR</A></LI>
-              <LI><A HREF="video.html#xv">2.3.1.2 Xv</A>
+              <LI><A HREF="video.html#normal">2.3.1.2 Video outputs for traditional video cards</A></LI>
+              <UL>
+                <LI><A HREF="video.html#xv">2.3.1.2.1 Xv</A>
+                  <UL>
+                    <LI><A HREF="video.html#xv_3dfx">2.3.1.2.1.1 3dfx cards</A></LI>
+                    <LI><A HREF="video.html#xv_s3">2.3.1.2.1.2 S3 cards</A></LI>
+                    <LI><A HREF="video.html#xv_nvidia">2.3.1.2.1.3 nVidia cards</A></LI>
+                    <LI><A HREF="video.html#xv_ati">2.3.1.2.1.4 ATI cards</A></LI>
+                    <LI><A HREF="video.html#xv_neomagic">2.3.1.2.1.5 NeoMagic cards</A></LI>
+                    <LI><A HREF="video.html#xv_trident">2.3.1.2.1.6 Trident cards</A></LI>
+                  </UL>
+                </LI>
+                <LI><A HREF="video.html#dga">2.3.1.2.2 DGA</A>
+                  <UL>
+                    <LI><A HREF="video.html#dga_summary">2.3.1.2.2.1 Summary</A></LI>
+                    <LI><A HREF="video.html#dga_whatis">2.3.1.2.2.2 What is DGA</A></LI>
+                    <LI><A HREF="video.html#dga_installation">2.3.1.2.2.3 Installing DGA support for MPlayer</A></LI>
+                    <LI><A HREF="video.html#dga_resolution">2.3.1.2.2.4 Resolution switching</A></LI>
+                    <LI><A HREF="video.html#dga_mplayer">2.3.1.2.2.5 DGA &amp; MPlayer</A></LI>
+                    <LI><A HREF="video.html#dga_features">2.3.1.2.2.6 Features of the DGA driver</A></LI>
+                    <LI><A HREF="video.html#dga_speed">2.3.1.2.2.7 Speed issues</A></LI>
+                    <LI><A HREF="video.html#dga_bugs">2.3.1.2.2.8 Known bugs</A></LI>
+                    <LI><A HREF="video.html#dga_future">2.3.1.2.2.9 Future work</A></LI>
+                    <LI><A HREF="video.html#dga_modelines">2.3.1.2.2.A Some modelines</A></LI>
+                    <LI><A HREF="video.html#dga_bug_reports">2.3.1.2.2.B Bug Reports</A></LI>
+                  </UL>
+                </LI>
+                <LI><A HREF="video.html#sdl">2.3.1.2.3 SDL</A></LI>
+                <LI><A HREF="video.html#svgalib">2.3.1.2.4 SVGAlib</A></LI>
+                <LI><A HREF="video.html#fbdev">2.3.1.2.5 Framebuffer output (FBdev)</A></LI>
+                <LI><A HREF="video.html#mga_vid">2.3.1.2.6 Matrox framebuffer (mga_vid)</A></LI>
+                <LI><A HREF="video.html#tdfxfb">2.3.1.2.7 3dfx YUV support (tdfxfb)</A></LI>
+                <LI><A HREF="video.html#opengl">2.3.1.2.8 OpenGL output</A></LI>
+                <LI><A HREF="video.html#aalib">2.3.1.2.9 AAlib - text mode displaying</A></LI>
+                <LI><A HREF="video.html#vesa">2.3.1.2.10 VESA - output to VESA BIOS</A></LI>
+                <LI><A HREF="video.html#x11">2.3.1.2.11 X11</A></LI>
+                <LI><A HREF="video.html#vidix">2.3.1.2.12 VIDIX</A></LI>
+                <LI><A HREF="video.html#directfb">2.3.1.2.13 DirectFB</A></LI>
+                <LI><A HREF="video.html#dfbmga">2.3.1.2.14 DirectFB/Matrox (dfbmga)</A></LI>
+              </UL>
+              <LI><A HREF="video.html#mpegdec">2.3.1.3 MPEG decoders</A></LI>
+              <UL>
+                <LI><A HREF="video.html#dvb">2.3.1.3.1 DVB</A></LI>
+                <LI><A HREF="video.html#dxr2">2.3.1.3.2 DXR2</A></LI>
+                <LI><A HREF="video.html#dxr3">2.3.1.3.3 DXR3/Hollywood+</A></LI>
+              </UL>
+              <LI><A HREF="video.html#other">2.3.1.4 Other visualization hardware</A></LI>
+              <UL>
+                <LI><A HREF="video.html#zr">2.3.1.4.1 Zoran JPEG decoders</A></LI>
+                <LI><A HREF="video.html#blinken">2.3.1.4.2 Blinkenlights</A></LI>
+              </UL>
+              <LI><A HREF="video.html#tv-out">2.3.1.5 TV-out support</A>
                 <UL>
-                  <LI><A HREF="video.html#xv_3dfx">2.3.1.2.1 3dfx cards</A></LI>
-                  <LI><A HREF="video.html#xv_s3">2.3.1.2.2 S3 cards</A></LI>
-                  <LI><A HREF="video.html#xv_nvidia">2.3.1.2.3 nVidia cards</A></LI>
-                  <LI><A HREF="video.html#xv_ati">2.3.1.2.4 ATI cards</A></LI>
-                  <LI><A HREF="video.html#xv_neomagic">2.3.1.2.5 NeoMagic cards</A></LI>
-                  <LI><A HREF="video.html#xv_trident">2.3.1.2.6 Trident cards</A></LI>
-                </UL>
-              </LI>
-              <LI><A HREF="video.html#dga">2.3.1.3 DGA</A>
-                <UL>
-                  <LI><A HREF="video.html#dga_summary">2.3.1.3.1 Summary</A></LI>
-                  <LI><A HREF="video.html#dga_whatis">2.3.1.3.2 What is DGA</A></LI>
-                  <LI><A HREF="video.html#dga_installation">2.3.1.3.3 Installing DGA support for MPlayer</A></LI>
-                  <LI><A HREF="video.html#dga_resolution">2.3.1.3.4 Resolution switching</A></LI>
-                  <LI><A HREF="video.html#dga_mplayer">2.3.1.3.5 DGA &amp; MPlayer</A></LI>
-                  <LI><A HREF="video.html#dga_features">2.3.1.3.6 Features of the DGA driver</A></LI>
-                  <LI><A HREF="video.html#dga_speed">2.3.1.3.7 Speed issues</A></LI>
-                  <LI><A HREF="video.html#dga_bugs">2.3.1.3.8 Known bugs</A></LI>
-                  <LI><A HREF="video.html#dga_future">2.3.1.3.9 Future work</A></LI>
-                  <LI><A HREF="video.html#dga_modelines">2.3.1.3.A Some modelines</A></LI>
-                  <LI><A HREF="video.html#dga_bug_reports">2.3.1.3.B Bug Reports</A></LI>
-                </UL>
-              </LI>
-              <LI><A HREF="video.html#sdl">2.3.1.4 SDL</A></LI>
-              <LI><A HREF="video.html#svgalib">2.3.1.5 SVGAlib</A></LI>
-              <LI><A HREF="video.html#fbdev">2.3.1.6 Framebuffer output (FBdev)</A></LI>
-              <LI><A HREF="video.html#mga_vid">2.3.1.7 Matrox framebuffer (mga_vid)</A></LI>
-              <LI><A HREF="video.html#tdfxfb">2.3.1.8 3dfx YUV support (tdfxfb)</A></LI>
-              <LI><A HREF="video.html#opengl">2.3.1.9 OpenGL output</A></LI>
-              <LI><A HREF="video.html#aalib">2.3.1.10 AAlib - text mode displaying</A></LI>
-              <LI><A HREF="video.html#vesa">2.3.1.11 VESA - output to VESA BIOS</A></LI>
-              <LI><A HREF="video.html#x11">2.3.1.12 X11</A></LI>
-              <LI><A HREF="video.html#vidix">2.3.1.13 VIDIX</A></LI>
-              <LI><A HREF="video.html#zr">2.3.1.14 Zr</A></LI>
-              <LI><A HREF="video.html#dvb">2.3.1.15 DVB</A></LI>
-              <LI><A HREF="video.html#dxr3">2.3.1.16 DXR3/Hollywood+</A></LI>
-              <LI><A HREF="video.html#tv-out">2.3.1.A TV-out support</A>
-                <UL>
-                  <LI><A HREF="video.html#tv-out_matrox">2.3.1.A.1 Matrox G400 cards</A></LI>
-                  <LI><A HREF="video.html#tv-out_matrox_g450">2.3.1.A.2 Matrox G450/G550 cards</A></LI>
-                  <LI><A HREF="video.html#tv-out_ati">2.3.1.A.3 ATI cards</A></LI>
-                  <LI><A HREF="video.html#tv-out_voodoo">2.3.1.A.4 Voodoo 3</A></LI>
+                  <LI><A HREF="video.html#tv-out_matrox">2.3.1.5.1 Matrox G400 cards</A></LI>
+                  <LI><A HREF="video.html#tv-out_matrox_g450">2.3.1.5.2 Matrox G450/G550 cards</A></LI>
+                  <LI><A HREF="video.html#tv-out_ati">2.3.1.5.3 ATI cards</A></LI>
+                  <LI><A HREF="video.html#tv-out_voodoo">2.3.1.5.4 Voodoo 3</A></LI>
                 </UL>
               </LI>
             </UL>
           <LI><A HREF="sound.html">2.3.2 Audio output devices</A>
             <UL>
-              <LI><A HREF="sound.html#experiences">2.3.2.1 Sound card experiences, recommendations</A></LI>
-              <LI><A HREF="sound.html#plugins">2.3.2.2 Audio plugins</A>
+              <LI><A HREF="sound.html#sync">2.3.2.1 Description of MPlayer's A/V sync method</A></LI>
+              <LI><A HREF="sound.html#experiences">2.3.2.2 Sound card experiences, recommendations</A></LI>
+              <LI><A HREF="sound.html#plugins">2.3.2.3 Audio plugins</A>
                 <UL>
-                  <LI><A HREF="sound.html#resample">2.3.2.2.1 Up/Downsampling</A></LI>
-                  <LI><A HREF="sound.html#surround_decoding">2.3.2.2.2 Surround Sound decoding</A></LI>
-                  <LI><A HREF="sound.html#format">2.3.2.2.3 Sample format converter</A></LI>
-                  <LI><A HREF="sound.html#delay">2.3.2.2.4 Delay</A></LI>
-                  <LI><A HREF="sound.html#volume">2.3.2.2.5 Software volume control</A></LI>
-                  <LI><A HREF="sound.html#extrastereo">2.3.2.2.6 Extrastereo</A></LI>
-                  <LI><A HREF="sound.html#normalizer">2.3.2.2.7 Volume Normalizer</A></LI>
+                  <LI><A HREF="sound.html#resample">2.3.2.3.1 Up/Downsampling</A></LI>
+                  <LI><A HREF="sound.html#surround_decoding">2.3.2.3.2 Surround Sound decoding</A></LI>
+                  <LI><A HREF="sound.html#format">2.3.2.3.3 Sample format converter</A></LI>
+                  <LI><A HREF="sound.html#delay">2.3.2.3.4 Delay</A></LI>
+                  <LI><A HREF="sound.html#volume">2.3.2.3.5 Software volume control</A></LI>
+                  <LI><A HREF="sound.html#extrastereo">2.3.2.3.6 Extrastereo</A></LI>
+                  <LI><A HREF="sound.html#normalizer">2.3.2.3.7 Volume Normalizer</A></LI>
                 </UL>
               </LI>
             </UL>
@@ -399,6 +415,8 @@
     Mpeg codec was libmpeg2 (mpeg2dec) by Aaron Holtzman &amp; Michel Lespinasse.
     It's great, optimized very fast C code with perfect image quality and
     100% MPEG standard conformance.</LI>
+  <LI><B>MPlayer v0.01:</B> Nov 11, 2000<BR>
+    TODO: A'rpi, would you say some words here? :)</LI>
   <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>
@@ -423,7 +441,10 @@
     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</LI>
+  <LI><B>MPlayer 0.90pre10 "The BirthdayCounter"</B> Nov 11, 2002<BR>
+    Although this is not a release, I am going to mention it because it
+    came out 2 years after MPlayer v0.01. Happy birthday, MPlayer!</LI>
+  <LI><B>MPlayer 0.90 "?"</B> Date yet unknown</LI>
 </UL>
 
 
@@ -478,6 +499,11 @@
   <LI><B>libvorbis</B> - optional, needed for playing OGG Vorbis audio.</LI>
   <LI><B><A HREF="http://www.live.com/mplayer/">LIVE.COM Streaming Media</A></B>
     - optional, needed for playing RTSP/RTP streams.</LI>
+  <LI><B>directfb</B> - optional, from
+    <A HREF="http://www.directfb.org">http://www.directfb.org</A></LI>
+  <LI><B>cdparanoia</B> - optional, for CDDA support</LI>
+  <LI><B>libfreetype</B> - optional, for TTF fonts support. At least 2.0.9 is
+    required.</LI>
 </UL>
 
 <H4>Codecs:</H4>
@@ -784,7 +810,16 @@
   <LI>AQTitle</LI>
 </UL>
 
-The command line options differ slightly for the different formats:
+<P>MPlayer can dump the previously listed subtitle formats into the following
+  destination formats, with the given options:</P>
+
+<UL>
+  <LI>MPsub: <CODE>-dumpmpsub</CODE></LI>
+  <LI>SubRip: <CODE>-dumpsrtsub</CODE></LI>
+  <LI>Microdvd: <CODE>-dumpmicrodvdsub</CODE></LI>
+</UL>
+
+<P>The command line options differ slightly for the different formats:</P>
 
 <H4>VobSub subtitles</H4>
 
@@ -892,6 +927,8 @@
     (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>
+  <LI>using a TrueType (TTF) font, by the means of the <B>freetype</B>
+    library. Version 2.0.9 or greater is mandatory! TODO: complete this</LI>
 </UL>
 
 <P>After that, UNZIP the file you downloaded to <CODE>~/.mplayer</CODE> or

Index: formats.html
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/formats.html,v
retrieving revision 1.47
retrieving revision 1.48
diff -u -r1.47 -r1.48
--- formats.html	29 Oct 2002 23:37:45 -0000	1.47
+++ formats.html	13 Nov 2002 05:13:51 -0000	1.48
@@ -224,6 +224,15 @@
   libraries are required.)</P>
 
 
+<H4><A NAME="pva">2.1.1.14 PVA files</A></H4>
+
+<P>PVA is an MPEG-like format used by DVB TV boards' software (e.g.: MultiDec,
+  WinTV) under Windows.</P>
+
+<P>The PVA specifications can be downloaded from the following address:
+  <A HREF="http://www.technotrend.de/download/av_format_v1.pdf">http://www.technotrend.de/download/av_format_v1.pdf</A></P>
+
+
 <H3><A NAME="audio_formats">2.1.2 Audio formats</A></H3>
 
 <P>MPlayer is a <B>Movie</B> and not a <B>Media</B> player, although
@@ -254,6 +263,16 @@
 
 
 <H4><A NAME="mp4">2.1.2.5 MP4 files</A></H4>
+
+
+<H4><A NAME="cdda">2.1.2.6 CD audio</A></H4>
+
+<P>MPlayer can use <B>cdparanoia</B> (lib) to play CDDA (Audio CD).
+  The scope of this section does not contain enumerating cdparanoia's
+  features.</P>
+
+<P>See the man page's <CODE>-cdda</CODE> option which can be used to
+  pass options to cdparanoia.</P>
 
 </BODY>
 </HTML>

Index: sound.html
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/sound.html,v
retrieving revision 1.54
retrieving revision 1.55
diff -u -r1.54 -r1.55
--- sound.html	20 Oct 2002 12:20:39 -0000	1.54
+++ sound.html	13 Nov 2002 05:13:51 -0000	1.55
@@ -12,6 +12,8 @@
 
 <H3><A NAME="audio">2.3.2 Audio output devices</A></H3>
 
+<H4><A NAME="sync">2.3.2.1 Description of MPlayer's A/V sync method</A></H4>
+
 <P>MPlayer's audio interface is called <I>libao2</I>. It currently
   contains these drivers:</P>
 
@@ -26,8 +28,24 @@
   <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>
+<P>Fact is, Linux sound card drivers have compatibility problems. The cause
+  is that MPlayer uses a feature of normally coded audio drivers to maintain
+  audio/video sync. Regrettably, some driver authors don't care of this
+  function: it isn't needed for playing MP3s, or sound effects.</P>
+
+<P>Other media players like aviplay or xine possibly work out-of-the-box with
+  these drivers because they use "simple" methods with internal timing. A note:
+  time showed their methods aren't AS efficient as MPlayer's.</P>
+
+<P>Using MPlayer with a correctly written audio driver won't ever give you A/V
+  desyncs related to the audio, only with very badly created files (check the
+  documentation for workarounds!).</P>
+
+<P>If you happen to have a bad audio driver, try the <CODE>-autosync</CODE>
+  option, it should sort out your problems. See the man page for detailed
+  information.</P>
+
+<P>Some notes:</P>
 
 <UL>
   <LI>If you have an OSS driver, first try <CODE>-ao oss</CODE> (this is the
@@ -40,17 +58,13 @@
     <CODE>-ao alsa5</CODE> , since ALSA 0.5 has buggy OSS emulation code, and
     will <B>crash MPlayer</B> with a message like this:<BR>
     <CODE>DEMUXER: Too many (945 in 8390980 bytes) video packets in the buffer!</CODE></LI>
-  <LI>If you have ALSA version 0.9 you may choose between <CODE>-ao oss</CODE>
-    and <CODE>-ao sdl</CODE>. You can also use <CODE>-ao alsa9</CODE>. It
-    works, but there may be problems like lost sync and disappearing
-    audio.</LI>
 </UL>
 
-<P>On <B>Solaris/FreeBSD</B> systems, use the SUN audio driver with the
+<P>On <B>Solaris</B>, use the SUN audio driver with the
   <CODE>-ao sun</CODE> option, otherwise neither video nor audio will work.</P>
 
 
-<H4><A NAME="experiences">2.3.2.1 Sound Card experiences, recommendations</A></H4>
+<H4><A NAME="experiences">2.3.2.2 Sound Card experiences, recommendations</A></H4>
 
 <TABLE BORDER=0 WIDTH="100%">
   <TR><TD COLSPAN=3><B>VIA onboard chipset (via82cxxx) 48kHz only</B></TD></TR>
@@ -136,7 +150,7 @@
   and your sound card(s) worked together.</P>
 
 
-<H4><A NAME="plugins">2.3.2.2 Audio plugins</A></H4>
+<H4><A NAME="plugins">2.3.2.3 Audio plugins</A></H4>
 
 <P>MPlayer has support for audio plugins. Audio plugins can be used for
   changing the properties of the audio data before the sound reaches the sound
@@ -164,7 +178,7 @@
 <P>Currently audio plugins can not be used in MEncoder.</P>
 
 
-<H5><A NAME="resample">2.3.2.2.1 Up/Downsampling</A></H5>
+<H5><A NAME="resample">2.3.2.3.1 Up/Downsampling</A></H5>
 
 <P>MPlayer fully supports up/downsampling of the sound. This plugin can
   be used if you have a fixed frequency sound card or if you are
@@ -184,7 +198,7 @@
   in addition to audio distortion.</P>
 
 
-<H5><A NAME="surround_decoding">2.3.2.2.2 Surround Sound decoding</A></H5>
+<H5><A NAME="surround_decoding">2.3.2.3.2 Surround Sound decoding</A></H5>
 
 <P>MPlayer has an audio plugin that can decode matrix encoded
   surround sound. Dolby Surround is an example of a matrix encoded format.
@@ -195,7 +209,7 @@
   &nbsp;&nbsp;<CODE>mplayer media.avi -aop list=surround</CODE></P>
 
 
-<H5><A NAME="format">2.3.2.2.3 Sample format converter</A></H5>
+<H5><A NAME="format">2.3.2.3.3 Sample format converter</A></H5>
                                                                                
 <P>If your sound card driver does not support signed 16bit <CODE>int</CODE> data type, 
   this plugin can
@@ -210,7 +224,7 @@
   list=format:format=&lt;required output format&gt;</CODE></P>
 
 
-<H5><A NAME="delay">2.3.2.2.4 Delay</A></H5>
+<H5><A NAME="delay">2.3.2.3.4 Delay</A></H5>
 
 <P>This plugin delays the sound and is intended as an example of how to develop
   new plugins. It can not be used for anything useful from a users perspective
@@ -218,7 +232,7 @@
   plugin unless you are a developer.</P>
 
 
-<H5><A NAME="volume">2.3.2.2.5 Software volume control</A></H5>
+<H5><A NAME="volume">2.3.2.3.5 Software volume control</A></H5>
 
 <P>This plugin is a software replacement for the volume control, and
   can be used on machines with a broken mixer device. It can also be
@@ -251,7 +265,7 @@
   list=volume:softclip</CODE></P>
 
 
-<H5><A NAME="extrastereo">2.3.2.2.6 Extrastereo</A></H5>
+<H5><A NAME="extrastereo">2.3.2.3.6 Extrastereo</A></H5>
 
 <P>This plugin (linearly) increases the difference between left and right
   channels (like the XMMS extrastereo plugin) which gives some sort of "live"
@@ -267,7 +281,7 @@
   -1.0, left and right channels will be swapped.</P>
 
 
-<H5><A NAME="normalizer">2.3.2.2.7 Volume normalizer</A></H5>
+<H5><A NAME="normalizer">2.3.2.3.7 Volume normalizer</A></H5>
 
 <P>This plugin maximizes the volume without distorting the sound.</P>
 

Index: video.html
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/video.html,v
retrieving revision 1.114
retrieving revision 1.115
diff -u -r1.114 -r1.115
--- video.html	11 Nov 2002 05:09:11 -0000	1.114
+++ video.html	13 Nov 2002 05:13:51 -0000	1.115
@@ -69,8 +69,9 @@
   stepping 0] doesn't support MTRR, but stepping 12's do ('<CODE>cat
   /proc/cpuinfo</CODE>' to check it').</P>
 
+<H4><A NAME="normal">2.3.1.2 Video outputs for traditional video cards</A></H4>
 
-<H4><A NAME="xv">2.3.1.2 Xv</A></H4>
+<H4><A NAME="xv">2.3.1.2.1 Xv</A></H4>
 
 <P>Under XFree86 4.0.2 or newer, you can use your card's hardware YUV routines
   using the XVideo extension. This is what the option '-vo xv' uses. Also,
@@ -130,7 +131,7 @@
 </UL>
 
 
-<H5><A NAME="xv_3dfx">2.3.1.2.1 3dfx cards</A></H5>
+<H4><A NAME="xv_3dfx">2.3.1.2.1.1 3dfx cards</A></H4>
 
 <P>Older 3dfx drivers were known to have problems with XVideo acceleration, it
   didn't support either YUY2 or YV12, and so. Verify that you have XFree86
@@ -143,7 +144,7 @@
   <A HREF="#tdfxfb">tdfxfb</A> section.</P>
 
 
-<H5><A NAME="xv_s3">2.3.1.2.2 S3 cards</A></H5>
+<H4><A NAME="xv_s3">2.3.1.2.1.2 S3 cards</A></H4>
 
 <P>S3 Savage3D's should work fine, but for Savage4, use XFree86 version 4.0.3
   or greater (in case of image problems, try 16bpp). As for S3 Virge.. there is
@@ -155,7 +156,7 @@
   driver.</P>
 
 
-<H5><A NAME="xv_nvidia">2.3.1.2.3 nVidia cards</A></H5>
+<H4><A NAME="xv_nvidia">2.3.1.2.1.3 nVidia cards</A></H4>
 
 <P>nVidia isn't a very good choice under Linux (according to nVidia, this is
   <A HREF="users_against_developers.html#nvidia">not true</A>).. You'll have to
@@ -170,7 +171,7 @@
   Complain to nVidia.</P>
 
 
-<H5><A NAME="xv_ati">2.3.1.2.4 ATI cards</A></H5>
+<H4><A NAME="xv_ati">2.3.1.2.1.4 ATI cards</A></H4>
 
 <UL>
   <LI>The <A HREF="http://gatos.sourceforge.net">GATOS driver</A> (which you
@@ -185,7 +186,7 @@
 </UL>
 
 
-<H5><A NAME="xv_neomagic">2.3.1.2.5 NeoMagic cards</A></H5>
+<H4><A NAME="xv_neomagic">2.3.1.2.1.5 NeoMagic cards</A></H4>
 
 <P>These cards can be found in many laptops. Unfortunately, the driver in
   X 4.2.0 can't do Xv, but we have a modified, Xv-capable driver for you.
@@ -202,24 +203,24 @@
   EndSection</P>
 
 
-<H5><A NAME="xv_trident">2.3.1.2.6 Trident cards</A></H5>
+<H4><A NAME="xv_trident">2.3.1.2.1.6 Trident cards</A></H4>
 
 <P>If you want to use xv with a trident card, provided that it doesn't work
   with 4.1.0, install XFree 4.2.0. 4.2.0 adds support for fullscreen xv
   support with the Cyberblade XP card.</P>
 
 
-<H4><A NAME="dga">2.3.1.3 DGA</A></H4>
+<H4><A NAME="dga">2.3.1.2.2 DGA</A></H4>
 
 
-<H5><A NAME="dga_summary">2.3.1.3.1 Summary</A></H5>
+<H4><A NAME="dga_summary">2.3.1.2.2.1 Summary</A></H4>
 
 <P>This document tries to explain in some words what DGA is in general and what
   the DGA video output driver for MPlayer can do (and what it
   can't).</P>
 
 
-<H5><A NAME="dga_whatis">2.3.1.3.2 What is DGA</A></H5>
+<H4><A NAME="dga_whatis">2.3.1.2.2.2 What is DGA</A></H4>
 
 <P>DGA is short for Direct Graphics Access and is a means for a program to
   bypass the X-Server and directly modifying the framebuffer memory.
@@ -246,7 +247,7 @@
   driver that controls this chip. So it does not work on every system ...</P>
 
 
-<H5><A NAME="dga_installation">2.3.1.3.3 Installing DGA support for MPlayer</A></H5>
+<H4><A NAME="dga_installation">2.3.1.2.2.3 Installing DGA support for MPlayer</A></H4>
 
 <P>First make sure X loads the DGA extension, see in /var/log/XFree86.0.log:</P>
 
@@ -283,7 +284,7 @@
   much faster.</P>
 
 
-<H5><A NAME="dga_resolution">2.3.1.3.4 Resolution switching</A></H5>
+<H4><A NAME="dga_resolution">2.3.1.2.2.4 Resolution switching</A></H4>
 
 <P>The DGA driver allows for switching the resolution of the output signal. 
   This avoids the need for doing (slow) software scaling and at the same time
@@ -301,7 +302,7 @@
 <P>See appendix A for some sample modeline definitions.</P>
 
 
-<H5><A NAME="dga_mplayer">2.3.1.3.5 DGA &amp; MPlayer</A></H5>
+<H4><A NAME="dga_mplayer">2.3.1.2.2.5 DGA &amp; MPlayer</A></H4>
 
 <P>DGA is used in two places with MPlayer: The SDL driver can be made to
   make use of it (-vo sdl:dga) and within the DGA driver (-vo dga). The above
@@ -309,7 +310,7 @@
   driver for MPlayer works.</P>
 
 
-<H5><A NAME="dga_features">2.3.1.3.6 Features of the DGA driver</A></H5>
+<H4><A NAME="dga_features">2.3.1.2.2.6 Features of the DGA driver</A></H4>
 
 <P>The DGA driver is invoked by specifying -vo dga at the command line.
   The default behavior is to switch to a resolution matching the original
@@ -348,7 +349,7 @@
   CPU time!) depending on the implementation of DGA for your hardware.</P>
 
 
-<H5><A NAME="dga_speed">2.3.1.3.7 Speed issues</A></H5>
+<H4><A NAME="dga_speed">2.3.1.2.2.7 Speed issues</A></H4>
 
 <P>Generally spoken, DGA framebuffer access should be at least as fast as using
   the X11 driver with the additional benefit of getting a fullscreen image. 
@@ -373,7 +374,7 @@
   CPUs might work at 400 MHZ and above.</P>
 
 
-<H5><A NAME="dga_bugs">2.3.1.3.8 Known bugs</A></H5>
+<H4><A NAME="dga_bugs">2.3.1.2.2.8 Known bugs</A></H4>
 
 <P>Well, according to some developers of XFree, DGA is quite a beast. They
   tell you better not to use it. Its implementation is not always flawless
@@ -396,7 +397,7 @@
 </UL>
 
 
-<H5><A NAME="dga_future">2.3.1.3.9 Future work</A></H5>
+<H4><A NAME="dga_future">2.3.1.2.2.9 Future work</A></H4>
 
 <UL>
   <LI>use of the new X11 render interface for OSD</LI>
@@ -404,7 +405,7 @@
 </UL>
 
 
-<H5><A NAME="dga_modelines">2.3.1.3.A Some modelines</A></H5>
+<H4><A NAME="dga_modelines">2.3.1.2.2.A Some modelines</A></H4>
 
 <PRE>
   Section "Modes"
@@ -423,7 +424,7 @@
   module.</P>
 
 
-<H5><A NAME="dga_bug_reports">2.3.1.3.B Bug Reports</A></H5>
+<H4><A NAME="dga_bug_reports">2.3.1.2.2.B Bug Reports</A></H4>
 
 <P>If you experience troubles with the DGA driver please feel free to file
   a bug report to me (e-mail address below). Please start MPlayer with
@@ -437,7 +438,7 @@
 <P><I>Acki (acki at acki-netz.de, www.acki-netz.de)</I></P>
 
 
-<H4><A NAME="sdl">2.3.1.4 SDL</A></H4>
+<H4><A NAME="sdl">2.3.1.2.3 SDL</A></H4>
 
 <P>SDL (Simple Directmedia Layer) is basically a unified video/audio
   interface. Programs that use it know only about SDL, and not about what video
@@ -489,7 +490,7 @@
 </UL>
 
 
-<H4><A NAME="svgalib">2.3.1.5 SVGAlib</A></H4>
+<H4><A NAME="svgalib">2.3.1.2.4 SVGAlib</A></H4>
 
 <H4>Installation</H4>
 
@@ -525,7 +526,7 @@
   &nbsp;&nbsp;<CODE>-noaspect</CODE></P>
 
 
-<H4><A NAME="fbdev">2.3.1.6 Framebuffer output (FBdev)</A></H4>
+<H4><A NAME="fbdev">2.3.1.2.5 Framebuffer output (FBdev)</A></H4>
 
 <P>Whether to build the FBdev target is autodetected during ./configure .
   Read the framebuffer documentation in the kernel sources
@@ -534,8 +535,8 @@
 <P>If your card doesn't support VBE 2.0 standard (older ISA/PCI
   cards, such as S3 Trio64), only VBE 1.2 (or older?):
   Well, VESAfb is still available, but you'll have to load SciTech Display
-  Doctor (formerly UniVBE) before booting Linux.  Use a DOS boot disk or
-  whatever.  And don't forget to register your UniVBE ;))</P>
+  Doctor (formerly UniVBE) before booting Linux. Use a DOS boot disk or
+  whatever. And don't forget to register your UniVBE ;))</P>
 
 <P>The FBdev output takes some additional parameters above the others:</P>
 
@@ -578,10 +579,10 @@
   and don't ask for it, since it's not an MPlayer limitation.</P>
 
 
-<H4><A NAME="mga_vid">2.3.1.7 Matrox framebuffer (mga_vid)</A></H4>
+<H4><A NAME="mga_vid">2.3.1.2.6 Matrox framebuffer (mga_vid)</A></H4>
 
 <P>This section is about the Matrox G200/G400/G450/G550 BES (Back-End Scaler)
-  support, the mga_vid kernel driver.  It's active developed by me (A'rpi), and
+  support, the mga_vid kernel driver. It's active developed by me (A'rpi), and
   it has hardware VSYNC support with triple buffering. It works on both
   framebuffer console and under X.</P>
 
@@ -621,14 +622,14 @@
   change: <CODE>echo "brightness=120" &gt; /dev/mga_vid</CODE></P>
 
 
-<H4><A NAME="tdfxfb">2.3.1.8 3dfx YUV support (tdfxfb)</A></H4>
+<H4><A NAME="tdfxfb">2.3.1.2.7 3dfx YUV support (tdfxfb)</A></H4>
 
 <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>
 
 
-<H4><A NAME="opengl">2.3.1.9 OpenGL output</A></H4>
+<H4><A NAME="opengl">2.3.1.2.8 OpenGL output</A></H4>
 
 <P>MPlayer supports displaying movies using OpenGL, but if your
   platform/driver supports xv as should be the case on a PC with Linux, use xv
@@ -646,7 +647,7 @@
   for download and installation instructions.</P>
 
 
-<H4><A NAME="aalib">2.3.1.10 AAlib - text mode displaying</A></H4>
+<H4><A NAME="aalib">2.3.1.2.9 AAlib - text mode displaying</A></H4>
 
 <P><B>AAlib</B> is a library for displaying graphics in text mode, using powerful
   ASCII renderer. There are LOTS of programs already supporting it, like Doom,
@@ -704,13 +705,13 @@
 
 <P>Playing on terminal you'll get better speed and quality using the Linux
   driver, not curses (<CODE>-aadriver linux</CODE>). But therefore you need write access on
-  <CODE>/dev/vcsa&lt;terminal&gt;</CODE>.  That isn't autodetected by aalib, but vo_aa tries
-  to find the best mode.  See
+  <CODE>/dev/vcsa&lt;terminal&gt;</CODE>. That isn't autodetected by aalib, but vo_aa tries
+  to find the best mode. See
   <A HREF="http://aa-project.sourceforge.net/tune/">http://aa-project.sourceforge.net/tune/</A>
   for further tuning issues.</P>
 
 
-<H4><A NAME="vesa">2.3.1.11 VESA - output to VESA BIOS</A></H4>
+<H4><A NAME="vesa">2.3.1.2.10 VESA - output to VESA BIOS</A></H4>
 
 <P>This driver was designed and introduced as a <B>generic driver</B> for any
   video card which has VESA VBE 2.0+ compatible BIOS. Another advantage of this
@@ -800,7 +801,7 @@
 </UL>
 
 
-<H4><A NAME="x11">2.3.1.12 X11</A></H4>
+<H4><A NAME="x11">2.3.1.2.11 X11</A></H4>
 
 <P>Avoid if possible. Outputs to X11 (uses shared memory extension), with no
   hardware acceleration at all. Supports (MMX/3DNow/SSE accelerated, but still
@@ -830,7 +831,7 @@
   video modes.</P>
 
 
-<H4><A NAME="vidix">2.3.1.13 VIDIX</A></H4>
+<H4><A NAME="vidix">2.3.1.2.12 VIDIX</A></H4>
 
 <P>VIDIX is the abbreviation for <B>VID</B>eo <B>I</B>nterface for
   *ni<B>X</B>.<BR>
@@ -850,7 +851,7 @@
 
 <UL>
   <LI>You can use standalone video output driver: <CODE>-vo xvidix</CODE><BR>
-    This driver was developed as X11's front end to VIDIX technology.  It
+    This driver was developed as X11's front end to VIDIX technology. It
     requires X server and can work only under X server. Note that, as it
     directly accesses the hardware and circumvents the X driver, pixmaps
     cached in the graphics card's memory may be corrupted. You can prevent
@@ -938,11 +939,11 @@
     brightness.</DD>
 
   <DT><CODE>-saturation</CODE></DT>
-  <DD>Adjust <B>SATURATION</B> of video output.  You can get grayscale
+  <DD>Adjust <B>SATURATION</B> of video output. You can get grayscale
     output with this option.</DD>
 
   <DT><CODE>-hue</CODE></DT>
-  <DD>Adjust <B>HUE</B> of video signal.  You can get colored negative
+  <DD>Adjust <B>HUE</B> of video signal. You can get colored negative
     of image with this option.</DD>
 
   <DT><CODE>-red_intensity</CODE></DT>
@@ -970,95 +971,47 @@
   filename.vob</CODE></P>
 
 
-<H4><A NAME="zr">2.3.1.14 Zr</A></H4>
+<H4><A NAME="directfb">2.3.1.2.13 DirectFB</A></H4>
 
-<P>This is a display-driver (<CODE>-vo zr</CODE>) for a number of MJPEG
-  capture/playback cards (tested for DC10+ and Buz, and it should work for the
-  LML33 and the original DC10). The driver works by encoding the frame to jpeg 
-  and then sending it to the card. For the jpeg encoding <B>libavcodec</B> is
-  used, and required. With the special <I>cinerama</I> mode, you can watch
-  movies in true wide screen provided that you have two beamers and two
-  MJPEG cards. Depending on resolution and quality settings, this driver
-  may require a lot of CPU power, remember to specify <CODE>-framedrop</CODE>
-  if your machine is too slow. Note: My AMD K6-2 350MHz is (with <CODE>
-  -framedrop</CODE>) quite adequate for watching VCD sized material and
-  downscaled movies.
-
-<P>This driver talks to the kernel driver available at
-  <A HREF="http://mjpeg.sourceforge.net">http://mjpeg.sourceforge.net</A>, so
-  you must get it working first. The presence of an MJPEG card is autodetected
-  by the configure script, if autodetection fails, force detection with
-
-<PRE>
-  ./configure --enable-zr
-</PRE>
-
-<P>The output can be controlled by several options, a long description of the
-  options can be found in the man page, a short list of options can be
-  viewed by running
+<P><I>"DirectFB is a graphics library which was designed with embedded systems in
+  mind. It offers maximum hardware accelerated performance at a minimum of
+  resource usage and overhead."</I> - quoted from
+  <A HREF="http://www.directfb.org">http://www.directfb.org</A>.</P>
 
-<PRE>
-  mplayer -zrhelp
-</PRE>
+<P>I'll exclude DirectFB features from this section.</P>
 
-<P>Things like scaling and the OSD (on screen display) are not handled by
-  this driver but can be done using the video filters. For example, 
-  suppose that you have a movie with a resolution of <CODE>512x272</CODE> and
-  you want to view it fullscreen on your DC10+. There are three main
-  possibilities, you may scale the movie to a width of <CODE>768</CODE>,
-  <CODE>384</CODE> or <CODE>192</CODE>. For performance and quality reasons,
-  I would choose to scale the movie to <CODE>384x204</CODE> using the fast
-  bilinear software scaler. The commandline is
-
-<PRE>
-  mplayer -vo zr -sws 0 -vop scale=384:204 movie.avi
-</PRE>
+<P>Though MPlayer is not supported as a "video provider" in DirectFB, this
+  output driver will enable video playback through DirectFB. It will -
+  of course - be accelerated, on my Matrox G400 DirectFB's speed was the
+  same as XVideo.</P>
 
-<P>Cropping can be done by the <CODE>crop</CODE> filter and by
-  this driver itself. Suppose that a movie is too wide for display on your
-  Buz and that you want to use <CODE>-zrcrop</CODE> to make the movie less
-  wide, the you would issue the following command
+<P>Always try to use the newest version of DirectFB. You can use DirectFB
+  options on the command line, using the <CODE>-dfbopts</CODE> option.
+  Layer selection can be done by the subdevice method, e.g.: <CODE>-vo
+  directfb:2</CODE> (layer -1 is default: autodetect)</P>
 
-<PRE>
-  mplayer -vo zr -zrcrop 720x320+80+0 benhur.avi
-</PRE>
 
-  if you want to use the <CODE>crop</CODE> filter, you would do
+<H4><A NAME="dfbmga">2.3.1.2.14 DirectFB/Matrox (dfbmga)</A></H4>
 
-<PRE>
-  mplayer -vo zr -vop crop=720:320:80:0 benhur.avi
-</PRE>
+<P>Please read the <A HREF=#directfb>main DirectFB section</A> for general
+  informations.</P>
 
-<P>Extra occurances of <CODE>-zrcrop</CODE> invoke <I>cinerama</I> mode, i.e.
-  you can distribute the movie over several TV's or beamers to create a larger
-  screen. Suppose you have two beamers. The left one is connected to your Buz
-  at <CODE>/dev/video1</CODE> and the right one is connected to your DC10+ at
-  <CODE>/dev/video0</CODE>. The movie has a resolution of <CODE>704x288</CODE>.
-  Suppose also that you want the right beamer in black and white and that
-  the right beamer should have jpeg frames at quality <CODE>10</CODE>,
-  then you would issue the following command
+<P>This video output driver will enable CRTC2 (on the second head) on the
+  Matrox G400 card, displaying video <B>independently</B> of the first head.</P>
 
-<PRE>
-  mplayer -vo zr -zrdev /dev/video0 -zrcrop 352x288+352+0 -zrxdoff 0 -zrbw \
-          -zrcrop 352x288+0+0 -zrdev /dev/video1 -zrquality 10 movie.avi
-</PRE>
+<P>Instructions on how to make it work can be found here:
+  <A HREF="http://www.sci.fi/~syrjala/directfb/readme.txt">http://www.sci.fi/~syrjala/directfb/readme.txt</A></P>
 
-<P>You see that the options appearing before the second <CODE>-zrcrop</CODE>
-  only apply to the DC10+ and that the options after the second 
-  <CODE>-zrcrop</CODE> apply to the Buz. The maximum number of MJPEG cards
-  participating in <I>cinerama</I> is four, so you can buid a <CODE>2x2</CODE>
-  vidiwall.</P>
+<P>Note: we haven't been able to make this work, but others did. Anyway,
+  porting of the CRTC2 code to <B>mga_vid</B> is underway.</P>
 
-<P>Finally an important remark: Do not start or stop XawTV on the playback
-  device during playback, it will crash your computer. It is, however, fine to
-  <B>FIRST</B> start XawTV, <B>THEN</B> start MPlayer, wait for
-  MPlayer to finish and <B>THEN</B> stop XawTV.</P>
 
+<H4><A NAME="mpegdec">2.3.1.3 MPEG decoders</A></H4>
 
-<H4><A NAME="dvb">2.3.1.15 DVB</A></H4>
+<H4><A NAME="dvb">2.3.1.3.1 DVB</A></H4>
 
 <P>MPlayer supports cards with the Siemens DVB chipset from vendors like
-  Siemens, Technotrend, Galaxis or Hauppauge.  The latest DVB drivers are
+  Siemens, Technotrend, Galaxis or Hauppauge. The latest DVB drivers are
   available from the <A HREF="http://www.linuxtv.org">Linux TV site</A>. If you
   want to do software transcoding you should have at least a 1GHz CPU.</P>
 
@@ -1158,7 +1111,12 @@
   decompression).</P>
 
 
-<H4><A NAME="dxr3">2.3.1.16 DXR3/Hollywood+</A></H4>
+<H4><A NAME="dxr2">2.3.1.3.2 DXR2</A></H4>
+
+<P>TODO: somebody please fill this section with information.</P>
+
+
+<H4><A NAME="dxr3">2.3.1.3.3 DXR3/Hollywood+</A></H4>
 
 <P>MPlayer supports hardware accelerated playback with the Creative DXR3
   and Sigma Designs Hollywood Plus cards. These cards both use the em8300 MPEG
@@ -1233,7 +1191,15 @@
     reason for this is unknown to us. If you set it to somewhere between 25 and
     27 the picture becomes stable. For now all we can do is accept this for a
     fact.</DD>
-  
+
+  <DT><CODE>-vop lavc,expand=-1:-1:-1:-1:1</CODE></DT>
+  <DD>Altough the DXR3 driver can put some OSD onto the MPEG1/2/4 video,
+    it has much lower quality than MPlayer's traditional OSD, and has several
+    refresh problems as well. The command line above will firstly convert the
+    input video to MPEG4 (this is mandatory, sorry), then apply an expand
+    filter which won't expand anything (-1: default), but apply the normal OSD
+    onto the picture (that's what the "1" at the end does).</DD>
+
   <DT><CODE>-ac hwac3</CODE></DT>
   <DD>The em8300 supports playing back AC3 audio (surround sound) through the
     digital audio output of the card. See the <CODE>-ao oss</CODE> option
@@ -1253,10 +1219,103 @@
   that it will need more CPU power, and you might loose some picture quality.</P>
 
 
-<H4><A NAME="tv-out">2.3.1.A TV-out support</A></H4>
+<H4><A NAME="other">2.3.1.4 Other visualization hardware</A></H4>
+
+<H4><A NAME="zr">2.3.1.4.1 Zr</A></H4>
+
+<P>This is a display-driver (<CODE>-vo zr</CODE>) for a number of MJPEG
+  capture/playback cards (tested for DC10+ and Buz, and it should work for the
+  LML33 and the original DC10). The driver works by encoding the frame to jpeg 
+  and then sending it to the card. For the jpeg encoding <B>libavcodec</B> is
+  used, and required. With the special <I>cinerama</I> mode, you can watch
+  movies in true wide screen provided that you have two beamers and two
+  MJPEG cards. Depending on resolution and quality settings, this driver
+  may require a lot of CPU power, remember to specify <CODE>-framedrop</CODE>
+  if your machine is too slow. Note: My AMD K6-2 350MHz is (with <CODE>
+  -framedrop</CODE>) quite adequate for watching VCD sized material and
+  downscaled movies.
+
+<P>This driver talks to the kernel driver available at
+  <A HREF="http://mjpeg.sourceforge.net">http://mjpeg.sourceforge.net</A>, so
+  you must get it working first. The presence of an MJPEG card is autodetected
+  by the configure script, if autodetection fails, force detection with
+
+<PRE>
+  ./configure --enable-zr
+</PRE>
+
+<P>The output can be controlled by several options, a long description of the
+  options can be found in the man page, a short list of options can be
+  viewed by running
+
+<PRE>
+  mplayer -zrhelp
+</PRE>
+
+<P>Things like scaling and the OSD (on screen display) are not handled by
+  this driver but can be done using the video filters. For example, 
+  suppose that you have a movie with a resolution of <CODE>512x272</CODE> and
+  you want to view it fullscreen on your DC10+. There are three main
+  possibilities, you may scale the movie to a width of <CODE>768</CODE>,
+  <CODE>384</CODE> or <CODE>192</CODE>. For performance and quality reasons,
+  I would choose to scale the movie to <CODE>384x204</CODE> using the fast
+  bilinear software scaler. The commandline is
+
+<PRE>
+  mplayer -vo zr -sws 0 -vop scale=384:204 movie.avi
+</PRE>
+
+<P>Cropping can be done by the <CODE>crop</CODE> filter and by
+  this driver itself. Suppose that a movie is too wide for display on your
+  Buz and that you want to use <CODE>-zrcrop</CODE> to make the movie less
+  wide, the you would issue the following command
+
+<PRE>
+  mplayer -vo zr -zrcrop 720x320+80+0 benhur.avi
+</PRE>
+
+  if you want to use the <CODE>crop</CODE> filter, you would do
+
+<PRE>
+  mplayer -vo zr -vop crop=720:320:80:0 benhur.avi
+</PRE>
+
+<P>Extra occurances of <CODE>-zrcrop</CODE> invoke <I>cinerama</I> mode, i.e.
+  you can distribute the movie over several TV's or beamers to create a larger
+  screen. Suppose you have two beamers. The left one is connected to your Buz
+  at <CODE>/dev/video1</CODE> and the right one is connected to your DC10+ at
+  <CODE>/dev/video0</CODE>. The movie has a resolution of <CODE>704x288</CODE>.
+  Suppose also that you want the right beamer in black and white and that
+  the right beamer should have jpeg frames at quality <CODE>10</CODE>,
+  then you would issue the following command
+
+<PRE>
+  mplayer -vo zr -zrdev /dev/video0 -zrcrop 352x288+352+0 -zrxdoff 0 -zrbw \
+          -zrcrop 352x288+0+0 -zrdev /dev/video1 -zrquality 10 movie.avi
+</PRE>
+
+<P>You see that the options appearing before the second <CODE>-zrcrop</CODE>
+  only apply to the DC10+ and that the options after the second 
+  <CODE>-zrcrop</CODE> apply to the Buz. The maximum number of MJPEG cards
+  participating in <I>cinerama</I> is four, so you can buid a <CODE>2x2</CODE>
+  vidiwall.</P>
+
+<P>Finally an important remark: Do not start or stop XawTV on the playback
+  device during playback, it will crash your computer. It is, however, fine to
+  <B>FIRST</B> start XawTV, <B>THEN</B> start MPlayer, wait for
+  MPlayer to finish and <B>THEN</B> stop XawTV.</P>
+
+
+<H4><A NAME="blinken">2.3.1.4.2 Blinkenlights</A></H4>
+
+<P>This driver is capable of playback using the Blinkenlights UPD protocol.
+  If you don't know what Blinkenlights is, you don't need this driver.</P>
 
 
-<H5><A NAME="tv-out_matrox">2.3.1.A.1 Matrox G400 cards</A></H5>
+<H4><A NAME="tv-out">2.3.1.5 TV-out support</A></H4>
+
+
+<H4><A NAME="tv-out_matrox">2.3.1.5.1 Matrox G400 cards</A></H4>
 
 <P>Under Linux you have 2 methods to get G400 TV out working:</P>
 
@@ -1319,8 +1378,17 @@
   </LI>
 </UL>
 
+<H4>Building a Matrox TV-out cable</H4>
+
+<P>This information was contributed by <B>Rácz Balázs</B>. Of course
+  no one takes any responsibility, nor guarantee for any damage caused
+  by this documentation.</P>
+
+<P>The CRTC2 connector's fourth pin is the composite video signal. The ground
+  are the sixth, seventh and eighth pins.</P>
+
 
-<H5><A NAME="tv-out_matrox_g450">2.3.1.A.2 Matrox G450/G550 cards</A></H5>
+<H4><A NAME="tv-out_matrox_g450">2.3.1.5.2 Matrox G450/G550 cards</A></H4>
 
 <P>TV output support for these cards has only been recently introduced, and is
   not yet in the mainstream kernel. Currently the <B>mga_vid</B> module
@@ -1339,7 +1407,7 @@
   <A HREF="http://www3.sympatico.ca/dan.eriksen/matrox_tvout/">http://www3.sympatico.ca/dan.eriksen/matrox_tvout/</A></P>
 
 
-<H5><A NAME="tv-out_ati">2.3.1.A.3 ATI cards</A></H5>
+<H4><A NAME="tv-out_ati">2.3.1.5.3 ATI cards</A></H4>
 
 <H5>PREAMBLE</H5>
 
@@ -1366,7 +1434,7 @@
   POST procedure.</P>
 
 
-<H5><A NAME="tv-out_voodoo">2.3.1.A.4 Voodoo 3</A></H5>
+<H4><A NAME="tv-out_voodoo">2.3.1.5.4 Voodoo 3</A></H4>
 
 <P>Check <A HREF="http://www.iki.fi/too/tvout-voodoo3-3000-xfree">this URL</A>.</P>
 




More information about the MPlayer-cvslog mailing list