OpenGLEAN
OpenGLEAN User Support
Home page | Introduction | Documentation | Files | Examples | Proposals | Authors | Links


OpenGLEAN Development
Summary | CVS | (discussion via home page) | (contact via home page) | (suggestion box) | License | Todo | Bugs

Joystick Access
[OpenGLEAN API Reference]

Collaboration diagram for Joystick Access:

DEPRECATED; EXPORTED TO gleandev

The old GLUT API for joysticks uses timer-based pseudo-events. But ultimately, GLUT would poll the hardware for joystick events. A preferable API would perhaps have been to define functions to allow the application to poll the joystick, and let the application use GLUT timers scheduling the pseudo events, if timer-based checks are desired.

freeglut defined, but did not originally implement an extended API for pollinng the hardware. The definition was informal, in the form of stubbed out functions at the bottom of joystick.c. In 2004, John Fay re-implemented the freeglut joystick support, and added support for these stubbed functions.

OpenGLEAN inherited both of these API forms indirectly through OpenGLUT. OpenGLEAN had intended to expose and support these functions in a separate joystick-only library. But the freeglut developers are pushing towards formally including these functions in a freeglut release. It seems likely that freeglut will include these functions formally in their next release.

For the benefit of OpenGLEAN users, these functions are now included in OpenGLEAN, and are fully documented. However, they are marked as deprecated in OpenGLEAN: freeglut's support for them is still somewhat uncertain, and OpenGLEAN would far rather see these functions used from a separate joystick library. You are discouraged from using these functions from OpenGLEAN's core library if you can wait till OpenGLEAN separates the functions into a better-focused library. But, if you use the functions via OpenGLEAN, it is likely that the] API will remain the same---you'll just need to use a different library.

See the Deprecated API Features section.



SourceForge.net Logo Supported in part by SourceForge.net.

Generated on Fri Sep 16 20:15:38 2005 for OpenGLEAN by doxygen 1.4.3
The OpenGLEAN project is hosted by olib.org and SourceForge.