SDL  2.0
docs/README-directfb.md
Go to the documentation of this file.
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