home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / MM1 / GRAPHICS / kwsaver20.lzh / ver2.notes < prev   
Text File  |  1994-06-21  |  5KB  |  95 lines
  1. KWSaver Version 2.0 Update Notes
  2. ================================
  3.  
  4.     This file will list the new features of version 2.0 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 to Version 2.0, this lets you designate the upper-left 
  13. corner of your screen as a special "zone" that, when the mouse is resting in 
  14. that zone, it will either immediately trigger a screen-saver or never trigger 
  15. a screen-saver.  If the zone is defined as a "Sleep Zone", placing the mouse 
  16. pointer in the very upper-left corner of the screen will trigger the 
  17. screen-saver right away.  If the zone is defined as a "Never-Sleep Zone", 
  18. placing the mouse pointer in the zone will cause the screen-saver to never be 
  19. run (while the mouse pointer remains within the zone).  Two beeps will signal 
  20. 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.     Version 2.0 of KWSaver actually saves the current contents of the screen 
  31. into a memory data module before calling a screen-saver program.  This allows 
  32. screen-saver programs to redraw the screen and manipulate the data, allowing 
  33. for some rather fun possibilities.  See the included kwsaver_rain screen-saver 
  34. program for an example of this type of saver.  Also, please see the 
  35. kwsaver.programmers.notes (updated for Version 2.0) if you wish to learn how 
  36. 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.     There had to be some more stringent standards for the lines in the 
  59. kwsaver.list file to accomodate some of the new features.  Comment lines still 
  60. begin with a '#' sign, however if you want to de-select a screen-saver, don't 
  61. use the '#' to comment it out... Instead, place an '!' at the beginning of the 
  62. line.  This convention is used by the KWSE program to distinguish between an 
  63. actual comment-line and a de-selected screen-saver program.
  64.  
  65.     Sleep zones and Never-Sleep zones are defined by placing a '+' or '-' 
  66. symbol, respectively, at the beginning of their own line anywhere within the 
  67. file.  Any text following the + or - on the line is considered a comment.  
  68. Omitting a +/- from the kwsaver.list file means there is no sleep zone 
  69. defined.  You should not have both a + and a - in the kwsaver.list file at the 
  70. same time, as unpredictable zone definitions will occur.
  71.  
  72.     Absolute path-names for screen-saver programs are allowed at last!  So, if 
  73. you like storing your screen-savers in another directory besides /dd/CMDS, and 
  74. you run KWSaver in your 'startup' file without defining an alternate 
  75. environment PATH, you can simply list the full path-name in the kwsaver.list 
  76. file.  So, instead of "kwsaver_rain", you may use "/dd/cmds/usr/kwsaver_rain".
  77.  
  78.     Just like before, you can edit the "kwsaver.list" file (using an ordinary 
  79. text editor, or by using the new KWSE utility program, included within this 
  80. archive) even while KWSaver is running in the background, and you do not have 
  81. to restart KWSaver for the changes to take effect.  The exception to this 
  82. rule is Sleep/Never-Sleep Zones.  If you change the zone in the file, you 
  83. must restart KWSaver for the change to take effect.
  84.  
  85.     The name of the memory data module created by Version 2.0 of KWSaver is 
  86. "kwsaver_data".  If you notice the data module does not go away after a 
  87. screen-saver program is finished, it is the fault of the screen-saver.  
  88. Screen-saver programs that use the memory data module must be sure to UNLINK 
  89. from the memory data module before exiting, or the module will persist.
  90.  
  91.  
  92. This archive is freely distributable in its complete form.
  93. The entire contents of this archive is (c) 1994 by Joel Mathew Hegberg.
  94.  
  95.