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