Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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	callback.  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 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 ASCII key strokes in the  window  are  ig-
       nored. Passing NULL to glutKeyboardFunc disables	the generation of key-
       board 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  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 sym-
       bols and	control	characters.  The precise behavior is window system de-
       pendent.

       Use glutSpecialUpFunc for a means to detect non-ASCII 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=glutKeyboardUpFunc&sektion=3&manpath=FreeBSD+Ports+15.0.quarterly>

home | help