@@ -14,54 +14,45 @@ layouts. For these reasons VCC provides three built-in keyboard layouts
1414The Coco (DECB) layout maps the PC’s keyboard in a layout similar to an
1515actual Coco 3 keyboard.
1616
17- Natural (OS-9) maps the PC’s keyboard is to match the keycaps on a US
17+ Natural (OS-9) maps the PC’s keyboard to match the keycaps on a US
1818QWERTY keyboard with the exception of a few special keys.
1919
2020Compact (OS-9) is simular to Natural, but with some keys altered to
2121compensate for missing the number pad keys on smaller laptops.
2222
23- See the “VCC Keyboard Map” section for details of the build-in key
24- mappings.
25-
2623The Custom layout is stored in a seperate file while the built-in layouts
2724are hardcoded within the VCC executable.
2825
29- The current layout is selected in the Keyboard tab on the Configuration menu.
30- From there click the radio button for the desired layout and click OK
31- or Apply.
26+ The mapping is selected by a radio button on the VCC Config Keyboard tab.
3227
33- Also on the Configuration Keyboard tab there is a section that allows the
34- Custom keyboard mapping to be configured.
28+ Also on the Config Keyboard tab there are two buttons in the Custom Keyboard
29+ section, as follows:
3530
36- Use the "Choose File" button to change the custom keymap file. If the chosen
31+ The "Choose File" button changes the custom keymap file. If the chosen
3732file exists the keymap is loaded. If the file does not exist a new file is
38- created containing the previously selected keymapping. This allows user to
39- create a new file that contains a copy of either one of the built-in keymaps or
40- the current custom map.
41-
42- Use the "EDIT" button to modify the current custom keymap using keymap editor.
43- Changes made in the keymap editor take immediate effect and are automatically
44- saved to the choosen keymap file. (Unless Cancel is selected within the Editor)
33+ created containing the selected keymapping. This allows user to create a
34+ file that contains a copy of any of the built-in keymaps.
4535
46- Using either the "Choose File" or the "EDIT" functions will cause the Custom
47- keymap to be automatically selected.
36+ The "EDIT" button modifies the Custom keymap. Changes made in the editor
37+ take immediate effect and are automatically saved to the keymap file unless
38+ Cancel is selected within the Editor. Using the keymap editor will cause the
39+ Custom keymap to be automatically selected.
4840
49- It is possible to modify keymap files using notepad or a text editor. This
50- should only be done for keymap files not currently choosen while VCC is
51- running. Otherwise VCC will overwrite the changes.
41+ It is possible to modify custom keymap files using a text editor. This should
42+ not be done while VCC is running. Otherwise VCC might overwrite the changes.
5243
5344
5445Custom Keyboard Map File
5546------------------------
5647
5748The keyboard map file is used to map host PC key codes into Color Computer 3
58- keys. This file has the default name "custom.keymap" and resides in the user's
59- Vcc appdata directory. The file contains lines of text, each contains four
60- fields (two pairs) seperated by one or more spaces or tabs. Blank lines,
61- lines starting with "#", or anything on a line beyond four fields are comments.
62- All other lines are key definitions. The first two fields of a key definition
63- are the PC code and it's modifier. The next two fields are the CoCo key and
64- it's modifier.
49+ keys. This file has the default name "custom.keymap" and normally resides in
50+ the user's Vcc appdata directory. The file contains lines of text, each
51+ contains four fields (two pairs) seperated by one or more spaces or tabs.
52+ Blank lines, lines starting with "#", or anything on a line beyond four fields
53+ are comments. All other lines are key definitions. The first two fields of
54+ a key definition are the PC code and it's modifier. The next two fields are
55+ the CoCo key and it's modifier.
6556
6657PC keynames start with "DIK_" and CoCo key names start with "COCO_".
6758Key modifiers are specified with a single digit as follows:
@@ -77,12 +68,12 @@ Here are some example entry lines:
7768 DIK_EQUALS 0 COCO_MINUS 1 # "=" Coco
7869 DIK_MINUS 1 COCO_MINUS 2 # "_" NitrOS-9
7970
80- This above example maps the '=' PC key to the 'Shift+' CoCo keys and 'Shift-'
81- PC keys to 'Alt-' CoCo keys in Vcc .
71+ This above example maps PC '=' to 'Shift+' and PC 'Shift-' key to 'Control -'
72+ on the emulated CoCo.
8273
8374Any CoCo key that is not mapped in the keymap file will be dead in Vcc.
8475However shifted letter keys do not need to be mapped to make them uppercase
85- because both DECB and NitrOS -9 will handle this internally.
76+ because both DECB and OS -9 will handle this internally.
8677
8778It is important to note that some PC keys can not be mapped. Specifically the
8879F3-F11 keys can not be mapped, they are used for Vcc control. Keys selected
0 commit comments