README.DirectFB
author Sam Lantinga <slouken@libsdl.org>
Mon, 01 Dec 2008 00:10:49 +0000
changeset 2815 e759ad5e6f43
parent 2791 8133d1d278da
child 2998 d364ee9b9c15
permissions -rw-r--r--
Date: Mon, 01 Dec 2008 00:57:15 +0100
From: Couriersud
Subject: SDL : Diff for directfb driver

please find attached a diff against SVN containing the following:

- Updated README.DirectFB a bit
- Fix compile issue with debug output
- Fix display mode setting/switching for directfb >= 1.2.2
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