README.DirectFB
author Sam Lantinga <slouken@libsdl.org>
Sat, 11 Aug 2007 21:51:19 +0000
changeset 2226 0e70b4b8cf84
child 2791 8133d1d278da
permissions -rw-r--r--
Date: Sat, 11 Aug 2007 02:03:16 +0200 (CEST)
From: couriersud arcor.de
To: slouken@libsdl.org
Subject: Directfb driver for SDL1.3

Hi,

the attachment contains a patch for a SDL1.3 directfb driver. It supports:

- Renderer "directfb":

Hardware acceleration as supported by the underlying directfb driver. With a
radeon X850, testsprite2 runs at 50% to 70% of OpenGL (X11, dri) performance.

Also supports hardware accelerated yuv overlays. This must be enabled by sett
ing:

export SDL_DIRECTFB_YUV_DIRECT=1

- Renderer "opengl"

Supports software opengl using mesa opengl (make linux-directfb).

Some more information may be found in README.DirectFB

There will certainly still be some bugs, and there is some debug code around.
When I find some time, I will compile against directfb-0.9.25 as distributed
with ubuntu 7.04.

The diff also contains a fix for SDL_LockYUVOverlay fixing a bug in *pixels
and pitches initialization.

Kind regards,

couriersud
     1 SDL on DirectFB
     2 
     3 Supports:
     4 
     5 - Hardware YUV overlays
     6 - OpenGL - software only
     7 - 2D/3D accelerations (depends on directfb driver)
     8 
     9 What you need:
    10 
    11 DirectFB 1.0.0 - required
    12 Kernel-Framebuffer support: required: vesafb, radeonfb .... 
    13 Mesa 7.0.x	   - optional for OpenGL
    14 
    15 As of this writing 20070810 you need to pull Mesa from git and do the following:
    16 
    17 ------------------------
    18 cd mesa 
    19 make linux-directfb
    20 make
    21 
    22 echo Installing - pleaser enter sudo pw.
    23 
    24 sudo make install INSTALL_DIR=/usr/local/dfb_GL
    25 cd src/mesa/drivers/directfb
    26 make
    27 sudo make install INSTALL_DIR=/usr/local/dfb_GL
    28 ------------------------
    29 
    30 To run the SDL - testprograms:
    31 
    32 export SDL_VIDEODRIVER=directfb
    33 export LD_LIBRARY_PATH=/usr/local/dfb_GL/lib
    34 export LD_PRELOAD=/usr/local/dfb_GL/libGL.so.7
    35 
    36 ./testgl
    37 
    38 To use hardware accelerated YUV-overlays for YUV-textures, use:
    39 
    40 export SDL_DIRECTFB_YUV_DIRECT=1
    41 
    42 This is disabled by default. It will only support one concurrent 
    43 overlay and may behave strange if not used with SDL_CreateYUvOverlay
    44 from SDLcompat.c. 
    45