Was this helpful?
Speed Keys Supported
The OpenROAD keyboard map file is a text file with a specific format. The file describes 23 OpenROAD system-defined keys, and 36 user-defined keys. The file contains one line for each key with four entries for each line. The entries are arranged in four columns separated by tabs. All of the columns are mandatory.
Because the contents of some columns require specific values, it is best to copy one of the existing keyboard map files and use this file as a template if you want to modify the file or create a new one.
The following table describes the columns:
Column
Description
1
Index that OpenROAD uses to map the key. It is read into memory and must always match the text label in column 4.
Do not change the entries in this column.
2
Text that appears in the pull-down menu for the speed key.
3
Virtual key name for keystroke that occurs.
4
Internal symbol name used by OpenROAD, which must match the index in column 1.
Do not change the entries in this column.
The following virtual key definitions can be used to define key strokes:
VK_BACK      VK_TAB        VK_RETURN      VK_SHIFT      VK_CONTROL
VK_MENU      VK_PAUSE      VK_CAPITAL     VK_ESCAPE     VK_SPACE
VK_PRIOR     VK_NEXT       VK_END         VK_HOME       VK_LEFT
VK_UP        VK_RIGHT      VK_DOWN        VK_SCROLL     VK_0
VK_1         VK_2          VK_3           VK_4          VK_5
VK_6         VK_7          VK_8           VK_9          VK_A
VK_B         VK_C          VK_D           VK_E          VK_F
VK_G         VK_H          VK_I           VK_J          VK_K
VK_L         VK_M          VK_N           VK_O          VK_P
VK_Q         VK_R          VK_S           VK_T          VK_U
VK_V         VK_W          VK_X           VK_Y          VK_Z
VK_NUMPAD0   VK_NUMPAD1    VK_NUMPAD2     VK_NUMPAD3    VK_NUMPAD4
VK_NUMPAD5   VK_NUMPAD6    VK_NUMPAD7     VK_NUMPAD8    VK_NUMPAD9
VK_MULTIPLY  VK_ADD        VK_SEPARATOR   VK_SUBTRACT   VK_DECIMAL
VK_DIVIDE    VK_F1        VK_F2          VK_F3         VK_F4
VK_F5        VK_F6         VK_F7          VK_F8         VK_F9
VK_F10       VK_F11        VK_F12         VK_F13        VK_F14
VK_F15       VK_F16        VK_F17         VK_F18        VK_F19
VK_F20       VK_F21        VK_F22         VK_F23        VK_F24
VK_NUMLOCK   VK_LSHIFT     VK_RSHIFT      VK_LCONTROL   VK_RCONTROL
VK_LMENU      VK_RMENU     VK_INSERT      VK_DELETE
If a key is defined in the mapping file, it will activate if assigned to an actual menu item. For example, if the VK_RETURN key is mapped to SK_USER1 and SK_USER1 is not used, then it will not change any behavior. On the other hand, if it is assigned to a menu item attached to the frame, then it will override the default behavior and raise that event block.
The same mapping is now used for all platforms. The older definitions in the PC keyboard files still work. Any keyboard file that used UNIX definitions will need to be changed to use the new virtual key definitions.
Now 104 different key definitions are available. OpenROAD still has a limit of 59 slots available for speed key definitions which are active for the life of a session.
Last modified date: 12/20/2023