Introduction to SDL 2.0

1. Introduction to SDL

1.1. What is SDL?

Simple DirectMedia Layer is a cross-platform development library designed to provide low level access to audio, keyboard, mouse, joystick, and graphics hardware via OpenGL and Direct3D. It is used by video playback software, emulators, and popular games including Valve's award winning catalog and many Humble Bundle games.

SDL officially supports Windows, Mac OS X, Linux, iOS, and Android. Support for other platforms may be found in the source code.

SDL is written in C, works natively with C++, and there are bindings available for several other languages, including C# and Python.

SDL 2.0 is distributed under the zlib license. This license allows you to use SDL freely in any software. The Simple DirectMedia Layer library (SDL) is a general API that provides low level access to audio, keyboard, mouse, joystick, 3D hardware via OpenGL, and 2D framebuffer across multiple platforms.

1.2. What can SDL do?

Read ahead for an overview of what SDL is capable of. If you're simply interested in the changes from 1.2 to 2.0, check out the Migration Guide.


Input Events

Force Feedback


File I/O Abstraction

Shared Object Support



CPU Feature Detection

Endian Independence

Power Management

1.3. What platforms does SDL run on?


Mac OS X




2. How to get and install SDL

You can get the source code and build and install it.

3. Transitioning from SDL 1.2 to 2.0

If you used SDL 1.2 previously and you want to use SDL 2.0, please note there are some API changes and some of your code will need to be adapted.

The migration guide lists the feature differences and how to adapt old code to the new SDL 2.0:

None: Introduction (last edited 2015-02-21 10:44:19 by PhilippWiesemann)