Input State
[OpenGLUT API Reference]

Functions

int glutDeviceGet (GLenum eWhat)

int glutGetModifiers (void)

void glutIgnoreKeyRepeat (int ignore)

void glutSetKeyRepeat (int repeatMode)

Query input device state.

Parameters:

eWhat Enumerated parameter ID.

Retrieve system-specific information about attached devices. Supported device queries are:

• GLUT_HAS_KEYBOARD
  Return non-zero if there is a keyboard.

• GLUT_HAS_MOUSE
  Return non-zero if there is a mouse.

• GLUT_HAS_JOYSTICK
  Return non-zero if there is a joystick.

• GLUT_HAS_SPACEBALL
  Return non-zero if there is a spaceball.

• GLUT_HAS_DIAL_AND_BUTTON_BOX
  Return non-zero if a dials-and-buttons box is present.

• GLUT_HAS_TABLET
  Return non-zero if a tablet is present.

• GLUT_NUM_MOUSE_BUTTONS
  Return the number of mouse buttons.

• GLUT_JOYSTICK_BUTTONS
  Return the number of joystick buttons.

• GLUT_JOYSTICK_AXES
  Return the number of joystick axes.

• GLUT_JOYSTICK_POLL_RATE
  Return the rate at which the joystick is polled, for the current window.

• GLUT_OWNS_JOYSTICK
  Return non-zero if OpenGLUT believes that it has successfully acquired access to the joystick.

• GLUT_DEVICE_IGNORE_KEY_REPEAT
  Return non-zero if the current window is set to disable key repeating.

• GLUT_DEVICE_KEY_REPEAT
  Described as returning the key repeat rate in one place, but actually returns a key repeat mode.

• GLUT_NUM_BUTTON_BOX_BUTTONS
  Return the number of buttons on a dials-and-buttons box, if any.

• GLUT_NUM_DIALS
  Return the number of dials on a dials-and-buttons box, if any.

• GLUT_NUM_SPACEBALL_BUTTONS
  Return the number of buttons on a spaceball, if any.

• GLUT_NUM_TABLET_BUTTONS
  Return the number of buttons on a tablet, if any.

Todo:

Keyboards assumed to exist.

Mouse assumed to exist on UNIX/X11.

Mice assumed to have three buttons on UNIX/X11.

Joystick query limited to one joystick

Consider moving to a table-based approach rather than a switch(), letting us move to modular functions.

Bug:

GLUT_DEVICE_KEY_REPEAT returns the key repeat mode, but the comment says it returns the rate. GLUT_DEVICE_KEY_REPEAT should probably return ogState.KeyRepeat.

See also:

glutSetOption(), glutGet(), glutGetModifiers(), glutLayerGet()

Query the Alt, Shift and Ctrl keys.

Return the logical OR combination of the following symbolic bitmasks:

• GLUT_ACTIVE_SHIFT
• GLUT_ACTIVE_CTRL
• GLUT_ACTIVE_ALT

Todo:

Complains if not invoked by a client callback.

Does not differentiate between the left and right forms of the modifiers.

See also:

glutSetOption(), glutGet(), glutDeviceGet(), glutLayerGet()

Set autorepeat status.

Parameters:

ignore Whether to ignore autorepeated keys.

If ignore is non-zero, then auto-repeat is disabled for keyboard callbacks for the current window.

See also:

glutSetKeyRepeat()

Sets autorepeat behavior for all OpenGLUT windows.

Parameters:

repeatMode On, Off or Default.

glutSetKeyRepeat() is similar to glutIgnoreKeyRepeat() but sets the behavior for OpenGLUT in general, rather than for a particular window. The options for repeatMode are:

• GLUT_KEY_REPEAT_OFF
  Turn off repeat for all windows.
• GLUT_KEY_REPEAT_ON
  Turn on repeat for all windows.
• GLUT_KEY_REPEAT_DEFAULT
  Respect the window's setting.

See also:

glutIgnoreKeyRepeat()