SDL/docs
Simon McVittie cd7c2f1de7 Switch versioning scheme to be the same as GLib and Flatpak
For stable releases, this gives us the ability to make bugfix-only point
releases such as 2.24.1 if we want to, and distinguish between them
programmatically. For example, this ability could have been useful after
2.0.16 to fix Xwayland regressions, and after 2.0.18 to fix event loop
regressions.

For development releases, this gives us the ability to make multiple
prereleases during the same feature cycle, and distinguish between them
programmatically. For example, this would have been useful during 2.0.22
development, which went through three prereleases before reaching the
final release.

Signed-off-by: Simon McVittie <smcv@collabora.com>
2022-05-04 09:55:35 -07:00
..
README-android.md Android: add comment to set render target to NULL when going to background (bug #4041) 2022-03-14 10:43:18 +01:00
README-cmake.md CMake: tabs to spaces in new parts of README-cmake.md 2019-09-23 18:30:22 -04:00
README-directfb.md Clean up formatting in README-directfb.md 2022-03-27 09:12:25 -07:00
README-dynapi.md README-dynapi.md: Google+ link is gone, remove it. 2021-08-03 22:15:04 -04:00
README-emscripten.md Emscripten: Simplified option name in build script and README. 2017-04-02 21:33:24 +02:00
README-gesture.md Fixed crash if initialization of EGL failed but was tried again later. 2015-06-21 17:33:46 +02:00
README-git.md Revert "Update wiki.libsdl.org urls to libsdl-org/SDL/wiki (#4069)" 2021-04-01 12:15:28 -04:00
README-hg.md Deprecate SDL_GetRevisionNumber and update things for git instead of hg. 2021-02-12 14:31:38 -05:00
README-ios.md Added a step necessary for running on a real device 2021-11-30 21:25:40 -08:00
README-kmsbsd.md KMSDRM on Dragonfly BSD doesn't work without being root 2021-05-12 09:26:23 -07:00
README-linux.md Add missing backslashes in README-linux.md command 2022-04-29 12:41:40 -04:00
README-macos.md docs: Don't let Doxygen expand HOME environment variable 2021-12-01 02:37:40 +03:00
README-nacl.md Converted README documentation to DOS text format 2016-10-07 17:46:58 -07:00
README-ngage.md Add support for the Nokia N-Gage (#5597) 2022-05-03 08:51:49 -07:00
README-os2.md fixed typo: ervironment to environment 2021-11-22 11:35:40 +03:00
README-pandora.md Converted README documentation to DOS text format 2016-10-07 17:46:58 -07:00
README-platforms.md Revert "Update wiki.libsdl.org urls to libsdl-org/SDL/wiki (#4069)" 2021-04-01 12:15:28 -04:00
README-porting.md docs: Replace references to configure.in with configure.ac 2019-03-27 20:58:33 +11:00
README-psp.md Updating Readme-psp info 2022-02-02 08:36:39 -05:00
README-raspberrypi.md x11: Remove XVidMode and Xinerama support. 2022-04-26 23:17:13 -04:00
README-riscos.md docs: Add README-riscos.md 2021-10-30 21:25:01 -07:00
README-touch.md Converted README documentation to DOS text format 2016-10-07 17:46:58 -07:00
README-visualc.md Remove URLs from markdown headers in README-visualc.md 2022-03-27 09:12:25 -07:00
README-vita.md Vita: fix readme 2022-03-31 06:02:50 -07:00
README-wince.md Converted README documentation to DOS text format 2016-10-07 17:46:58 -07:00
README-windows.md README-windows: Notes on building with Visual Studio/LLVM. 2022-03-26 08:55:26 -04:00
README-winrt.md README-winrt.md: Cleaned up sample code 2021-08-03 21:52:47 -04:00
README.md Add support for the Nokia N-Gage (#5597) 2022-05-03 08:51:49 -07:00
doxyfile docs/release_checklist.md: Document how/where to bump version numbers 2022-05-04 09:55:35 -07:00
release_checklist.md Switch versioning scheme to be the same as GLib and Flatpak 2022-05-04 09:55:35 -07:00

README.md

Simple DirectMedia Layer

                              (SDL)

                            Version 2.0

http://www.libsdl.org/

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, macOS, 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.

This library is distributed under the zlib license, which can be found in the file "LICENSE.txt".

The best way to learn how to use SDL is to check out the header files in the "include" subdirectory and the programs in the "test" subdirectory. The header files and test programs are well commented and always up to date.

More documentation and FAQs are available online at the wiki

If you need help with the library, or just want to discuss SDL related issues, you can join the SDL Discourse, which can be used as a web forum or a mailing list, at your preference.

If you want to report bugs or contribute patches, please submit them to our bug tracker

Enjoy!

Sam Lantinga mailto:slouken@libsdl.org