README.android
changeset 6330 0fa55ca2efdd
parent 6273 2fa7e0540f95
child 6354 17840f487124
equal deleted inserted replaced
6329:77dcb8c486e9 6330:0fa55ca2efdd
    70 	res/drawable-*		- directories holding icons for different phone hardware
    70 	res/drawable-*		- directories holding icons for different phone hardware
    71 	res/layout/main.xml	- place holder for the main screen layout, overridden by the SDL video output
    71 	res/layout/main.xml	- place holder for the main screen layout, overridden by the SDL video output
    72 	res/values/strings.xml	- strings used in your application, including the application name shown on the phone.
    72 	res/values/strings.xml	- strings used in your application, including the application name shown on the phone.
    73 	src/org/libsdl/app/SDLActivity.java	- the Java class handling the initialization and binding to SDL.  Be very careful changing this, as the SDL library relies on this implementation.
    73 	src/org/libsdl/app/SDLActivity.java	- the Java class handling the initialization and binding to SDL.  Be very careful changing this, as the SDL library relies on this implementation.
    74 
    74 
       
    75 
       
    76 ================================================================================
       
    77  Pause / Resume behaviour
       
    78 ================================================================================
       
    79 
       
    80 If SDL is compiled with SDL_ANDROID_BLOCK_ON_PAUSE defined, the event loop will
       
    81 block itself when the app is paused (ie, when the user returns to the main
       
    82 Android dashboard). Blocking is better in terms of battery use, and it allows your
       
    83 app to spring back to life instantaneously after resume (versus polling for
       
    84 a resume message).
       
    85 Upon resume, SDL will attempt to restore the GL context automatically.
       
    86 In modern devices (Android 3.0 and up) this will most likely succeed and your
       
    87 app can continue to operate as it was.
       
    88 However, there's a chance (on older hardware, or on systems under heavy load),
       
    89 where the GL context can not be restored. In that case you have to listen for
       
    90 a specific message, (which is not yet implemented!) and restore your textures
       
    91 manually or quit the app (which is actually the kind of behaviour you'll see
       
    92 under iOS, if the OS can not restore your GL context it will just kill your app)
    75 
    93 
    76 ================================================================================
    94 ================================================================================
    77  Additional documentation
    95  Additional documentation
    78 ================================================================================
    96 ================================================================================
    79 
    97