
I'm taking a page from Dolphin's book, and including copies of each dependency's source code. This combines the ease of use of including pre-built libraries instead of needing to navigate a package manager - as is (or was) the case for MSVC - with the portability of using packages. Granted, this method's more of a jack of all trades, master of none, since it's *less* user-friendly than prebuilt packages (compilation times), and you don't get the per-distro compatibility fixes you'd get from a package manager. You can still use system libs if you want. In fact, it's still the default behaviour: compiling the libs manually is just a fallback. I'll add an option to force-enable this soon, however, since it's a nicer way to produce static MSYS2 builds than the hackish nightmare that I was using before. Not to mention, having my own copy of the sources means I can provide my own fixes and tweaks your package manager may not. For example, I can combine MSYS2's FreeType subpixel rendering with vcpkg's fix for SDL2 exporting its symbols in static builds.
107 lines
2.6 KiB
Markdown
107 lines
2.6 KiB
Markdown
DirectFB
|
|
========
|
|
|
|
Supports:
|
|
|
|
- Hardware YUV overlays
|
|
- OpenGL - software only
|
|
- 2D/3D accelerations (depends on directfb driver)
|
|
- multiple displays
|
|
- windows
|
|
|
|
What you need:
|
|
|
|
* DirectFB 1.0.1, 1.2.x, 1.3.0
|
|
* Kernel-Framebuffer support: required: vesafb, radeonfb ....
|
|
* Mesa 7.0.x - optional for OpenGL
|
|
|
|
/etc/directfbrc
|
|
|
|
This file should contain the following lines to make
|
|
your joystick work and avoid crashes:
|
|
------------------------
|
|
disable-module=joystick
|
|
disable-module=cle266
|
|
disable-module=cyber5k
|
|
no-linux-input-grab
|
|
------------------------
|
|
|
|
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
|
|
|
|
To use hardware accelerated YUV-overlays for YUV-textures, use:
|
|
|
|
export SDL_DIRECTFB_YUV_DIRECT=1
|
|
|
|
This is disabled by default. It will only support one
|
|
YUV texture, namely the first. Every other YUV texture will be
|
|
rendered in software.
|
|
|
|
In addition, you may use (directfb-1.2.x)
|
|
|
|
export SDL_DIRECTFB_YUV_UNDERLAY=1
|
|
|
|
to make the YUV texture an underlay. This will make the cursor to
|
|
be shown.
|
|
|
|
Simple Window Manager
|
|
=====================
|
|
|
|
The driver has support for a very, very basic window manager you may
|
|
want to use when running 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
|
|
|
|
OpenGL Support
|
|
==============
|
|
|
|
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:
|
|
|
|
------------------------
|
|
git clone git://anongit.freedesktop.org/git/mesa/mesa
|
|
cd mesa
|
|
git checkout 2c9fdaf7292423c157fc79b5ce43f0f199dd753a
|
|
------------------------
|
|
|
|
Edit configs/linux-directfb so that the Directories-section looks like
|
|
------------------------
|
|
# Directories
|
|
SRC_DIRS = mesa glu
|
|
GLU_DIRS = sgi
|
|
DRIVER_DIRS = directfb
|
|
PROGRAM_DIRS =
|
|
------------------------
|
|
|
|
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
|
|
|