README.android
changeset 6664 2deb17aefbaf
parent 6657 35de500cc918
child 6678 afb9be20f8d2
     1.1 --- a/README.android	Wed Nov 07 20:17:07 2012 -0800
     1.2 +++ b/README.android	Wed Nov 07 20:17:27 2012 -0800
     1.3 @@ -143,14 +143,16 @@
     1.4   Pause / Resume behaviour
     1.5  ================================================================================
     1.6  
     1.7 -If SDL is compiled with SDL_ANDROID_BLOCK_ON_PAUSE defined, the event loop will
     1.8 -block itself when the app is paused (ie, when the user returns to the main
     1.9 -Android dashboard). Blocking is better in terms of battery use, and it allows your
    1.10 -app to spring back to life instantaneously after resume (versus polling for
    1.11 -a resume message).
    1.12 +If SDL is compiled with SDL_ANDROID_BLOCK_ON_PAUSE defined (the default),
    1.13 +the event loop will block itself when the app is paused (ie, when the user
    1.14 +returns to the main Android dashboard). Blocking is better in terms of battery
    1.15 +use, and it allows your app to spring back to life instantaneously after resume
    1.16 +(versus polling for a resume message).
    1.17 +
    1.18  Upon resume, SDL will attempt to restore the GL context automatically.
    1.19  In modern devices (Android 3.0 and up) this will most likely succeed and your
    1.20  app can continue to operate as it was.
    1.21 +
    1.22  However, there's a chance (on older hardware, or on systems under heavy load),
    1.23  where the GL context can not be restored. In that case you have to listen for
    1.24  a specific message, (which is not yet implemented!) and restore your textures