home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1995 November / PCWK1195.iso / inne / podstawy / dos / 4dos / 4uzytki / gl-keys.exe / KEYS.DOC < prev    next >
Text File  |  1994-02-10  |  6KB  |  120 lines
  1. KEYS allows you to provide automatic keystrokes.  One highly useful
  2. technique is to run KEYS from a batch file to set up some automatic
  3. keystrokes for the next program in the batch file.
  4.  
  5. KEYS is fully compatible with the program KSTACK which is shipped
  6. with 4DOS, and is also mostly compatible with 4DOS's KEYSTACK command.
  7. KEYS provides a superset of the capabilities of 4DOS KSTACK program
  8. and KEYSTACK command, in a fully coexistant environment.  KEYS can be
  9. substituted for the KSTACK program, or for the KEYSTACK command, or
  10. both.  KEYS has a more useable command line syntax for keystroke
  11. specification than the KEYSTACK command.  KEYS consumes less resident
  12. memory than the KSTACK program.  KEYS comes with assembler source, and
  13. can be used independently of 4DOS.
  14.  
  15. To install KEYS, run it with the /I parameter:   KEYS /I
  16. (This is equivalent to running the KSTACK program with no parameters
  17. prior to it being installed, or with the /I parameter at any time.)
  18.  
  19. To check if KEYS has already been installed, run it with no parameters.
  20. KEYS will inform you of the installation state.
  21.  
  22. To initialize keystrokes, run it with any of the other parameters
  23. below on the command line (They are a superset of KEYSTACK's
  24. parameters).  If the command line isn't long enough to allow
  25. specification of enough keystrokes, you can put the keystroke
  26. parameters into a file, and use the command:  KEYS /F < file
  27.  
  28. The parsing is very dumb.  If you follow the rules below, will should
  29. have no problem.  If you do not, you may get unpredictable keystrokes.
  30. Unquoted numbers should generally be followed by a space.
  31.  
  32. quoted string:  begins and ends with the same quote character.  All
  33.                 characters between are automatic keystrokes.  The
  34.                 quote character itself may be either ' or ", and may
  35.                 not be imbedded within the quoted string.  A string
  36.                 delimited by leading and trailing tilde characters ("~")
  37.                 can also be used.  In this case, the scancodes used for
  38.                 the digits and for the characters ".*-+" are those from
  39.                 the numeric keypad.
  40.  
  41. -:  Satisfies a check for type-ahead with a zero response, is ignored for
  42.     waited get character requests.
  43.  
  44. !:  Clears all pending KEYS keystrokes, as well as all user supplied
  45.     keystrokes.  Does not clear any parameters specified with this same
  46.     command, however, only keystrokes that existed before this invocation
  47.     of KEYS are cleared.
  48.  
  49. f1-f12:  Generates the extended ASCII sequence for function keys 1 to 12.
  50.  
  51. fs1-fs12:  Generates codes for shifted function keys.
  52.  
  53. fc1-fc12:  Generates codes for control function keys.
  54.  
  55. fa1-fa12:  Generates codes for alternate function keys.
  56.  
  57. r,e:  Either of these generate a carriage return.  
  58.  
  59. ^c: Generates the control code associated with the character "c".
  60.     Control-C is not specially recognized by the BIOS in this manner.
  61.     The character "c" should generally be a letter.
  62.  
  63. &c: Generates the ALT code associated with the character "c".
  64.     The character "c" should generally be a letter.
  65.  
  66. numbers:  The ASCII code of any character can be typed in.  If the
  67.           number is greater than 255 it is assumed to also contain
  68.           the scan code for the character.
  69.  
  70. Extended ASCII:  An @-sign followed by a number code is treated as an
  71.                  Extended ASCII code.  All Function keys are included.
  72.  
  73. Enhanced Keyboard Extended ASCII: A %-sign followed by a number code is
  74.                                   treated as an Extended ASCII code from
  75.                                   the enhanced keyboard.  The ASCII value
  76.                                   is hex E0 'α'.
  77.  
  78. Scan code: A #-sign followed by a number changes the scan code that is
  79.            provided for successive characters.  The initial value is 255.
  80.            A value of 255 emulates using the actual keys on the keyboard:
  81.            the scan code is derived from the ASCII value of the keystroke.
  82.            Other values of the scan code are used for every character
  83.            specified until the scan code is changed again.  For example,
  84.            since hitting the "+" key on the numeric pad is indistinguishable
  85.            from hitting the "+" key on the alphanumeric pad by the ASCII
  86.            value, KEYSTACK will interpret it as coming from the alphanumeric
  87.            keyboard.  However, to specify it as coming from the numeric pad,
  88.            use the following parameters:  #78 "+".  Or ~+~.  Strange
  89.            combinations of scan codes and ASCII codes can result from
  90.            misuse of this feature.  Also, any combination of codes that
  91.            can be generated from any keyboard can be generated this way.
  92.  
  93. /wnnn: nnn is a number of tenths of seconds that are delayed between
  94.        between the prior and next parameters.  Numbers between 0 and 255 
  95.        are acceptable.  A tenth of a second is approximated by 2 BIOS clock 
  96.        ticks, causing the actual delay to be somewhat longer than specified.
  97.  
  98. Note: minor incompatibilities with the KSTACK program and KEYSTACK command
  99. of 4DOS:  
  100.  
  101. KEYSTACK's /W parameter is in 18ths of a second, or BIOS clock ticks.
  102. KEYS will wait twice as long for the same specification.  Generally,
  103. this will slow things down a little but otherwise not cause bad effects.
  104. Tenths of seconds are felt to be more user-friendly.
  105.  
  106. KEYS automatically supplies the correct BIOS scan code for parameter
  107. keystrokes.  KEYSTACK generally supplies 0 for the scan code.  KEYS
  108. can simulate KEYSTACK's behavior in this regard, if you supply as the
  109. first parameter "#0".  However, KEYS default behavior is superior to
  110. KEYSTACK's default behavior.
  111.  
  112. KEYS can be patched to supply scan codes for alternate keyboards.
  113. There are two tables at the end of the binary that are used to look
  114. up the scan code value for a particular ASCII value... the first
  115. with preference for the alphanumeric keyboard, the second with
  116. preference for the numeric keypad, for those characters that are on
  117. both.
  118.  
  119. Written by Glenn Linderman, glenn.linderman@sandiegoca.ncr.com
  120.