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
     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 /etc/directfbrc
    31 
    32 This file should contain the following two lines to make
    33 your joystick work:
    34 ------------------------
    35 disable-module=joystick
    36 disable-module=linux_input
    37 ------------------------
    38 
    39 To run the SDL - testprograms:
    40 
    41 export SDL_VIDEODRIVER=directfb
    42 export LD_LIBRARY_PATH=/usr/local/dfb_GL/lib
    43 export LD_PRELOAD=/usr/local/dfb_GL/libGL.so.7
    44 
    45 ./testgl
    46 
    47 To use hardware accelerated YUV-overlays for YUV-textures, use:
    48 
    49 export SDL_DIRECTFB_YUV_DIRECT=1
    50 
    51 This is disabled by default. It will only support one 
    52 YUV texture, namely the first. Every other YUV texture will be
    53 rendered in software.
    54 
    55 In addition, you may use 
    56 
    57 export SDL_DIRECTFB_YUV_UNDERLAY=1
    58 
    59 to make the YUV texture an underlay. This will make the cursor to
    60 be shown.
    61