comparison DOCS/documentation.html @ 1500:526047bdda07

*** empty log message ***

1499:c3517acc0497

  If you own a Matrox G200/G400/G450 card, then please see the <A HREF="#2.2.1.6">2.2.1.6</A>
  section in order to gain big speedup. It is important to do these steps
  _before_ compiling <B>MPlayer</B>, otherwise no Matrox-specific support will be
  built.

  Then build <B>MPlayer</B>:


	./configure
	make

  See http://mplayer.sourceforge.net/DOCS/codecs.html for the complete,
  daily updated list!!!

  The most important video codecs:
  - MPEG1 (VCD) and MPEG2 (DVD) video
  - DivX, OpenDivX and other MPEG4 variants
  - Windows Media Video 7 (WMV1) used in .wmv files
  - Intel Indeo codecs (3.1,3.2,4.1,5.0)
  - MJPEG, ASV2 and other hardware formats

  The most important audio codecs:

  ldconfig
  cp decore.h /usr/local/include/


  <B>MPlayer</B> autodetects if OpenDivX is (properly) installed, just compile
  as usual.

  Using it is a bit tricky. As it conflicts with the old OpenDivX (it's API is
  very similar to OpenDivX's), OpenDivX code is disabled, and the OpenDivX
  driver calls this library too.

  Beginning with version 0.4.2 , <A HREF="http://ffmpeg.sourceforge.net">ffmpeg</A> contains an <B>opensource</B> DivX codec,
  which is compatible with the traditional DivX. <B>MPlayer</B> contains this codec,
  and this makes it possible to <B>watch DivX movies on non-x86 platforms!</B>
  To get it compile, you'll need nasm, bison, and flex, above the other
  devel tools. No manual hacking is needed to build it, ./configure detects
  if it can be built. At the moment it doesn't support postprocessing, and
  is under optimization (it's generally a bit faster than the DirectShow
  DivX codec, now).

  In order to use it, refresh your codecs.conf file, and do as the manpage,
  or the example.conf says (the -vfm option).

  Note: libavcodec contains other codecs as well, but at the moment we mostly
        focus on ffdivx.

  <A NAME=2.1.3>2.1.4.  Codec importing howto


  <A NAME=2.1.4.1>2.1.4.1.  VFW codecs

  This is the MP3 codec.
  So, now we have all the info needed (fourcc, codec file, sample AVI), submit
  your codec support request in mail, and upload these files to the FTP:
    ftp://mplayerhq.hu/MPlayer/incoming/<codecname>/


  <A NAME=2.1.4.2>2.1.4.2.  DirectShow codecs

  DirectShow is the newer Video API, which is even worse than its predecessor.

  NOTE : dump that M$ shit.


  So, now we have all the info needed (fourcc, GUID, codec file, sample AVI),
  submit your codec support request in mail, and upload these files to the FTP:
      ftp://mplayerhq.hu/MPlayer/incoming/<codecname>/


  <A NAME=2.2>2.2.  Video & Audio output devices

  There are several commandline switches for SDL:

		-vo sdl:name	specifies sdl video driver to use (ie. aalib,
				dga, x11)
		-ao sdl:name	specifies sdl audio driver to use (ie. dsp,
				esd)
		-noxv		disables Xvideo hardware acceleration
		-forcexv	tries to force Xvideo acceleration

  SDL Keys:

  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 ;))


  NOTE: FBdev video mode changing _does not work_ with the VESA framebuffer,
	and don't ask for it, since it's not an <B>MPlayer</B> limitation.

   button = Tape_Stop
   config = QUIT
  end

  If you don't like the standard location for the lirc-config file (~/.lircrc) 
  use the -lircconf <filename> switch to specify another file.


  <A NAME=3.3>3.3.  Streaming from network or pipes

  <B>MPlayer</B> can play media from network, by using the HTTP protocol, and even

  for 2MB prefetched reading from the file (it's useful for scratched CDROMs).
  It's recommended that you tuneup your CDROM drive also with hdparm :


		hdparm -d1 -a8 -u1 <cdrom device>


  to enable using DMA access, readahead, and IRQ unmasking.
  (if you don't understand these, *read the hdparm manpage*)

  <A NAME=6.1>6.1.  Compilation

  <B>Q: What's the problem with gcc 2.96 ?
  </B>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 <B>MPlayer</B>, because it simply SKIPS MMX codes, it just does not
     compile it. Important: this is NOT an <B>MPlayer</B>-specific problem, numerous
     other projects (DRI, avifile, etc..) have problems with this shit too.
     ** DO NOT USE gcc 2.96 !!! **

  <B>Q: SDL output doesn't work or compile. Problem is ....
  </B>A: It is tested with newest SDL (probably runs on 1.1.7+).
     It does NOT work with 1.1.6, 1.1.5 1.1.4 1.1.3 1.0.4 etc, don't ask.

     Alternatively, try SDL's DGA driver with '-vo sdl:dga' options.

  <B>Q: I can't compile SVGAlib.. I'm using 2.3/2.4 kernel.
  </B>A: You have to edit SVGAlib's Makefile.cfg and comment "BACKGROUND = y" out.

  <B>Q: I compiled <B>MPlayer</B> with libcss support, but when I try to start
        it, it says :
	  > error while loading shared libraries: libcss.so.0: cannot load
	  > shared object file: No such file or directory
	I checked up on the file and it IS there in /usr/local/lib.
  </B>A: What are you doing on Linux? Can't you install a library? Why do
    we get these questions? It's not <B>MPlayer</B> specific at all! Add
    /usr/local/lib to <B>/etc/ld.so.conf</B> and run <B>ldconfig</B> .

  <A NAME=6.2>6.2.  General questions

  <B>Q: What about DVD playback?
  </B>A: Read files 'DVD' and 'DVD-FAQ'.

  To run <B>MPlayer</B> you will need to re-compile the kernel with 
  "options USER_LDT" (unless you are running -CURRENT, where this is default).

  If <B>MPlayer</B> complains about "CD-ROM Device '/dev/cdrom' not found!" make a 
  symbolic link : ln -s /dev/<your_cdrom_device> /dev/cdrom 

  There's no DVD support for FreeBSD yet. 
  Feel free to add it :-)

   % gmake
   ...
   gcc -c -Iloader -Ilibvo -O4 -march=i686 -mcpu=i686 -pipe -ffast-math 
	-fomit-frame-pointer  -I/usr/local/include   -o mplayer.o mplayer.c
   Assembler: mplayer.c
   "<stdin>", line 3567 : Illegal mnemonic
   "<stdin>", line 3567 : Syntax error
   ... more "Illegal mnemonic" and "Syntax error" errors ...


  For DVD support you must have the patched libcss installed. Patch:
  http://www.tools.de/solaris/mplayer/

1500:526047bdda07

  If you own a Matrox G200/G400/G450 card, then please see the <A HREF="#2.2.1.6">2.2.1.6</A>
  section in order to gain big speedup. It is important to do these steps
  _before_ compiling <B>MPlayer</B>, otherwise no Matrox-specific support will be
  built.

  If you plan to use the ProjectMayo's <B>OpenDivX</B> codec, check the
  <A HREF="#2.1.2.1">2.1.2.1</A> section before compiling.

  Then build <B>MPlayer</B>:


	./configure
	make

  See http://mplayer.sourceforge.net/DOCS/codecs.html for the complete,
  daily updated list!!!

  The most important video codecs:
  - MPEG1 (VCD) and MPEG2 (DVD) video
  - DivX, FFmpeg, OpenDivX and other MPEG4 variants
  - Windows Media Video 7 (WMV1) used in .wmv files
  - Intel Indeo codecs (3.1,3.2,4.1,5.0)
  - MJPEG, ASV2 and other hardware formats

  The most important audio codecs:

  ldconfig
  cp decore.h /usr/local/include/


  <B>MPlayer</B> autodetects if OpenDivX is (properly) installed, just compile
  as usual. If it doesn't detect it, you didn't install it exactly as above,
  and/or has fucked up config (see last question of 6.1 section).

  Using it is a bit tricky. As it conflicts with the old OpenDivX (it's API is
  very similar to OpenDivX's), OpenDivX code is disabled, and the OpenDivX
  driver calls this library too.

  Beginning with version 0.4.2 , <A HREF="http://ffmpeg.sourceforge.net">ffmpeg</A> contains an <B>opensource</B> DivX codec,
  which is compatible with the traditional DivX. <B>MPlayer</B> contains this codec,
  and this makes it possible to <B>watch DivX movies on non-x86 platforms!</B>
  To get it compile, you'll need nasm, bison, and flex, above the other
  devel tools. It was removed from <B>MPlayer</B>'s cvs tree, you have
  to download it manually directly from <B>FFmpeg</B>'s tree :


  cvs -d:pserver:[e-mail]:/cvsroot/ffmpeg login
  cvs -d:pserver:[e-mail]:/cvsroot/ffmpeg co ffmpeg


  Note: if you copy with CVS subdirs, next time it's enough to do
	'cvs update'.

  Now, move the newly downloaded ffmpeg source's <B>libavcodec</B> directory,
  (with all it's subdirectories) to <B>MPlayer</B>'s tree, so it will look
  like this :


		main/libavcodec


  Symlinking is NOT enough, you have to copy it.

  ./configure detects if it can be built. At the moment it doesn't support
  postprocessing, and is under optimization (it's faster than the DS/VfW DivX
  codec).

  In order to use it, refresh your codecs.conf file, and do as the manpage,
  or the example.conf says (the -vfm option).

  Note: libavcodec contains other codecs as well, but at the moment we mostly
        focus on ffdivx, and it's unlikely that this will change.

  <A NAME=2.1.3>2.1.4.  Codec importing howto


  <A NAME=2.1.4.1>2.1.4.1.  VFW codecs

  This is the MP3 codec.
  So, now we have all the info needed (fourcc, codec file, sample AVI), submit
  your codec support request in mail, and upload these files to the FTP:
    ftp://mplayerhq.hu/MPlayer/incoming/[codecname]/


  <A NAME=2.1.4.2>2.1.4.2.  DirectShow codecs

  DirectShow is the newer Video API, which is even worse than its predecessor.

  NOTE : dump that M$ shit.


  So, now we have all the info needed (fourcc, GUID, codec file, sample AVI),
  submit your codec support request in mail, and upload these files to the FTP:
      ftp://mplayerhq.hu/MPlayer/incoming/[codecname]/


  <A NAME=2.2>2.2.  Video & Audio output devices

  There are several commandline switches for SDL:

		-vo sdl:name	specifies sdl video driver to use (ie. aalib,
				dga, x11)
		-ao sdl:name	specifies sdl audio driver to use (ie. dsp,
				esd, arts)
		-noxv		disables Xvideo hardware acceleration
		-forcexv	tries to force Xvideo acceleration

  SDL Keys:

  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 ;))

  The FBdev output takes some additional parameters above the others:

	-fb		specify the framebuffer device to use (/dev/fd0)
	-fbmode		mode name to use (according to /etc/fb.modes)
	-fbmodeconfig	config file of modes (default /etc/fb.modes)
	monitor_hfreq
	monitor_vfreq		IMPORTANT values, see example.conf
	monitor_dotclock

  If you want to change to a specific mode, then use

	mplayer -vm -fbmode (NameOfMode) filename

  -vm alone will choose the most suitable mode from /etc/fb.modes . Can be
  used together with -x and -y options too. The -flip option is supported only
  if the movie's pixel format matches the video mode's pixel format.
  Pay attention to the bpp value, fbdev driver tries to use the current,
  or if you specify the -bpp option, then that.
  -zoom option isn't supported (software scaling is slow). -fs option
  isn't supported. You can't use 8bpp (or less) modes.

  NOTE: FBdev video mode changing _does not work_ with the VESA framebuffer,
	and don't ask for it, since it's not an <B>MPlayer</B> limitation.

   button = Tape_Stop
   config = QUIT
  end

  If you don't like the standard location for the lirc-config file (~/.lircrc) 
  use the -lircconf [filename] switch to specify another file.


  <A NAME=3.3>3.3.  Streaming from network or pipes

  <B>MPlayer</B> can play media from network, by using the HTTP protocol, and even

  for 2MB prefetched reading from the file (it's useful for scratched CDROMs).
  It's recommended that you tuneup your CDROM drive also with hdparm :


		hdparm -d1 -a8 -u1 (cdrom device)


  to enable using DMA access, readahead, and IRQ unmasking.
  (if you don't understand these, *read the hdparm manpage*)

  <A NAME=6.1>6.1.  Compilation

  <B>Q: What's the problem with gcc 2.96 ?
  </B>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 <B>MPlayer</B>, because it simply SKIPS MMX codes, it just does
     not compile it. Important: this is NOT an <B>MPlayer</B>-specific problem,
     numerous other projects (DRI, avifile, etc..) have problems with this shit
     too.
     ** DO NOT USE gcc 2.96 !!! **

  <B>Q: Great, I have gcc 3.0.1 from RedHat/Mandrake, then I'm fine--!
  </B>A: No :) Their gcc 3.0.1 was compiled with gcc 2.96, so they are
     buggy shit too.

  <B>Q: Now then. What should I use?
  </B>A: Any of gcc 2.95 series.

  <B>Q: SDL output doesn't work or compile. Problem is ....
  </B>A: It is tested with newest SDL (probably runs on 1.1.7+).
     It does NOT work with 1.1.6, 1.1.5 1.1.4 1.1.3 1.0.4 etc, don't ask.

     Alternatively, try SDL's DGA driver with '-vo sdl:dga' options.

  <B>Q: I can't compile SVGAlib.. I'm using 2.3/2.4 kernel.
  </B>A: You have to edit SVGAlib's Makefile.cfg and comment "BACKGROUND = y" out.

  <B>Q: I compiled <B>MPlayer</B> with libcss/libdivxdecore support, but when
	I try to start it, it says :
	  > error while loading shared libraries: libcss.so.0: cannot load
	  > shared object file: No such file or directory
	I checked up on the file and it IS there in /usr/local/lib.
  </B>A: What are you doing on Linux? Can't you install a library? Why do
    we get these questions? It's not <B>MPlayer</B> specific at all! Add
    /usr/local/lib to <B>/etc/ld.so.conf</B> and run <B>ldconfig</B> .
    Or install it to /usr/lib , because if you can't solve the /usr/local
    problem, you are careless enough to do such things.

  <A NAME=6.2>6.2.  General questions

  <B>Q: What about DVD playback?
  </B>A: Read files 'DVD' and 'DVD-FAQ'.

  To run <B>MPlayer</B> you will need to re-compile the kernel with 
  "options USER_LDT" (unless you are running -CURRENT, where this is default).

  If <B>MPlayer</B> complains about "CD-ROM Device '/dev/cdrom' not found!" make a 
  symbolic link : ln -s /dev/(your_cdrom_device) /dev/cdrom 

  There's no DVD support for FreeBSD yet. 
  Feel free to add it :-)

   % gmake
   ...
   gcc -c -Iloader -Ilibvo -O4 -march=i686 -mcpu=i686 -pipe -ffast-math 
	-fomit-frame-pointer  -I/usr/local/include   -o mplayer.o mplayer.c
   Assembler: mplayer.c
   "(stdin)", line 3567 : Illegal mnemonic
   "(stdin)", line 3567 : Syntax error
   ... more "Illegal mnemonic" and "Syntax error" errors ...


  For DVD support you must have the patched libcss installed. Patch:
  http://www.tools.de/solaris/mplayer/