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