home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / MM1 / GRAPHICS / kwsaver25.lzh / ver25.notes < prev   
Text File  |  1995-03-17  |  5KB  |  99 lines
  1. KWSaver Version 2.5 Update Notes
  2. ================================
  3.  
  4.     This file will list the new features of version 2.5 of KWSaver.  Be sure 
  5. to read the KWSaver.readme file for full documentation on all the original 
  6. features of KWSaver.
  7.  
  8.  
  9. Sleep/Never-Sleep Zone
  10. ======================
  11.  
  12.     A new feature starting with Version 2.0, this lets you designate the 
  13. upper-left corner of your screen as a special "zone" that, when the mouse is 
  14. resting in that zone, it will either immediately trigger a screen-saver or 
  15. never trigger a screen-saver.  If the zone is defined as a "Sleep Zone", 
  16. placing the mouse pointer in the very upper-left corner of the screen will 
  17. trigger the screen-saver right away.  If the zone is defined as a "Never-Sleep 
  18. Zone", placing the mouse pointer in the zone will cause the screen-saver to 
  19. never be run (while the mouse pointer remains within the zone).  Two beeps 
  20. will signal when the mouse enters a Never-Sleep zone.
  21.  
  22.     These zones are defined in the "kwsaver.list" file (see Technical Notes 
  23. section below).  Also, by using the '-i' command-line option, you can cause 
  24. KWSaver to ignore any sleep zone defined within the kwsaver.list file.
  25.  
  26.  
  27. Better Screen-Savers
  28. ====================
  29.  
  30.     Starging with Version 2.0, KWSaver actually saves the current contents of 
  31. the screen into a memory data module before calling a screen-saver program.  
  32. This allows screen-saver programs to redraw the screen and manipulate the 
  33. data, allowing for some rather fun possibilities.  See the included 
  34. kwsaver_rain screen-saver program for an example of this type of saver.  Also, 
  35. please see the kwsaver.programmers.notes (updated for Version 2.5) if you wish 
  36. to learn how to write screen-savers that use this stored information.
  37.  
  38.     The creation of the memory data module requires some memory, however.  
  39. A typical-size screen (80x26) takes up about 65k of memory.  While this 
  40. generally is not significant on today's large-memory systems, you may wish to 
  41. prevent this module from being created if you are not going to be using any 
  42. screen-savers that make use of this new feature.  You may do this by using the 
  43. command-line option '-m'.
  44.  
  45.  
  46. KWSE Editor Program
  47. ===================
  48.  
  49.     A graphical "kwsaver.list" editor has been included for those who like to 
  50. edit their list of screen-savers in a simple yet flashy manner.  Full 
  51. instructions on how to use KWSE can be found in the included "kwse.readme" 
  52. file.
  53.  
  54.  
  55. Technical Notes
  56. ===============
  57.  
  58.     Starting with Version 2.5, KWSaver now has the ability to poll the entire 
  59. keyboard (rather than only special keys).  This means KWSaver is better able 
  60. to track user activity when deciding when to launch a screen saver.
  61.  
  62.     There had to be some more stringent standards for the lines in the 
  63. kwsaver.list file to accomodate some of the new features.  Comment lines still 
  64. begin with a '#' sign, however if you want to de-select a screen-saver, don't 
  65. use the '#' to comment it out... Instead, place an '!' at the beginning of the 
  66. line.  This convention is used by the KWSE program to distinguish between an 
  67. actual comment-line and a de-selected screen-saver program.
  68.  
  69.     Sleep zones and Never-Sleep zones are defined by placing a '+' or '-' 
  70. symbol, respectively, at the beginning of their own line anywhere within the 
  71. file.  Any text following the + or - on the line is considered a comment.  
  72. Omitting a +/- from the kwsaver.list file means there is no sleep zone 
  73. defined.  You should not have both a + and a - in the kwsaver.list file at the 
  74. same time, as unpredictable zone definitions will occur.
  75.  
  76.     Absolute path-names for screen-saver programs are allowed at last!  So, if 
  77. you like storing your screen-savers in another directory besides /dd/CMDS, and 
  78. you run KWSaver in your 'startup' file without defining an alternate 
  79. environment PATH, you can simply list the full path-name in the kwsaver.list 
  80. file.  So, instead of "kwsaver_rain", you may use "/dd/cmds/usr/kwsaver_rain".
  81.  
  82.     Just like before, you can edit the "kwsaver.list" file (using an ordinary 
  83. text editor, or by using the new KWSE utility program, included within this 
  84. archive) even while KWSaver is running in the background, and you do not have 
  85. to restart KWSaver for the changes to take effect.  The exception to this 
  86. rule is Sleep/Never-Sleep Zones.  If you change the zone in the file, you 
  87. must restart KWSaver for the change to take effect.
  88.  
  89.     The name of the memory data module created by Version 2.5 of KWSaver is 
  90. "kwsaver_data".  If you notice the data module does not go away after a 
  91. screen-saver program is finished, it is the fault of the screen-saver.  
  92. Screen-saver programs that use the memory data module must be sure to UNLINK 
  93. from the memory data module before exiting, or the module will persist.
  94.  
  95.  
  96. This archive is freely distributable in its complete form.
  97. The entire contents of this archive is (c) 1994, 1995 by Joel Mathew Hegberg.
  98.  
  99.