sdl

FORK: Simple Directmedia Layer
git clone https://git.neptards.moe/neptards/sdl.git
Log | Files | Refs

README-directfb.md (2660B)

      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