author Sam Lantinga <>
Sun, 10 Mar 2013 09:03:38 -0700
changeset 6987 7084af936d82
parent 5199 164f20ba08eb
permissions -rw-r--r--
Fixed bug 1748 - Patch for errors and mistakes in SDL 2 README files. Philipp Wiesemann SDL's README files seem to contain multiple errors and mistakes. I attached a patch with changes and updates. README: * removed Windows CE because no more supported README-SDL.txt: * corrected spelling mistake README.DirectFB: * corrected spelling mistakes README.MacOSX: * corrected spelling mistakes README.Platforms: * changed Android version to match AndroidManifest.xml README.Porting: * added missing directories from list * removed cdrom directories from list * updated required NDK revision * add to list * changed lower limit for to android-10 and removed upper * added a statement why older devices not supported * added correct dates to statements about OpenGL ES * added info about Google's device numbers and date * corrected spelling mistakes README.gesture: * corrected spelling mistakes README.pandora: * corrected spelling mistake README.touch: * changed that values are no in range 0..1 * updated the names of some functions * updated the notes about usage * corrected spelling mistakes * added info that API changed near original author contact

SDL on DirectFB


- 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


This file should contain the following lines to make
your joystick work and avoid crashes:

To disable to use x11 backend when DISPLAY variable is found use


To disable the use of linux input devices, i.e. multimice/multikeyboard support,


To use hardware accelerated YUV-overlays for YUV-textures, use:


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)


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


to enable basic window borders. In order to have the window title rendered,
you need to have the following font installed:


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://
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

make linux-directfb

echo Installing - please enter sudo pw.

sudo make install INSTALL_DIR=/usr/local/dfb_GL
cd src/mesa/drivers/directfb
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/