Go to file
David Ludwig 50ee99ecb2 WinRT: Made app-backgrounded events get sent at separate, distinct times.
SDL_APP_WILLENTERBACKGROUND is now sent as soon as the app is told that it is
about to go to the background.  SDL_APP_DIDENTERBACKGROUND is sent via a WinRT
'deferral operation', which is how WinRT gives apps a bit of extra time
(multiple seconds worth) to prepare for an app-backgrounding.

The distinction may be important as the deferral operation's code is always run
in a separate thread.  For Direct3D-only apps, this means that between the
two SDL app-backgrounded events, SDL_APP_WILLENTERBACKGROUND will be the only
one run from the main thread.  Given that some WinRT operations can only be done
on the main thread (operations to the CoreWindow fall into this category), this
could be important.

It is important to note that pre-deferral code may only have a very short bit of
time to execute code, less so than code run in the deferral operation (where
SDL_APP_DIDENTERBACKGROUND is sent from), which usually gets several seconds to
run.
2014-03-23 08:56:52 -04:00
VisualC Add input validation to SDL_getenv/SDL_setenv; update Stdlib testsuite; add Hints testsuite 2014-03-19 21:39:55 -07:00
VisualC-WinPhone/SDL Fixed broken rotation detection routines on WinRT 2014-03-15 14:54:23 -04:00
VisualC-WinRT WinRT: Got OpenGL ES 2 working with the latest version of ANGLE/WinRT. 2014-03-22 20:48:18 -04:00
Xcode Updated framework version to match dylib version. 2014-03-12 07:55:32 -07:00
Xcode-iOS Integrated David Ludwig's support for Windows RT 2014-03-09 11:36:47 -07:00
acinclude Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
android-project Try to work around Android's handling of static variables in terminated apps 2014-02-12 18:12:14 -03:00
build-scripts Minor comment cleanups in checker-buildbot.sh 2014-03-19 22:43:30 -04:00
cmake CMake: Just assume Apple platforms have Cocoa support. 2014-02-23 01:10:33 -05:00
debian Updated SDL to version 2.0.3 2014-03-09 10:38:30 -07:00
include WinRT: Got OpenGL ES 2 working with the latest version of ANGLE/WinRT. 2014-03-22 20:48:18 -04:00
premake Fixed bug 2374 - Update copyright for 2014... 2014-02-02 00:53:27 -08:00
src WinRT: Made app-backgrounded events get sent at separate, distinct times. 2014-03-23 08:56:52 -04:00
test Fix visualstudio build break introduced by changeset 8645 2014-03-19 21:48:32 -07:00
visualtest Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
.hgignore Ignore the buildbot build directories. 2014-02-02 21:38:16 -05:00
Android.mk Add Dynamic API to Android makefile. 2014-01-08 00:45:29 -05:00
BUGS.txt Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
CMakeLists.txt Disable Wayland/Mir again for 2.0.3; it's a quick, brown-paper-bag release. 2014-03-11 10:33:51 -04:00
COPYING.txt Fixed bug 2374 - Update copyright for 2014... 2014-02-02 00:53:27 -08:00
CREDITS.txt Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
INSTALL.txt Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
Makefile.in Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
Makefile.minimal Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
Makefile.pandora Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
Makefile.psp Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
Makefile.wiz Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
README-SDL.txt Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
README-android.txt Updated paths in README for Android. 2013-12-25 16:53:39 +01:00
README-cmake.txt Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
README-directfb.txt Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
README-dynapi.txt Adds README-dynapi.txt based on Ryan's G+ post (lightly edited) 2014-01-15 12:29:17 -03:00
README-gesture.txt Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
README-hg.txt Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
README-ios.txt Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
README-linux.txt Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
README-macosx.txt Updated to build on Mac OS X 10.7 with Xcode 4.6 2014-03-02 12:58:00 -08:00
README-pandora.txt Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
README-platforms.txt Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
README-porting.txt Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
README-psp.txt Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
README-raspberrypi.txt Fixed typo in documentation. 2014-01-26 23:42:25 +01:00
README-touch.txt Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
README-wince.txt Updated WinCE readme to note WinRT work. 2014-03-10 00:31:31 -04:00
README-windows.txt Corrected name of hint in README. 2014-02-15 23:52:04 +01:00
README.txt Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
SDL2.spec.in Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
TODO.txt Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
VisualC.html Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
WhatsNew.txt Added a patch note for 2.0.3 2014-03-15 16:43:58 -07:00
autogen.sh Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
configure Disable Wayland/Mir again for 2.0.3; it's a quick, brown-paper-bag release. 2014-03-11 10:33:51 -04:00
configure.in Disable Wayland/Mir again for 2.0.3; it's a quick, brown-paper-bag release. 2014-03-11 10:33:51 -04:00
sdl2-config.in Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
sdl2.m4 Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00
sdl2.pc.in Improve Android pause/resume behavior. 2013-11-29 10:06:08 -03:00

README.txt

This file contains invisible Unicode characters!

This file contains invisible Unicode characters that may be processed differently from what appears below. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to reveal hidden characters.


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

This library is distributed under the zlib license, which can be found
in the file "COPYING.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:
	http://wiki.libsdl.org/

If you need help with the library, or just want to discuss SDL related
issues, you can join the developers mailing list:
	http://www.libsdl.org/mailing-list.php

If you want to report bugs or contribute patches, please submit them to
bugzilla:
    http://bugzilla.libsdl.org/

Enjoy!
	Sam Lantinga				(slouken@libsdl.org)