This README is supposed to tell you what all this stuff does ;)

--------------------

Mesa-embedded-2-branch-<date>.tar.bz2

Mesa source code for use with DirectFBGL.
Originally from Mesa cvs embedded-2-branch.
Has since received a lot of bugfixes to the mga driver and Mesa code
itself has been updated to latest 5.x state.
Also includes a hack to allow playing GLX games under XDirectFB.

Installation:

1: Unpack Mesa sources

2: Install DirectFBGL headers (cvs version required)
 $ cd <path to DirectFBGL sources>
 $ ./autogen.sh --with-mesa=<path to Mesa sources>
 $ cd include
 # make install

3: Compile Mesa
 $ cd <path to Mesa sources>
 $ make

4: Compile and install DirectFBGL
 $ cd <path to DirectFBGL sources>
 $ make
 # make install

5: Compile mga drm kernel module (included in Mesa sources)
 $ cd <path to Mesa sources>
 $ cd src/kernel/drm
 $ make
 
 Then insmod the resulting mga.o (on 2.4 kernel) or mga.ko (on 2.6 kernel).
 This module should work fine with XFree86/DRI too. But note that some
 security checks have been disabled in the module so it's not as safe as the
 official drm module...

6: You may also need to create DRI device file.
 # mkdir /dev/dri
 # mknod /dev/dri/card0 c 226 0

 And remember to set the file permissions so you can access it.

Now you should be able to run df_gears and other DirectFBGL apps.

--------------------

xdirectfb_glx_hack.patch

Patch to XDirectFB to make keyboard input work when playing Quake3 with the GLX hack.
Apply the patch and recompile XDirectFB.

The you can play quake3 ;)
LD_LIBRARY_PATH=<path to Mesa sources>/lib quake3

--------------------

sdl_directfb_gl.patch

Patch to SDL that adds OpenGL support to the directfb video driver.

1: Get SDL cvs sources (the patch might work with older versions too...)
 Instructions at http://www.libsdl.org/cvs.php

2: Apply the patch
 $ cd SDL12
 $ patch -p1 < sdl_config_gl.patch

3: Compile and install
 $ ./configure --enable-directfb
 $ make
 # make install

Now you should be able to run SDL OpenGL programs on DirectFBGL.
SDL_VIDEODRIVER=directfb LD_LIBRARY_PATH=<Mesa source directory>/lib some_program

Some games I've succesfully played: glaxium, chromiun, freespace2

--------------------

freeglut-directfb.tar.bz2

DirectFBGL port of freeglut (http://freeglut.sourceforge.net).
A full featured GLUT implementation.

$ ./configure --enable-directfb
$ make
# make install


freeglut-directfb.pc

A pkg-config file for freeglut-directfb. Just copy it to your pkg-config directory.

There are a lot of small GLUT demo programs included in Mesa.
Check the demos, tests, samples and book directories in Mesa sources.
Just type 'make' in each directory to build the samples.

--------------------

Rage128Samples-linux.tar.gz

Some OpenGL sample apps from ATI.
I just made the compile with DirectFBGL and added some autoconf/automake
stuff to make compilation easier. You need to install freeglut-directfb
and the pkg-config file first.

Installation:
 $ ./configure
 $ make

Usage:
 $ cd Rage128AlphaTest/Debug
 $ ../Rage128AlphaTest

 Repeat the same for the other sample programs.

 Here are the keys you can use to control the samples. You can also use the
 mouse to rotate the objects. [esc] always exits the program.

 Rage128AlphaTest:
  +/-              - Increment/decrement value used for alpha test by 0.05
  a                - Toggle alpha blending on and off

 Rage128Bump:
  left mouse drag  - Rotate object
  right mouse drag - Rotate light
  +/-              - Cycle through textures
  a                - toggle display of tangent space axes
  l                - toggle display of light vector
  s                - toggle number of vertices displayed
  b                - toggle bump mapping on/off
  c                - toggle color tinting on/off
  j/k              - move displayed vertex left/right
  i/m              - move displayed vertex up/down
  w                - toggle wire frame on/off
  f                - toggle filling on/off

 Rage128CrossFade:
  +/-     - Increase/decrease band between scenes during cross fade
  [space] - Begin cross-fade

 Rage128EdgeClamp:
  left mouse drag  - Rotate object
  [space]          - Change clamp mode

 Rage128LightMap:
  left mouse drag  - Rotate object
  m                - Toggle multitexturing
  [up]/[down]      - Change texture offset

 Rage128Specular:
  left mouse drag  - Rotate object
  [space]          - Change shader state

 Rage128StencilCap:
  left mouse drag  - Rotate object
  right mouse drag - Slide clip plane
  o                - Cycle through some convex objects
  p                - Toggle drawing alpha blended clip plane

--------------------