docs/README-directfb.md
changeset 9025 d09d4b578e77
parent 9023 276802355854
child 9066 c2af3ff967cc
equal deleted inserted replaced
9023:276802355854 9025:d09d4b578e77
       
     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