comparison DOCS/xml/en/video.xml @ 13912:c66b1514ce5b

Remove pointless devices section, make video and audio top level sections.

13911:bb37fefc205b

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<sect2 id="video-dev">
<title>Video output devices</title>

<sect3 id="mtrr">
<title>Setting up MTRR</title>

<para>
It is VERY recommended to check if the MTRR registers
are set up properly, because they can give a big performance boost.

<para>
Not all CPUs have MTRRs. For example older K6-2 (around 266MHz,
stepping 0) CPUs don't have MTRRs, but stepping 12 does
(execute <command>cat /proc/cpuinfo</command> to check it).
</para>
</sect3>

<sect3 id="output-trad">
<title>Video outputs for traditional video cards</title>
<sect4 id="xv">
<title>Xv</title>

<para>
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

  --></screen>
  </para></listitem>
</orderedlist>
</para>

<sect5 id="tdfx">
<title>3dfx cards</title>

<para>
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

<para>
<emphasis role="bold">OR</emphasis>, try the NEW
<option>-vo tdfxfb</option> driver! See the <link linkend="tdfxfb">tdfxfb</link>
section.
</para>
</sect5>


<sect5 id="s3">
<title>S3 cards</title>

<para>
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

It's currently unclear which Savage models lack YV12 support, and convert by
driver (slow). If you suspect your card, get a newer driver, or ask politely
on the mplayer-users mailing list for an MMX/3DNow! enabled driver.
</para>
</note>
</sect5>


<sect5 id="nvidia">
<title>nVidia cards</title>

<para>
nVidia isn't always a very good choice under Linux (according to nVidia, this
is <link linkend="nvidia-opinions">not true</link>)... XFree86's

However, <application>MPlayer</application> contains a
<link linkend="vidix">VIDIX</link> driver for most nVidia cards. Currently it
is in beta stage, and has some drawbacks. For more information, see
<link linkend="vidix-nvidia">nVidia VIDIX</link> section.
</para>
</sect5>


<sect5 id="ati">
<title>ATI cards</title>

<para>
The <ulink url="http://www.linuxvideo.org/gatos">GATOS driver</ulink>
(which you should use, unless you have Rage128 or Radeon) has VSYNC enabled

No TV out support. Of course with <application>MPlayer</application> you can
happily get <emphasis role="bold">accelerated</emphasis> display, with or without
<emphasis role="bold">TV output</emphasis>, and no libraries or X are needed.
Read the <link linkend="vidix">VIDIX</link> section.
</para>
</sect5>


<sect5 id="neomagic">
<title>NeoMagic cards</title>

<para>
These cards can be found in many laptops. You must use XFree86 4.3.0 or
above, or else use Stefan Seyfried's

    <emphasis>Option "OverlayMem" "829440"</emphasis>
    [...]
EndSection<!--
--></programlisting>
</para>
</sect5>


<sect5 id="trident">
<title>Trident cards</title>
<para>
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.

<para>
Alternatively, <application>MPlayer</application> contains a
<link linkend="vidix">VIDIX</link> driver for the Cyberblade/i1 card.
</para>

</sect5>


<sect5 id="kyro">
<title>Kyro/PowerVR cards</title>
<para>
If you want to use Xv with a Kyro based card (for example Hercules
Prophet 4000XT), you should download the drivers from the
<ulink url="http://www.powervr.com/">PowerVR site</ulink>
</para>
</sect5>
</sect4>

<!-- ********** -->

<sect4 id="dga">
<title>DGA</title>

<formalpara>
<title>PREAMBLE</title>
<para>

<listitem><simpara>
  OSD only works with double buffering enabled (else it flickers).
  </simpara></listitem>
</itemizedlist>

</sect4>
<!--</sect3>-->

<!-- ********** -->

<sect4 id="sdl">
<title>SDL</title>

<para>
<acronym>SDL</acronym> (Simple Directmedia Layer) is basically a unified
video/audio interface. Programs that use it know only about SDL, and not

  </simpara></listitem>
<listitem><simpara>
  DO NOT USE SDL with GUI! It won't work as it should.
  </simpara></listitem>
</itemizedlist>
</sect4>


<sect4 id="svgalib">
<title>SVGAlib</title>

<formalpara>
<title>INSTALLATION</title>
<para>

<para>
You can turn on OSD and subtitles only with the <option>expand</option>
filter, see the man page for exact parameters.
</para>
</sect4>


<sect4 id="fbdev">
<title>Framebuffer output (FBdev)</title>

<para>
Whether to build the FBdev target is autodetected during
<filename>./configure</filename>. Read the framebuffer documentation in

FBdev video mode changing <emphasis>does not work</emphasis> with the VESA
framebuffer, and don't ask for it, since it's not an
<application>MPlayer</application> limitation.
</para>
</note>
</sect4>


<sect4 id="mga_vid">
<title>Matrox framebuffer (mga_vid)</title>

<para>
This section is about the Matrox G200/G400/G450/G550 BES (Back-End Scaler)
support, the mga_vid kernel driver. It's actively developed by A'rpi, and

info, for example by
<screen>cat /dev/mga_vid</screen>
and can be written for brightness change:
<screen>echo "brightness=120" &gt; /dev/mga_vid</screen>
</para>
</sect4>


<sect4 id="tdfxfb" xreflabel="3Dfx YUV support (tdfxfb)">
<title>3Dfx YUV support</title>
<para>
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
<screen>./configure --enable-tdfxfb</screen>
</para>
</sect4>


<sect4 id="opengl">
<title>OpenGL output</title>

<para>
<application>MPlayer</application> supports displaying movies using OpenGL,
but if your platform/driver supports xv as should be the case on a PC with

<para>
<command>export $__GL_SYNC_TO_VBLANK=1</command>
</para>

</sect4>


<sect4 id="aalib">
<title>AAlib - text mode displaying</title>

<para>
AAlib is a library for displaying graphics in text mode, using powerful
ASCII renderer. There are <emphasis>lots</emphasis> of programs already

<filename>/dev/vcsa<replaceable>&lt;terminal&gt;</replaceable></filename>!
That isn't autodetected by aalib, but vo_aa tries to find the best mode.
See <ulink url="http://aa-project.sourceforge.net/tune"/> for further
tuning issues.
</para>
</sect4>


<sect4 id="caca">
<title><systemitem class="library">libcaca</systemitem> - Color ASCII Art library</title>

<para>
The <ulink url="http://sam.zoy.org/projects/libcaca/"><systemitem class="library">libcaca</systemitem></ulink>
library is a graphics library that outputs text instead of pixels, so that it

<para>
Use the <option>-framedrop</option> option if your computer is not fast
enough to render all frames.
</para>

</sect4>


<sect4 id="vesa">
<title>VESA - output to VESA BIOS</title>

<para>
This driver was designed and introduced as a <emphasis role="bold">generic
driver</emphasis> for any video card which has VESA VBE 2.0 compatible

  To get <emphasis role="bold">working TV-out</emphasis> you need have plugged
  TV-connector in before booting your PC since video BIOS initializes
  itself only once during POST procedure.
  </simpara></listitem>
</itemizedlist>
</sect4>


<sect4 id="x11">
<title>X11</title>

<para>
Avoid if possible. Outputs to X11 (uses shared memory extension), with no
hardware acceleration at all. Supports (MMX/3DNow/SSE accelerated, but

<para>
If you can't find the modes you inserted, browse XFree86's output. Some
drivers can't use low pixelclocks that are needed for low resolution
video modes.
</para>
</sect4>


<sect4 id="vidix">
<title>VIDIX</title>

<formalpara>
<title>PREAMBLE</title>
<para>

<step><para>
  Recompile and install libdha.
  </para></step>
</procedure>

<sect5 id="vidix-ati">
<title>ATI cards</title>
<para>
Currently most ATI cards are supported natively, from Mach64 to the
newest Radeons.
</para>

<para>
There are two compiled binaries: <filename>radeon_vid</filename> for Radeon and
<filename>rage128_vid</filename> for Rage 128 cards. You may force one or let
the VIDIX system autoprobe all available drivers.
</para>
</sect5>

<sect5 id="vidix-mga">
<title>Matrox cards</title>
<para>
Matrox G200, G400, G450 and G550 have been reported to work.
</para>

<para>
The driver supports video equalizers and should be nearly as fast as the
<link linkend="mga_vid">Matrox framebuffer</link>
</para>
</sect5>

<sect5 id="vidix-trident">
<title>Trident cards</title>
<para>
There is a driver available for the Trident Cyberblade/i1 chipset, which
can be found on VIA Epia motherboards.
</para>

<para>
The driver was written and is maintained by
<ulink url="http://www.blackfiveservices.co.uk/EPIAVidix.shtml">Alastair M. Robinson</ulink>
</para>
</sect5>

<sect5 id="vidix-3dlabs">
<title>3DLabs cards</title>
<para>
Although there is a driver for the 3DLabs GLINT R3 and Permedia3 chips, no one
has tested it, so reports are welcome.
</para>
</sect5>

<sect5 id="vidix-nvidia">
<title>nVidia cards</title>
<para>
There's a relatively new nVidia driver out there, it's known to work on Riva
128, TNT and GeForce2 chipsets, also others have been reported working.
</para>

</para>

<para>
Reports awaited!
</para>
</sect5>

<sect5 id="vidix-sis">
<title>SiS cards</title>
<para>
This is very experimental code, just like nvidia_vid.
</para>

</para>

<para>
Reports awaited!
</para>
</sect5>
</sect4>

<sect4 id="directfb">
<title>DirectFB</title>
<blockquote><para>
&quot;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.&quot; - quoted from <ulink url="http://www.directfb.org"/>

Always try to use the newest version of DirectFB. You can use DirectFB options on
the command line, using the <option>-dfbopts</option> option. Layer selection can
be done by the subdevice method, e.g.: <option>-vo directfb:2</option>
(layer -1 is default: autodetect)
</para>
</sect4>

<sect4 id="dfbmga">
<title>DirectFB/Matrox (dfbmga)</title>
<para>
Please read the <link linkend="directfb">main DirectFB</link> section for general
information.
</para>

0.9.17 (it's buggy, needs that <systemitem>surfacemanager</systemitem>
patch from the URL above). Porting the CRTC2 code to
<link linkend="mga_vid">mga_vid</link> has been planned for years,
<ulink url="../../tech/patches.txt">patches</ulink> are welcome.
</para></note>
</sect4>
</sect3>

<sect3 id="mpeg_decoders">
<title>MPEG decoders</title>

<sect4 id="dvb">
<title>DVB output and input</title>
<para>
<application>MPlayer</application> supports cards with the Siemens DVB chipset
from vendors like Siemens, Technotrend, Galaxis or Hauppauge. The latest DVB
drivers are available from the <ulink url="http://www.linuxtv.org">Linux TV site</ulink>.

In the future you may expect the ability to display OSD and subtitles using
the native OSD feature of DVB cards, as well as more fluent playback of
non-25fps movies and realtime transcoding between MPEG2 and MPEG4 (partial
decompression).
</para>
</sect4>

<sect4 id="dxr2">
<title>DXR2</title>
<para><application>MPlayer</application> supports hardware accelerated playback
  with the Creative DXR2 card.</para>
<para>
First of all you will need properly installed DXR2 drivers. You can find

around the characters or some other funny effect. But if you properly adjust
the colorkey settings you should be able to get acceptable results.
</para>

<para>Please see the man page for available options.</para>
</sect4>

<sect4 id="dxr3">
<title>DXR3/Hollywood+</title>
<para>
<application>MPlayer</application> supports hardware accelerated playback
with the Creative DXR3 and Sigma Designs Hollywood Plus cards. These cards
both use the em8300 MPEG decoder chip from Sigma Designs.

digital audio output of the card. See the <option>-ao oss</option> option above,
it must be used to specify the DXR3's output instead of a sound card.
</para></listitem>
</varlistentry>
</variablelist>
</sect4>

</sect3>

<sect3 id="other">
<title>Other visualization hardware</title>

<sect4 id="zr">
<title>Zr</title>

<para>
This is a display-driver (<option>-vo zr</option>) for a number of MJPEG
capture/playback cards (tested for DC10+ and Buz, and it should work for the

during playback, it will crash your computer. It is, however, fine to
<emphasis role="bold">FIRST</emphasis> start XawTV, <emphasis role="bold">THEN</emphasis>
start <application>MPlayer</application>, wait for <application>MPlayer</application>
to finish and <emphasis role="bold">THEN</emphasis> stop XawTV.
</para>
</sect4>

<sect4 id="blinkenlights">
<title>Blinkenlights</title>
<para>
This driver is capable of playback using the Blinkenlights UDP protocol. If you
don't know what <ulink url="http://www.blinkenlights.de/">Blinkenlights</ulink>
or its successor

has to offer. Just watch some of the
<ulink url="http://www.blinkenlights.de/video.en.html">Blinkenlights documentation videos</ulink>.
On the Arcade video you can see the Blinkenlights output driver in
action at 00:07:50.
</para>
</sect4>
</sect3>

<sect3 id="tvout">
<title>TV-out support</title>

<sect4 id="tvout-mga-g400">
<title>Matrox G400 cards</title>

<para>
Under Linux you have two methods to get G400 TV out working:
</para>

The CRTC2 connector's first pin is the composite video signal. The
ground are the fifth, sixth, seventh, and fifteenth (5, 6, 7, 15)
pins. (info contributed from Balázs Kerekes)
</para>
</formalpara>
</sect4>

<sect4 id="tv-out_matrox_g450">
<title>Matrox G450/G550 cards</title>
<para>
TV output support for these cards has only been recently introduced, and is
not yet in the mainstream kernel. Currently the <emphasis role="bold">mga_vid</emphasis>
module can't be used AFAIK, because the G450/G550 driver works only in one

<para>
The necessary kernel patch and the detailed HOWTO is downloadable from
<ulink url="http://www.bglug.ca/matrox_tvout/"/>
</para>
</sect4>


<sect4 id="tvout-ati">
<title>ATI cards</title>

<formalpara>
<title>PREAMBLE</title>
<para>

<para>
Only thing you need to do - <emphasis role="bold">Have the TV connector
plugged in before booting your PC</emphasis> since video BIOS initializes
itself only once during POST procedure.
</para>
</sect4>


<sect4 id="tvout-voodoo">
<title>Voodoo 3</title>
<para>
Check <ulink url="http://www.iki.fi/too/tvout-voodoo3-3000-xfree">this URL</ulink>.
</para>
</sect4>

<sect4 id="tvout-nvidia">
<title>nVidia</title>
<para>
First, you MUST download the closed-source drivers from <ulink url="http://nvidia.com"/>.
I will not describe the installation and configuration process because it does not cover
the scope of this documentation.

</para>

<para>
Of course the important thing is the TwinView part.
</para>
</sect4>

<sect4 id="tvout-neomagic">
<title>NeoMagic</title>
<para>
The NeoMagic chip is found in a variety of laptops, some of them are equipped
with a simple analog TV encoder, some have a more advanced one.
<itemizedlist>

  blacklevel, flickfilter are implemented.
  </simpara>
</listitem>
</itemizedlist>
</para>
</sect4>
</sect3>
</sect2>

13912:c66b1514ce5b

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<sect1 id="video">
<title>Video output devices</title>

<sect2 id="mtrr">
<title>Setting up MTRR</title>

<para>
It is VERY recommended to check if the MTRR registers
are set up properly, because they can give a big performance boost.

<para>
Not all CPUs have MTRRs. For example older K6-2 (around 266MHz,
stepping 0) CPUs don't have MTRRs, but stepping 12 does
(execute <command>cat /proc/cpuinfo</command> to check it).
</para>
</sect2>

<sect2 id="output-trad">
<title>Video outputs for traditional video cards</title>
<sect3 id="xv">
<title>Xv</title>

<para>
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

  --></screen>
  </para></listitem>
</orderedlist>
</para>

<sect4 id="tdfx">
<title>3dfx cards</title>

<para>
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

<para>
<emphasis role="bold">OR</emphasis>, try the NEW
<option>-vo tdfxfb</option> driver! See the <link linkend="tdfxfb">tdfxfb</link>
section.
</para>
</sect4>


<sect4 id="s3">
<title>S3 cards</title>

<para>
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

It's currently unclear which Savage models lack YV12 support, and convert by
driver (slow). If you suspect your card, get a newer driver, or ask politely
on the mplayer-users mailing list for an MMX/3DNow! enabled driver.
</para>
</note>
</sect4>


<sect4 id="nvidia">
<title>nVidia cards</title>

<para>
nVidia isn't always a very good choice under Linux (according to nVidia, this
is <link linkend="nvidia-opinions">not true</link>)... XFree86's

However, <application>MPlayer</application> contains a
<link linkend="vidix">VIDIX</link> driver for most nVidia cards. Currently it
is in beta stage, and has some drawbacks. For more information, see
<link linkend="vidix-nvidia">nVidia VIDIX</link> section.
</para>
</sect4>


<sect4 id="ati">
<title>ATI cards</title>

<para>
The <ulink url="http://www.linuxvideo.org/gatos">GATOS driver</ulink>
(which you should use, unless you have Rage128 or Radeon) has VSYNC enabled

No TV out support. Of course with <application>MPlayer</application> you can
happily get <emphasis role="bold">accelerated</emphasis> display, with or without
<emphasis role="bold">TV output</emphasis>, and no libraries or X are needed.
Read the <link linkend="vidix">VIDIX</link> section.
</para>
</sect4>


<sect4 id="neomagic">
<title>NeoMagic cards</title>

<para>
These cards can be found in many laptops. You must use XFree86 4.3.0 or
above, or else use Stefan Seyfried's

    <emphasis>Option "OverlayMem" "829440"</emphasis>
    [...]
EndSection<!--
--></programlisting>
</para>
</sect4>


<sect4 id="trident">
<title>Trident cards</title>
<para>
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.

<para>
Alternatively, <application>MPlayer</application> contains a
<link linkend="vidix">VIDIX</link> driver for the Cyberblade/i1 card.
</para>

</sect4>


<sect4 id="kyro">
<title>Kyro/PowerVR cards</title>
<para>
If you want to use Xv with a Kyro based card (for example Hercules
Prophet 4000XT), you should download the drivers from the
<ulink url="http://www.powervr.com/">PowerVR site</ulink>
</para>
</sect4>
</sect3>

<!-- ********** -->

<sect3 id="dga">
<title>DGA</title>

<formalpara>
<title>PREAMBLE</title>
<para>

<listitem><simpara>
  OSD only works with double buffering enabled (else it flickers).
  </simpara></listitem>
</itemizedlist>

</sect3>
<!--</sect2>-->

<!-- ********** -->

<sect3 id="sdl">
<title>SDL</title>

<para>
<acronym>SDL</acronym> (Simple Directmedia Layer) is basically a unified
video/audio interface. Programs that use it know only about SDL, and not

  </simpara></listitem>
<listitem><simpara>
  DO NOT USE SDL with GUI! It won't work as it should.
  </simpara></listitem>
</itemizedlist>
</sect3>


<sect3 id="svgalib">
<title>SVGAlib</title>

<formalpara>
<title>INSTALLATION</title>
<para>

<para>
You can turn on OSD and subtitles only with the <option>expand</option>
filter, see the man page for exact parameters.
</para>
</sect3>


<sect3 id="fbdev">
<title>Framebuffer output (FBdev)</title>

<para>
Whether to build the FBdev target is autodetected during
<filename>./configure</filename>. Read the framebuffer documentation in

FBdev video mode changing <emphasis>does not work</emphasis> with the VESA
framebuffer, and don't ask for it, since it's not an
<application>MPlayer</application> limitation.
</para>
</note>
</sect3>


<sect3 id="mga_vid">
<title>Matrox framebuffer (mga_vid)</title>

<para>
This section is about the Matrox G200/G400/G450/G550 BES (Back-End Scaler)
support, the mga_vid kernel driver. It's actively developed by A'rpi, and

info, for example by
<screen>cat /dev/mga_vid</screen>
and can be written for brightness change:
<screen>echo "brightness=120" &gt; /dev/mga_vid</screen>
</para>
</sect3>


<sect3 id="tdfxfb" xreflabel="3Dfx YUV support (tdfxfb)">
<title>3Dfx YUV support</title>
<para>
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
<screen>./configure --enable-tdfxfb</screen>
</para>
</sect3>


<sect3 id="opengl">
<title>OpenGL output</title>

<para>
<application>MPlayer</application> supports displaying movies using OpenGL,
but if your platform/driver supports xv as should be the case on a PC with

<para>
<command>export $__GL_SYNC_TO_VBLANK=1</command>
</para>

</sect3>


<sect3 id="aalib">
<title>AAlib - text mode displaying</title>

<para>
AAlib is a library for displaying graphics in text mode, using powerful
ASCII renderer. There are <emphasis>lots</emphasis> of programs already

<filename>/dev/vcsa<replaceable>&lt;terminal&gt;</replaceable></filename>!
That isn't autodetected by aalib, but vo_aa tries to find the best mode.
See <ulink url="http://aa-project.sourceforge.net/tune"/> for further
tuning issues.
</para>
</sect3>


<sect3 id="caca">
<title><systemitem class="library">libcaca</systemitem> - Color ASCII Art library</title>

<para>
The <ulink url="http://sam.zoy.org/projects/libcaca/"><systemitem class="library">libcaca</systemitem></ulink>
library is a graphics library that outputs text instead of pixels, so that it

<para>
Use the <option>-framedrop</option> option if your computer is not fast
enough to render all frames.
</para>

</sect3>


<sect3 id="vesa">
<title>VESA - output to VESA BIOS</title>

<para>
This driver was designed and introduced as a <emphasis role="bold">generic
driver</emphasis> for any video card which has VESA VBE 2.0 compatible

  To get <emphasis role="bold">working TV-out</emphasis> you need have plugged
  TV-connector in before booting your PC since video BIOS initializes
  itself only once during POST procedure.
  </simpara></listitem>
</itemizedlist>
</sect3>


<sect3 id="x11">
<title>X11</title>

<para>
Avoid if possible. Outputs to X11 (uses shared memory extension), with no
hardware acceleration at all. Supports (MMX/3DNow/SSE accelerated, but

<para>
If you can't find the modes you inserted, browse XFree86's output. Some
drivers can't use low pixelclocks that are needed for low resolution
video modes.
</para>
</sect3>


<sect3 id="vidix">
<title>VIDIX</title>

<formalpara>
<title>PREAMBLE</title>
<para>

<step><para>
  Recompile and install libdha.
  </para></step>
</procedure>

<sect4 id="vidix-ati">
<title>ATI cards</title>
<para>
Currently most ATI cards are supported natively, from Mach64 to the
newest Radeons.
</para>

<para>
There are two compiled binaries: <filename>radeon_vid</filename> for Radeon and
<filename>rage128_vid</filename> for Rage 128 cards. You may force one or let
the VIDIX system autoprobe all available drivers.
</para>
</sect4>

<sect4 id="vidix-mga">
<title>Matrox cards</title>
<para>
Matrox G200, G400, G450 and G550 have been reported to work.
</para>

<para>
The driver supports video equalizers and should be nearly as fast as the
<link linkend="mga_vid">Matrox framebuffer</link>
</para>
</sect4>

<sect4 id="vidix-trident">
<title>Trident cards</title>
<para>
There is a driver available for the Trident Cyberblade/i1 chipset, which
can be found on VIA Epia motherboards.
</para>

<para>
The driver was written and is maintained by
<ulink url="http://www.blackfiveservices.co.uk/EPIAVidix.shtml">Alastair M. Robinson</ulink>
</para>
</sect4>

<sect4 id="vidix-3dlabs">
<title>3DLabs cards</title>
<para>
Although there is a driver for the 3DLabs GLINT R3 and Permedia3 chips, no one
has tested it, so reports are welcome.
</para>
</sect4>

<sect4 id="vidix-nvidia">
<title>nVidia cards</title>
<para>
There's a relatively new nVidia driver out there, it's known to work on Riva
128, TNT and GeForce2 chipsets, also others have been reported working.
</para>

</para>

<para>
Reports awaited!
</para>
</sect4>

<sect4 id="vidix-sis">
<title>SiS cards</title>
<para>
This is very experimental code, just like nvidia_vid.
</para>

</para>

<para>
Reports awaited!
</para>
</sect4>
</sect3>

<sect3 id="directfb">
<title>DirectFB</title>
<blockquote><para>
&quot;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.&quot; - quoted from <ulink url="http://www.directfb.org"/>

Always try to use the newest version of DirectFB. You can use DirectFB options on
the command line, using the <option>-dfbopts</option> option. Layer selection can
be done by the subdevice method, e.g.: <option>-vo directfb:2</option>
(layer -1 is default: autodetect)
</para>
</sect3>

<sect3 id="dfbmga">
<title>DirectFB/Matrox (dfbmga)</title>
<para>
Please read the <link linkend="directfb">main DirectFB</link> section for general
information.
</para>

0.9.17 (it's buggy, needs that <systemitem>surfacemanager</systemitem>
patch from the URL above). Porting the CRTC2 code to
<link linkend="mga_vid">mga_vid</link> has been planned for years,
<ulink url="../../tech/patches.txt">patches</ulink> are welcome.
</para></note>
</sect3>
</sect2>

<sect2 id="mpeg_decoders">
<title>MPEG decoders</title>

<sect3 id="dvb">
<title>DVB output and input</title>
<para>
<application>MPlayer</application> supports cards with the Siemens DVB chipset
from vendors like Siemens, Technotrend, Galaxis or Hauppauge. The latest DVB
drivers are available from the <ulink url="http://www.linuxtv.org">Linux TV site</ulink>.

In the future you may expect the ability to display OSD and subtitles using
the native OSD feature of DVB cards, as well as more fluent playback of
non-25fps movies and realtime transcoding between MPEG2 and MPEG4 (partial
decompression).
</para>
</sect3>

<sect3 id="dxr2">
<title>DXR2</title>
<para><application>MPlayer</application> supports hardware accelerated playback
  with the Creative DXR2 card.</para>
<para>
First of all you will need properly installed DXR2 drivers. You can find

around the characters or some other funny effect. But if you properly adjust
the colorkey settings you should be able to get acceptable results.
</para>

<para>Please see the man page for available options.</para>
</sect3>

<sect3 id="dxr3">
<title>DXR3/Hollywood+</title>
<para>
<application>MPlayer</application> supports hardware accelerated playback
with the Creative DXR3 and Sigma Designs Hollywood Plus cards. These cards
both use the em8300 MPEG decoder chip from Sigma Designs.

digital audio output of the card. See the <option>-ao oss</option> option above,
it must be used to specify the DXR3's output instead of a sound card.
</para></listitem>
</varlistentry>
</variablelist>
</sect3>

</sect2>

<sect2 id="other">
<title>Other visualization hardware</title>

<sect3 id="zr">
<title>Zr</title>

<para>
This is a display-driver (<option>-vo zr</option>) for a number of MJPEG
capture/playback cards (tested for DC10+ and Buz, and it should work for the

during playback, it will crash your computer. It is, however, fine to
<emphasis role="bold">FIRST</emphasis> start XawTV, <emphasis role="bold">THEN</emphasis>
start <application>MPlayer</application>, wait for <application>MPlayer</application>
to finish and <emphasis role="bold">THEN</emphasis> stop XawTV.
</para>
</sect3>

<sect3 id="blinkenlights">
<title>Blinkenlights</title>
<para>
This driver is capable of playback using the Blinkenlights UDP protocol. If you
don't know what <ulink url="http://www.blinkenlights.de/">Blinkenlights</ulink>
or its successor

has to offer. Just watch some of the
<ulink url="http://www.blinkenlights.de/video.en.html">Blinkenlights documentation videos</ulink>.
On the Arcade video you can see the Blinkenlights output driver in
action at 00:07:50.
</para>
</sect3>
</sect2>

<sect2 id="tvout">
<title>TV-out support</title>

<sect3 id="tvout-mga-g400">
<title>Matrox G400 cards</title>

<para>
Under Linux you have two methods to get G400 TV out working:
</para>

The CRTC2 connector's first pin is the composite video signal. The
ground are the fifth, sixth, seventh, and fifteenth (5, 6, 7, 15)
pins. (info contributed from Balázs Kerekes)
</para>
</formalpara>
</sect3>

<sect3 id="tv-out_matrox_g450">
<title>Matrox G450/G550 cards</title>
<para>
TV output support for these cards has only been recently introduced, and is
not yet in the mainstream kernel. Currently the <emphasis role="bold">mga_vid</emphasis>
module can't be used AFAIK, because the G450/G550 driver works only in one

<para>
The necessary kernel patch and the detailed HOWTO is downloadable from
<ulink url="http://www.bglug.ca/matrox_tvout/"/>
</para>
</sect3>


<sect3 id="tvout-ati">
<title>ATI cards</title>

<formalpara>
<title>PREAMBLE</title>
<para>

<para>
Only thing you need to do - <emphasis role="bold">Have the TV connector
plugged in before booting your PC</emphasis> since video BIOS initializes
itself only once during POST procedure.
</para>
</sect3>


<sect3 id="tvout-voodoo">
<title>Voodoo 3</title>
<para>
Check <ulink url="http://www.iki.fi/too/tvout-voodoo3-3000-xfree">this URL</ulink>.
</para>
</sect3>

<sect3 id="tvout-nvidia">
<title>nVidia</title>
<para>
First, you MUST download the closed-source drivers from <ulink url="http://nvidia.com"/>.
I will not describe the installation and configuration process because it does not cover
the scope of this documentation.

</para>

<para>
Of course the important thing is the TwinView part.
</para>
</sect3>

<sect3 id="tvout-neomagic">
<title>NeoMagic</title>
<para>
The NeoMagic chip is found in a variety of laptops, some of them are equipped
with a simple analog TV encoder, some have a more advanced one.
<itemizedlist>

  blacklevel, flickfilter are implemented.
  </simpara>
</listitem>
</itemizedlist>
</para>
</sect3>
</sect2>
</sect1>