home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PSION / MISC / KPMOST / README2.TXT < prev    next >
Encoding:
Text File  |  1996-02-02  |  11.2 KB  |  266 lines
  1.                  KP  Typing Tutor International Generation
  2.                             Version  4.0
  3.  
  4.                        Copyright (C)  1996
  5.  
  6.                             Zijian Huang
  7.  
  8.                   All Right Reserved           Shareware
  9.  
  10.  
  11.  
  12. This document describes more details of KP, especially when you want to get
  13. more choices from the flexibility of KP.
  14.  
  15. ------------------------------------------------------------------------------
  16. How the batch files work
  17.  
  18. Here is the content of "kpus.bat":
  19.  
  20. kpworldf.exe kp.txt kpcourse.txt us.key [kp.rec] [color/mono]
  21.  
  22. The first argument indicates the sample text file which the functions
  23. "Sentence practice" and "Text practice" will use.
  24.  
  25. The second indicates the sample text which the function "Course" will use.
  26.  
  27. The third indicates a keyboard template file, KP uses this file to display a
  28. specified virtual keyboard template on the screen.
  29.  
  30. The forth argument is optional. It records the progress of the learner. If a
  31. network manager is going to use KP in a network, the manager has better
  32. to indicate the path of this file. It is recommended that the manager treats
  33. this file as a user file to  make sure that the learners can record their
  34. progress in their own files. For example:
  35. You install KP in "X:" drive, and the default user path is "F:", So you can
  36. write a batch file like:
  37. "...
  38. kpworldf.exe kp.txt course2.txt us.key f:\kp.rec
  39. ..."
  40.  
  41. Other DOS text files can be used as sample source files. It is recommended
  42. that the text files contain no more than 1600 lines, or the lines behind will
  43. be neglected; and each line contains no more than 78 characters, or the
  44. characters behind will be neglected. The last character of each line has
  45. better to be a visible character.
  46.  
  47. DO REMEMBER, the bigger the sample text file is, the larger memory the KP
  48. program requires.
  49. It is recommended to call KP via a batch file which indicate all the
  50. arguments. If no argument is given to "kpworldf.exe", "kpworldf.exe" will
  51. search for "kp.txt", "kpcourse.txt", "uk.key" and "kp.rec", and run under
  52. color mode.
  53.  
  54. ------------------------------------------------------------------------------
  55. Where to get a most original copy of KP
  56.  
  57. You can get KP from ftp and www, here is the list of addresses:
  58. http://www.ncl.ac.uk/~n4521661/share.htm
  59. ftp://ftp.ncl.ac.uk/pub/local/n4521661/share
  60. ...
  61.  
  62.  
  63. If you want to get KP from ftp, please read "read.me" in the ftp directory
  64. first.
  65.  
  66. To get access to a ftp site, here is a example:
  67.  
  68. You could access it anonymously:
  69. =============================
  70. ftp ftp.ncl.ac.uk
  71. user name->anonymous
  72. passwd->[your e-mail name]
  73. cd /pub/local/n4521661/share
  74. =============================
  75.  
  76. Here is an example in more detail:
  77.  
  78. ftp
  79. >open ftp.ncl.ac.uk
  80. Connected to aidan.ncl.ac.uk.
  81. 220 aidan FTP server (Version wu-2.4(4) Fri Apr 22 15:04:35 BST 1994) ready.
  82. Name (ftp.ncl.ac.uk:root): anonymous
  83. 331 Guest login ok, send your complete e-mail address as password.
  84. Password:
  85. 230-
  86. 230-
  87. *********************************************************************
  88. 230-*                                                        
  89. 230-* This is the newcastle ftp archive.  It is now running the Wuarchive ftp
  90. 230-* daemon, which means that compressed downloads, etc are supported.
  91. 230-* If your ftp client is having trouble, try a password starting with '-'.
  92. 230-*                                                        
  93. 230-* You must have an appropriate entry in the DNS.         
  94. 230-*                                                        
  95. 230-* Please report any problems to "postmaster@newcastle.ac.uk."
  96. 230-*                                                        
  97. 230-
  98. *********************************************************************
  99. 230-
  100. 230-
  101. 230 Guest login ok, access restrictions apply.
  102. ftp> cd /pub/local/n4521661/share
  103. 250 CWD command successful.
  104. ftp> ls
  105. 200 PORT command successful.
  106. 150 Opening ASCII mode data connection for file list.
  107. ftp> kpmost.zip    read.me    kpmost.exe
  108.  
  109. 226 Transfer complete.
  110. ftp> bin
  111. ftp> get kpmost.zip
  112. ......
  113. ftp> bye
  114. 221 Goodbye.
  115.  
  116. ==================================================
  117. REMEMBAER to use 'bin' command first before you get non-ascii files.
  118. ==================================================
  119.  
  120. ------------------------------------------------------------------------------
  121. How to modify or produce a keyboard template file
  122.  
  123. This section introduces to you how to modify or produce a keyboard template
  124. file. IF YOU WISH ONLY TO USE THE KEYBOARD TEMPLATES SUPPLIED, YOU DON NOT
  125. NEED TO READ THIS SECTION.
  126.  
  127. Though the KP Typing Tutor International Generation was developed to support
  128. most alphabet languages and keyboards templates, KP needs your help to make
  129. it more international, supporting your language, and the keyboards used in
  130. your country on behalf of your nation. I just made files "uk.key", "ukf.key",
  131. "us.key", "usf.key", "fr.key", "gr.key", "be.key" and "it.key", others were
  132. from people on the internet. If you decide to make a new keyboard template
  133. file, please read this section, and the copyright notice of KP.
  134.  
  135. Hopefully you understand ASCII code, code page, extend code page.
  136.  
  137. "*.key" is a text file that only contains integer numbers. The format of the
  138. file will be described below by some examples.
  139.  
  140. The content of "usf.key" is:
  141. 0    7   9   11
  142. 13    96 126 14   49 33 14   50 64 13   51 35 12   52 36 11   53 37 11   54 94
  143. 16   55 38 16   56 42 17   57 40 18   48 41 19   45 95 19   61 43 19
  144.         7 2        7 2        7 2        7 2        7 2        7 2        7 2
  145. 7 2        7 2        7 2        7 2        7 2        7 2
  146. 13    113 81 4    119 87 3   101 69 2   114 82 1    116 84 1   121 89 6  117
  147. 85 6   105 73 7   111 79 8   112 80 9   91 123 19  93 125 19  92 124 19
  148.          7 7        7 7        7 7        7 7        7 7        7 7        7 7
  149. 7 7        7 7        7 7        7 2        7 2       7 2
  150. 11    97 65 4   115 83 3   100 68 2   102 70 1   103 71 1   104 72 6   106 74
  151. 6   107 75 7   108 76 8   59 58 19   39 34 19
  152.         3 3        3 3        3 3        11 11      7 7        7 7        11
  153. 11      3 3        3 3        7 2        7 2
  154. 10    122 90 4   120 88 3   99 67 2   118 86 1   98 66 1   110 78 6   109 77 6
  155. 44 60 17   46 62 18    47 63 19
  156.         7 7        7 7        7 7        7 7        7 7        7 7        7 7
  157. 7 2        7 2       7 2
  158. IT SHOULD BE NOTICED that each line of a "usf.key" file will probably more
  159. than 80 characters, if you want to read and write a "*.key" file more easily,
  160. you may turn off the wrap line function of the editor.
  161.  
  162. The following are descriptions for each line of this file:
  163. LINE ONE 111111111111111111111111111111111111111111111111111111111111111111
  164. 0    7   9   11
  165.  
  166. Four numbers indicate the offsets from the left-most of the keyboard, for each
  167. line of keys from top to bottom.
  168.  
  169. LINE TWO 222222222222222222222222222222222222222222222222222222222222222222
  170. 13    96 126 14   49 33 14   50 64 13   51 35 12   52 36 11   53 37 11   54 94
  171. 16   55 38 16   56 42 17   57 40 18   48 41 19   45 95 19   61 43 19
  172.  
  173. The number 13 indicates there exist 13 keys in the top row of the keyboard;
  174. the following 13 groups of numbers indicate the information of the 13 keys on
  175. the top row of the keyboard. In each group, the first number indicates the
  176. ASCII code of the lower case character; the second indicates the ASCII code of
  177. the upper case character; the third indicates the attribute of the key. For
  178. example, in the second group, number 49 is the ASCII code of character '1',
  179. number  33 is the ASCII code of character '!', number 14 contains number 1 and
  180. 4, number 4 means the little finger of the left hand, number 1 means this key
  181. is divided into lower part and upper part.
  182.  
  183. LINE THREE 33333333333333333333333333333333333333333333333333333333333333333
  184.         7 2        7 2        7 2        7 2        7 2        7 2        7 2
  185. 7 2        7 2        7 2        7 2        7 2        7 2
  186.  
  187. These 13 groups of data indicate the colors of characters of each key. In each
  188. group, the FIRST number indicate the color of the LOWER case character, the
  189. SECOND indicate the color of the UPPER case character.
  190.  
  191. LINE FOUR 44444444444444444444444444444444444444444444444444444444444444444
  192. 13    113 81 4    119 87 3   101 69 2   114 82 1    116 84 1   121 89 6  117
  193. 85 6   105 73 7   111 79 8   112 80 9   91 123 19  93 125 19  92 124 19
  194.  
  195. In this line, number 13 indicate there exist 13 keys on the second row. In the
  196. nineth group, number 79 is the ASCII code of 'O', number 111 is the ASCII code
  197. of 'o', number 8 contains number 0 and 8. number 0 means this key is for a
  198. alphabet letter, number 8 means the ring finger of the right hand.
  199.  
  200. LINE FIVE 5555555555555555555555555555555555555555555555555555555555555555
  201. 7 7        7 7        7 7        7 7        7 7        7 7        7 7        7
  202. 7        7 7        7 7        7 2        7 2       7 2
  203.  
  204. LINE SIX 666666666666666666666666666666666666666666666666666666666666666666
  205. 11    97 65 4   115 83 3   100 68 2   102 70 1   103 71 1   104 72 6   106 74
  206. 6   107 75 7   108 76 8   59 58 19   39 34 19
  207. LINE SEVEN 777777777777777777777777777777777777777777777777777777777777777
  208. 3 3        3 3        3 3        11 11      7 7        7 7        11 11
  209. 3 3        3 3        7 2           7 2
  210.  
  211. LINE EIGHT 8888888888888888888888888888888888888888888888888888888888888888
  212. 10    122 90 4   120 88 3   99 67 2   118 86 1   98 66 1   110 78 6   109 77 6
  213. 44 60 17   46 62 18    47 63 19
  214.  
  215. LINE NINE 99999999999999999999999999999999999999999999999999999999999999999
  216.          7 2        7 7        7 7        7 7        7 7        7 7        7 7
  217. 7 7        7 2        7 2
  218.  
  219. Symbolic constant numeric value:
  220. BLACK                   0
  221. BLUE                    1
  222. GREEN                   2
  223. CYAN                    3
  224. RED                     4
  225. MAGENTA                 5
  226. BROWN                   6
  227. LIGHTGRAY               7
  228. DARKGRAY                          8
  229. LIGHTBLUE                         9
  230. LIGHTGREEN                        10
  231. LIGHTCYAN                         11
  232. LIGHTRED                          12
  233. LIGHTMAGENTA                      13
  234. YELLOW                            14
  235. WHITE                             15
  236.  
  237. "Note:    Some monitors do not recognise the intensity signal used to create
  238. the eight "light" colors(8-15). On such monitors, the light colors are
  239. displayed as their "dark" equivalents (0-7). Also, systems that do not display
  240. in color can treat these numbers as shades of one color,
  241. special patterns, or special attributes (such as underlined, bold, italics,
  242. and so on). Exactly what you"ll see on such systems depends on your hardware."
  243. (From Borland C++ on-line help)
  244.  
  245. The ASCII code for each character in this file  follow US code page (437)..
  246.  
  247. In file "us.key", you can see an additional line with ten number,
  248.  
  249. 6 14 5 3 4 6 15 5 3 4
  250.  
  251. which define the colors of ten fingers.
  252. The order is:
  253. l-t, l-i, l-m, l-r, l-l;  r-t, r-i, r-m, r-l.
  254. Try to run "kpukf.bat". Which layout would you like?
  255.  
  256. Hopefully, this example will give you some ideas how "kpus.bat" can work
  257. on various keyboards and different alphabet languages.
  258.  
  259. Any other advice, comments, suggestions please send to me. Here, I also thank
  260. Miss Katrien Deroey who helped me to generate files of French, German, Belgium
  261. keyboard template.
  262.  
  263.  
  264. Zijian Huang
  265. 12, December 1995
  266.