Provided by: libsvga1-dev_1.4.3-29_i386 bug

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.