Programming instructions

Intermec Fingerprint v7.61 – Programmer’s Reference Manual Ed. 7136
Chapter 2 Program Instructions
KEYBMAP$
Field of Application Variable returning or setting the keyboard map table.
Syntax Read the map table: <svar> = KEYBMAP$(<nexp>)
<svar> returns the keyboard mapping
<nexp> is the type of string to be returned:
0 = Unshifted 64 characters
1 = Shifted 64 characters
Set the map table: KEYBMAP$(<nexp>) = <sexp>
<nexp> is the type of string to be remapped:
0 = Unshifted 64 characters
1 = Shifted 64 characters
<sexp> is the string specifying the ASCII value for each key position
in the selected type of string.
Remarks
In the KEYBMAP$ statement, each key on the printer’s front panel
has two characteristics:
• The physical location of the key (position number).
(This is not the same thing as the key’s Id No, see KEE ON/OFF
or ON KEY GOSUB.)
• The ASCII decimal value that will be produced when the key is pressed.
(Compare with BREAK.)
In principle, each physical key can produce two different ASCII values, one
in unshifted position and another in shifted position. One key is appointed
<Shift> key. When the <Shift> key is pressed at the same time as another key,
the unshifted ASCII value of the latter will be increased by 128.
You can use the KEYBMAP$ instruction in two ways:
Reading the keyboard mapping
You can read how the keyboard is mapped in regard of either unshifted
or shifted characters. The printer will return a string of ASCII values in
ascending key position number. Because many keys return non-printable
ASCII values (ASCII 00-31 dec.), all will not be returned to the screen
of the host or printed on a label.
Changing the keyboard mapping
You can change the mapping of the keyboard, so a key will produce
another ASCII value than before. To do that, you must create a string which
specifi es the ASCII value for each of all unshifted or shifted key positions
in ascending order. Regardless of what the keyboard looks like, there are
always 64 theoretical key positions.
Characters, that cannot be produced by the keyboard of the host, can be
substituted by CHR$ functions, where the character is specifi ed by its ASCII
decimal value according to the selected character set (see NASC statement.)
The same applies to special characters. Key positions which should be
disabled or are not included in the physical keyboard can be mapped as
NUL, using the function CHR$(0). Note that the position of the <Shift> key
cannot be remapped.