************************
*    Ultimate Fenix    *
*         v0.2         *
************************

Engine based on: Fenix 0.92a

Port from: http://fenix.divsite.net
By: Israel Lopez Fernandez (Puck2099)
Website: http://www.gp32wip.com
Contact and donations (Paypal): puck2099@gmail.com
Based partially in Chui's port for GP32. Controls managed by Rlyeh's minilib.
Tests by Joanvr and Quiest.

Please, if you want to include the runtime with your game, include also these files readme.txt
and leeme.txt with it.

What is Ultimate Fenix?
-----------------------
It's an interpreter to play games coded using that programming language.

There wasn't a Fenix already? What's the difference?
----------------------------------------------------
Yes, until now there was only the Fenix GP2X I ported. The difference between that and this one
is basically the Fenix version in which it's based. Ultimate Fenix make use of Fenix' engine 0.92a,
but the "old" Fenix uses 0.84

Logically, games made for that version will need to be recompiled for this one.

In addiction, in this Ultimate Fenix I will center my efforts to add important improvements that
let us make use of GP2X's hardware (second core, more RAM available, RAM tweak...).

How must I install it?
----------------------
Unzip the files in any place of your SD card. Into the folder called uFenix there are several
tests to see how it works. If you want to add new games, just open one of the .gpe files included 
and create a new file based in that to launch the new game.

Is the source code available to download?
-----------------------------------------
Yes, as it is said by GPL license, you can download the source code from my own website.
By the way, I warn you that the changes realised to the code are not enough "cleaned" nor
documented.
If you want to make any change, please, I would be very grateful if you contact me first
to avoid working two people in fixing the same bug :)

Commands:
----------
This new runtime incorporates the possibility to use commands through the script used to launch
each game. The usage is as follow:

./ufxi game.dcb [commands]

As commands you can use the following flags:

    * --nosplash -> Skips splash screen containing information about runtime version and speed. If
		    you prefer to change background image, you can copy a bmp, gif, jpg or png file
		    in the same folder an using the same name as the .dcb
    * --speed XXX -> Select the speed at which runtime will run (200 Mhz by default). XXX is the speed
	             in Mhz, for example, --speed 245 will run the game at 245 Mhz.
    * --tweak -> Turns on RAM Tweak to improve speed. WARNING: It could cause inestability in some
		 machines, it's not usual, but it could happen.
    * --gp32 -> Uses GP32 mode, what means that volume is controlled by VOL+ and VOL- buttons. This
	        is the default mode.
    * --gp2x -> Uses GP2X mode, so you will be able to use VOL buttons in the same way as the rest
                of the buttons.

Overclocking is limited from 133 to 300 Mhz, you should use one of the following values:
133, 150, 166, 180, 200, 225, 233, 245, 250, 255, 260, 265, 266, 270, 275, 280, 285, 290, 295 y 300.

Controls:
----------
This port admits two game modes: "native" mode and "emulated" mode.

In "native" mode, only useful for GP2X, you have to code the games using the control as it was
a 19 buttons joystick, with the same correspondece as SDL as you can see here:
http://wiki.gp2x.org/wiki/SDL_Joystick_mapping

In "emulated" mode the port recognizes several keys and emulates them using the own GP2X control
as you can see:
Cursors -> pad
ctrl -> A
alt -> B
return -> START
space -> SELECT
backspace -> L
tab -> R
x -> X
z -> Y
a -> VOL-
s -> VOL+
c -> CLICK

Changelog Ultimate Fenix:
-------------------------
v0.2:
-----
- Added support to touch screen (used through variables mouse.x, mouse.y and mouse.left).
  Thanks to Eclipse, Joyrider, Hangman, Lithosphere, Propeller, Paeryn, DJWillis y Joanvr for their work
  interpreting touch screen.
- Modified main volume to a 50% if it detects that it's running in a F200.

v0.1:
-----
- First release.
