This manual page is for Mac OS X version 10.6.3

Reading manual pages

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)