Input Device Action Names Used in Cloanto Software
This document describes the names associated to keyboard and other input device actions as implemented in scripting and configuration files used by Cloanto applications.
Overview to Keyboard Names
Keyboard names include all single-character marks that appear on keyboard keys, like "A", "@" or "5". These names are not case sensitive, i.e. "a" is the same as "A". Special attributes (e.g. UPPERCASE, or SHIFT and/or CAPS LOCK) must be used to indicate specific conditions such as upper or lower case, numeric keypad, etc. Attributes are also used to indicate certain combinations of control keys and non-control keys.
Names for Graphical Keys (All Systems)
All graphical keys (symbols) can be represented by the single character (symbol) which they are associated with, using either ISO 8859-1 or Unicode representation. In certain contexts, however, it is necessary or preferable to avoid the use of certain characters, which may be confused with control characters. For this reason, the following names are available as aliases (synonyms), of characters which may be considered special.
Names for Graphical Keys (PET/CBM)
The following graphical keys (symbols) appear on some models by Commodore, such as the PET/CBM, VIC 20 and C64.
Names for Japanese Keys (PET/CBM)
The following keys appear on Japanese versions of the VIC 1001, VIC 20 and C64.Work in progress. We may directly reference Unicode characters.
Names for "PETSCII" Graphical Keys (PET/CBM)
Work in progress. We may directly reference Unicode characters and make a formal proposal for missing characters.
Names for Non-Graphical Keys (All Systems)
The following names are used to describe keys which do not enter text, but rather are associated with some control or spacing action. Where a key name exists with the LEFT or RIGHT prefix, the key name without prefix means "either LEFT or RIGHT".
The Commodore HOME, INST, DEL, RETURN keys use the same name as the corresponding PC keys (HOME, INSERT, DELETE, ENTER), even if the function sometimes differs (e.g. INST on the C64 inserts a white space).
The C128 uses all six cursor key names (four individual direction keys, plus two horizontal/vertical keys).
HOME [Shift+Home gives CLR on some PET/CBM systems]
F1 .. F24
Names for Non-Graphical Keys (PET/CBM and Amiga)
The following names are used to describe keys which do not enter text, but rather are associated with some spacing or other control action. Where a key name exists with the LEFT or RIGHT prefix, the key name without prefix means "either LEFT or RIGHT".
For the PET/CBM "Inst/Del" key, see INSERT and BACKSPACE under All Systems ("Del" is defined by its functionality, which is a BACKSPACE, not a DELETE). For "Return", see ENTER under All Systems.
For the C128 "No Scroll" key, see SCROLL LOCK under All Systems.
LEFT AMIGA [solid "A" symbol]
RIGHT AMIGA ["A" outline symbol]
STOP [Shift+Stop gives RUN]
COMMODORE ["C=" symbol]
40 80 DISPLAY
The following Keyboard Attributes can be combined together, and must be used in combination with a non-attribute key name. Attributes can be combined with the "+" sign. Space separators are optional. The KEYBOARD, NUMPAD, UPPERCASE and LOWERCASE attributes are used immediately before a key name, separated by a space, but without "+" sign.
Names for CDTV Remote (Joypad) Keys
The infrared-linked CDTV remote control is a hybrid joypad-like device which has both a set of buttons which are sent to the main unit as keyboard keys, and a set of buttons which can be set (via the Joy/Mouse switch) to emulate either an Amiga joystick or a mouse. The following names are used to describe the peculiar remote keyboard events (since joystick and mouse events are already described elsewhere).
REMOTE PLAY [also used for Pause]
REMOTE FORWARD [also known as FF or Fast Forward]
REMOTE REWIND [also known as REW, Reverse or Fast Reverse]
Names for Non-Keyboard Buttons
The following names are used to describe mouse and joystick button actions. If there are multiple mice or joysticks, it is assumed that the event is related to the primary or default device. The PRIMARY mouse button is usually the left mouse button, and the SECONDARY mouse button is the right button.
JOYSTICK UP [meaning Forward]
JOYSTICK DOWN [meaning Back]
JOYSTICK FIRE [meaning button 1]
JOYSTICK BUTTON <#> [where <#> is a button number 1-]
TAPE FAST FORWARD
The following are example of valid key name combinations:
NUMPAD PLUS SIGN
LEFT SHIFT+NUMPAD 5
LEFT ALT + RIGHT ALT + SHIFT + RIGHT WINDOWS + PLUS
SHIFT + RUN STOP
RESTORE + RUN STOP
SHIFT + CURSOR HORIZONTAL
TAPE PLAY + TAPE RECORD