Wiki Weblogs Forums JavaGames Home www.java.net
Welcome to the Java Input API Project!
Overview

The JInput Project hosts an implementation of an API for game controller discovery and polled input. It is part of a suite of open-source technologies initiated by the Game Technology Group at Sun Microsystems with intention of making the development of high performance games in Java a reality.

The API itself is pure Java and presents a platform-neutral completely portable model of controller discovery and polling. It can handle arbitrary controllers and returns both human and machine understandable descriptions of the inputs available.

The implementation hosted here also includes plug-ins to allow the API to adapt to various specific platforms. These plug-ins often contain a native code portion to interface to the host system.

Project Status
The intial implementation of the Java Input API is available for download from CVS. The initial release only contains a plug-in for Win32. Plug-ins for other platforms (eg Linux, Mac, etc.) are expected to be forthcoming either from the Java Game Technology Group or other project contributors.
Getting Started

This project has been built in the following environment:

  • Win32 (Win 2000 in the case of our machine)
  • Sun J2SDK 1.4.2 (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 "dx8libs.zip" at www.urebelscum.speedhost.com/download.html (Copy all his .a files into your MinGW installation's "lib" directory.)
    • The DirectX9 SDK available at www.microsoft.com/directx (The ant script expects this to be in c:\dx9. If you install elsewhere you will need to modify the Win32 plugin's build.xml file.)
  • ANT 1.4.1 (available at www.apache.org)
  • This project requires that the Java Utils library (jutil.jar) be built and placed in this project's lib directories. See the README for more detail. For the Java Utils library itself see jutils.dev.java.net

 

Useful Links
Developer Agreement