NAME¶
keyboard_translatekeys - modify scancode mappings in raw keyboard mode
SYNOPSIS¶
#include <vgakeyboard.h>
void keyboard_translatekeys(int mask);
DESCRIPTION¶
This function sets several flags which control how certain scancodes are mapped.
At startup a
mask value of 0 is active.
mask must be a logical or of zero or more of the following
#predefined integers to turn the features listed on:
- TRANSLATE_CURSORKEYS
- Translate the scancodes of the SCANCODE_CURSORBLOCK*
keys to those of the cursor keys on the number pad, s.t.
keyboard_getstate(3) and keyboard_keypressed(3) report a
keypress of the corresponding number pad cursor key and not the one on the
cursor block.
- TRANSLATE_DIAGONAL
- Translates the scancodes of diagonal cursor keys (keypad 7,
9, 1, 3) to presses of two of the ordinary up, down, left, right keys. For
example, instead of reporting a press of SCANCODE_CURSORUPRIGHT
keyboard_getstate(3) and keyboard_keypressed(3) report a
simultaneous press of SCANCODE_CURSORUP and
SCANCODE_CURSORRIGHT.
- TRANSLATE_KEYPADENTER
- The scancode of the keypad enter key is mapped to that of
the ordinary enter key, s.t. keyboard_getstate(3) and
keyboard_keypressed(3) report a press of SCANCODE_ENTER
regardless if keypad enter or ordinary enter is pressed.
- DONT_CATCH_CTRLC
- Pressing <Ctrl>-C does not raise a
SIGINT. On contrary to the other flags this has also effect when a
user defined keyboard event handler is used. Svgalib will always
process <Alt>-F1 - <Alt>-F10 and perform console
switches accordingly.
BUGS¶
The
TRANSLATE_* options above do really do simple scancode translations.
For example, when
TRANSLATE_KEYPADENTER is active and the user presses
both enter and keypad enter. Then, if he releases one of them (say keypad
enter), it's release event will clear the common keyboard state, s.t. no
keypress is reported even though enter is still pressed.
Similarly, if
TRANSLATE_DIAGONAL is active, the user holds cursor upleft
(keypad 7) down and then presses and release cursor up (keypad 8), svgalib
will only report a pressed cursor left but the simulated cursor up will be
lost. You can easily try this with the
keytest(6) demo to make the
effect more clear to you.
SEE ALSO¶
svgalib(7),
vgagl(7),
libvga.config(5),
keytest(6),
eventtest(6),
keyboard_seteventhandler(3),
keyboard_init(3),
keyboard_init_return_fd(3),
keyboard_close(3),
keyboard_update(3),
keyboard_waitforupdate(3),
keyboard_setdefaulteventhandler(3),
keyboard_getstate(3),
keyboard_clearstate(3),
keyboard_keypressed(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.
