NAME¶
keyboard_seteventhandler, keyboard_setdefaulteventhandler - define an event
handler for keyboard events in raw mode
SYNOPSIS¶
#include <vgakeyboard.h>
typedef void (*__keyboard_handler) (int scancode,
int press);
void keyboard_seteventhandler(__keyboard_handler handler);
void keyboard_setdefaulteventhandler(void);
DESCRIPTION¶
These functions allow to define a keyboard event handler which is called by
keyboard_update(3) and
keyboard_waitforupdate(3) when a keyboard
event occured.
press is
KEY_EVENTRELEASE or
KEY_EVENTPRESS if key
scancode was released or pressed. Actually the first value is 0 and the
second is 1 which are so intuitive s.t. you may use them in your program.
Even you specify an own handler, svgalib will check for
<Alt>-F* or
<Ctrl>-C for console switches or generation of
SIGINT if
allowed by
keyboard_translatekeys(3).
Calling
keyboard_setdefaulteventhandler() reinstates the default handler
which maintains the tables used by
keyboard_getstate(3) and
keyboard_keypressed(3). It is probably a good idea to call
keyboard_clearstate(3) after reenabling the default handler.
Here are the supported scancodes. The names of the
#defines originate
from the US keyboard layout, for other countries, they'll refer to the key in
the same physical location, but the keycap will have a different inscription.
For the list below, add
SCANCODE_ in front of the names to get the
right name for your C source. That means, if it lists
BACKSLASH below,
you shall use
SCANCODE_BACKSLASH as symbol in your program. In addition
to the names below we also have
SCANCODE_0 -
SCANCODE_9,
SCANCODE_KEYPAD0 -
SCANCODE_KEYPAD9,
SCANCODE_A -
SCANCODE_Z, and
SCANCODE_F1 -
SCANCODE_F12.
The other key names are
ESCAPE,
MINUS,
EQUAL,
BACKSPACE,
TAB,
BRACKET_LEFT,
BRACKET_RIGHT,
ENTER,
LEFTCONTROL,
SEMICOLON,
APOSTROPHE,
GRAVE,
LEFTSHIFT,
BACKSLASH,
COMMA,
PERIOD,
SLASH,
RIGHTSHIFT,
KEYPADMULTIPLY,
LEFTALT,
SPACE,
CAPSLOCK,
NUMLOCK,
SCROLLLOCK,
CURSORUPLEFT,
CURSORUP,
CURSORUPRIGHT,
KEYPADMINUS,
CURSORLEFT,
CURSORRIGHT,
KEYPADPLUS,
CURSORDOWNLEFT,
CURSORDOWN,
CURSORDOWNRIGHT,
KEYPADPERIOD,
LESS,
KEYPADENTER,
RIGHTCONTROL,
CONTROL,
KEYPADDIVIDE,
PRINTSCREEN,
RIGHTALT,
BREAK,
BREAK_ALTERNATIVE,
HOME,
CURSORBLOCKUP,
PAGEUP,
CURSORBLOCKLEFT,
CURSORBLOCKRIGHT,
END,
CURSORBLOCKDOWN,
PAGEDOWN,
INSERT, and
REMOVE.
SEE ALSO¶
svgalib(7),
vgagl(7),
libvga.config(5),
keytest(6),
eventtest(6),
keyboard_init(3),
keyboard_init_return_fd(3),
keyboard_close(3),
keyboard_getstate(3),
keyboard_keypressed(3),
keyboard_clearstate(3),
keyboard_translatekeys(3),
keyboard_update(3),
keyboard_waitforupdate(3),
vga_waitevent(3)
AUTHOR¶
This manual page was edited by Michael Weller
<eowmob@exp-math.uni-essen.de>. The exact source of the referenced
function as well as of the original documentation is unknown.
It is very likely that both are at least to some extent are due to Harm
Hanemaayer <H.Hanemaayer@inter.nl.net>.
Occasionally this might be wrong. I hereby asked to be excused by the original
author and will happily accept any additions or corrections to this first
version of the svgalib manual.