glutDeviceGet(3GLUT)

NAME
glutDeviceGet - retrieves GLUT device information represented by integers.

SYNTAX
#include <GLUT/glut.h>

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 callback 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, glutButtonBoxFunc, glutIgnoreKeyRepeat, glutSetKeyRepeat, glutJoystickFunc

AUTHOR
Mark J. Kilgard (mjk@nvidia.com)