File format for AquaTerra keystroke files (*.atk)

The files described here are read by WinKeyDriver version 1.1,
which will be shipped with GenScn 1.1 and can be invoked using the
File/Playback Keys menu.

WinKeyDriver version 1.0 differed in the following ways:

-the TIM command was not supported
-all non-keystroke commands (see below starting with {APP ...}) 
 were not surrounded by curly braces.
-commas were treated as comment characters

Keystrokes that produce a character on the screen appear as that
character in the file.

The SendKeys documentation in Visual Basic contains the following
table of keys and their corresponding codes that appear in a
keystroke file:

Key         Code 
BACKSPACE   {BACKSPACE}, {BS}, or {BKSP} 
BREAK       {BREAK} 
CAPS LOCK   {CAPSLOCK} 
DELETE      {DELETE} or {DEL} 
DOWN ARROW  {DOWN} 
END         {END} 
ENTER       {ENTER} or ~ 
ESC         {ESC} 
HELP        {HELP} 
HOME        {HOME} 
INSERT      {INSERT} or {INS} 
LEFT ARROW  {LEFT} 
NUM LOCK    {NUMLOCK} 
PAGE DOWN   {PGDN} 
PAGE UP     {PGUP} 
RIGHT ARROW {RIGHT} 
SCROLL LOCK {SCROLLLOCK} 
TAB         {TAB} 
UP ARROW    {UP} 
F1          {F1} 
...
F16         {F16} 

+           {+}
^           {^}
%           {%}
~           {~}
(           {(}
)           {)}
[           {[}
]           {]}
{           {{}
}           {}}
'           {'}

SHIFT       + 
CTRL        ^ 
ALT         % 


To specify that any combination of SHIFT, CTRL, and ALT should be
held down while several other keys are pressed, enclose the code
for those keys in parentheses. For example, to specify to hold
down SHIFT while E and C are pressed, use +(EC). To specify to
hold down SHIFT while E is pressed, followed by C without SHIFT,
use +EC.

To specify repeating keys, use the form {key number}. You must put
a space between key and number. For example, {LEFT 42} means press
the LEFT ARROW key 42 times; {h 10} means press H 10 times.

Non-keystroke commands:

In addition to keys that are passed on to the application,
WinKeyDriver recognizes several useful commands:

If a single quote ' appears on a line other than as part of {'}
then the single quote and the rest of the line are seen as a
comment and are not processed.

{APP c:\Windows\Notepad.exe}

runs the specified application and sends the remaining
keystrokes to it (This command is not necessary in keystroke
files that will be run from the Playback Keys menu in GenScn.)

{TIM 1000}

sets the per-keystroke wait time to the specified number of
milliseconds. If this time is too short, keystrokes may be sent
before the window is ready to receive them. The default is 1000
milliseconds (one second.)

{PAU 5}

pauses playback for the specified number of seconds

{SAV c:\temp}

sets the directory where captured screenshots will be saved

{PRTS slide1}

copies the current contents of the whole screen to a file in the
save directory. This example would be saved as c:\temp\slide1.bmp.

{PRTW slide2}

same as PRTS, but captures only the active window instead of the
whole screen.

{MSG Finished capturing all slides!}

opens a message box displaying the specified text and waits for
the user to press OK

{PID}

opens a message box to display the PID of the application being
driven by WinKeyDriver - useful when debugging under Windows NT


A sample keystroke file that runs GenScn is shown below. Since
this file contains the APP command, it is meant to be started by
running WinKeyDriver. If the APP line were removed, this
would work from the File/Playback Keys menu within GenScn.

{APP c:\vb\genscn\bin\genscn.exe c:\test\genscn\shena\shena.sta}
{PAU 5}        'Wait 5 sec for GenScn to start and load shena project
%CF{DOWN 4}{ } 'select con flow
%SF{DOWN 2}{ } 'select scen base
%LA            'all locations
%TA            'timeser add
%TF{DOWN 2}    'timeser focus, down 2
%TC            'timeser clear
%AG            'analysis graph
%G             'Window:Graph: graph generate 
%FC            'Window:Graph Standard Plot: file close
{ESC}          'Window:Graph: close
%FX            'Window:GenScn: close