Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-FileBioskeys()
Keytbl()                                                              XBIOS

Syntax

KEYTAB *Keytbl( normal, shift, caps )
char *unshift, *shift, *caps;

Function      Keytbl() reads/modifies the internal keyboard mapping
              tables.

Opcode        16 (0x10)

Availability  All TOS versions.

Parameters    normal is a pointer to an array of 128 CHARs which can be
              indexed by a keyboard scancode to return the correct ASCII
              value for a given unshifted key. shift and caps point to
              similar array except their values are only utilized when
              shift and caps-lock respectively are used. Passing a value
              of KT_NOCHANGE ((char *)-1) will leave the table unchanged.

Binding       pea      caps
              pea      shift
              pea      normal
              move.w   #$10,-(sp)
              trap     #14
              lea      14(sp),sp

Return Value  Keytbl() returns a pointer to a KEYTAB structure defined as
              follows:

              typedef struct
              {
               char *unshift;
               char *shift;
               char *caps;
              } KEYTAB;

              The entries in this table each point to the current
              keyboard lookup table in their category. Entries are indexed
              with a keyboard scancode to obtain the ASCII value of a key.
              A value of 0 indicates that no ASCII equivalent exists.

See Also      Bioskeys()