changeset 11824:ce44fb6eb15c

Our DirectFB documentation is dated, the current version is now linked to from video.xml.
author diego
date Wed, 21 Jan 2004 21:18:33 +0000
parents 98a40d938b91
children 38887cab0d8b
files DOCS/tech/directfb.txt DOCS/xml/en/video.xml
diffstat 2 files changed, 14 insertions(+), 75 deletions(-) [+]
line wrap: on
line diff
--- a/DOCS/tech/directfb.txt	Wed Jan 21 19:59:33 2004 +0000
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,63 +0,0 @@
-Written by Ville Syrjälä <syrjala@sci.fi>, original can be found at
-http://www.sci.fi/~syrjala/directfb/readme.txt
-For more information see also http://www.directfb.org
---------------------------------------------------------------------------------
-DirectFB includes TV out support for Matrox G400 cards.
-If you've used the Windows drivers you most likely know about
-DVDMax... DirectFB provides the same functionality. Now you can get
-excellent quality video playback on your TV.
-
-DirectFB TV output features:
-- interlaced picture
-- 720x576 50Hz PAL and 720x486 60Hz NTSC
-- RGB15, RGB16, RGB32, ARGB, YUY2, UYVY, I420, YV12 pixel formats
-- hardware blended sub-picure in I420 and YV12 modes
-- brightness, contrast, hue, saturation adjustments
-- no more tweaking sessions with fbset to get the image centered :)
-
-I recommend you use DirectFB 0.9.15 or later since some vsync problems
-were fixed in that release.
-
-Linux kernel setup:
-
-1. Patch your kernel with matroxfb-vsync-c2vline-irq-patch-2.4.19.bz2
-It's distributed with DirectFB sources in the patches subdirectory.
-This patch enables IRQ based vblank waiting. Make sure your card has
-an IRQ assigned to it. You may have an option in the BIOS setup for
-this.
-
-2. Add "#define FBIO_WAITFORVSYNC _IOW('F', 0x20, int)" to
-   /usr/include/linux/fb.h
-
-3. Build and install the kernel. Set the following options:
- CONFIG_I2C
- CONFIG_I2C_ALGOBIT
- CONFIG_I2C_CHARDEV
- CONFIG_I2C_PROC
- CONFIG_FB_MATROX
- CONFIG_FB_MATROX_G100
- CONFIG_FB_MATROX_I2C
-DirectFB doesn't require kernel support for the second head. In fact it may
-interfere with the TV out.
-
-4. Make sure you have the proper /dev/i2c-N device file in place.
-   After loading i2c-matroxfb module you should see MAVEN in
-   /proc/bus/i2c. You must have the corresponding device file. To
-   create these files use:
-   'mknod /dev/i2c-N c 89 N' where N is 0,1,2...
-   The number might change depending on the order you load i2c modules
-   so you may want to create some extra files.
-
-DirectFB setup:
-
-1. Build and install DirectFB
-
-2. Use the following DirectFB options:
- matrox-crtc2
- matrox-tv-standard=pal or ntsc
-You can store them in /etc/directfbrc or ~/.directfbrc so that the will be
-used every time.
-
-That's pretty much it. Well you do need some applications. mplayer has
-a special video out plugin 'dfbmga' for this stuff. You need a recent
-version of mplayer to use it.
--- a/DOCS/xml/en/video.xml	Wed Jan 21 19:59:33 2004 +0000
+++ b/DOCS/xml/en/video.xml	Wed Jan 21 21:18:33 2004 +0000
@@ -1585,24 +1585,26 @@
 <sect4 id="dfbmga">
 <title>DirectFB/Matrox (dfbmga)</title>
 <para>
-Please read the <link linkend="directfb">main DirectFB</link> section or general
-informations.
-</para>
-
-<para>This video output driver will enable CRTC2 (on the second head) on the
-Matrox G400/G450/G550 card, displaying video <emphasis role="bold">independently</emphasis>
-of the first head.
+Please read the <link linkend="directfb">main DirectFB</link> section for general
+information.
 </para>
 
 <para>
-Instructions on how to make it work can be found in the
-<ulink url="../../tech/directfb.txt">tech</ulink> section
-or directly on Ville Syrjala's
-<ulink url="http://www.sci.fi/~syrjala/directfb/Matrox_TV-out_README.txt">home page</ulink>.
+This video output driver will enable CRTC2 (on the second head) on Matrox
+G400/G450/G550 cards, displaying video
+<emphasis role="bold">independent</emphasis> of the first head.
+</para>
+
+<para>
+Ville Syrjala's has a 
+<ulink url="http://www.sci.fi/~syrjala/directfb/Matrox_TV-out_README.txt">README</ulink>
+and a 
+<ulink url="http://www.sci.fi/~syrjala/directfb/matrox_tv-out_howto">HOWTO</ulink>
+on his homepage that explain how to make DirectFB TV output run on Matrox cards.
 </para>
 
 <note><para>
-the first DirectFB version with which we could kick this working was
+the first DirectFB version with which we could get this working was
 0.9.17 (it's buggy, needs that <systemitem>surfacemanager</systemitem> patch from
 the URL above). Anyway, porting of the CRTC2 code to <emphasis role="bold">mga_vid</emphasis>
 is underway.