30
between English and your desired language, type that key with both drivers to make yourself a custom
language dictionary. Then use the English version of that key in the layout file. If macros are played while a
different keyboard language is active than the language in which it was designed, some actions will change.
Layout files are updated only when the v
-
drive is closed.
Any given layout can be modified by both onboard programming commands and through direct editing. Be
cautious about using both on
-
board programming and direct editing while the v
-
drive is open. If you use on
-
board programming while the v
-
drive is open and/or while the active layout file is open, be aware that on
-
board programming changes are not usually read from saved layout files until the v
-
drive is closed.
Note: If you save your edits and re
-
select that layout using the onboard programming shortcut (e.g. progm +
F3 for the qwerty.txt layout), the recently saved edits will be implemented even though the v
-
drive hasn
’
t been
closed.
7.9 Basic Syntax Examples
Below are several examples of the actual syntax used to encode certain remaps and macros. This
“
code
”
can
be copied and pasted into a layout file and then edited to produce a custom macro.
Remaps
Syntax Example 1: The Q key location will perform the letter
“
a
”.
[q]>[a]
Syntax Example 2: The Right Windows key location (always the default Win Mode location) will be
deactivated using the
“
null
”
token.
[rwin]>[null]
Syntax Example 3: When the keypad layer is active, the A key location will perform the
“
Volume Down
”
action.
[kp
-
a]>[vol
-
]
Macros
Longer macros can be tedious to write from scratch so onboard programming is recommended, at least as an
initial step. Direct Editing can be a useful tool for creating shorter macros or fine
-
tuning longer macros. Take
advantage of existing macros and examples where possible.
Note: Macros normally play when the trigger key
is depressed, without waiting for release.
Syntax Example 4: Pressing and holding Right Ctrl and the G key location plays the text macro
“
go
”.
{rctrl}{g}>{g}{o}
Syntax Example 5: When the keypad layer is active, the Escape key location plays text macro
“
hello
”.
{kp
-
escape}>{h}{e}{l}{l}{o}
Shifted characters
As shown below in Syntax Examples 6 and 7, the {
-
shift} represents the negative or downward action of
pressing the shift key, while {+shift} represents the positive or upward action of releasing the shift key.
Bracketing a token with {
-
shift} and {+shift} emulates holding down the shift key while typing the bracketed
key, and then releasing the shift key to produce the equivalent shifted action of that key.
Syntax Example 6: The Pause key location plays the text macro
“
Hi Joy!".
{pause}>{
-
Lshift}{h}{+Lshift}{i}{space}{
-
Lshift}{j}{+Lshift}{o}{y}{
-
Lshift}{1}{+Lshift}
Syntax Example 7: The F12 key location plays the text macro
“1+2=3”.
{f12}>{1}{
-
Rshift}{=}{+Rshift}{2}{=}{3}
