net.java.jinput:jinput-platform

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.)