home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / utilities / utilsf / floating / !Floating / !Help < prev    next >
Encoding:
Text File  |  1996-02-15  |  11.4 KB  |  244 lines
  1. =============================================================================
  2. = Floating Desktop Clock ===================================  © Toby Bryans =
  3. =============================================================================
  4.  
  5. = Information ===============================================================
  6.  
  7. Welcome. This little program is a desktop clock. In my opinion, it is one of
  8. the best, but then again, I would be a little bit biased! The reason I like
  9. it is because it looks nice, it always stays on the top (like the one on
  10. Windows 3.1), it is moveable, and with one click, you can bring up the
  11. current full date. This has always been one of my gripes with other clocks
  12. that I have seen, they don't show the date as well, which causes me to go to
  13. the command line to get to it, which hassles me rather a lot. Another reason
  14. that I like it is that I wrote it...
  15.  
  16. To all RISC-OS 2 users: Sorry I haven't provided RISC-OS 2 templates, but it
  17. is against my morals to include backwards compatibility. UPGRADE!. It really
  18. is worth it.
  19.  
  20. To all RISC-OS 3+ users: If you want to put this in your !Boot sequence (that
  21. should be all of you) you will have to Filer_Boot this first, and then 
  22. Filer_Run it, as the program detection routine needs to be started. The
  23. program WILL NOT WORK without this. Eventually I will sort out the desktop
  24. saving routines.
  25.  
  26.  
  27. = Instructions ==============================================================
  28.  
  29. Double click on the !Floating icon, This will cause a digital clock to appear 
  30. in the top right corner of the desktop. If you put a window over it, you will 
  31. find that it comes up over it again every second. Also, if you click with 
  32. Select the date will appear beside it for about 5 seconds. If you click menu
  33. over the icon, you will be presented with the following :
  34. _________________
  35. |     Clock     |
  36. |———————————————|
  37. | Info         ⇨| - This brings up the info window if you move to the left.
  38. | Choices...    | - This brings up the options window
  39. |---------------|
  40. | Quit          | - This terminates the program
  41. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  42.  
  43.  
  44. = The options window ========================================================
  45.  
  46. - Bring to top... -----------------------------------------------------------
  47.  
  48. Now, in the options window there are a set of options. The first one controls
  49. the rate at which the clock is brought to the top of the window pile. These
  50. are every minute, every second, and never (i.e. option turned off)
  51.  
  52. - When clicked on by Select... ----------------------------------------------
  53.  
  54. The next option controls how the clock reacts when clicked on with select. If
  55. “Move” is selected, the clock can be moved around. If “Bring up date for”
  56. is selected, then the full date is brought up for the time period displayed
  57. in the icon next door to it. You can change the time period by using the 
  58. arrow icons to the left and right of the icon.
  59.  
  60. - When clicked on by Adjust... ----------------------------------------------
  61.  
  62. The next option controls how the clock reacts when clicked on with adjust. If
  63. “Bring up date for” is selected, then the full date is brought up for the
  64. time period displayed in the icon next door to it. You can change the time
  65. period by using the arrow icons to the left and right of the icon. If “Open
  66. options window” is selected, the options window will be opened.
  67.  
  68. - Clock display... ----------------------------------------------------------
  69.  
  70. The next options control the clock display itself. If seconds are chosen,
  71. then the clock displays seconds, if minutes are chosen, then the clock does
  72. not display seconds.
  73.  
  74. - Clock position... ---------------------------------------------------------
  75.  
  76. The next option controls the position of the clock window. Click on “Top 
  77. right corner” if you want it in the top right corner of your screen (my 
  78. favourite). Click on “Left, above icon bar” if you want it on the left hand 
  79. side of your screen, above the icon bar. Click on “Position”, and then fill
  80. in the x and y positions that you want. Eventually I will get round to
  81. changing this code.
  82.  
  83. If you want to drag the clock, you will have to turn off ‘Bring to top’, drag
  84. the clock window, then bring up the Options window again (even if it is
  85. already open), and then click on the Position icon. I am aware of the fact
  86. that this is a bit of a roundabout way of doing this, but I can’t be bothered
  87. to change it at the moment. If you want it changed, please tell me, and I
  88. will put it higher on my list of things to do.
  89.  
  90. I don’t use this facility much, it is just there for completeness, and it
  91. doesn't react to mode changes, like the other two options do.
  92.  
  93. Notes : The way I work out “Top right” uses a call from the WimpExt module.
  94.         Unfortunately, this does not seem to work all the time, so if it
  95.         doesn’t work, use the “Position” option to place it.
  96.         
  97. - Date position... ----------------------------------------------------------
  98.  
  99. This allows you to edit the position of the date window, and is again here
  100. only for completeness. If you want to change the position of the date window,
  101. the Clock position has to be set to ‘Position’. Again, you can change the
  102. position by editing the numbers in the icons, or by dragging the date window
  103. around. There are the same problems with the latter as there are with 
  104. dragging the clock around.
  105.  
  106. - Window border colour... ---------------------------------------------------
  107.  
  108. This changes the border colour of the window. “Black” makes it black, “Clear”
  109. makes the border disappear (again, my favourite).
  110.  
  111. - OK icon -------------------------------------------------------------------
  112.  
  113. If you click on “OK”, the options will be set for this session.
  114.  
  115. - Cancel --------------------------------------------------------------------
  116.  
  117. If you click on “Cancel”, the options will be reset to the values that you 
  118. last saved.
  119.  
  120. - Save ----------------------------------------------------------------------
  121.  
  122. If you click on “Save”, the options will be saved, along with the window
  123. positions (of the clock and date window).
  124.  
  125. - Reset ---------------------------------------------------------------------
  126.  
  127. If you click on “Reset”, the options will be reset to the “factory set 
  128. values”.
  129.  
  130. - Notes ---------------------------------------------------------------------
  131.  
  132. If you use adjust on the above four buttons, the window will stay open after
  133. the changes have been made - this is Style Guide compliant.
  134.  
  135. If you receive the program with a corrupted or no configuration file, the
  136. program MakeFile in the application directory will create it for you.
  137.  
  138.  
  139. = The full date window ======================================================
  140.  
  141. That is all for the options window. Now the full date window. While this is
  142. on screen, it can be moved around to the position you like best.
  143.  
  144.  
  145. = Copyright Bit =============================================================
  146.  
  147. You may not change this application, or use *ANY* part of it in other
  148. products without my approval. (Excepting the Wimp Extension Module - write to
  149. Doggysoft for more information). You may spread it freely with all the files 
  150. present and unaltered (with the exception of the Configurat file). This program
  151. is supplied “as is”. In no circumstances shall the author, or any provider or
  152. distributor of this program, be liable for any damage, loss of profits, or any
  153. indirect or consequential loss arising out of the use of this program.
  154.  
  155.  
  156. = Thanks ====================================================================
  157.  
  158. Thanks go to :
  159.               
  160.              Jon Ribbens and Doggysoft for the Wimp Extension module.
  161.               
  162.              Robert Rankin, Iain Banks, William Gibson, Irvine Welsh, Michael
  163.              Marshall-Smith for their excellent fiction.
  164.  
  165.              Dominic Symes for the superlative !Zap editor.
  166.  
  167.  
  168. = History and Things To Do ==================================================
  169.  
  170. -----------------------------------------------------------------------------
  171.  Version  | Comments
  172. ----------|------------------------------------------------------------------
  173.  1.00     | A Clock. No date. No options. Update is very complex. Really does
  174.           | need tidying up a tad.
  175. ----------|------------------------------------------------------------------
  176.  1.01     | Completely rewrote WIMP code with the aid of Wimp Extension. Fun
  177.           | with clock update - added date and options to change time that it
  178.           | comes up to the top of the window stack, time that date is open. 
  179. ----------|------------------------------------------------------------------
  180.  2.00     | Some time later... Arrgh, can’t understand clock redraw code.
  181.        | Lets start again. Add difference in Adjust code.
  182. ----------|------------------------------------------------------------------
  183.  2.01     | Hey cool, I think that I can save the window positions, and
  184.         | change the clock border colours to clear, making it look well
  185.         | nice on a window background.
  186. ----------|------------------------------------------------------------------
  187.  2.02     | I know, lets rewrite my options code. It REALLY needs it. Also,
  188.        | redesigned templates a bit including my new TB software 1995 logo
  189.        | which is rather snazzy, even if I say so myself...
  190. ----------|------------------------------------------------------------------
  191.  2.03     | Finished...(I wish...)
  192. ----------|------------------------------------------------------------------
  193.  2.04     | I find more erm, bugs. But all easy to correct, and should work
  194.           | proper now.
  195. ----------|------------------------------------------------------------------
  196.  2.05     | It works on a RISC-PC! (And look damn nice too with the textured
  197.        | backdrop). Changed the templates a little to make it look ever so
  198.        | slightly better.
  199. ----------|------------------------------------------------------------------
  200.  2.06     | Got a virtual desktop program, and discovered that the clock
  201.  14.02.96 | stays on the original screen. The code has now been changed, (and
  202.  (just)   | has become more structured...) to now update the position of the
  203.           | clock and date window on the next of each of their updates.
  204.           | 
  205.           | Found out that if the options were fiddled with too much, an error
  206.           | was produced. So increased memory requirements to 36k :-(. I will
  207.           | try to reduce memory usage in the next release.
  208.           | 
  209.           | It is now 1996 - have redesigned logo to TB Software 1996.
  210. ----------|------------------------------------------------------------------
  211.  2.07     | Found a lot of redundancy in code, rearranged it a bit, and it is
  212.  15.02.96 | now much more structured than it was before.
  213.           |
  214.           | Added ‘Date position...’ in choices window, and implemented code
  215.           | to use it.
  216.           |
  217.           | There was a problem with the Virtual Desktop positioning code,
  218.           | which caused the date window not to be positioned properly. This
  219.           | is now fixed.
  220. -----------------------------------------------------------------------------
  221.  
  222. Right. I want to add : An Alarm facility.
  223.                             A Stop Watch / Timer
  224.                             A free memory viewer
  225.  
  226. Also make it compliant with the “Desktop Saving” routine.
  227.  
  228. If you want any other features added, then write to me, and I will see what I
  229. can do!
  230.  
  231. I am finally about to learn C. So the next release should be in C. Maybe.
  232.  
  233. = Contact Details ===========================================================
  234.  
  235. WWW    : http://www.soton.ac.uk/~tob195/
  236. e-mail : tob195@ecs.soton.ac.uk
  237.  
  238. Toby Bryans.
  239.  
  240. = Final Word ================================================================
  241.  
  242. Turnip.
  243.  
  244. = End of file ================================================================