miguel.horta/commandergenius
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Updated readme

Browse Source
This commit is contained in:
pelya
2012-05-24 13:58:28 +03:00
parent b4db4d71fe
commit 424e5aa28f
1 changed files with 8 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
readme.txt
View File

@@ -8,7 +8,7 @@ Also this port is developed very slowly, although the same is true for an offici
Installation Installation
============ ============
This project should be compiled with Android 3.1 SDK (API level 12) and NDK r6 or r5c, This project should be compiled with Android 3.1 SDK (API level 12) and NDK r7c, r6 or r5c,
google for them and install them as described in their docs. google for them and install them as described in their docs.
You'll need to install Java Ant too. You'll need to install Java Ant too.
The application will run on Android OS 1.6 and above, don't mind the 3.1 dependency. The application will run on Android OS 1.6 and above, don't mind the 3.1 dependency.
@@ -94,16 +94,16 @@ on public HTTP server - you may specify URL in ChangeAppSettings.sh, also you ma
If you'll release new version of data files you should change download URL or data file name and update your app as well - If you'll release new version of data files you should change download URL or data file name and update your app as well -
the app will re-download the data if URL does not match the saved URL from previous download. the app will re-download the data if URL does not match the saved URL from previous download.
All devices have different screen resolutions, you may toggle automatic All devices have different screen resolutions, you may toggle automatic screen resizing
screen resizing in ChangeAppSettings.sh and draw to virtual 640x480 screen - in ChangeAppSettings.sh and draw to virtual 640x480 screen - it will be HW accelerated
it will be HW accelerated and will not impact performance. and will not impact performance. Automatic screen resizing does not work in SDL 1.3/2.0.
SDL_ListModes()[0] will always return native screen resolution. SDL_ListModes()[0] will always return native screen resolution.
Also make sure that your HW textures are not wider than 1024 pixels, or it will fail to allocate such Also make sure that your HW textures are not wider than 1024 pixels, or it will fail to allocate such
texture on HTC G1, and other low-end devices. Software surfaces may be of any size of course. texture on HTC G1, and other low-end devices. Software surfaces may be of any size of course.
If you want HW acceleration - just use OpenGL, that's the easiest and most cross-platform way, If you want HW acceleration - just use OpenGL, that's the easiest and most cross-platform way,
however if you'll use on-screen keyboard (even the text input button) the OpenGL state will get however if you'll use on-screen keyboard (even the text input button) the OpenGL state will get
screwed after each frame - after each SDL_Flip() you'll need to call: messed up after each frame - after each SDL_GL_SwapBuffers() you'll need to call:
glEnable(GL_TEXTURE_2D); glEnable(GL_TEXTURE_2D);
glBindTexture(GL_TEXTURE_2D, your_texture_id); glBindTexture(GL_TEXTURE_2D, your_texture_id);
@@ -120,7 +120,7 @@ AppNeedsArrowKeys=n
AppNeedsTextInput=n AppNeedsTextInput=n
AppTouchscreenKeyboardKeysAmount=0 AppTouchscreenKeyboardKeysAmount=0
SDL supports HW acceleration, however it has many limitations: SDL 1.2 supports HW acceleration, however it has many limitations:
You should use 16-bit color depth. You should use 16-bit color depth.
You cannot blit SW surface to screen, it should be only HW surface. You cannot blit SW surface to screen, it should be only HW surface.
You can use colorkey, per-surface alpha and per-pixel alpha with HW surfaces. You can use colorkey, per-surface alpha and per-pixel alpha with HW surfaces.
@@ -170,6 +170,8 @@ SDL_BlitSurface(SDL_GetVideoSurface(), sourceRect, sprite, &targetRect);
// ----- End of example // ----- End of example
To get HW acceleration in SDL 1.3/2.0 just follow the instructions on libsdl.org
If you'll add new libs - add them to project/jni/, copy Android.mk from existing lib, and If you'll add new libs - add them to project/jni/, copy Android.mk from existing lib, and
add libname to project/jni/<yourapp>/Android.mk add libname to project/jni/<yourapp>/Android.mk
Also you'll need to move all include files to <libname>/include dir. Also you'll need to move all include files to <libname>/include dir.