comparison DOCS/documentation.html @ 6583:4b7d097a9c69

big update

6582:f98313dcd428

              <LI><A HREF="codecs.html#2.2.1.5">2.2.1.5 MPEG1/2 video</A></LI>
              <LI><A HREF="codecs.html#2.2.1.6">2.2.1.6 MS Video1</A></LI>
              <LI><A HREF="codecs.html#2.2.1.7">2.2.1.7 Cinepak CVID</A></LI>
              <LI><A HREF="codecs.html#2.2.1.8">2.2.1.8 RealVideo</A></LI>
              <LI><A HREF="codecs.html#2.2.1.9">2.2.1.9 XViD</A></LI>
            </UL>
          </LI>
          <LI><A HREF="codecs.html#2.2.2">2.2.2 Audio</A>
            <UL>
              <LI><A HREF="codecs.html#2.2.2.1">2.2.2.1 Software AC3 decoding</A></LI>

              <LI><A HREF="video.html#2.3.1.9">2.3.1.9 3dfx YUV support (tdfxfb)</A></LI>
              <LI><A HREF="video.html#2.3.1.10">2.3.1.10 OpenGL output</A></LI>
              <LI><A HREF="video.html#2.3.1.11">2.3.1.11 AAlib - text mode displaying</A></LI>
              <LI><A HREF="video.html#2.3.1.12">2.3.1.12 VESA - output to VESA BIOS</A></LI>
              <LI><A HREF="video.html#2.3.1.13">2.3.1.13 X11</A></LI>
              <LI><A HREF="video.html#2.3.1.15">2.3.1.14 Rage128 / Radeon video overlay (OBSOLETED - link to Vidix!)</A></LI>
              <LI><A HREF="video.html#2.3.1.15">2.3.1.15 Vidix</A></LI>
              <LI><A HREF="video.html#2.3.1.16">2.3.1.16 Zr (for some MJPEG capture/playback boards)</A></LI>
              <LI><A HREF="video.html#2.3.1.A">2.3.1.A TVout</A>
                <UL>
                  <LI><A HREF="video.html#2.3.1.A.1">2.3.1.A.1 Matrox G400</A></LI>

  can't. A healthy quantity of combining ability is welcomed, though.
  Good luck. You'll need it :) And for another good advice, let me quote
  Chris Phillips from the <B>mplayer-users</B> mailing list:</P>

<P><I>"I said a while ago that there is such a difference between a newbie and
  a dumbass. No matter what you actaully know about a system (linux, cars,
  girls :D) you should ALWAYS be able to take a step back and be objective,
  otherwise, you're just dumb IMHO. A girl i live with assumed the vacuum
  cleaner was broken because it didn't suck things up. never thought to change
  the bag, becasue she'd never done it before... now that's just stupid, not a
  case of simply not knowing what to do... Simply not being that familiar with

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

<P><B>MPlayer</B> is a movie player for LINUX (runs on many other Unices, and
<B>non-x86</B> CPUs, see <A HREF="#6">section 6</A>). It plays most MPEG, VOB,
AVI, OGG, VIVO, ASF/WMV, QT/MOV, FLI, RM, NuppelVideo, yuv4mpeg, FILM, RoQ
files, supported by many native, XAnim, and
Win32 DLL codecs. You can watch <B>VideoCD</B>, <B>SVCD</B>, <B>DVD</B>,
<B>3ivx</B>, and even <B>DivX</B> movies too (and you don't need the avifile
library at all!). The another big feature of mplayer is the wide range of
supported output drivers. It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev,
AAlib, DirectFB, but you can use GGI and SDL (and this way all their drivers)
and some lowlevel card-specific drivers (for Matrox, 3Dfx and Radeon) too! Most
of them supports software or hardware scaling, so you can enjoy movies in
fullscreen. <B>MPlayer</B> supports displaying through some hardware MPEG
decoder boards, such as the <B><A HREF="DVB">DVB</A></B> and <B> <A
HREF="DXR3">DXR3/Hollywood+</A></B> ! And what about the nice big antialiased
shaded subtitles (<B>10 supported types!!!</B>) with european/ISO 8859-1,2
(Hungarian, English, Czech, etc), Cyrillic, Korean fonts, and the onscreen
display (OSD)?</P>

<P><B>MPlayer</B> is under GPL v2 license.</P>

<P>My player is rock solid playing damaged MPEG files (useful for some VCDs),
and it plays bad AVI files which are unplayable with the famous
windows media player. Even AVI files without index chunk are playable, and
you can temporarily rebuild their indexes with the -idx option, or
permanently with <B>MEncoder</B>, thus enabling seeking!
As you see, stability and quality are the most important things,
but the speed is also amazing.</P>

    codecs and much more. Try it!</LI>
<LI><B>MPlayer 0.60 "The RTFMCounter"</B> Jan 3, 2002<BR>
    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> May? ??, 2002<BR>
    </LI>
</UL>

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

differs from ours, so if you want to use all supported codecs, then use our
package! However, you can use our codecs package with avifile. Features:<BR>
<UL>
  <LI>you need this if you want to play or encode for example movies recorded
  with various hardware compressors, like tuner cards, digital cameras (example: DV, ATI VCR, MJPEG)</LI>
  <LI>needed if you want to play <B>WMV movies</B> or older (MP41/MP42) ASF's</LI>
</UL>
</LI>

<LI><B>DivX4/DivX5</B> : information about this codec is available in the
<A HREF="codecs.html#2.2.1.1">2.2.1.1</A> section. If you don't want to encode

  compile from
  <A HREF="http://ogg.org/ogg/vorbis/download/vorbis_nightly_cvs.tgz">source</A>
  (this is a nightly updated tarball of vorbis CVS).</LI>

<LI><B>MPlayer</B> can use the libraries of RealPlayer 8 or RealONE to play
  <B>RealVideo 2.0 and 3.0</B> files. See
  <A HREF="formats.html#2.1.1.7">RealMedia file format</A> section for
  installation instructions and more information!</LI>

</UL>

They can display and scale (zoom) the picture to any size that fits in
their memory, with <B>small CPU usage</B> (zooming doesn't increase it!), thus
you get a nice and very fast fullscreen playing.</P>

<UL>
<LI><B>Matrox G200/G400/G450/G550 cards</B> : although a
  <A HREF="video.html#2.3.1.9">Vidix driver</A> is provided, it is recommended
  to use the old mga_vid kernel module instead, for it works much better.
  Please see the <A HREF="video.html#2.3.1.7">mga_vid</A> section about its
  installation and usage. It is important to do these steps <I>before</I>
  compiling <B>MPlayer</B>, otherwise no mga_vid support will be built. Also
  check out the <A HREF="video.html#2.3.1.A.1">Matrox TV-out</A> section.
  <U><B>If you are non-Linux user</B></U>, your only possibility is the Vidix
  driver: read <A HREF="video.html#2.3.1.15">Vidix</A> documentation !</LI>

<LI><B>3Dfx Voodoo3/Banshee cards</B> : please see the
  <A HREF="video.html#2.3.1.9">2.3.1.9</A> section in order to gain big
  speedup. It is important to do these steps <I>before</I> compiling
  <B>MPlayer</B>, otherwise no 3Dfx support will be built. Also see the <A
  HREF="video.html#2.3.1.A.3">3dfx TV-out section</A>. If you use X, use at
  least 4.2.0, as 3dfx Xv driver was broken in 4.1.0, and earlier
  releases!</LI>

<LI><B>ATI cards</B> : <A HREF="video.html#2.3.1.14">Vidix driver</A> is
  provided for the following cards:
  <B>Radeon</B>, <B>Rage128</B>, <B>Mach64</B> (Rage XL/Mobility, Xpert98).
  Also see the <A HREF="video.html#2.3.1.A.2">ATI cards
  section</A> of the TV-out documentation, to know if you card's TV-out is
  supported under Linux/MPlayer.</LI>

<LI><B>S3 cards</B> : the Savage and Virge/DX chips have hardware acceleration. Use as
new XFree86 version as possible, older drivers are buggy. Savage chips
have problems with YV12 display, see <A HREF="video.html#2.3.1.2.2">S3 Xv
section</A> for details. Older, Trio cards have no, or slow hardware
support.</LI>

<LI><B>Nvidia cards</B> : very bad choice for video playing (NVidia has
<A HREF="users_against_developers.html#nvidia">different opinion</A>!).
Nvidia's cards have very cheap and bad
quality chips. Moreover, <U>the built-in Nvidia driver in XFree86 doesn't
contain support for hardware YUV acceleration for all NVidia cards !</U>
You have to download Nvidia's closed-source drivers from nvidia.com. See
details in <A HREF="video.html#2.3.1.2.3">Nvidia Xv driver</A> section.</LI>

<LI><B>3DLabs GLINT R3 and Permedia3</B> : a Vidix driver is provided
  (pm3_vid). Please see the <A HREF="video.html#2.3.1.15">Vidix
  instructions</A>.</LI>

<LI><B>other cards</B> : none of the above?
  <UL>
    <LI>Try if the XFree86 driver (and your card) supports hardware
      acceleration. See the <A HREF="video.html#2.3.1.2">Xv section</A> for
      details.</LI>
    <LI>If it doesn't, then your card's video features aren't supported under your OS :(<BR>

<P><CODE>mplayer http_proxy://proxy.micorsops.com:3128/http://micorsops.com:80/stream.asf</CODE></P>

<P><B>MPlayer</B> can read from stdin (NOT named pipes). This can be for example
used to play from FTP:</P>
<P><CODE>wget ftp://micorsops.com/something.avi -O - | mplayer -</CODE></P>

<P>Note: it's also recommended to enable CACHE when playback from network:</P>
<P><CODE>wget ftp://micorsops.com/something.avi -O - | mplayer -cache 8192 -</CODE></P>


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

    cd main
    fakeroot debian/rules binary
</PRE>

<P>(... mplayer detects hardware/software, builds itself and.. )
dpkg-deb: building package `mplayer' in `../mplayer_0.18-1_i386.deb'.</P>

<P>And now just become root, and:</P>

<PRE>
    dpkg -i ../mplayer_0.18-1_i386.deb as root.
</PRE>

<P>Here's how it looks like:</P>

<PRE>
	eyck@incubus:/src/main$ sudo dpkg -i ../mplayer_0.18-1_i386.deb
	Password:
	(Reading database ... 26946 files and directories currently installed.)
	Preparing to replace mplayer 0.17a-1 (using ../mplayer_0.18-1_i386.deb)
	Unpacking replacement mplayer ...
	Setting up mplayer (0.18-1) ...
</PRE>


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

6583:4b7d097a9c69

              <LI><A HREF="codecs.html#2.2.1.5">2.2.1.5 MPEG1/2 video</A></LI>
              <LI><A HREF="codecs.html#2.2.1.6">2.2.1.6 MS Video1</A></LI>
              <LI><A HREF="codecs.html#2.2.1.7">2.2.1.7 Cinepak CVID</A></LI>
              <LI><A HREF="codecs.html#2.2.1.8">2.2.1.8 RealVideo</A></LI>
              <LI><A HREF="codecs.html#2.2.1.9">2.2.1.9 XViD</A></LI>
              <LI><A HREF="codecs.html#2.2.1.10">2.2.1.10 Sorenson</A></LI>
            </UL>
          </LI>
          <LI><A HREF="codecs.html#2.2.2">2.2.2 Audio</A>
            <UL>
              <LI><A HREF="codecs.html#2.2.2.1">2.2.2.1 Software AC3 decoding</A></LI>

              <LI><A HREF="video.html#2.3.1.9">2.3.1.9 3dfx YUV support (tdfxfb)</A></LI>
              <LI><A HREF="video.html#2.3.1.10">2.3.1.10 OpenGL output</A></LI>
              <LI><A HREF="video.html#2.3.1.11">2.3.1.11 AAlib - text mode displaying</A></LI>
              <LI><A HREF="video.html#2.3.1.12">2.3.1.12 VESA - output to VESA BIOS</A></LI>
              <LI><A HREF="video.html#2.3.1.13">2.3.1.13 X11</A></LI>
              <LI><A HREF="video.html#2.3.1.15">2.3.1.14 (non-existant section)</A></LI>
              <LI><A HREF="video.html#2.3.1.15">2.3.1.15 Vidix</A></LI>
              <LI><A HREF="video.html#2.3.1.16">2.3.1.16 Zr (for some MJPEG capture/playback boards)</A></LI>
              <LI><A HREF="video.html#2.3.1.A">2.3.1.A TVout</A>
                <UL>
                  <LI><A HREF="video.html#2.3.1.A.1">2.3.1.A.1 Matrox G400</A></LI>

  can't. A healthy quantity of combining ability is welcomed, though.
  Good luck. You'll need it :) And for another good advice, let me quote
  Chris Phillips from the <B>mplayer-users</B> mailing list:</P>

<P><I>"I said a while ago that there is such a difference between a newbie and
  a dumbass. No matter what you actually know about a system (linux, cars,
  girls :D) you should ALWAYS be able to take a step back and be objective,
  otherwise, you're just dumb IMHO. A girl i live with assumed the vacuum
  cleaner was broken because it didn't suck things up. never thought to change
  the bag, becasue she'd never done it before... now that's just stupid, not a
  case of simply not knowing what to do... Simply not being that familiar with

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

<P><B>MPlayer</B> is a movie player for LINUX (runs on many other Unices, and
<B>non-x86</B> CPUs, see <A HREF="#6">section 6</A>). It plays most MPEG, VOB,
AVI, OGG, VIVO, ASF/WMV, QT/MOV, FLI, RM, NuppelVideo, yuv4mpeg, FILM, RoQ
files, supported by many native, XAnim, RealPlayer, and
Win32 DLL codecs. You can watch <B>VideoCD</B>, <B>SVCD</B>, <B>DVD</B>,
<B>3ivx</B>, <B>RealMedia</B>, and <B>DivX</B> movies too (and you don't need
the avifile
library at all!). The another big feature of mplayer is the wide range of
supported output drivers. It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev,
AAlib, DirectFB, but you can use GGI and SDL (and this way all their drivers)
and some lowlevel card-specific drivers (for Matrox, 3Dfx and Radeon,
Mach64, Permedia3) too! Most
of them supports software or hardware scaling, so you can enjoy movies in
fullscreen. <B>MPlayer</B> supports displaying through some hardware MPEG
decoder boards, such as the <B><A HREF="DVB">DVB</A></B> and <B> <A
HREF="DXR3">DXR3/Hollywood+</A></B> ! And what about the nice big antialiased
shaded subtitles (<B>10 supported types!!!</B>) with european/ISO 8859-1,2
(Hungarian, English, Czech, etc), Cyrillic, Korean fonts, and the onscreen
display (OSD)?</P>

<P><B>MPlayer</B> is under GPL v2 license.</P>

<P>The player is rock solid playing damaged MPEG files (useful for some VCDs),
and it plays bad AVI files which are unplayable with the famous
windows media player. Even AVI files without index chunk are playable, and
you can temporarily rebuild their indexes with the <CODE>-idx</CODE> option, or
permanently with <B>MEncoder</B>, thus enabling seeking!
As you see, stability and quality are the most important things,
but the speed is also amazing.</P>

    codecs and much more. Try it!</LI>
<LI><B>MPlayer 0.60 "The RTFMCounter"</B> Jan 3, 2002<BR>
    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> Jul? ??, 2002<BR>
    </LI>
</UL>

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

differs from ours, so if you want to use all supported codecs, then use our
package! However, you can use our codecs package with avifile. Features:<BR>
<UL>
  <LI>you need this if you want to play or encode for example movies recorded
  with various hardware compressors, like tuner cards, digital cameras (example: DV, ATI VCR, MJPEG)</LI>
  <LI>needed if you want to play <B>WMV8 movies</B>. Not needed for old
  ASF's with MP41 or MP42 video (though VoxWare audio is frequent for these
  files - it's done by the Win32 codec), or WMV7.</LI>
</UL>
</LI>

<LI><B>DivX4/DivX5</B> : information about this codec is available in the
<A HREF="codecs.html#2.2.1.1">2.2.1.1</A> section. If you don't want to encode

  compile from
  <A HREF="http://ogg.org/ogg/vorbis/download/vorbis_nightly_cvs.tgz">source</A>
  (this is a nightly updated tarball of vorbis CVS).</LI>

<LI><B>MPlayer</B> can use the libraries of RealPlayer 8 or RealONE to play
  files with <B>RealVideo 2.0 and 3.0</B> video, and Sipro/Cook audio. See
  <A HREF="formats.html#2.1.1.7">RealMedia file format</A> section for
  installation instructions and more information!</LI>

</UL>

They can display and scale (zoom) the picture to any size that fits in
their memory, with <B>small CPU usage</B> (zooming doesn't increase it!), thus
you get a nice and very fast fullscreen playing.</P>

<UL>
<LI><B>Matrox G200/G400/G450/G550 cards</B>: although a
  <A HREF="video.html#2.3.1.9">Vidix driver</A> is provided, it is recommended
  to use the old mga_vid kernel module instead, for it works much better.
  Please see the <A HREF="video.html#2.3.1.7">mga_vid</A> section about its
  installation and usage. It is important to do these steps <I>before</I>
  compiling <B>MPlayer</B>, otherwise no mga_vid support will be built. Also
  check out the <A HREF="video.html#2.3.1.A.1">Matrox TV-out</A> section.
  <U><B>If you are non-Linux user</B></U>, your only possibility is the Vidix
  driver: read <A HREF="video.html#2.3.1.15">Vidix</A> documentation !</LI>

<LI><B>3Dfx Voodoo3/Banshee cards</B>: please see the
  <A HREF="video.html#2.3.1.9">2.3.1.9</A> section in order to gain big
  speedup. It is important to do these steps <I>before</I> compiling
  <B>MPlayer</B>, otherwise no 3Dfx support will be built. Also see the <A
  HREF="video.html#2.3.1.A.3">3dfx TV-out section</A>. If you use X, use at
  least 4.2.0, as 3dfx Xv driver was broken in 4.1.0, and earlier
  releases!</LI>

<LI><B>ATI cards</B>: <A HREF="video.html#2.3.1.14">Vidix driver</A> is
  provided for the following cards:
  <B>Radeon</B>, <B>Rage128</B>, <B>Mach64</B> (Rage XL/Mobility, Xpert98).
  Also see the <A HREF="video.html#2.3.1.A.2">ATI cards
  section</A> of the TV-out documentation, to know if you card's TV-out is
  supported under Linux/MPlayer.</LI>

<LI><B>S3 cards</B>: the Savage and Virge/DX chips have hardware acceleration. Use as
new XFree86 version as possible, older drivers are buggy. Savage chips
have problems with YV12 display, see <A HREF="video.html#2.3.1.2.2">S3 Xv
section</A> for details. Older, Trio cards have no, or slow hardware
support.</LI>

<LI><B>Nvidia cards</B>: very bad choice for video playing (NVidia has
<A HREF="users_against_developers.html#nvidia">different opinion</A>!).
Nvidia's cards have very cheap and bad
quality chips. Moreover, <U>the built-in Nvidia driver in XFree86 doesn't
contain support for hardware YUV acceleration for all NVidia cards !</U>
You have to download Nvidia's closed-source drivers from nvidia.com. See
details in <A HREF="video.html#2.3.1.2.3">Nvidia Xv driver</A> section.</LI>

<LI><B>3DLabs GLINT R3 and Permedia3</B>: a Vidix driver is provided
  (pm3_vid). Please see the <A HREF="video.html#2.3.1.15">Vidix
  instructions</A>.</LI>

<LI><B>other cards</B>: none of the above?
  <UL>
    <LI>Try if the XFree86 driver (and your card) supports hardware
      acceleration. See the <A HREF="video.html#2.3.1.2">Xv section</A> for
      details.</LI>
    <LI>If it doesn't, then your card's video features aren't supported under your OS :(<BR>

<P><CODE>mplayer http_proxy://proxy.micorsops.com:3128/http://micorsops.com:80/stream.asf</CODE></P>

<P><B>MPlayer</B> can read from stdin (NOT named pipes). This can be for example
used to play from FTP:</P>
<P><CODE>&nbsp;&nbsp;wget ftp://micorsops.com/something.avi -O - | mplayer -</CODE></P>

<P>Note: it's also recommended to enable CACHE when playback from network:</P>
<P><CODE>&nbsp;&nbsp;wget ftp://micorsops.com/something.avi -O - | mplayer -cache 8192 -</CODE></P>


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

    cd main
    fakeroot debian/rules binary
</PRE>

<P>(... mplayer detects hardware/software, builds itself and.. )
dpkg-deb: building package `mplayer' in `../mplayer_0.90-1_i386.deb'.</P>

<P>And now just become root, and:</P>

<PRE>
    dpkg -i ../mplayer_0.90-1_i386.deb as root.
</PRE>

<P>Here's how it looks like:</P>

<PRE>
	eyck@incubus:/src/main$ sudo dpkg -i ../mplayer_0.90-1_i386.deb
	Password:
	(Reading database ... 26946 files and directories currently installed.)
	Preparing to replace mplayer 0.50-1 (using ../mplayer_0.90-1_i386.deb)
	Unpacking replacement mplayer ...
	Setting up mplayer (0.90-1) ...
</PRE>


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