Tao.FreeGlut SDK Documentation

Glut.glutSetKeyRepeat Method 

Sets the key repeat mode for the window system.

[Visual Basic]
Public Shared Sub glutSetKeyRepeat( _
   ByVal repeatMode As Integer _
)
[C#]
public static void glutSetKeyRepeat(
   int repeatMode
);

Parameters

repeatMode

Mode for setting key repeat to. Available modes are:

Value Description
GLUT_KEY_REPEAT_OFF Disable key repeat for the window system on a global basis if possible.
GLUT_KEY_REPEAT_ON Enable key repeat for the window system on a global basis if possible.
GLUT_KEY_REPEAT_DEFAULT Reset the key repeat mode for the window system to its default state if possible.

Remarks

glutSetKeyRepeat sets the key repeat mode for the window system on a global basis if possible. If supported by the window system, the key repeat can either be enabled, disabled, or set to the window system's default key repeat state.

X IMPLEMENTATION NOTES

X11 sends KeyPress events repeatedly when the window system's global auto repeat is enabled. glutIgnoreKeyRepeat can prevent these auto repeated keystrokes from being reported as keyboard or special callbacks, but there is still some minimal overhead by the X server to continually stream KeyPress events to the GLUT application. The glutSetKeyRepeat routine can be used to actually disable the global sending of auto repeated KeyPress events. Note that glutSetKeyRepeat affects the global window system auto repeat state so other applications will not auto repeat if you disable auto repeat globally through glutSetKeyRepeat.

GLUT applications using the X11 GLUT implemenation should disable key repeat with glutSetKeyRepeat to disable key repeats most efficiently.

WIN32 IMPLEMENTATION NOTES

The Win32 implementation of glutSetKeyRepeat does nothing. The glutIgnoreKeyRepeat routine can be used in the Win32 GLUT implementation to ignore repeated keys on a per-window basis without changing the global window system key repeat.

See Also

Glut Class | Tao.FreeGlut Namespace | glutDeviceGet | glutIgnoreKeyRepeat | glutKeyboardFunc | glutKeyboardUpFunc | glutSpecialFunc | glutSpecialUpFunc