glutKeyboardUpFunc(3GLUT) GLUT glutKeyboardUpFunc(3GLUT)
NAME
glutKeyboardUpFunc - sets the keyboard up (key release) callback for the current window.
SYNTAX
void glutKeyboardUpFunc(void (*func)(unsigned char key,
int x, int y));
ARGUMENTS
func The new keyboard up callback function.
DESCRIPTION
glutKeyboardFunc sets the keyboard up (key release) callback for the current window. When a user
types into the window, each key release matching an ASCII character will generate a keyboard up call-back. callback.
back. The key callback parameter is the generated ASCII character. The state of modifier keys such as
Shift cannot be determined directly; their only effect will be on the returned ASCII data. The x and
y callback parameters indicate the mouse location in window relative coordinates when the key was
pressed. When a new window is created, no keyboard callback is initially registered, and ASCII key
strokes in the window are ignored. Passing NULL to glutKeyboardFunc disables the generation of key-board keyboard
board callbacks.
During a keyboard up callback, glutGetModifiers may be called to determine the state of modifier keys
when the keystroke generating the callback occurred.
To avoid the reporting of key release/press pairs due to auto repeat, use glutIgnoreKeyRepeat to
ignore auto repeated keystrokes.
There is no guarantee that the keyboard press callback will match the exact ASCII character as the
keyboard up callback. For example, the key down may be for a lowercase b, but the key release may
report an uppercase B if the shift state has changed. The same applies to symbols and control char-acters. characters.
acters. The precise behavior is window system dependent.
Use glutSpecialUpFunc for a means to detect non-ASCII key releases.
SEE ALSO
glutKeyboardFunc(3G), glutSpecialUpFunc(3G), glutSpecialFunc(3G), glutCreateWindow(3G), glutMouseFunc(3G), glutSpaceball-ButtonFunc(3G), glutSpaceballButtonFunc(3G),
ButtonFunc(3G), glutButtonBoxFunc(3G), glutTabletButtonFunc(3G), glutGetModifiers(3G), glutIgnoreKeyRepeat(3G)
AUTHOR
Mark J. Kilgard (mjk@nvidia.com)
GLUT 3.7 glutKeyboardUpFunc(3GLUT)
|