home *** CD-ROM | disk | FTP | other *** search
/ ST-Computer Leser-CD 2000 January / LCD_01_2000.iso / tools / clock237 / doc / english / clocky.txt next >
Encoding:
Text File  |  1998-06-21  |  5.9 KB  |  129 lines
  1. NOTE: the most up-to-date documentation is in CLOCKY.HYP file (read with
  2.       ST-Guide)
  3.  
  4. Clocky┐ 2.22beta                                                1998/03/29
  5. ~~~~~~~~~~~~~~~~
  6.  
  7. this is a sort of README.TXT for English version of Clocky. Sorry for
  8. my English, I translated the programs roughly word by word and wrote this
  9. document in a hurry.
  10.  
  11. What is Clocky? It's the most useful all-in-one utility for Atari range of
  12. computers (ST, STe, MegaSTE, TT, Falcon). It's very small (under 5 kB)
  13. because it's written in pure assembler. Its development started when I
  14. bought my first 520STM in 1989, and still continues as I keep buying new
  15. Atari hardware (last time it was NOVA graphics card). When you start using
  16. Clocky, you can usually remove many others TSR from your AUTO folder, so
  17. you minimize memory consumption and risk of unwanted collision between the
  18. many other AUTO programs.
  19.  
  20. Installation:
  21. -------------
  22. 1) put CLOCKY.PRG into your AUTO folder. I prefer to put it as the first
  23.    program, so its functions are available as soon as possible.
  24.  
  25. 2) start SETCLOCK.PRG and configure CLOCKY.PRG for your system and
  26.    according to your needs (see below)
  27.  
  28. 3) Clocky is able to read date and time from 'DATE' and 'TIME' Cookies. You
  29.    may want to put DTCOOKIE.PRG into your AUTO folder for this.
  30.  
  31. 4) reboot your computer so CLOCKY starts.
  32.  
  33. Clocky's features:
  34. ------------------
  35.  
  36. [T] shows Time and date in upper right corner of screen (on Falcon in all
  37.     resolution depths including TrueColor). Graphics cards are partially
  38.     supported (on my NOVA 1-bit and 8-bit color depths work fine).
  39.  
  40. [?] allows you to define and use two different keyboard layouts (if you are
  41.     not English or American, you may want to use first keyboard layout for
  42.     programming and second one for quick typing of texts in your national
  43.     language - for instance Czech contains 30 additional letters that are
  44.     mapped on different keys on first and second keyboard layouts). Then
  45.     you can switch between the [O]riginal layout from ROM, the first [N]
  46.     and the second [C] keyboards on-the-fly.
  47.  
  48. [D] you can type special letters with Dead keys (this is hardcoded for
  49.     Czech characters ATM, though I plan on making this freely editable).
  50.     Dead key is the second key left from Backspace.
  51.  
  52. [A] on TOS < 2.06 you might type special letters (e.g. with ASCII code 240)
  53.     by holding down Alt and typing the ASCII code on numeric keypad.
  54.  
  55. [M] dynamic Mouse accelerator with variable acceleration (twice or four
  56.     times).
  57.  
  58. [S] Screen saver - at this moment for VGA monitors on Falcon and for SM124
  59.     on ST - saves screen by disabling screen output. On Falcon this also
  60.     speeds up the computer itself, because VIDEL doesn't hog the data bus
  61.     when screen saver is active.
  62.  
  63. [L] Latin2 real-time conversion on printer (hardcoded for Czech characters
  64.     ATM, but might be freely editable soon)
  65.  
  66. [K] Keyboard clicks and/or bells might be disabled
  67.  
  68. [B] Black on white or white on black? This enables invers colors (on Falcon
  69.     even in 16 and 256 color modes)
  70.  
  71. [+] special support for MegaSTE - enables 16 MHz and caches during boot
  72.     (greatly speeds up booting). Later you can switch between Slow and Fast
  73.     mode by pressing [-] and [+] on numeric keypad (just like on older
  74.     PC's)
  75.  
  76. It is possible to enable and disable all these 10 features by simple
  77. pressing the hotkey. Hotkey is the letter in brackets together with some
  78. shifts, control or alternate keys - defined by Hotkeys buttons in the
  79. Configuration program of Clocky. By default the Hotkeys are defined as
  80. LeftShift+RightShift (i.e. both shifts hold down at the same time).
  81.  
  82. Additional features:
  83. --------------------
  84. Fufin didn't want to have the Time showed on screen all the time, but he
  85. wanted to have a quick look on it from time to time. For this I implemented
  86. so called Seekeys. You can watch the Time by simple holding down the
  87. Seekeys combination (by default LeftShift + Control).
  88.  
  89. Clocky features Cookie Jar 'JCLK' which points to defined structure. You
  90. can drive Clocky by an external program or just read Clocky's settings. A
  91. good example is Clocky Tools, written by Fufin. This program is able to
  92. stop or enforce Clocky's screen saver by simple moving of mouses pointer to
  93. a defined screen corner.
  94.  
  95. The most interesting feature is the possibility of external hotkeys. Clocky
  96. holds the control over keyboard buffer and steal any Control-Alternate-key
  97. combination. You can read the key in the Clocky Cookie Jar structure and if
  98. you like this key, you can take it and set the key value to zero in the
  99. Clocky's structure. If you don't react in 0.1 second, Clocky puts the key
  100. back to keyboard buffer so operating system or top application can detect it.
  101.  
  102. First Clocky's External Hotkey Client is Clocky Tools, written by Fufin.
  103. It's an accessory with configuration file where you can define the GEM
  104. messages sent on different keys detected. This way you can easily launch or
  105. top your favourite applications (like is text editor, ST-Guide, e-mail
  106. program, WWW browser or programming environment) by simple pressing the
  107. hotkey (defined in JCLKTOOL.SET file). So with Clocky Tools you get unified
  108. environment for launching applications from any other application or
  109. desktop by simple keypress!
  110.  
  111. It's even possible to start several different Clocky External Hotkey
  112. Clients. Every client has to register the keys he's going to use, so
  113. collisions between Hotkey clients are avoided.
  114.  
  115. Don't know what to say about Clocky's Config app. Simply click on buttons,
  116. edit both keyboards and have fun.
  117.  
  118. Clocky┐ is fairware. If you use it regularly and like it, consider
  119. sending me a small amount of money (read REGISTER.TXT, do not mind the
  120. Czech characters, note just the postal address and list of registered
  121. users).
  122.  
  123. EnJoy Clocky!
  124.  
  125. Petr
  126.  
  127. e-mail: stehlik@cas3.zlin.vutbr.cz
  128. WWW     http://cas3.zlin.vutbr.cz/~stehlik/
  129.