From f8f150b427e96c788d3c9ce34648bd585d63f128 Mon Sep 17 00:00:00 2001 From: gabucino Date: Tue, 24 Jul 2001 16:06:00 +0000 Subject: [PATCH] ready git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@1387 b3059339-0415-0410-9bf9-f77b7e298cf2 --- DOCS/documentation.html | 368 ++++++++++++++++++++++++---------------- 1 file changed, 220 insertions(+), 148 deletions(-) diff --git a/DOCS/documentation.html b/DOCS/documentation.html index 8667137f54..a799504b19 100644 --- a/DOCS/documentation.html +++ b/DOCS/documentation.html @@ -67,7 +67,7 @@ Table of Contents 2.2.1.8 3dfx YUV support 2.2.1.9 OpenGL output 2.2.2 Audio output devices - +SOUNDCARDS + 2.2.2.1 Soundcard experiences, recommendations

3. Usage @@ -95,7 +95,12 @@ Table of Contents 6. FAQ section

- 6.10 DVD FAQ + 6.1 Compilation + 6.2 General questions + 6.3 File playing problems + 6.4 Video/audio driver problems + 6.5 Feature requests + 6.6 DVD FAQ

7. Misc OS'es @@ -114,9 +119,7 @@ Table of Contents

C. How to report bugs

-

- License+standard disc, maintainers -

+ 

@@ -922,6 +925,64 @@ Table of Contents
   - SUN audio driver (/dev/audio) for BSD and Solaris8 users
 
 
+  2.2.2.1.  Soundcard experiences, recommendations
+
+  Aureal Vortex 2:
+			OSS/Free: no driver
+			OSS	: OK
+			ALSA	: no driver
+			Max kHz : 48
+			Driver	: aureal.sourceforge.net
+			Driver2 : from here
+				  (buffer size increased to 64k)
+
+  GUS PnP:
+			OSS/Free: no driver
+			OSS	: OK
+			ALSA	: OK
+			Max kHz	: 48
+
+  SB Live!:
+			OSS	: OK
+			ALSA	: (?)
+			Max kHz : 48
+
+  SB AWE 64		OSS	: max 44kHz
+			ALSA	: 48kHz sounds shit
+			Max kHz : 48
+
+  Gravis UltraSound ACE:
+			OSS     : max 44Khz. Also has problems with the
+				  new sound code.
+			ALSA    : OK
+			Max kHz : 48
+
+  Gravis UltraSound MAX:
+			OSS     : OK
+			ALSA    : OK (?)
+			Max kHz : 48
+
+  ESS 688:
+			OSS     : OK
+			ALSA    : OK (?)
+			Max kHz : 48
+
+  PC Speaker or DAC:
+			OSS     : OK (new timing code?)
+			ALSA    : no driver
+			Max kHz : 6 ;) (the driver emulates 44.1 maybe more)
+			Driver  : ftp://ftp.infradead.org/pub/pcsp
+
+   - use at least 2.4 if possible, 2.2 isn't tested
+   - if sound clicks when playing from CD-ROM, turn on IRQ unmasking !
+     for example "hdparm -u1 /dev/cdrom" (see "man hdparm" !!!)
+     This is recommended anyways... (for XMMS, etc...)
+     Read section 5.1 .
+   - don't use your soundcard by other application ( for ex. XMMS ) !
+     if you use ESD, start MPlayer with the esddsp utility !
+   - Please tell us how MPlayer and your soundcard(s) worked together!
+
+
   3.  Usage
 
   file:  mplayer [options] [path/]filename
@@ -1284,8 +1345,16 @@ Table of Contents
 
   6. FAQ section (TODO)
 
-  Q: What about DVD playback?
-  A: Read files 'DVD' and 'DVD-FAQ'.
+
+  6.1.  Compilation
+
+  Q: What's the problem with gcc 2.96 ?
+  A: gcc 2.96 is RedHat's UNOFFICIAL (it can be found only on RedHat sites, or
+     RedHat distributions) and BUGGY gcc release. gcc 2.96 is TOTALLY
+     unsupported by MPlayer, because it simply SKIPS MMX codes, it just does not
+     compile it. Important: this is NOT an MPlayer-specific problem, numerous
+     other projects (DRI, avifile, etc..) have problems with this shit too.
+     ** DO NOT USE gcc 2.96 !!! **
 
   Q: SDL output doesn't work or compile. Problem is ....
   A: It is tested with newest SDL (probably runs on 1.1.7+).
@@ -1305,6 +1374,41 @@ Table of Contents
   A: Only kernel versions 2.4.x supports SSE (or try latest 2.2.19 or newer, but
      be prepared for problems)
 
+  Q: I have G200/G400, how to compile/use mga_vid driver?
+  A: Read all this documentation.
+
+  Q: Are there rpm/deb/... packages of MPlayer?
+  A: You can make a .deb package for yourself, check section 7.1 .
+     It's _STRONGLY_ discouraged to use precompiled packages
+     of MPlayer, since it (currently) _highly_ depends on compile-time
+     options and optimizations!
+     Precompiled packages are COMPLETELY unsupported by the MPlayer team!
+
+  Q: During 'make', MPlayer complains about X11 libraries. I don't understand,
+     I DO have X installed!?
+  A: ...but you don't have the X development package installed. Or not
+     correctly. It's called XFree86-devel* under RedHat, and xlib6g-dev* under
+     Debian.  Also check if the /usr/X11 symlink exists (this can be a problem on
+     Mandrake systems). It can be created with the
+	$ ln -sf /usr/X11R6 /usr/X11
+     command. Also check the /usr/include/X11 link :
+	$ ln -sf /usr/X11R6/include/X11 /usr/include/X11
+     Your distribution may differ from the Linux Filesystem Standard.
+
+  Q: What about DGA driver? I can't find it!!!
+  A: ./configure autodetects your DGA driver. If -vo help doesn't show
+     DGA, then there's a problem with your X installation.
+     Try ./configure --enable-dga (and read VIDEOCARDS)
+     Alternatively, try SDL's DGA driver with '-vo sdl:dga' options.
+
+  Q: I can't compile SVGAlib.. I'm using 2.3/2.4 kernel.
+  A: You have to edit SVGAlib's Makefile.cfg and comment "BACKGROUND = y" out.
+
+  6.2.  General questions
+
+  Q: What about DVD playback?
+  A: Read files 'DVD' and 'DVD-FAQ'.
+
   Q: -xy option doesn't work with x11 driver (-vo x11)
   A: x11 driver doesn't support scaling, but XF86VidMode support is now
      used: you must specify the -vm and the -fs switch, and you're done.
@@ -1313,10 +1417,6 @@ Table of Contents
      It's much faster. If SDL's DGA works too, use that, it'll be EVEN
      faster!
 
-  Q: audio goes out of sync playing .avi file
-  A: try with -bps or -nobps option
-     if still bad, send me (upload to ftp) that file, I'll check.
-
   Q: what is the meaning of numbers in the status line?
   A: see:
          A:   2.1  V:   2.2  A-V: -0.167  ct:  0.042   57  41%   0%  2.6% 0
@@ -1336,16 +1436,6 @@ Table of Contents
      You should try to play the file using -vo null and then -vo ... and check
      the difference to see video_out speed...
 
-  Q: OpenGL (-vo gl) output doesn't work (hangup/black window/X11 errors/...)
-  A: your opengl driver doesn't support dynamic texture changes (glTexSubImage)
-     it's known not to work with nVidia's binary shit.
-     it's known to work with Utah-GLX/DRI and Matrox G400 card. Also with
-     DRI and Radeon card. It won't work with DRI others than these.
-     it will not work with 3DFX cards because the 256x256 texture size limit.
-
-  Q: I have G200/G400, how to compile/use mga_vid driver?
-  A: read VIDEOCARDS, INSTALL, README
-
   Q: What's XMMP? (is it XMMS or XMPS but mispelled?)
   A: It's a new project, see http://frozenproductions.com for details
 
@@ -1353,6 +1443,49 @@ Table of Contents
   A: Download & install w32codec.zip from *our* FTP
      (avifile's codec package has different DLL set)
 
+  Q: Are there any mailing lists on MPlayer?
+  A: Yes! See README on how to subscribe them!
+
+  Q: I've found a nasty bug when I tried to play my favourite video!!
+     Who should I inform?
+  A: See Appendix C .
+
+ Q: I have problems playing files with ... codec. Can I use'em?
+  A: Check http://mplayer.sourceforge.net/DOCS/codecs.html,
+     if it doesn't contain your codec, read
+     http://mplayer.sourceforge.net/DOCS/CODECS, and contact us.
+
+  Q: Umm, what is "IdegCounter" ?
+  A: A mixture of a hungarian and an english word. In english, "Ideg" means
+     "nerve", and is pronounced as something like "ydaegh" . It was first used
+     to measure the nervousness of A'rpi, after some (umm) "mystic" disappearance
+     of CVS code ;)
+
+  Q: LIRC doesn't work, because ...
+  A: Are you sure you use "mplayer_lirc" instead of "mplayer" ?
+
+  Q: Subtitles are very nice, the most beautiful I've ever seen, but they slow
+     down the playing! I know it's unlikely...
+  A: After running ./configure , edit config.h and replace #undef FAST_OSD with
+     #define FAST_OSD . Then recompile.
+
+  Q: The OSD is flickering!
+  A: You use a vo driver with single buffering (x11,xv). With xv you can change
+     the number of buffers in libvo/vo_xv.c :
+     Increase #define NUM_BUFFERS 1
+
+  Q: What exactly is this libavcodec?
+  A: It's from Gerard Lantau's ffmpeg package (http://ffmpeg.sourceforge.net).
+     It has C language DivX ;-) and OpenDivX codec.  Some benchmarks
+     showed that its DivX seems to be even faster than DirectShow codec without
+     preprocessing, and only a few percent slower than ProjectMayo's OpenDivX
+     decoder.  It uses YV12 pixel format, so old Voodoo users can use it for YUV.
+     Also, open the possibility to play DivX on virtually every computer that
+     has a C compiler. Kinda great stuff, isn't it?
+
+
+  6.3.  File playing problems
+
   Q: ...... works with avifile/aviplay while doesn't with MPlayer
   A: MPlayer != avifile
      The only common thing between these players is the Win32 DLL loader.
@@ -1361,6 +1494,10 @@ Table of Contents
      If something works with aviplay it doesn't mean that MPlayer should do
      it and vice versa.
 
+  Q: audio goes out of sync playing .avi file
+  A: try with -bps or -nobps option
+     if still bad, send me (upload to ftp) that file, I'll check.
+
   Q: Indeo 3.x/4.x movies are viewed upside-down!!!?
   A: It's a known bug (really it's a bug/limitation of the DLL codec)
      Try if your vo driver supports the -flip switch.
@@ -1373,95 +1510,6 @@ Table of Contents
   A: This is highly unlikely, since the mp3lib rewrite. Contact us, it may be
      a bug. Possibly it's a damaged file, try with -afm 4 .
 
-  Q: Are there rpm/deb/... packages of MPlayer?
-  A: You can make a .deb package for yourself, check DOCS/DEBIAN .
-     It's _STRONGLY_ discouraged to use precompiled packages
-     of MPlayer, since it (currently) _highly_ depends on compile-time
-     options and optimizations!
-     Precompiled packages are COMPLETELY unsupported by the MPlayer team!
-
-  Q: Are there any mailing lists on MPlayer?
-  A: Yes! See README on how to subscribe them!
-
-  Q: I've found a nasty bug when I tried to play my favourite video!!
-     Who should I inform?
-  A: See DOCS/BUGREPORTS
-
-  Q: During 'make', MPlayer complains about X11 libraries. I don't understand,
-     I DO have X installed!?
-  A: ...but you don't have the X development package installed. Or not
-     correctly. It's called XFree86-devel* under RedHat, and xlib6g-dev* under
-     Debian.  Also check if the /usr/X11 symlink exists (this can be a problem on
-     Mandrake systems). It can be created with the
-	$ ln -sf /usr/X11R6 /usr/X11
-     command. Also check the /usr/include/X11 link :
-	$ ln -sf /usr/X11R6/include/X11 /usr/include/X11
-     Your distribution may differ from the Linux Filesystem Standard.
-
-  Q: I have problems playing files with ... codec. Can I use'em?
-  A: Check http://mplayer.sourceforge.net/DOCS/codecs.html,
-     if it doesn't contain your codec, read
-     http://mplayer.sourceforge.net/DOCS/CODECS, and contact us.
-
-  Q: What about DGA driver? I can't find it!!!
-  A: ./configure autodetects your DGA driver. If -vo help doesn't show
-     DGA, then there's a problem with your X installation.
-     Try ./configure --enable-dga (and read VIDEOCARDS)
-     Alternatively, try SDL's DGA driver with '-vo sdl:dga' options.
-
-  Q: Ok, -vo help shows DGA driver, but it is babbling about permissions!
-     Help me!
-  A: It works only if running as root! It's a DGA limitation.
-     You should become to root (su -), and try again.
-
-   Another solution is making mplayer SUID root, but its NOT RECOMMENDED!
-
-	chown root /usr/local/bin/mplayer
-	chmod 750 /usr/local/bin/mplayer
-	chmod +s /usr/local/bin/mplayer
-
-                           !!!! BUT STAY TUNED !!!!
-    This is a *BIG* security risk! *NEVER* do this on a server or on a computer
-    can be accessed by more people than only you because they can gain root
-    privilegies through suid root mplayer!!!
-                       !!!! SO YOU HAVE BEEN WARNED ... !!!!
-
-  Q: The fsdga driver doesn't work with my xyz.avi file. Why is that?
-  A: Because it only works with MPEG. (yet)
-
-  Q: When using Xvideo, my Voodoo 3/Banshee says:
-     X Error of failed request:  BadAccess (attempt to access private resource
-     denied)
-      Major opcode of failed request:  147 (MIT-SHM)
-      Minor opcode of failed request:  1 (X_ShmAttach)
-      Serial number of failed request:  26
-      Current serial number in output stream:27 
-  A: Your driver is old, update it. Either download (at least) DRI version 0.6
-     from http://dri.sourceforge.net , or use the DRI cvs.
-
-  Q: When using Xvideo, I can't play DivX avis with my Voodoo 3/Banshee !
-     It says:
-      ...
-      Xvideo image format: 0x32315659 (YV12) planar
-      Xvideo image format: 0x30323449 (I420) planar
-      ...
-  A1: See the previous answer.
-  A2: Since 0.18pre4 we include libavcodec from the ffmpeg package. It contains
-      a C language DivX and OpenDivX decoder. The DivX decoder uses YV12 format
-      for output, thus it should work for you. Compile in libavcodec support.
-
-  Q: Umm, what is "IdegCounter" ?
-  A: A mixture of a hungarian and an english word. In english, "Ideg" means
-     "nerve", and is pronounced as something like "ydaegh" . It was first used
-     to measure the nervousness of A'rpi, after some (umm) "mystic" disappearance
-     of CVS code ;)
-
-  Q: I can't compile SVGAlib.. I'm using 2.3/2.4 kernel.
-  A: You have to edit SVGAlib's Makefile.cfg and comment "BACKGROUND = y" out.
-
-  Q: LIRC doesn't work, because ...
-  A: Are you sure you use "mplayer_lirc" instead of "mplayer" ?
-
   Q: MPlayer exits with something error when using l3codeca.acm
   A: Check 'ldd /usr/local/bin/mplayer' output. If it contains
           libc.so.6 => /lib/libc.so.6 (0x4???????)
@@ -1483,7 +1531,7 @@ Table of Contents
   A: Try running MPlayer on the machine you compiled on. Or recompile. Don't
      use MPlayer on different CPU than it was compiled on.
 
-  Q: I have problems with  and fullscreen xv/xmga/sdl/x11
+  Q: I have problems with [your window manager] and fullscreen xv/xmga/sdl/x11
      modes..
   A1: Use the -fsmode switch. See example.conf or manpage.
 
@@ -1501,25 +1549,63 @@ Table of Contents
   A: The KDE arts sound daemon is blocking the sound device, either wait the time
      until video starts or you disable the arts-daemon in kontrollcenter.
 
-  Q: Subtitles are very nice, the most beautiful I've ever seen, but they slow
-     down the playing! I know it's unlikely...
-  A: After running ./configure , edit config.h and replace #undef FAST_OSD with
-     #define FAST_OSD . Then recompile.
 
-  Q: The OSD is flickering!
-  A: You use a vo driver with single buffering (x11,xv). With xv you can change
-     the number of buffers in libvo/vo_xv.c :
-     Increase #define NUM_BUFFERS 1
+  6.4.  Video/audio driver problems (vo/ao)
 
-  Q: What's the problem with gcc 2.96 ?
-  A: gcc 2.96 is RedHat's UNOFFICIAL (it can be found only on RedHat sites, or
-     RedHat distributions) and BUGGY gcc release. gcc 2.96 is TOTALLY
-     unsupported by MPlayer, because it simply SKIPS MMX codes, it just does not
-     compile it. Important: this is NOT an MPlayer-specific problem, numerous
-     other projects (DRI, avifile, etc..) have problems with this shit too.
-     ** DO NOT USE gcc 2.96 !!! **
+  Q: Ok, -vo help shows DGA driver, but it is babbling about permissions!
+     Help me!
+  A: It works only if running as root! It's a DGA limitation.
+     You should become to root (su -), and try again.
 
-  Q: Is there a hint on how to watch QuickTime and RealMedia movies in mplayer?
+   Another solution is making mplayer SUID root, but its NOT RECOMMENDED!
+
+	chown root /usr/local/bin/mplayer
+	chmod 750 /usr/local/bin/mplayer
+	chmod +s /usr/local/bin/mplayer
+
+                           !!!! BUT STAY TUNED !!!!
+    This is a *BIG* security risk! *NEVER* do this on a server or on a computer
+    can be accessed by more people than only you because they can gain root
+    privilegies through suid root mplayer!!!
+                       !!!! SO YOU HAVE BEEN WARNED ... !!!!
+
+  Q: When using Xvideo, my Voodoo 3/Banshee says:
+     X Error of failed request:  BadAccess (attempt to access private resource
+     denied)
+      Major opcode of failed request:  147 (MIT-SHM)
+      Minor opcode of failed request:  1 (X_ShmAttach)
+      Serial number of failed request:  26
+      Current serial number in output stream:27 
+  A: Your driver is old, update it. Either download (at least) DRI version 0.6
+     from http://dri.sourceforge.net , or use the DRI cvs.
+
+  Q: When using Xvideo, I can't play DivX avis with my Voodoo 3/Banshee !
+     It says:
+      ...
+      Xvideo image format: 0x32315659 (YV12) planar
+      Xvideo image format: 0x30323449 (I420) planar
+      ...
+  A1: See the previous answer.
+  A2: Since 0.18pre4 we include libavcodec from the ffmpeg package. It contains
+      a C language DivX and OpenDivX decoder. The DivX decoder uses YV12 format
+      for output, thus it should work for you. Compile in libavcodec support.
+
+  Q: OpenGL (-vo gl) output doesn't work (hangup/black window/X11 errors/...)
+  A: your opengl driver doesn't support dynamic texture changes (glTexSubImage)
+     it's known not to work with nVidia's binary shit.
+     it's known to work with Utah-GLX/DRI and Matrox G400 card. Also with
+     DRI and Radeon card. It won't work with DRI others than these.
+     it will not work with 3DFX cards because the 256x256 texture size limit.
+
+  Q: I have an nVidia TNT/TNT2 card, and I have a band with strange colours,
+     right under the movie! Whose fault is this?
+  A: It's the nVidia X driver's. These bugs are ONLY with the TNT/TNT2 cards,
+     and we can't do anything about it, it's not our bug.
+
+
+  6.5.  Feature requests
+
+  Q: Is there a hint on how to watch QuickTime and RealMedia movies in MPlayer?
   A: There's no way to do it. Therefore these formats deserve to die in flames.
      Theoretically you can reverse engineer Real codecs built for Linux (they
      are available as .so files), but in practice that's really difficult, even
@@ -1529,22 +1615,8 @@ Table of Contents
      encoded, and that codec is built-in deep in the QT executable, there's
      no way to use it.
 
-  Q: I have an nVidia TNT/TNT2 card, and I have a band with strange colours,
-     right under the movie! Whose fault is this?
-  A: It's the nVidia X driver's. These bugs are ONLY with the TNT/TNT2 cards,
-     and we can't do anything about it, it's not our bug.
 
-  Q: What exactly is this libavcodec?
-  A: It's from Gerard Lantau's ffmpeg package (http://ffmpeg.sourceforge.net).
-     It has C language DivX ;-) and OpenDivX codec.  Some benchmarks
-     showed that its DivX seems to be even faster than DirectShow codec without
-     preprocessing, and only a few percent slower than ProjectMayo's OpenDivX
-     decoder.  It uses YV12 pixel format, so old Voodoo users can use it for YUV.
-     Also, open the possibility to play DivX on virtually every computer that
-     has a C compiler. Kinda great stuff, isn't it?
-
-
-  6.10.  DVD FAQ
+  6.6.  DVD FAQ
 
   Q: I have some problem not mentioned here ...
   A: Read file 'DVD' as well.
@@ -1713,7 +1785,7 @@ Table of Contents
   Appendix A - Authors
 
 NOTE: Do *NOT* send bugreports, help & feature requests directly to the authors!
-===== Read DOCS/BUGREPORTS and subscribe to mplayer-users mailing lists.
+===== Read Appendix C and subscribe to mplayer-users mailing lists.
 
 ========================== The MPlayer project: ===============================
 
@@ -1724,7 +1796,7 @@ NOTE: Do *NOT* send bugreports, help & feature requests directly to the authors!
 - some changes in libmpeg2 code (progressive frames, bitrate & fps support)
 - libvo improvements: adding OpenGL support, bugfix in mga driver...
 - triple buffering & YUY2 support (for DivX/MPEG4) into mga_vid driver 
-- scripts in the TVout directory (TVout on Matrox G400DH, read DOCS/TVout-G400)
+- scripts in the TVout directory (TVout on Matrox G400DH, read documentation)
 - hacking DivX/Mpeg4 VfW codecs to get YUV output
 - opendivx decoder speed optimizations (see opendivx/ChangeLog)
 - OSD & SUB display code
@@ -1780,7 +1852,7 @@ Alex Beregszaszi (Al3x): 
 - vo_ggi output driver in libvo (www.ggi-project.org)
 
 Andreas Ackermann (Acki):  
-- LIRC support (see DOCS/LIRC)
+- LIRC support (see documentation)
 - DGA support in libvo
 
 Felix Bünemann (Atmos): 
@@ -1814,7 +1886,7 @@ German Gomez Garcia: 
 - SPDIF AC3 output for SBLive!  [not yet in the main trunk]
 
 Dariush Pietrzak (Eyck): 
-- debian packaging support (see debian/* and DOCS/DEBIAN)
+- debian packaging support (see debian/* and this documentation)
 - support for vplayer subtitle format
 - prelimenary support for .RT subtitle format
 
@@ -1904,9 +1976,9 @@ the following addresses:
 - MPlayer users list:  
 	http://lists.sourceforge.net/lists/listinfo/mplayer-users
 
-	- send bugreports here (after reading DOCS/BUGS, BUGREPORTS)
+	- send bugreports here (after reading DOCS/BUGS, Appendix C)
 	- send feature requests here (after reading DOCS/TODO)
-	- send user questions here (after reading DOCS/README, INSTALL, FAQ etc)
+	- send user questions here (after reading all this documentation)
 
 - MPlayer & Matrox G200/G400/G450 users:
 	http://lists.sourceforge.net/lists/listinfo/mplayer-matrox