README.android
changeset 6330 0fa55ca2efdd
parent 6273 2fa7e0540f95
child 6354 17840f487124
     1.1 --- a/README.android	Tue Jun 19 12:29:53 2012 -0400
     1.2 +++ b/README.android	Tue Jun 19 13:57:42 2012 -0300
     1.3 @@ -74,6 +74,24 @@
     1.4  
     1.5  
     1.6  ================================================================================
     1.7 + Pause / Resume behaviour
     1.8 +================================================================================
     1.9 +
    1.10 +If SDL is compiled with SDL_ANDROID_BLOCK_ON_PAUSE defined, the event loop will
    1.11 +block itself when the app is paused (ie, when the user returns to the main
    1.12 +Android dashboard). Blocking is better in terms of battery use, and it allows your
    1.13 +app to spring back to life instantaneously after resume (versus polling for
    1.14 +a resume message).
    1.15 +Upon resume, SDL will attempt to restore the GL context automatically.
    1.16 +In modern devices (Android 3.0 and up) this will most likely succeed and your
    1.17 +app can continue to operate as it was.
    1.18 +However, there's a chance (on older hardware, or on systems under heavy load),
    1.19 +where the GL context can not be restored. In that case you have to listen for
    1.20 +a specific message, (which is not yet implemented!) and restore your textures
    1.21 +manually or quit the app (which is actually the kind of behaviour you'll see
    1.22 +under iOS, if the OS can not restore your GL context it will just kill your app)
    1.23 +
    1.24 +================================================================================
    1.25   Additional documentation
    1.26  ================================================================================
    1.27