JAVA 1.5 GP2X RUNTIME (JRE)
Version 1.0 Beta 2.0
22 October 2006

References:
  Author: Fungostar (fungostar@gmail.com)
  Site: italian forum http://www.gp2xdev.net (you can send me PM here)
  Supporters on italian forum: SMX, Bau, Ryo Saeba, Zaxxon
  GP2X Wiki:
     http://wiki.gp2x.org/wiki/Java
     http://wiki.gp2x.org/wiki/Software_Directory

This package includes the following software:
- jamvm 1.4.3 (http://jamvm.sourceforge.net/)
- GNU classpath 0.9.1 (http://www.gnu.org/software/classpath/)
- sdljava 0.91 (http://sdljava.sourceforge.net/)
- SFont (http://www.linux-games.com/sfont/)
- Lucida Fonts by Zaxxon

This is the runtime of a Java-compatible Virtual Machine, completed with a full port of the GNU Classpath library and the Java-SDL Layer SDLJava.

<<<<<<<<<<<<<<<<<< INSTALLATION:

Inside the package you will find two directories: jamvm and jamvm-cp
The installation is as simple as copying the two directories to the root of you SD card. These folders cannot be installed in another place because the Virtual Machine expects to find its files placed in /mnt/sd/jamvm and /mnt/sd/jamvm-cp, where /mnt/sd is the full path of the SD Card root on the GP2X Console.
If you have an earlier version, please substitute completely both directories, don't mix files inside.

<<<<<<<<<<<<<<<<<< EXECUTION:

Fast forward:
  go inside Games, then jamvm, start Launcher.sh and try to understand how it works

Normal:
Java applications that will run on this VM must be built with GP2X in mind, so don't expect to be able to run any MIDlet (J2ME) or some exotic Java app.
This is true for this package, future releases of this Java VM will probably allow you to run phone J2ME games.

You can launch applications in two ways:
- running the application's provided launch script directly from Games menu
- starting the provided Java Launcher, selecting the application and pressing B while highlighting the application's file launcher.properties

The two provided examples can be launched with the Launcher, so go running them now:
- power up the GP2X
- navigate to the Games menu and then enter the folder jamvm
- start the Launcher.sh program by highlighting it and pressing B

When starting you will watch a Java logo with a small advancing progress bar, once the bar reaches the 100% the screen will go black for a few seconds, usually 5 to 10 depending on the SD Card speed.
The launcher is a (very) simple folder navigation tool, keystrokes are:
- B enters the highlighted item, if its a folder go inside, if its a launcher.properties file, starts the application
- Y go up to parent folder
- X quits the Launcher

When entering a folder, if an application launcher.properties exists, it will be read and some informations will be shown, like the title of the application and its logo.

Once you run the Launcher, you can try these applications:
- Hello World, inside the folder jamvm/Hello
  quit pressing any key or moving the joy
- Jam-Test, inside the folder jamvm/JamTest
  this lets you experiments with fonts and various gp2x aspects, like the CPU clock
- the game Kill the Duck ("Ammazza la Papera" in italian), inside the folder jamvm/Paperotte
  follow the in-game indications

When the running application quits, the Launcher will be restarted so you can switch java applications very quickly.

I wish to thank:
- Zaxxon for the Lucida bitmapped font
- Ryo Saeba for GMenu2X, an excellent piece of work, a real vault of informations
- for SFont, the author, Karl Bartel

Hope you enjoy this Second Beta release.

Cheers,
  Fungostar

<<<<<<<<<<<<<<<<<< CHANGELOG since 1.0 Beta 1.5:

Bug:
- Fixed the Audio bug in the Duck game that causes the delay between action and sound
- Fixed a big amoount of bugs in the sdljava layer, most with palettized images

New Additions:
- New support for Bitmapped Fonts made by Zaxxon of the Italian GP2xdev.net forum, now the Launcher uses a combination of TTF (the title) and Bitmapped (files and dirs)
- Launcher now provides a Battery Monitor thread that watches the battery status and lights the Red LED when the battery goes low
- Launcher now can change the CPU clock when launching apps
- New support for SFont font, the same Ryo Saeba uses on its GMenu2x
- New support for these gp2x hardware functions:
  * red led control (on/off)
  * backlight control (on/off)
  * overclock/underclock
  * battery status polling
- New demo program Jam-Test, this demonstrated the new SFont support and all hardware additions, also it measures the frame rate it reaches

Enhancements:
- Modifies the SFont library used by Ryo, I've added the runtime scaling and antialiasing of fonts
- Modified all Surface initializations, now are all hardware
- Enabled the VM optimization (-O2) and advanced threading tecniques

Things remaining to do:
- ability to change the SFont color, now its only white
- enable the hardware double buffering, now it is software inside the GP2X class in the HAL JAR
- completing j2me support

Performaces are much better now, the Duck game run full speed and with audio perfectly synchronized.
The Jam-Test program starts clocked at 50 MHz and runs at 12 FPS, clokked at 200 MHz reaches 85 FPS, overcloked goes over 100 FPS.


