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