README.DirectFB
author Sam Lantinga <slouken@libsdl.org>
Wed, 26 Nov 2008 21:59:35 +0000
changeset 2791 8133d1d278da
parent 2226 0e70b4b8cf84
child 2815 e759ad5e6f43
permissions -rw-r--r--
Date: Wed, 26 Nov 2008 19:50:31 +0100
From: Couriersud
Subject: LPGL and closed-source license / Re: [Bug 607] Texture palette not up

Permission granted to release code under both LPGL and closed-source
commercial license.

Please find attached a minor patch fixing vsync handling in the directfb
driver and containing a small update to README.directfb
slouken@2226
     1
SDL on DirectFB
slouken@2226
     2
slouken@2226
     3
Supports:
slouken@2226
     4
slouken@2226
     5
- Hardware YUV overlays
slouken@2226
     6
- OpenGL - software only
slouken@2226
     7
- 2D/3D accelerations (depends on directfb driver)
slouken@2226
     8
slouken@2226
     9
What you need:
slouken@2226
    10
slouken@2226
    11
DirectFB 1.0.0 - required
slouken@2226
    12
Kernel-Framebuffer support: required: vesafb, radeonfb .... 
slouken@2226
    13
Mesa 7.0.x	   - optional for OpenGL
slouken@2226
    14
slouken@2226
    15
As of this writing 20070810 you need to pull Mesa from git and do the following:
slouken@2226
    16
slouken@2226
    17
------------------------
slouken@2226
    18
cd mesa 
slouken@2226
    19
make linux-directfb
slouken@2226
    20
make
slouken@2226
    21
slouken@2226
    22
echo Installing - pleaser enter sudo pw.
slouken@2226
    23
slouken@2226
    24
sudo make install INSTALL_DIR=/usr/local/dfb_GL
slouken@2226
    25
cd src/mesa/drivers/directfb
slouken@2226
    26
make
slouken@2226
    27
sudo make install INSTALL_DIR=/usr/local/dfb_GL
slouken@2226
    28
------------------------
slouken@2226
    29
slouken@2791
    30
/etc/directfbrc
slouken@2791
    31
slouken@2791
    32
This file should contain the following two lines to make
slouken@2791
    33
your joystick work:
slouken@2791
    34
------------------------
slouken@2791
    35
disable-module=joystick
slouken@2791
    36
disable-module=linux_input
slouken@2791
    37
------------------------
slouken@2791
    38
slouken@2226
    39
To run the SDL - testprograms:
slouken@2226
    40
slouken@2226
    41
export SDL_VIDEODRIVER=directfb
slouken@2226
    42
export LD_LIBRARY_PATH=/usr/local/dfb_GL/lib
slouken@2226
    43
export LD_PRELOAD=/usr/local/dfb_GL/libGL.so.7
slouken@2226
    44
slouken@2226
    45
./testgl
slouken@2226
    46
slouken@2226
    47
To use hardware accelerated YUV-overlays for YUV-textures, use:
slouken@2226
    48
slouken@2226
    49
export SDL_DIRECTFB_YUV_DIRECT=1
slouken@2226
    50
slouken@2791
    51
This is disabled by default. It will only support one 
slouken@2791
    52
YUV texture, namely the first. Every other YUV texture will be
slouken@2791
    53
rendered in software.
slouken@2791
    54
slouken@2791
    55
In addition, you may use 
slouken@2791
    56
slouken@2791
    57
export SDL_DIRECTFB_YUV_UNDERLAY=1
slouken@2791
    58
slouken@2791
    59
to make the YUV texture an underlay. This will make the cursor to
slouken@2791
    60
be shown.
slouken@2791
    61