README-directfb.txt
changeset 7222 2435b221d77d
parent 6987 7084af936d82
child 7241 28602f5ca96d
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/README-directfb.txt	Sun May 26 11:06:17 2013 -0700
     1.3 @@ -0,0 +1,106 @@
     1.4 +SDL on DirectFB
     1.5 +
     1.6 +Supports:
     1.7 +
     1.8 +- Hardware YUV overlays
     1.9 +- OpenGL - software only
    1.10 +- 2D/3D accelerations (depends on directfb driver)
    1.11 +- multiple displays
    1.12 +- windows
    1.13 +
    1.14 +What you need:
    1.15 +
    1.16 +DirectFB 1.0.1, 1.2.x, 1.3.0
    1.17 +Kernel-Framebuffer support: required: vesafb, radeonfb .... 
    1.18 +esa 7.0.x	   - optional for OpenGL
    1.19 +
    1.20 +/etc/directfbrc
    1.21 +
    1.22 +This file should contain the following lines to make
    1.23 +your joystick work and avoid crashes:
    1.24 +------------------------
    1.25 +disable-module=joystick
    1.26 +disable-module=cle266
    1.27 +disable-module=cyber5k
    1.28 +no-linux-input-grab
    1.29 +------------------------
    1.30 +
    1.31 +To disable to use x11 backend when DISPLAY variable is found use
    1.32 +
    1.33 +export SDL_DIRECTFB_X11_CHECK=0
    1.34 +
    1.35 +To disable the use of linux input devices, i.e. multimice/multikeyboard support,
    1.36 +use
    1.37 +
    1.38 +export SDL_DIRECTFB_LINUX_INPUT=0
    1.39 +
    1.40 +To use hardware accelerated YUV-overlays for YUV-textures, use:
    1.41 +
    1.42 +export SDL_DIRECTFB_YUV_DIRECT=1
    1.43 +
    1.44 +This is disabled by default. It will only support one 
    1.45 +YUV texture, namely the first. Every other YUV texture will be
    1.46 +rendered in software.
    1.47 +
    1.48 +In addition, you may use (directfb-1.2.x)
    1.49 +
    1.50 +export SDL_DIRECTFB_YUV_UNDERLAY=1
    1.51 +
    1.52 +to make the YUV texture an underlay. This will make the cursor to
    1.53 +be shown.
    1.54 +
    1.55 +Simple Window Manager
    1.56 +=====================
    1.57 +
    1.58 +The driver has support for a very, very basic window manager you may
    1.59 +want to use when running with "wm=default". Use
    1.60 +
    1.61 +export SDL_DIRECTFB_WM=1
    1.62 +
    1.63 +to enable basic window borders. In order to have the window title rendered,
    1.64 +you need to have the following font installed:
    1.65 +
    1.66 +/usr/share/fonts/truetype/freefont/FreeSans.ttf
    1.67 +
    1.68 +OpenGL Support
    1.69 +==============
    1.70 +
    1.71 +The following instructions will give you *software* OpenGL. However this
    1.72 +works at least on all directfb supported platforms.
    1.73 +
    1.74 +As of this writing 20100802 you need to pull Mesa from git and do the following:
    1.75 +
    1.76 +------------------------
    1.77 +git clone git://anongit.freedesktop.org/git/mesa/mesa
    1.78 +cd mesa 
    1.79 +git checkout 2c9fdaf7292423c157fc79b5ce43f0f199dd753a
    1.80 +------------------------
    1.81 +
    1.82 +Edit configs/linux-directfb so that the Directories-section looks like
    1.83 +------------------------
    1.84 +# Directories
    1.85 +SRC_DIRS     = mesa glu 
    1.86 +GLU_DIRS     = sgi
    1.87 +DRIVER_DIRS  = directfb
    1.88 +PROGRAM_DIRS = 
    1.89 +------------------------
    1.90 +
    1.91 +make linux-directfb
    1.92 +make
    1.93 +
    1.94 +echo Installing - please enter sudo pw.
    1.95 +
    1.96 +sudo make install INSTALL_DIR=/usr/local/dfb_GL
    1.97 +cd src/mesa/drivers/directfb
    1.98 +make
    1.99 +sudo make install INSTALL_DIR=/usr/local/dfb_GL
   1.100 +------------------------
   1.101 +
   1.102 +To run the SDL - testprograms:
   1.103 +
   1.104 +export SDL_VIDEODRIVER=directfb
   1.105 +export LD_LIBRARY_PATH=/usr/local/dfb_GL/lib
   1.106 +export LD_PRELOAD=/usr/local/dfb_GL/libGL.so.7
   1.107 +
   1.108 +./testgl
   1.109 +