glutSpecialFunc(3GLUT)

NAME
glutSpecialFunc - sets the special keyboard callback for the current window.

SYNTAX

void glutSpecialFunc(void (*func)(int key, int x, int y));

ARGUMENTS

func
    The new special callback function.

DESCRIPTION
glutSpecialFunc sets the special keyboard callback for the current window. The special keyboard callback is triggered when keyboard function or directional keys are pressed. The key callback parameter is a GLUT_KEY_* constant for the special key pressed. The x and y callback parameters indicate the mouse in window relative coordinates when the key was pressed. When a new window is created, no special callback is initially registered and special key strokes in the window are ignored. Passing NULL to glutSpecialFunc disables the generation of special callbacks. During a special callback, glutGetModifiers may be called to determine the state of modifier keys when the keystroke generating the callback occurred. An implementation should do its best to provide ways to generate all the GLUT_KEY_* special keys. The available GLUT_KEY_* values are:

GLUT_KEY_F1
    F1 function key.

GLUT_KEY_F2
    F2 function key.

GLUT_KEY_F3
    F3 function key.

GLUT_KEY_F4
    F4 function key.

GLUT_KEY_F5
    F5 function key.

GLUT_KEY_F6
    F6 function key.

GLUT_KEY_F7
    F7 function key.

GLUT_KEY_F8
    F8 function key.

GLUT_KEY_F9
    F9 function key.

GLUT_KEY_F10
    F10 function key.

GLUT_KEY_F11
    F11 function key.

GLUT_KEY_F12
    F12 function key.

GLUT_KEY_LEFT
    Left directional key.

GLUT_KEY_UP
    Up directional key.

GLUT_KEY_RIGHT
    Right directional key.

GLUT_KEY_DOWN
    Down directional key.

GLUT_KEY_PAGE_UP
    Page up directional key.

GLUT_KEY_PAGE_DOWN
    Page down directional key.

GLUT_KEY_HOME
    Home directional key.

GLUT_KEY_END
    End directional key.

GLUT_KEY_INSERT
    Inset directional key.

Note that the escape, backspace, and delete keys are generated as an ASCII character.

SEE ALSO
glutSpecialUpFunc, glutKeyboardFunc, glutMouseFunc, glutSpaceballButtonFunc, glutButtonBoxFunc, glutTabletButtonFunc, glutGetModifiers

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