docs/README-directfb.md
author Philipp Wiesemann <philipp.wiesemann@arcor.de>
Sun, 15 Mar 2015 19:25:10 +0100
changeset 9383 62164ad0b7d5
parent 9066 c2af3ff967cc
child 10486 5bf595c48fd4
permissions -rw-r--r--
Updated name of assert type in test program.
     1 DirectFB
     2 ========
     3 
     4 Supports:
     5 
     6 - Hardware YUV overlays
     7 - OpenGL - software only
     8 - 2D/3D accelerations (depends on directfb driver)
     9 - multiple displays
    10 - windows
    11 
    12 What you need:
    13 
    14 * DirectFB 1.0.1, 1.2.x, 1.3.0
    15 * Kernel-Framebuffer support: required: vesafb, radeonfb .... 
    16 * Mesa 7.0.x	   - optional for OpenGL
    17 
    18 /etc/directfbrc
    19 
    20 This file should contain the following lines to make
    21 your joystick work and avoid crashes:
    22 ------------------------
    23 disable-module=joystick
    24 disable-module=cle266
    25 disable-module=cyber5k
    26 no-linux-input-grab
    27 ------------------------
    28 
    29 To disable to use x11 backend when DISPLAY variable is found use
    30 
    31 export SDL_DIRECTFB_X11_CHECK=0
    32 
    33 To disable the use of linux input devices, i.e. multimice/multikeyboard support,
    34 use
    35 
    36 export SDL_DIRECTFB_LINUX_INPUT=0
    37 
    38 To use hardware accelerated YUV-overlays for YUV-textures, use:
    39 
    40 export SDL_DIRECTFB_YUV_DIRECT=1
    41 
    42 This is disabled by default. It will only support one 
    43 YUV texture, namely the first. Every other YUV texture will be
    44 rendered in software.
    45 
    46 In addition, you may use (directfb-1.2.x)
    47 
    48 export SDL_DIRECTFB_YUV_UNDERLAY=1
    49 
    50 to make the YUV texture an underlay. This will make the cursor to
    51 be shown.
    52 
    53 Simple Window Manager
    54 =====================
    55 
    56 The driver has support for a very, very basic window manager you may
    57 want to use when running with "wm=default". Use
    58 
    59 export SDL_DIRECTFB_WM=1
    60 
    61 to enable basic window borders. In order to have the window title rendered,
    62 you need to have the following font installed:
    63 
    64 /usr/share/fonts/truetype/freefont/FreeSans.ttf
    65 
    66 OpenGL Support
    67 ==============
    68 
    69 The following instructions will give you *software* OpenGL. However this
    70 works at least on all directfb supported platforms.
    71 
    72 As of this writing 20100802 you need to pull Mesa from git and do the following:
    73 
    74 ------------------------
    75 git clone git://anongit.freedesktop.org/git/mesa/mesa
    76 cd mesa 
    77 git checkout 2c9fdaf7292423c157fc79b5ce43f0f199dd753a
    78 ------------------------
    79 
    80 Edit configs/linux-directfb so that the Directories-section looks like
    81 ------------------------
    82 # Directories
    83 SRC_DIRS     = mesa glu 
    84 GLU_DIRS     = sgi
    85 DRIVER_DIRS  = directfb
    86 PROGRAM_DIRS = 
    87 ------------------------
    88 
    89 make linux-directfb
    90 make
    91 
    92 echo Installing - please enter sudo pw.
    93 
    94 sudo make install INSTALL_DIR=/usr/local/dfb_GL
    95 cd src/mesa/drivers/directfb
    96 make
    97 sudo make install INSTALL_DIR=/usr/local/dfb_GL
    98 ------------------------
    99 
   100 To run the SDL - testprograms:
   101 
   102 export SDL_VIDEODRIVER=directfb
   103 export LD_LIBRARY_PATH=/usr/local/dfb_GL/lib
   104 export LD_PRELOAD=/usr/local/dfb_GL/libGL.so.7
   105 
   106 ./testgl
   107