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
108