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 ASCI character will generate a keyboard up  callback.  The
       key  callback  parameter is the generated ASCI character. The state of
       modifier keys such as Shift cannot be determined directly;  their  only
       effect will be on the returned ASCI data. The x and y callback parame-
       ters 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  ASCI  key  strokes  in  the  window  are
       ignored.  Passing  NUL  to glutKeyboardFunc disables the generation of
       keyboard callbacks.

       During a keyboard up callback, glutGetModifiers may be called to deter-
       mine the state of modifier keys when the keystroke generating the call-
       back 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 ASCI 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  sym-
       bols  and  control  characters.   The precise behavior is window system
       dependent.

       Use glutSpecialUpFunc for a means to detect non-ASCI key releases.

SEE ALSO
       glutKeyboardFunc, glutSpecialUpFunc, glutSpecialFunc, glutCreateWindow,
       glutMouseFunc,  glutSpaceballButtonFunc, glutButtonBoxFunc, glutTablet-
       ButtonFunc, glutGetModifiers, glutIgnoreKeyRepeat

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



GLUT                                  3.7            glutKeyboardUpFunc(3GLUT)