JAVA 1.5 GP2X DEVKIT per Windows
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 Java Development Kit for GP2X, it is the collection of all Java source codes released with the Runtime and includes the Windows DLL necessary to run/test your programs on your PC before testing of the GP2X.

<<<<<<<<<<<<<<<<<< BEFORE WORD:

What this package is:
* the complete collection of Java sources used to make the Runtime, to be used as a reference to start implementing something for your GP2X

What this package is NOT:
* a complete JDK for Windows
* the complete source distribution of the GP2X Runtime

This package does not contain all source codes to rebuild the Runtime, nor contains the necessary graphics/sound files used t run any java game or utility present in the Runtime distribution.

If you want to run the Launcher or the Paperotte game on your pc you have to download the runtime and place files in the right folder.


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

unpack this Zip where you prefer, better if the path does not contain spaces or special characters.


<<<<<<<<<<<<<<<<<< DESCRIPTION:

Inside the Zip you find these folders:

- lib:		precompiled DLL and JARs
- Projects:	all java projects enclosed in the Runtime
	- bin:		precompiled DLL and JARs
	- build.xml:	ANT script that rebuilds all projects
	- HAL:		Hardware Abstraction Layer, the base GP2X Java library
	- AppLauncher:	The App Launcher
	- Hello:	Simple Hello World
	- JamTest:	JamVM testing program for GP2X Extensions
	- Val:		The Game of Kill the Duck (Paperotte)
	- UIKit:	User Interface Kit prototype library, this aims to be the basis for the J2ME wrapper
- sdljava-0.9.1
	- src:	java sources of the SDLJava integration layer
	- api:	javadoc documentation

The easy way to start using this devkit is importing all projects inside the Eclipse IDE (www.eclipse.org) and giving a look at how the Hello World is implemented.

It is necessary to import all projects because they have dependencies, for example all projects depends on HAL.

In order of difficulty level, HelloWorld is the most simple one, then JamTest is more complex as it manages the joystick and finally the Kill the Duck game is the most complete.

Once you imported all projects, you can try running the Launcher, the Run configuration for Eclipse is:
Main class:			val.gp2x.AppLauncher
From the project:		GP2X-AppLauncher
Additional VM parameters:	-Djava.library.path=../../lib
that specifies where the sdljava*.dll libraries are.

The GP2X joystick are emulated via Keyboard as:
- Up/Down/Left/Right arrows
- keys A, B, X, Y the same keys on GP2X
- Return is "Start"
- Backspace is "Select"
- keys L and R the same keys on GP2X
- Page Up and Down is the volume control
if you need more keys, you have to modify the class Projects\HAL\src\val\gp2x\GP2x.java

Please take a look to all other readme files.

