glutjoystickfunc(3glut) [osx man page]
glutJoystickFunc(3GLUT) GLUT glutJoystickFunc(3GLUT) NAME
glutJoystickFunc - sets the joystick callback for the current window. SYNTAX
#include <GLUT/glut.h> void glutJoystickFunc(void (*func)(unsigned int buttonMask, int x, int y, int z), int pollInterval); ARGUMENTS
func The new joystick callback function. pollInterval Joystick polling interval in milliseconds. DESCRIPTION
glutJoystickFunc sets the joystick callback for the current window. The joystick callback is called either due to polling of the joystick at the uniform timer interval specified by pollInterval (in millisec- onds) or in response to calling glutForceJoystickFunc. If the pollInterval is non-positive, no joystick polling is performed and the GLUT application must frequently (usually from an idle callback) call glutForceJoystickFunc. The joystick buttons are reported by the callback's buttonMask parameter. The constants GLUT_JOYSTICK_BUTTON_A(0x1), GLUT_JOYSTICK_BUT- TON_B(0x2), GLUT_JOYSTICK_BUTTON_C(0x4), and GLUT_JOYSTICK_BUTTON_D(0x8) are provided for programming convience. The x, y, and z callback parameters report the X, Y, and Z axes of the joystick. The joystick is centered at (0,0,0). X, Y, and Z are scaled to range between -1000 and 1000. Moving the joystick left reports negative X; right reports positive X. Pulling the stick towards you reports negative Y; push the stick away from you reports positive Y. If the joystick has a third axis (rudder or up/down), down reports negative Z; up reports positive Z. Passing a NULL func to glutJoystickFunc disables the generation of joystick callbacks. Without a joystick callback registered, glutForce- JoystickFunc does nothing. When a new window is created, no joystick callback is initially registered. LIMITATIONS
The GLUT joystick callback only reports the first 3 axes and 32 buttons. GLUT supports only a single joystick. GLUT IMPLEMENTATION NOTES FOR X11 The GLUT 3.7 implementation of GLUT for X11 supports the joystick API, but not joystick input. A future implementation of GLUT for X11 may add joystick support. GLUT IMPLEMENTATION NOTES FOR WIN32 The GLUT 3.7 implementation of GLUT for Win32 supports the joystick API and joystick input, but does so through the dated joySetCapture and joyGetPosEx Win32 Multimedia API. The GLUT 3.7 joystick support for Win32 has all the limitations of the Win32 Multimedia API joystick support. A future implementation of GLUT for Win32 may use DirectInput. SEE ALSO
glutForceJoystickFunc, glutMotionFunc, glutMouseFunc, glutSpaceballButtonFunc, glutSpaceballMotionFunc, glutButtonBoxFunc, glutTabletBut- tonFunc, glutDeviceGet AUTHOR
Mark J. Kilgard (mjk@nvidia.com) GLUT
3.7 glutJoystickFunc(3GLUT)
Check Out this Related Man Page
glutDeviceGet(3GLUT) GLUT glutDeviceGet(3GLUT) NAME
glutDeviceGet - retrieves GLUT device information represented by integers. SYNTAX
int glutDeviceGet(GLenum info); ARGUMENTS
info Name of device information to retrieve. GLUT_HAS_KEYBOARD Non-zero if a keyboard is available; zero if not available. For most GLUT implementations, a keyboard can be assumed. GLUT_HAS_MOUSE Non-zero if a mouse is available; zero if not available. For most GLUT implementations, a keyboard can be assumed. GLUT_HAS_SPACEBALL Non-zero if a Spaceball is available; zero if not available. GLUT_HAS_DIAL_AND_BUTTON_BOX Non-zero if a dial & button box is available; zero if not available. GLUT_HAS_TABLET Non-zero if a tablet is available; zero if not available. GLUT_NUM_MOUSE_BUTTONS Number of buttons supported by the mouse. If no mouse is supported, zero is returned. GLUT_NUM_SPACEBALL_BUTTONS Number of buttons supported by the Spaceball. If no Spaceball is supported, zero is returned. GLUT_NUM_BUTTON_BOX_BUTTONS Number of buttons supported by the dial & button box device. If no dials & button box device is supported, zero is returned. GLUT_NUM_DIALS Number of dials supported by the dial & button box device. If no dials & button box device is supported, zero is returned. GLUT_NUM_TABLET_BUTTONS Number of buttons supported by the tablet. If no tablet is supported, zero is returned. GLUT_DEVICE_IGNORE_KEY_REPEAT Returns true if the current window's auto repeated keys are ignored. This state is controlled by glutIgnoreKeyRepeat. GLUT_DEVICE_KEY_REPEAT The window system's global key repeat state. Returns either GLUT_KEY_REPEAT_OFF, GLUT_KEY_REPEAT_ON, or GLUT_KEY_REPEAT_DEFAULT. This will not necessarily return the value last passed to glutSetKeyRepeat. GLUT_JOYSTICK_POLL_RATE Returns the current window's joystick poll rate as set by glutJoystickFunc. If no joystick is supported, the poll rate will always be zero. The joystick poll rate also returns zero if the poll rate last specified to glutJoystickFunc is negative or a NULL call- back was registered. GLUT_HAS_JOYSTICK Non-zero if a joystick is available; zero if not available. GLUT_JOYSTICK_BUTTONS Number of buttons supported by the joystick. If no joystick is supported, zero is returned. GLUT_JOYSTICK_AXES Number of axes supported by the joystick. If no joystick is supposrted, zero is returned. DESCRIPTION
glutDeviceGet retrieves GLUT device information represented by integers. The info parameter determines what type of device information to return. Requesting device information for an invalid GLUT device information name returns negative one. X IMPLEMENTATION NOTES
The current implementation uses to X Input extension to regonize SGI's Spaceball, tablet, and dial and button box devices. WIN32 IMPLEMENTATION NOTES The GLUT_DEVICE_KEY_REPEAT alwasy returns GLUT_KEY_REPEAT_ON. SEE ALSO
glutGet, glutKeyboardFunc, glutMouseFunc, glutSpaceballMotion, glutTabletMotionFunc, glutTabletButtonFunc, glutDialsFunc, glutButtonBox- Func, glutIgnoreKeyRepeat, glutSetKeyRepeat, glutJoystickFunc AUTHOR
Mark J. Kilgard (mjk@nvidia.com) GLUT
3.7 glutDeviceGet(3GLUT)