################################################
# Game Controller v0.1 alpha by zeratul        #
# Relase: 02.01.2010.                          #
# email: pinter.sandor.norbert@gmail.com       #
-  

0.)
After starting the program, you will see a blank white screen with two options: EXIT, SEND TO BACKGROUND.
******* SCROLL DOWN TO POINT 9.) FOR MORE DETAILED HOW TO ! *******************
*******************************************************************************

If you press CAMERA KEY, you can switch between virtual key modes (see point 4.) and you can see the virtual keys on the screen. What you can not see is that the RED, GREEN, WHITE HW keys are also emulating soft key "NO", soft key "OK" and soft key "YES" (having normal buttons on your Nokia 5800:).
If you press POWER KEY, you can turn off displaying the virtual buttons (see point 4.).
                                            -
1.)
Copyright : This program is freeware, however if you would like to request improvementes, 
donation is appreciated : https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=XQ68C8BX998LS

2.)
Contents of this package: 
 - README.txt (this file)
 - animation_gcce.sis (UNSIGNED application)

3.)
The aim of this software is to provide an universal controller for Nokia 5800 devices using touch ui for movement and HW keys as buttons.
(The program is built with S60V5 SDK and probably runs on other S60V5 devices as well, but never tested).

4.)
Capabilities:
NEVER FORGET: THIS APP IS USING POWER AND CAMERA HW KEYS FOR SWITCHING BETWEEN MODES, SO IT CAN INTERFERE WITH THE FOLLOWING SOFTWARES : VirtualKey, Pencil

	4 touch ui modes, switching between them with CAMERA key:  (DON'T FORGET!)
      - first mode  : 
	                virtual arrows are 123 , 4_6, 789, 
					an ESC key in the top left corner 
					and asd, qwe on the right side,  
					HW keys are: RED: soft key "NO", WHITE: soft key "OK", GREEN: soft key "YES"
					
	  - second mode : 
					virtual arrows are cursor up,down,etc. ,  
					an ESC key in the top left corner 
					and asd, qwe on the right side, 
					HW keys are: RED: soft key "NO", WHITE: soft key "OK", GREEN: soft key "YES"
					
	  - third mode  : 
					only virtual arrows (on whole screen) which are 123, 4_6, 789,
					HW keys are: RED: soft key "NO", WHITE: soft key "OK", GREEN: soft key "YES"
					
	  - fourth mode :  (DEFAULT, ACTIVATED ON STARTUP !)
					NO EMULATION AT ALL! ALL TOUCH AND HW KEY EVENTS ARE BYPASSED TO THE OP SYSTEM.

 - YOU CAN ENABLE/DISABLE DISPLAYING VIRTUAL BUTTONS ON THE SCREEN BY PRESSING POWER KEY (DON'T FORGET!) 
	The virtual key emulation remains active, but nothing is displayed! Useful for playing games using direct screen access (e.g. Quake2, 3DBrickBreaker, Doom).
 
Here is a schematic drawing of a NOKIA 5800 :] running this app :]

															CAMERA
		--------------------------------------------------------------
POWER	- ESC                                       a   q  -  RED   -
		-                                                  -        -
		-                                                  -        -
		-                                                  -        -
		-                                           s   w  -  WHITE -
		-                                                  -        -
		-                                                  -        -
		- virtual arrows                                   -        -
		- area                                      d  e   -  GREEN -
		-------------------------------------------------------------


5.)
Tested with the following games/emus:
 - AnotherGuest's UAE4ALL,
 - PicoDrive 1.5,
 - DukeNukem3D,
 - Quake2,
 - 3DBrickBreaker,
 - Doom
 
 6.)
 Known bugs:
 - The virtual button displaying flickers sometimes during gameplay (doesn't affect the emulation! it's smooth!),
 - Some games using DSA interferes with displaying virtual buttons (e.g. Quake2, 3DBrickBreaker, Doom), I'm trying to figure out a solution, until that just turn off virtual button display by pressing camera key (don't forget, emulation is still active, just you can't see the buttons!),
 - The emulation doesn't work with C6 FW (Pnht), sorry, actually couldn't find the reason...
  
7.)
Planned for future releases:
 - Finding more convenient places for virtual buttons (yep, I know, it's ok now, but...)
 - Better documentation on the app as well,
 - Renaming app from Animation to something else,
 - Creating an icon,
 - Finding a solution for flickering and DSA problems (if you know a solution, do not hesitate to email me),
 - Finding a solution to work with C6 FW.
 
 8.) demonstration
 
([b]This program Might work on other S60V5 phones as well, but never tested[/b]).

*** REMEMBER: IT IS 0.01 ALPHA VERSION !!! ***

*** YOU NEED TO SIGN IT, IT IS UNSIGNED ***

Some demonstration videos are here (turn off sound, there is noisy radio in the background):

[youtube]http://www.youtube.com/watch?v=wx_Y-KafWAk[/youtube]
[youtube]http://www.youtube.com/watch?v=lxLvN_orMCs[/youtube]
[youtube]http://www.youtube.com/watch?v=aXgRgw_pl8g[/youtube]

If you like it and would like to get improvements, please donate.

9.) 
###########################################
[b]Usage:[/b]
###########################################
- if your phone is not hacked, sign it because it's unsigned,
- install,
- after starting, you will see a white screen with options and exit,
- go to options, choose send to background,

- [b]press camera key to switch to mode 1[/b],
- [u]this mode is made for java games e.g. 3D Brick Breaker, due to the reason that it was made for N97, but 5800 doesn't have real keyboard[/u] 
- you will see an indicator on the top left corner stating you are in mode 1,
- [b]mode 1 means[/b]:   
     virtual leftup   -> emulating hardware key 1, 
     virtual up        -> emulating hardware key 2, 
     virtual rightup -> emulating hardware key 3, 

     virtual left        -> emulating hardware key 4, 
     virtual bottom -> emulating nothing
     virtual right   -> emulating hardware key 1, 

     virtual leftdown -> emulating hardware key 7, 
     virtual down      -> emulating hardware key 8, 
     virtual rightdown-> emulating hardware key 9, 

     virtual top left corner -> emulating hardware key C (escape),

     virtual boxes on the right -> emulating hardware keys a, s, d and q, w, e,

     RED button: soft key "NO", 
     WHITE button: soft key "OK",
      GREEN button: soft key "YES"

- [b]press camera key to switch to mode 2[/b],
- (you can try it now and can move in the menu by pressing virtual arrows:)
- [u]this mode is made for Symbian games like Doom, DukeNukem3D, PicoDrive Sega Emulator, UAE4ALL Amiga emulator, Quake2, due to the reason they require keyboard to play, but 5800 doesn't have real keyboard[/u] 
- you will see an indicator on the top left corner stating you are in mode 2,
- [b]mode 2 means[/b]:   
     virtual leftup   -> emulating cursor left + cursor up, 
     virtual up        -> emulating cursor up, 
     virtual rightup -> emulating cursor right + cursor up, 

     virtual left        -> emulating cursor left,
     virtual bottom -> emulating nothing,
     virtual right   -> emulating cursor right,

     virtual leftdown -> emulating cursor left + cursor down,
     virtual down      -> emulating cursor down,
     virtual rightdown-> emulating cursor right + cursor down,

     virtual top left corner -> emulating hardware key C (escape),

     virtual boxes on the right -> emulating hardware keys a, s, d and q, w, e,

     RED button: soft key "NO", 
     WHITE button: soft key "OK",
      GREEN button: soft key "YES"

- [b]press camera key to switch to mode 3[/b],
- it's not so useful now (see readme.txt), you can skip it,

- [b]press camera key to switch to mode 4 aka emulation disabled[/b],
- in this mode, none of the touch ui events are catched, you can use your mobile normally, start any program and can bring up virtual button emulations by pressing camera key

[b]POWER key is also captured! see readme.txt in the zip for more info[/b]

[b]This program may work with N-Gage emu as well, but couldn't try it yet[/b]

[center][b]Why is it better than Virtual Keyboard? Or Virtual Key?[/b][/center]
- because if you hold down your finger, emulation still works (not like in Virtual Keyboard wherein this means you want to move the emulation window... pff),
- becuase if you hold down your finger and moving accross different virtual keys, it's emulated smoothly and none of them are sticked, the emulation stops at the moment when you release any of them,
- because the hardware red white and green buttons are also emulated in one program,
- see the youtube videos and give a try!
