Added documentation on loading assets on Android.
authorSam Lantinga <slouken@libsdl.org>
Sun, 04 Nov 2012 09:45:18 -0800
changeset 6646dd32cce44d3c
parent 6645 3f83af6d119c
child 6650 d36232135316
Added documentation on loading assets on Android.
README.android
include/SDL_system.h
     1.1 --- a/README.android	Sun Nov 04 08:51:43 2012 -0800
     1.2 +++ b/README.android	Sun Nov 04 09:45:18 2012 -0800
     1.3 @@ -124,6 +124,22 @@
     1.4  the filename used by Eclipse.
     1.5  
     1.6  ================================================================================
     1.7 + Loading assets
     1.8 +================================================================================
     1.9 +
    1.10 +Any files you put in the "assets" directory of your android-project directory
    1.11 +will get bundled into the application package and you can load them using the
    1.12 +standard functions in SDL_rwops.h.
    1.13 +
    1.14 +There are also a few Android specific functions that allow you to get other
    1.15 +useful paths for saving and loading data:
    1.16 +SDL_AndroidGetInternalStoragePath()
    1.17 +SDL_AndroidGetExternalStorageState()
    1.18 +SDL_AndroidGetExternalStoragePath()
    1.19 +
    1.20 +See SDL_system.h for more details on these functions.
    1.21 +
    1.22 +================================================================================
    1.23   Pause / Resume behaviour
    1.24  ================================================================================
    1.25  
     2.1 --- a/include/SDL_system.h	Sun Nov 04 08:51:43 2012 -0800
     2.2 +++ b/include/SDL_system.h	Sun Nov 04 09:45:18 2012 -0800
     2.3 @@ -76,7 +76,10 @@
     2.4  #define SDL_ANDROID_EXTERNAL_STORAGE_READ   0x01
     2.5  #define SDL_ANDROID_EXTERNAL_STORAGE_WRITE  0x02
     2.6  
     2.7 -/* Get the path used for internal storage for this application */
     2.8 +/* Get the path used for internal storage for this application.
     2.9 +   This path is unique to your application and cannot be written to
    2.10 +   by other applications.
    2.11 + */
    2.12  extern DECLSPEC const char * SDLCALL SDL_AndroidGetInternalStoragePath();
    2.13  
    2.14  /* Get the current state of external storage, a bitmask of these values:
    2.15 @@ -86,7 +89,10 @@
    2.16  */
    2.17  extern DECLSPEC int SDLCALL SDL_AndroidGetExternalStorageState();
    2.18  
    2.19 -/* Get the path used for external storage for this application */
    2.20 +/* Get the path used for external storage for this application.
    2.21 +   This path is unique to your application, but is public and can be
    2.22 +   written to by other applications.
    2.23 + */
    2.24  extern DECLSPEC const char * SDLCALL SDL_AndroidGetExternalStoragePath();
    2.25  
    2.26  #endif /* __ANDROID__ */