The Prizm’s syscalls and related keyboard functions use different methods of representing keys. These values vary in size and are tied to specific groups of syscalls. The Reading_Input tutorial page has information on such syscalls and their uses.

Matrix Key Codes #

The matrix key codes are a 2 byte column/row pair specified as 0xCCRR. These correlate to the column and row of the keyboard matrix that the key is located at. The following functions use this key format:

• GetKeyWait_OS
• Keyboard_PutKeycode (first two parameters)

The two tables in this section show the same information, presented in different ways.

Program Key Codes #

The key codes here are decimal values made up of the column and row as CR. The following functions use this key format:

• PRGM_GetKey - Function to emulate legacy functionality, see PRGM_GetKey_OS for definition.

Character and Control Codes #

Character codes are not directly mapped to the physical keys on the keyboard. The values use the state of key modifiers to return a value pertaining to the specific function of a key (pressing EXIT returns a code that’s different from when pressing SHIFT then EXIT). The following syscalls use these codes:

• GetKey
• Keyboard_PutKeycode (third parameter)
• EditMBStringCtrl and variants
• EditMBStringChar and variants

The values in the tables below are in hexadecimal.

Notes #

• The values of the characters in Alpha mode are the same as their ASCII codes, both for upper- and lower-case.
• Certain keys have a different value when modifiers are on, even when there is nothing printed on the keyboard to indicate such. Examples include Shift+Optn and Shift+cursor keys.
• Control codes start at 0x7530 (decimal: 30000) and are meant to be redirected to syscalls such as EditMBStringCtrl; character codes are much lower values and should be redirected to syscalls like EditMBStringChar.

Direct Keyboard Matrix #

TODO