home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / MM1 / GRAPHICS / kwsaver20.lzh / kwsaver.readme < prev    next >
Text File  |  1994-06-21  |  8KB  |  161 lines
  1.  
  2. * Marked for release 05/06/94 by JMH via Sub-Etha Software/Midwest Division *
  3.  
  4. KWSaver Version 1.0 for K-Windows
  5. (c) 1994 by Joel Mathew Hegberg
  6. =================================
  7.  
  8.     KWSaver is a screen-saver management program for K-Windows.  Because it is 
  9. merely the manager program, you may choose which screen-savers you want on 
  10. your system, and even write your own.  KWSaver looks in the file 
  11. /dd/SYS/kwsaver.list to find a list of the screen-saver programs available on 
  12. the system, and randomly selects a saver from the list.  (NOTE: See 'The 
  13. kwsaver.list File' section below.)
  14.  
  15.     KWSaver monitors your mouse & keyboard (*) activity.  If you do not use 
  16. your mouse or keyboard for a certain amount of time (default setting is 10 
  17. minutes), KWSaver calls one of your screen-saver programs.  To exit a 
  18. screen-saver, simply move the mouse or hold down one of the detectable 
  19. keyboard keys.  (*NOTE: Currently, K-Windows only provides information 
  20. regarding the SHIFT, ALT, CTRL, CAPSLOCK, & SCROLL LOCK keys.  Because of 
  21. this, if you do not use any of these keys during normal operation, and you are 
  22. not using the mouse, KWSaver may run a screen-saver while you are typing.  
  23. This should be rare if the KWSaver delay is long enough, since most people 
  24. need to type characters that are SHIFTed, or for typing CTRL-A at a shell 
  25. prompt [to repeat the last command typed].)
  26.  
  27.     KWSaver is meant to be run in the background from your startup script 
  28. file.  To run KWSaver using its default time delay of 10 minutes, you can use:
  29. kwsaver&
  30. (Note that the '&' character runs KWSaver in the background.)
  31. To run KWSaver using a time delay of 30 minutes, you can use:
  32. kwsaver 30&
  33.  
  34.     The maximum time delay allowed is 60 minutes.
  35.  
  36.  
  37. KWSaver V1.0 Options:
  38. =====================
  39.  
  40.     Due to the way K-Windows currently works, a window must be allocated for 
  41. KWSaver to monitor mouse activity.  The window must provide unblocked access 
  42. for getstat calls (to read the mouse data).  By default, KWSaver will create a 
  43. tiny little window (with a graphic icon) atop the current window.  This will 
  44. provide an unimpeded path for mouse information to be received through.  If 
  45. you would prefer to have the icon not appear atop the current window, you may 
  46. use the '-n' option, and it will be created on a new screen.
  47.  
  48.     If you are not going to be using the screen, you may not want to create 
  49. another window.  By using the '-c' option, you use the 'current' window as 
  50. the mouse-polling window.  This window should never become read-blocked.  You 
  51. may not want to run KWSaver in the background front this window, but rather 
  52. run it in the foreground to ensure the window never becomes read-blocked.
  53.  
  54.     If you are using KWSaver with the MM_ONE startup graphic program, you may 
  55. use the '-s=<val>' option, which will place a the graphic icon in the current 
  56. window.  The icon's location on-screen is based on the <val> used.  (Note 
  57. that this <val> just like the <val> used in the 'install_spooler' program, 
  58. also used for the MM_ONE startup program.)  You may want to use the '-s' 
  59. option in combination with the '-c' option when running in the foreground 
  60. from the startup file after MM_ONE is run.
  61.  
  62.  
  63. The 'kwsaver.list' File:
  64. ========================
  65.  
  66.     This file must be stored in your /dd/SYS directory.  It may be renamed 
  67. '.kwsaver.list' if you want it to be invisible to avoid cluttering up your 
  68. SYS directory -- KWSaver is smart enough to find it.
  69.  
  70.     The file is merely a listing of all the screen-saver programs (one per 
  71. line) you have on your system.  Whenever you add another saver to your system, 
  72. make sure to place its name here (or else it will never get run).  
  73. Comment-lines start with the '#' character.  This also makes it convenient to 
  74. deselect one of your screen-savers in the list by simply placing a '#' before 
  75. it's name, so you don't have to erase it from the file.
  76.  
  77.  
  78. About the KWSaver Archive:
  79. ==========================
  80.  
  81.     There are a lot of files in this archive.  If you are only interested in 
  82. running KWSaver on your system, you only need to do the following:
  83.  
  84. 1) Move the 'kwsaver' program to your CMDS directory.
  85. 2) Move the 'kwsaver_lines', 'kwsaver_lines2', 'kwsaver_mm1s', and 
  86. 'kwsaver_mm1b' files to your CMDS directory.
  87. 3) Move the 'kwsaver.list' file to your SYS directory.
  88. 4) Edit your 'startup' file to run KWSaver when you power-up your system.
  89.  
  90.     The rest of the files are provided for people who may be interested in 
  91. writing their own screen savers for KWSaver.  Here's what they are for:
  92.  
  93. kwsaver.programmers.notes - Notes (rules) on how to write screen-savers.
  94. kwsaver_lines.c           - A sample type-1 screen-saver program.
  95. kwsaver_mm1s.c            - A sample type-2 screen-saver program.
  96. kwsaver_mm1s.h            - A header file needed to compile kwsaver_mm1s.c.
  97.  
  98.  
  99. Technical Notes:
  100. ================
  101.  
  102.     When the screen-saver is run, the window it runs in is placed atop the 
  103. current screen.  However, it's window is not the currently 'selected' 
  104. window... this is why you return to the screen you were working on when the 
  105. screen-saver deactivates.  However, what would happen if you used the F9/F10 
  106. keys (which are undetectable to KWSaver) to switch screens while the 
  107. screen-saver is running?  This generally is not a problem... when the 
  108. screen-saver is deactivated, then its window disappears (where ever it may 
  109. be) -- big deal.  BUT, if you happen to have selected (switched to) the 
  110. actual screen-saver screen itself and deactivate the screen-saver, an evil 
  111. K-Windows bug would normally occur!  The problem is, it's the selected window, 
  112. and now it's dying.  Because of this, K-Windows dies, and with it, essentially 
  113. your entire system, requiring you to reboot.  To prevent this from happening 
  114. to nice people like yourself, KWSaver will check to see if you've selected the 
  115. saver's screen (using pt_valid info from mouse data) before killing the 
  116. window.  If the window has been selected, a message is displayed requesting 
  117. the user switch to another screen.  KWSaver then waits for the user to change 
  118. screens, and then waits another full second.  After this, KWSaver checks all 
  119. over again, and once it's safe, the saver's window is killed.
  120.  
  121.     When KWSaver activates, it actually opens a very small window in the 
  122. upper-left corner of the current screen (by using window type 'FF') and then 
  123. polls the screen for information such as screen size.  The small window is 
  124. then closed and a new window, the exact size of the current screen, is opened 
  125. atop the current screen (again, but using window type 'FF').  This window has 
  126. certain guaranteed properties, listed below.  This is the window the 
  127. screen-saver program is run in, and is defined to be the screen-saver's 
  128. standard in, out, and error paths.  The screen-saver is guaranteed to run for 
  129. at least 2 seconds (for initialization, if needed) before KWSaver will 
  130. interrupt it due to user interaction.  When the user begins interacting with 
  131. the computer, KWSaver will send a signal (of value 4444 decimal) to the 
  132. screen-saver program.  KWSaver waits for the screen-saver program to die, and 
  133. then deallocates the saver window.
  134.  
  135.     The saver window is guaranteed to have these properties before the 
  136. screen-saver program is run:
  137. 1) Graphics scaling is ON.  [ScaleSw(PATH,1);]
  138. 2) Foreground color is MAX. (15 for 16-color screens, 255 for 256-color)
  139. 3) Background color is 0.
  140. 4) Cursor is OFF. **
  141. 5) Scaling is based off of 640x208 screen coordinates.
  142. 6) Logic is OFF.            [LSet(PATH,0);]
  143. 7) No pattern is selected.  [PSet(PATH,0,0);]
  144. 8) ^C and ^E from keyboard are disabled.
  145.  
  146. ** Even though the cursor is turned off in the saver's window, a cursor may 
  147. be visible.  This is the cursor of the window beneath the screen-saver's 
  148. window, which is the selected window.  Just ignore it.
  149.  
  150. KWSaver has been written and tested very carefully.  However, use of this 
  151. program (and its related files) are at your own risk.  The author is not 
  152. liable in any way.
  153.  
  154. KWSaver may not be sold.
  155.  
  156. KWSaver is copyright 1994 by Joel Mathew Hegberg.
  157.  
  158.  
  159. This program and its archive are freely distributable.
  160.  
  161.