cloanto.comProducts & ServicesSupport

Specs
Previous Page
End of Page

Input Device Action Names Used in Cloanto Software

Abstract

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.

PLUS

MINUS

HYPHEN

PERIOD

COMMA

EURO

POUND

YEN

EQUALS

DOUBLE QUOTE

BACKSLASH

SEMICOLON

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.

UPWARDS ARROW

LEFTWARDS ARROW

PI

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).

SPACE

ESCAPE

TAB

ENTER

BACKSPACE

DELETE

INSERT

HOME [Shift+Home gives CLR on some PET/CBM systems]

END

PAGE UP

PAGE DOWN

CURSOR UP

CURSOR DOWN

CURSOR LEFT

CURSOR RIGHT

CURSOR HORIZONTAL

CURSOR VERTICAL

PRINT SCREEN

SYS RQ

NUM LOCK

SCROLL LOCK

PAUSE

BREAK

APPLICATION

F1 .. F24

SHIFT

LEFT SHIFT

RIGHT SHIFT

ALT

LEFT ALT

RIGHT ALT

CONTROL

LEFT CONTROL

RIGHT CONTROL

WINDOWS

LEFT WINDOWS

RIGHT WINDOWS

CAPS LOCK

GRAPHICS

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]

HELP

CLR

STOP [Shift+Stop gives RUN]

RESTORE

COMMODORE ["C=" symbol]

40 80 DISPLAY

NO SCROLL

LINE FEED 

REVERSE

OFF REVERSE

REPEAT

Keyboard Attributes

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.

SHIFT+

ALT+

CONTROL+

WINDOWS+

LEFT SHIFT+

RIGHT SHIFT+

LEFT ALT+

RIGHT ALT+

LEFT CONTROL+

RIGHT CONTROL+

LEFT WINDOWS+

RIGHT WINDOWS+

LEFT AMIGA+

RIGHT AMIGA+

CAPS LOCK+

ALT GR+

KEYBOARD

NUMPAD

UPPERCASE

LOWERCASE

RESTORE+

COMMODORE+

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 STOP

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.

MOUSE PRIMARY

MOUSE MIDDLE

MOUSE SECONDARY

JOYSTICK UP [meaning Forward]

JOYSTICK DOWN [meaning Back]

JOYSTICK LEFT

JOYSTICK RIGHT

JOYSTICK FIRE [meaning button 1]

JOYSTICK BUTTON <#> [where <#> is a button number 1-]

TAPE PLAY

TAPE STOP

TAPE RECORD

TAPE REWIND

TAPE FAST FORWARD

TAPE EJECT

Examples

The following are example of valid key name combinations:

NUMPAD PLUS SIGN

NUMPAD +

NUMPAD CE

NUMPAD 00

LEFT SHIFT+NUMPAD 5

KEYBOARD ENTER

LEFT ALT + RIGHT ALT + SHIFT + RIGHT WINDOWS + PLUS

SHIFT + RUN STOP

RESTORE + RUN STOP

SHIFT + CURSOR HORIZONTAL

TAPE PLAY + TAPE RECORD

Change Log

  • 2007-11-11: Added non-keyboard events
  • 2010-03-25: Replaced "left/right/up/down arrow" with "cursor left/right/up/down"; Added RetroPlatform events
  • 2011-11-02: Added more PET/CBM names and normalization by function
  • 2016-10-18: Added more PET/CBM names
  • 2016-12-15: Added CDTV Joypad names

Specification Information
Home Page: https://cloanto.com/specs/ianames/
Version: 1.6
Status: Cloanto Private
Last Page Update: 2016-10-18
Your feedback is always appreciated. It is safe to link to this page.
Top of Page
Legal NotesPrivacy Notes