comparison DOCS/documentation.html @ 1668:a5cb1b1d47a8

*** empty log message ***

1667:6a227dc19dec

</P>
<P>
  <A HREF="#2">2. Features</A>
</P>
<P>
     <A HREF="codecs.html">2.1 Video Formats, Audio & Video Codecs</A>
	<A HREF="codecs.html#2.1.1">2.1.1 Supported input formats</A>
        <A HREF="codecs.html#2.1.2">2.1.2 Supported audio & video codecs</A>
	     <A HREF="codecs.html#2.1.2.1">2.1.2.1 DivX4</A>
	     <A HREF="codecs.html#2.1.2.2">2.1.2.2 ffmpeg's DivX/libavcodec</A>
	<A HREF="codecs.html#2.1.4">2.1.4 Codec importing howto</A>
	     <A HREF="codecs.html#2.1.4.1">2.1.4.1 VFW codecs</A>
	     <A HREF="codecs.html#2.1.4.2">2.1.4.2 DirectShow codecs</A>
</P>
<P>
     <A HREF="video.html">2.2 Video & Audio output devices</A>
	<A HREF="video.html#2.2.1">2.2.1 Video output devices</A>
	     <A HREF="video.html#2.2.1.1">2.2.1.1 MTRR</A>
	     <A HREF="video.html#2.2.1.2">2.2.1.2 Xv</A>
		    <A HREF="video.html#2.2.1.2.1">2.2.1.2.1 3dfx cards</A>
		    <A HREF="video.html#2.2.1.2.2">2.2.1.2.2 S3 cards</A>

	     <A HREF="video.html#2.2.1.3">2.2.3.2 DGA</A>
		    <A HREF="video.html#2.2.1.3.1">2.2.1.3.1 Summary</A>
		    <A HREF="video.html#2.2.1.3.2">2.2.1.3.2 What is DGA</A>
		    <A HREF="video.html#2.2.1.3.3">2.2.1.3.3 Installing DGA support for MPlayer</A>
		    <A HREF="video.html#2.2.1.3.4">2.2.1.3.4 Resolution switching</A>
		    <A HREF="video.html#2.2.1.3.5">2.2.1.3.5 DGA & MPlayer</A>
		    <A HREF="video.html#2.2.1.3.6">2.2.1.3.6 Features of the DGA driver</A>
		    <A HREF="video.html#2.2.1.3.7">2.2.1.3.7 Speed issues</A>
		    <A HREF="video.html#2.2.1.3.8">2.2.1.3.8 Known bugs</A>
		    <A HREF="video.html#2.2.1.3.9">2.2.1.3.9 Future work</A>
		    <A HREF="video.html#2.2.1.3.A">2.2.1.3.A Some modelines</A>

</P>
</PRE>
<P><HR></P>

<P><PRE>
  <A NAME=1>1.  Introduction


  <A NAME=1.1>1.1.  Overview

  <B>MPlayer</B> is a movie player for LINUX. It plays most MPEG, AVI and ASF files,
  supported by many native and Win32 DLL codecs. You can watch VCD, DVD and
  even DivX movies too. The another big feature of mplayer is the wide range of
  supported output drivers. It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev,

  you can rebuild their indexes with the -idx option, thus enabling seeking!
  As you see, stability and quality are the most important things for me,
  but the speed is also amazing.


  <A NAME=1.2>1.2.  History

  This began a year ago...
  I've tried lots of players under linux (mtv,xmps,dvdview,livid/oms,VideoLAN,
  xine,xanim,avifile,xmmp) but they all have some problem. Mostly with special
  files or with audio/video sync. Most of them is unable to play both MPEG1,

    but there were image quality and speed problems with it.
  - mpg12play v0.5-v0.87:
    Mpeg codec replaced with DVDview by Dirk Farin, it was a great stuff,
    but it was slow and was written in C++ (I hate C++!!!)
  - mpg12play v0.9-v0.95pre5:
    Mpeg codec was libmpeg2 (mpeg2dec) by Aaron Holtzman & Michel Lespinasse.
    It's great, optimized very fast C code with perfect image quality and
    100% MPEG standard conformance.
  - <B>MPlayer</B> v0.3-v0.9:
    It was a pack of two programs: mpg12playv0.95pre6 and my new simple AVI
    player 'avip' based on avifile's Win32 DLL loader.

    2 months since 0.17 and here's a new release.. Completed ASF support,
    more subtitle formats, introduced libao (similar to libvo but to audio),
    even more stable than ever, and so on. It's a MUST !  


  <A NAME=1.3>1.3.  Installation

  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 .
  Note: the avifile project has similar codecs package, but it differs
  from our, so if you want to use all supported codecs, then use

	cd ~/.mplayer/font
	unzip mp_font3.zip
	unzip mp_font3_hu.zip


  <A NAME=1.4>1.4.  What about the GUI ?

  I'm not a GUI programmer. I hate GUIs, I like the pure black 80x25 console.
  So the player has only keyboard control from the controlling console/xterm now.
  There is a GUI development for the player, coordinated by Pontscho/Fresh!
  It's still under development, but it will be merged and released real soon.
  BTW he needs some nice skins, if you are a good graphician, contact him!!!


  <A NAME=2>2.  Features


  <A NAME=2.1>2.1.  <A HREF="codecs.html">Video Formats, Audio & Video Codecs</A>


  <A NAME=2.2>2.2.  <A HREF="video.html">Video</A> & <A HREF="sound.html">Audio</A> output devices


  <A NAME=3>3.  Usage

  file:  mplayer [options] [path/]filename
  VCD:   mplayer [options] -vcd trackno /dev/cdrom
  DVD:   mplayer [options] -dvdauth /dev/dvd filename.VOB
  net:   mplayer [options] http://site.com/file.[mpg|avi]

  mplayer -afm 3 /mnt/DVDtrailers/alien4.vob
  mplayer -dvd /dev/dvd /mnt/dvd/matrix.vob 
  mplayer -abs 65536 -delay -0.4 -nobps ~/movies/test.avi


  <A NAME=3.1>3.1.  Control from keyboard


    <-  or  ->          seek backward/forward  10 seconds
    up or down          seek backward/forward   1 minute
    pgup/pgdown         seek backward/forward  10 minutes

    3 or 4              adjust brightness
    5 or 6              adjust ?
    7 or 8              adjust saturation   
   

  <A NAME=3.2>3.2.  Control from LIRC

  Linux Infrared Remote Control - use an easy to build home-brewn IR-receiver, 
  an (almost) arbitrary remote control and control your linux box with it!
  More about it at www.lirc.org.

  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
  beta ASF streaming (FROM network) is available.
  Configuring it is simple, just recompile <B>MPlayer</B> with

        wget ftp://micorsops.com/something.avi -O - | mplayer -


  <A NAME=4>4.  <A HREF="faq.html">FAQ section</A>


  <A NAME=5>5.  <A HREF="cd-dvd.html">CD/DVD section</A>


  <A NAME=6>6. Misc OS'es


  <A NAME=6.1>6.1.  Debian packaging

  To build the package, get the cvs version, or .tgz and uncompress it,
  and cd into programs directory:

	Preparing to replace mplayer 0.17a-1 (using ../mplayer_0.18-1_i386.deb)
	Unpacking replacement mplayer ...
	Setting up mplayer (0.18-1) ...


  <A NAME=6.2>6.2.  FreeBSD

  To build the package you will need GNU make (gmake, /usr/ports/devel/gmake), 
  native BSD make will not work.

  To run <B>MPlayer</B> you will need to re-compile the kernel with 

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


  <A NAME=6.3>6.3.  Solaris 8

  AVI file playback works best on Solaris x86, because you have the
  option to use the win32 codecs on the x86 platform.  On Solaris SPARC,
  you'll find quite a few AVI files with non working video and/or
  audio playback, because the video/audio codecs using the win32 DLLs

     ISO9660), hsfs currently does not support partitions/disks >4GB,
     all data is accessed modulo 4GB
     (http://groups.yahoo.com/group/solarisonintel/message/22592)


  <A NAME=6.4>6.4.  StrongARM

  <B>MPlayer</B> is reported to compile on StrongARM. Use the following command line:


  ./configure --target=arm-linux --disable-css --with-x11libdir=/usr/arm/lib
	      --with-x11incdir=/usr/arm/lib --disable-gcc-checking


  <A NAME=A>Appendix A - Authors

NOTE: Do *NOT* send bugreports, help & feature requests directly to the authors!
===== Read Appendix <A HREF="#C">C</A> and subscribe to mplayer-users mailing lists.

========================== The <B>MPlayer</B> project: ===============================

Árpád Gereöffy (A'rpi/ESP-team):  [[e-mail]]
- player code (mpeg stream demultiplexer and avi/asf parser, A-V sync, seek...)
- mp3lib, based on mpglib sources  [MP3 audio decoder]
- getch2  [keyboard handler]
- 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 documentation)
- hacking DivX/Mpeg4 VfW codecs to get YUV output
- opendivx decoder speed optimizations (see opendivx/ChangeLog)
- OSD & SUB display code
- ffmpeg/libavcodec integration
- DivX4Linux (ProjectMayo) support (see documentation)

Zoltán Ponekker (Pontscho/Fresh!):  [[e-mail]] 
- configure script and Makefiles for easy compile

- various X11 cleanups and fixes

Gábor Bérczi (Gabucino):  [[e-mail]]
- documentation maintainer
- hungarian translation of documentation
- second webpage design&gfx
- webpage maintainer
- testing, codecs quality & speed comparsions
- IRC channel #<B>MPlayer</B> operator
  (devel channel, users earn kickban)
- experimental MINIX port

Szabolcs Berecz (Szabi): [[e-mail]]

- SUB reader
- screensaver+DPMS disable for libvo

Gyula László (Chass, Tégla): [[e-mail]]
- first fonts (mp_font1.zip)
- third (current) homepage design&gfx

Zoltán Márk Vicián (Se7en): [[e-mail]]
- SVGAlib support in libvo

Alex Beregszaszi (Al3x): [[e-mail]]

- patched <B>MPlayer</B> to work on FreeBSD x86

Bertrand BAUDET: [[e-mail]]
- network streaming support

Artur Zaprzala: <[e-mail]>
- Complete font generator prog + OSD font (TOOLS/subfont-c)

[e-mail]:
- GIMP font generator plugin (TOOLS/subfont-gimp)

Adam Williams:   [[e-mail]]
- libmpeg3 (and xmovie) author  [MPEG1/MPEG2 video decoder, used in v0.1-v0.4]


  <A NAME=B>Appendix B - Mailing lists

  There are some public mailing lists on <B>MPlayer</B>. Subscribing can be
  achieved on the following addresses:

  - <B>MPlayer</B> core/hungarian developers list:

	- send bugreports here (after reading DOCS/BUGS, Appendix <A HREF="#C">C</A>)
	- send feature requests here (after reading DOCS/TODO)
	- send user questions here (after reading all this documentation)

  - <B>MPlayer</B> & Matrox G200/G400/G450 users:
	http://lists.sourceforge.net/lists/listinfo/mplayer-matrox

	Send matrox-related questions here,
	- things about mga_vid,
	- matrox's official beta drivers (for X 4.x.x)

  NOTE: language of above lists are ENGLISH, unless explicitly stated
        otherwise.  Please do not send messages using other language!


  <A NAME=C><A HREF="bugreports.html">Appendix C</A> - How to report bugs

</PRE>

</BODY>

1668:a5cb1b1d47a8

</P>
<P>
  <A HREF="#2">2. Features</A>
</P>
<P>
     <A HREF="codecs.html">2.1 Video Formats, Audio &amp; Video Codecs</A>
	<A HREF="codecs.html#2.1.1">2.1.1 Supported input formats</A>
        <A HREF="codecs.html#2.1.2">2.1.2 Supported audio &amp; video codecs</A>
	     <A HREF="codecs.html#2.1.2.1">2.1.2.1 DivX4</A>
	     <A HREF="codecs.html#2.1.2.2">2.1.2.2 ffmpeg's DivX/libavcodec</A>
	     <A HREF="codecs.html#2.1.2.3">2.1.2.3 Hardware AC3 decoding</A>
	<A HREF="codecs.html#2.1.4">2.1.4 Codec importing howto</A>
	     <A HREF="codecs.html#2.1.4.1">2.1.4.1 VFW codecs</A>
	     <A HREF="codecs.html#2.1.4.2">2.1.4.2 DirectShow codecs</A>
</P>
<P>
     <A HREF="video.html">2.2 Video &amp; Audio output devices</A>
	<A HREF="video.html#2.2.1">2.2.1 Video output devices</A>
	     <A HREF="video.html#2.2.1.1">2.2.1.1 MTRR</A>
	     <A HREF="video.html#2.2.1.2">2.2.1.2 Xv</A>
		    <A HREF="video.html#2.2.1.2.1">2.2.1.2.1 3dfx cards</A>
		    <A HREF="video.html#2.2.1.2.2">2.2.1.2.2 S3 cards</A>

	     <A HREF="video.html#2.2.1.3">2.2.3.2 DGA</A>
		    <A HREF="video.html#2.2.1.3.1">2.2.1.3.1 Summary</A>
		    <A HREF="video.html#2.2.1.3.2">2.2.1.3.2 What is DGA</A>
		    <A HREF="video.html#2.2.1.3.3">2.2.1.3.3 Installing DGA support for MPlayer</A>
		    <A HREF="video.html#2.2.1.3.4">2.2.1.3.4 Resolution switching</A>
		    <A HREF="video.html#2.2.1.3.5">2.2.1.3.5 DGA &amp; MPlayer</A>
		    <A HREF="video.html#2.2.1.3.6">2.2.1.3.6 Features of the DGA driver</A>
		    <A HREF="video.html#2.2.1.3.7">2.2.1.3.7 Speed issues</A>
		    <A HREF="video.html#2.2.1.3.8">2.2.1.3.8 Known bugs</A>
		    <A HREF="video.html#2.2.1.3.9">2.2.1.3.9 Future work</A>
		    <A HREF="video.html#2.2.1.3.A">2.2.1.3.A Some modelines</A>

</P>
</PRE>
<P><HR></P>

<P><PRE>
  <A NAME=1>1.  Introduction</A>


  <A NAME=1.1>1.1.  Overview</A>

  <B>MPlayer</B> is a movie player for LINUX. It plays most MPEG, AVI and ASF files,
  supported by many native and Win32 DLL codecs. You can watch VCD, DVD and
  even DivX movies too. The another big feature of mplayer is the wide range of
  supported output drivers. It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev,

  you can rebuild their indexes with the -idx option, thus enabling seeking!
  As you see, stability and quality are the most important things for me,
  but the speed is also amazing.


  <A NAME=1.2>1.2.  History</A>

  This began a year ago...
  I've tried lots of players under linux (mtv,xmps,dvdview,livid/oms,VideoLAN,
  xine,xanim,avifile,xmmp) but they all have some problem. Mostly with special
  files or with audio/video sync. Most of them is unable to play both MPEG1,

    but there were image quality and speed problems with it.
  - mpg12play v0.5-v0.87:
    Mpeg codec replaced with DVDview by Dirk Farin, it was a great stuff,
    but it was slow and was written in C++ (I hate C++!!!)
  - mpg12play v0.9-v0.95pre5:
    Mpeg codec was libmpeg2 (mpeg2dec) by Aaron Holtzman & Michel Lespinasse.
    It's great, optimized very fast C code with perfect image quality and
    100% MPEG standard conformance.
  - <B>MPlayer</B> v0.3-v0.9:
    It was a pack of two programs: mpg12playv0.95pre6 and my new simple AVI
    player 'avip' based on avifile's Win32 DLL loader.

    2 months since 0.17 and here's a new release.. Completed ASF support,
    more subtitle formats, introduced libao (similar to libvo but to audio),
    even more stable than ever, and so on. It's a MUST !  


  <A NAME=1.3>1.3.  Installation</A>

  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 .
  Note: the avifile project has similar codecs package, but it differs
  from our, so if you want to use all supported codecs, then use

	cd ~/.mplayer/font
	unzip mp_font3.zip
	unzip mp_font3_hu.zip


  <A NAME=1.4>1.4.  What about the GUI ?</A>

  I'm not a GUI programmer. I hate GUIs, I like the pure black 80x25 console.
  So the player has only keyboard control from the controlling console/xterm now.
  There is a GUI development for the player, coordinated by Pontscho/Fresh!
  It's still under development, but it will be merged and released real soon.
  BTW he needs some nice skins, if you are a good graphician, contact him!!!


  <A NAME=2>2.  Features</A>


  <A NAME=2.1>2.1.  <A HREF="codecs.html">Video Formats, Audio &amp; Video Codecs</A></A>


  <A NAME=2.2>2.2.  <A HREF="video.html">Video</A> &amp; <A HREF="sound.html">Audio</A> output devices</A>


  <A NAME=3>3.  Usage</A>

  file:  mplayer [options] [path/]filename
  VCD:   mplayer [options] -vcd trackno /dev/cdrom
  DVD:   mplayer [options] -dvdauth /dev/dvd filename.VOB
  net:   mplayer [options] http://site.com/file.[mpg|avi]

  mplayer -afm 3 /mnt/DVDtrailers/alien4.vob
  mplayer -dvd /dev/dvd /mnt/dvd/matrix.vob 
  mplayer -abs 65536 -delay -0.4 -nobps ~/movies/test.avi


  <A NAME=3.1>3.1.  Control from keyboard</A>


    <-  or  ->          seek backward/forward  10 seconds
    up or down          seek backward/forward   1 minute
    pgup/pgdown         seek backward/forward  10 minutes

    3 or 4              adjust brightness
    5 or 6              adjust ?
    7 or 8              adjust saturation   
   

  <A NAME=3.2>3.2.  Control from LIRC</A>

  Linux Infrared Remote Control - use an easy to build home-brewn IR-receiver, 
  an (almost) arbitrary remote control and control your linux box with it!
  More about it at www.lirc.org.

  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</A>

  <B>MPlayer</B> can play media from network, by using the HTTP protocol, and even
  beta ASF streaming (FROM network) is available.
  Configuring it is simple, just recompile <B>MPlayer</B> with

        wget ftp://micorsops.com/something.avi -O - | mplayer -


  <A NAME=4>4.  <A HREF="faq.html">FAQ section</A></A>


  <A NAME=5>5.  <A HREF="cd-dvd.html">CD/DVD section</A></A>


  <A NAME=6>6. Misc OS'es</A>


  <A NAME=6.1>6.1.  Debian packaging</A>

  To build the package, get the cvs version, or .tgz and uncompress it,
  and cd into programs directory:

	Preparing to replace mplayer 0.17a-1 (using ../mplayer_0.18-1_i386.deb)
	Unpacking replacement mplayer ...
	Setting up mplayer (0.18-1) ...


  <A NAME=6.2>6.2.  FreeBSD</A>

  To build the package you will need GNU make (gmake, /usr/ports/devel/gmake), 
  native BSD make will not work.

  To run <B>MPlayer</B> you will need to re-compile the kernel with 

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


  <A NAME=6.3>6.3.  Solaris 8</A>

  AVI file playback works best on Solaris x86, because you have the
  option to use the win32 codecs on the x86 platform.  On Solaris SPARC,
  you'll find quite a few AVI files with non working video and/or
  audio playback, because the video/audio codecs using the win32 DLLs

     ISO9660), hsfs currently does not support partitions/disks >4GB,
     all data is accessed modulo 4GB
     (http://groups.yahoo.com/group/solarisonintel/message/22592)


  <A NAME=6.4>6.4.  StrongARM</A>

  <B>MPlayer</B> is reported to compile on StrongARM. Use the following command line:


  ./configure --target=arm-linux --disable-css --with-x11libdir=/usr/arm/lib
	      --with-x11incdir=/usr/arm/lib --disable-gcc-checking


  <A NAME=A>Appendix A - Authors</A>

NOTE: Do *NOT* send bugreports, help &amp; feature requests directly to the authors!
===== Read Appendix <A HREF="#C">C</A> and subscribe to mplayer-users mailing lists.

========================== The <B>MPlayer</B> project: ===============================

Árpád Gereöffy (A'rpi/ESP-team):  [[e-mail]]
- player code (mpeg stream demultiplexer and avi/asf parser, A-V sync, seek...)
- mp3lib, based on mpglib sources  [MP3 audio decoder]
- getch2  [keyboard handler]
- some changes in libmpeg2 code (progressive frames, bitrate &amp; fps support)
- libvo improvements: adding OpenGL support, bugfix in mga driver...
- triple buffering &amp; YUY2 support (for DivX/MPEG4) into mga_vid driver 
- 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 &amp; SUB display code
- ffmpeg/libavcodec integration
- DivX4Linux (ProjectMayo) support (see documentation)

Zoltán Ponekker (Pontscho/Fresh!):  [[e-mail]] 
- configure script and Makefiles for easy compile

- various X11 cleanups and fixes

Gábor Bérczi (Gabucino):  [[e-mail]]
- documentation maintainer
- hungarian translation of documentation
- second webpage design&gfx
- webpage maintainer
- testing, codecs quality & speed comparsions
- IRC channel #<B>MPlayer</B> operator
  (devel channel, users earn kickban)
- experimental MINIX port

Szabolcs Berecz (Szabi): [[e-mail]]

- SUB reader
- screensaver+DPMS disable for libvo

Gyula László (Chass, Tégla): [[e-mail]]
- first fonts (mp_font1.zip)
- third (current) homepage design&gfx

Zoltán Márk Vicián (Se7en): [[e-mail]]
- SVGAlib support in libvo

Alex Beregszaszi (Al3x): [[e-mail]]

- patched <B>MPlayer</B> to work on FreeBSD x86

Bertrand BAUDET: [[e-mail]]
- network streaming support

Artur Zaprzala: [[e-mail]]
- Complete font generator prog + OSD font (TOOLS/subfont-c)

[e-mail]:
- GIMP font generator plugin (TOOLS/subfont-gimp)

Adam Williams:   [[e-mail]]
- libmpeg3 (and xmovie) author  [MPEG1/MPEG2 video decoder, used in v0.1-v0.4]


  <A NAME=B>Appendix B - Mailing lists</A>

  There are some public mailing lists on <B>MPlayer</B>. Subscribing can be
  achieved on the following addresses:

  - <B>MPlayer</B> core/hungarian developers list:

	- send bugreports here (after reading DOCS/BUGS, Appendix <A HREF="#C">C</A>)
	- send feature requests here (after reading DOCS/TODO)
	- send user questions here (after reading all this documentation)

  - <B>MPlayer</B> &amp; Matrox G200/G400/G450 users:
	http://lists.sourceforge.net/lists/listinfo/mplayer-matrox

	Send matrox-related questions here,
	- things about mga_vid,
	- matrox's official beta drivers (for X 4.x.x)

  NOTE: language of above lists are ENGLISH, unless explicitly stated
        otherwise.  Please do not send messages using other language!


  <A NAME=C><A HREF="bugreports.html">Appendix C</A> - How to report bugs</A>

</PRE>

</BODY>