README.DirectFB
author Sam Lantinga
Tue, 02 Dec 2008 17:14:04 +0000
changeset 2824 4dba7aa7ea77
parent 2815 e759ad5e6f43
child 2998 d364ee9b9c15
permissions -rw-r--r--
Added slow but complete blit fallback
Don't try to RLE encode surfaces that have alpha channel and alpha modulation
Don't turn on blending when converting an RGB surface to RGBA format
Do turn on blending when converting colorkey to alpha channel
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@2815
     8
- multiple displays
slouken@2815
     9
- windows
slouken@2226
    10
slouken@2226
    11
What you need:
slouken@2226
    12
slouken@2815
    13
DirectFB 1.0.1, 1.2.x, 1.3.0
slouken@2226
    14
Kernel-Framebuffer support: required: vesafb, radeonfb .... 
slouken@2226
    15
Mesa 7.0.x	   - optional for OpenGL
slouken@2226
    16
slouken@2815
    17
/etc/directfbrc
slouken@2815
    18
slouken@2815
    19
This file should contain the following lines to make
slouken@2815
    20
your joystick work and avoid crashes:
slouken@2815
    21
------------------------
slouken@2815
    22
disable-module=joystick
slouken@2815
    23
disable-module=linux_input
slouken@2815
    24
disable-module=cle266
slouken@2815
    25
disable-module=cyber5k
slouken@2815
    26
disable-module=x11input
slouken@2815
    27
------------------------
slouken@2815
    28
slouken@2815
    29
To use hardware accelerated YUV-overlays for YUV-textures, use:
slouken@2815
    30
slouken@2815
    31
export SDL_DIRECTFB_YUV_DIRECT=1
slouken@2815
    32
slouken@2815
    33
This is disabled by default. It will only support one 
slouken@2815
    34
YUV texture, namely the first. Every other YUV texture will be
slouken@2815
    35
rendered in software.
slouken@2815
    36
slouken@2815
    37
In addition, you may use (directfb-1.2.x)
slouken@2815
    38
slouken@2815
    39
export SDL_DIRECTFB_YUV_UNDERLAY=1
slouken@2815
    40
slouken@2815
    41
to make the YUV texture an underlay. This will make the cursor to
slouken@2815
    42
be shown.
slouken@2815
    43
slouken@2815
    44
OPENGL Support
slouken@2815
    45
==============
slouken@2815
    46
slouken@2226
    47
As of this writing 20070810 you need to pull Mesa from git and do the following:
slouken@2226
    48
slouken@2226
    49
------------------------
slouken@2226
    50
cd mesa 
slouken@2226
    51
make linux-directfb
slouken@2226
    52
make
slouken@2226
    53
slouken@2815
    54
echo Installing - please enter sudo pw.
slouken@2226
    55
slouken@2226
    56
sudo make install INSTALL_DIR=/usr/local/dfb_GL
slouken@2226
    57
cd src/mesa/drivers/directfb
slouken@2226
    58
make
slouken@2226
    59
sudo make install INSTALL_DIR=/usr/local/dfb_GL
slouken@2226
    60
------------------------
slouken@2226
    61
slouken@2226
    62
To run the SDL - testprograms:
slouken@2226
    63
slouken@2226
    64
export SDL_VIDEODRIVER=directfb
slouken@2226
    65
export LD_LIBRARY_PATH=/usr/local/dfb_GL/lib
slouken@2226
    66
export LD_PRELOAD=/usr/local/dfb_GL/libGL.so.7
slouken@2226
    67
slouken@2226
    68
./testgl