README.txt

Project: net.java.games.*
Purpose: Open source game libraries
Authors:
    -- input API design:
            Michael Martak, Sun Microsystems
            Thomas Daniel, Sony Computer Entertainment
    -- input API original author:
            Michael Martak,Sun Microsystems
    -- input API original release author:
            Jeff Kesselman, Game Technology Architect,
            Advanced Software Technologies Group,
            Sun Microsystems.
    -- this file updated on 06/06/2003 by Jeff Kesselman


Introduction:

This is the source tree for the Java Game Initiative (JGI) Open Source
client game programming APIs.

Build Requirements:

Note: This build depends on there being a jutils.jar in the lib directories
of both the coreAPI and the plug-ins.  If you install the JGI Jutils project
at the same root as this project and build it first it will put jars in the
right places.

This project has been built in the following environment.
 -- Win32 (Win 2000 in the case of our machine)
 -- Sun J2SDK 1.4 (available at java.sun.com)
 -- MinGW 2.0.0  plus the following updates: (all available at www.mingw.org)
     -- binutils 2.13.90
     -- w32api-2.2
     -- mingw-runtime-2.4
     -- "Peter Puck's" directx8 binding
	(http://www.urebelscum.speedhost.com/download.html, file: dx8libs.zip
	(Copy all of his *.a library files into the MingW "lib" directory)
     -- The DirectX 9 SDK available at the Microsoft DirectX site.
	(http://www.microsoft.com/directx)
	The Win32 plug-in build.xml file expects this to be installed in
	c:\dx9.  You can install it elsewhere but then you will have to modify
	the reference in that build.xml ant script.
 -- ANT 1.4.1 (available at apache.org)


Directory Organization:

The root contains a master ANT build.xml and the following sub directories:
 -- coreAPI:  The actual API
 -- plugins:  Directories for building controller plugins.
		(Currently the only plug in is the Win32 DX8 plugin.)

Build instructions:

To clean: ant clean
To build:  ant all (or just ant)
To build docs: ant javadoc
To test:
	First cd to coreAPI.  There are currently 2 tests there.
		Textest: A simple discovery test that dumps
			the data about the discovered controllers to stdout
			To run: ant textest
		Readtest:  A test that creates a window for each discovered
			controller (or sub-controller) which displays the
			current state of all the controller's axes.
			(Note: The windows currently all open at the same
			 place on the screen so you will have to move them to
			 see them all.)
			To run: ant readtest

Release Info:
    Initial Release:  This release contains an implementation of the input
        API designed by Mike Martak of Sun and Thomas (?) of Sony CEA for
        the WIn32 platform.  All the code in src/input is cross platform. The
        Win32 code is segregated to the DirectX plugin (src/DXplugin) which
        depends on DirectInput from DX7 (or later).

    05/09/2003:  A number of bugs and problems with the DXPlugin are fixed in this
	release.  This release also brings the code up to date using the DI8
	interface.  This thus is the first release that requires Peter Puck's
	DX8 bindings to compile with MinGW.

    05/09/2003 (second update):
	This version adds a new standard value type to the API.
	Axis.POV holds standard definitions for values for POV (hat) switches
		-- Axis.POV.CENTER and Axis.POV.OFF are synonymous and are
			the center position.
		-- Axis.POV.UP, Axis.POV.DOWN, Axis.POV.LEFT and Axis.POV.RIGHT
		   should be self explanatory.
	Any hat that claims to be "normalized" will return these values. (It is
	recommended that all hats be normalized by the system specific plugins.)