home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / screensav / a171_1 / !Lunch / !Help next >
Text File  |  1992-12-22  |  8KB  |  201 lines
  1.  
  2.  
  3.                             ============
  4.                             Out to Lunch
  5.                             ============   
  6.                             Version 0.34
  7.  
  8.                         © Peter Gaunt, 1992
  9.  
  10.                      ----------------------------
  11.     This application is in the Public Domain and may be freely
  12.     distributed provided
  13.  
  14.       a) no charge is made other than to cover the cost of the medium
  15.       b) all files, including this !Help file, are included
  16.  
  17.     If you run a Public Domain software library please obtain my permission
  18.     before including this program in your lists or distributing it.
  19.  
  20.                 Copyright remains with me at all times.
  21.  
  22.  
  23. ----------------------------------------------------------------------------
  24. *** New to version 0.34 of Out to Lunch
  25.  
  26.     Now includes an option to monitor the serial port.
  27. ----------------------------------------------------------------------------
  28. *** New to version 0.33 of Out to Lunch
  29.     
  30.     Will now include itself in RISC OS 3's desktop boot files. Otherwise the
  31.     main code is identical to version 0.32
  32.  
  33.     Configuration has been speeded up.
  34.  
  35.     Includes a new display module "Sea Life" (this uses rather a lot of
  36.     RAM if it is configured).
  37. ----------------------------------------------------------------------------
  38. *** New to version 0.32 of Out to Lunch ***
  39.  
  40.     Configurable displays
  41.     Configurable "sleep" and "no sleep" corners
  42. ----------------------------------------------------------------------------
  43.  
  44.  
  45. ----------------------------------------------------------------------------
  46. *** Before Out to Lunch will run on RISC OS 2 the computer must have seen
  47.     the !System application which must contain the 'Colours' module in
  48.     its 'Modules' directory. On RISC OS 3 'Colours' is built into the ROM.
  49. ----------------------------------------------------------------------------
  50. *** If you are replacing an earlier version of Out to Lunch please delete the
  51.     old version first. Some of the files within Out to Lunch have changed
  52.     their names. Simply copying this new version on top of the old one will
  53.     leave you with redundant files on the disc.
  54. ----------------------------------------------------------------------------
  55. *** The sprites for the 'Sea Life' display are versions of those in After
  56.     Dark on the Mac. They were originally converted for the Arc by Richard
  57.     Spooner.
  58. *** The 'Pong' and 'Space Trip' displays were written by Chris Ross
  59. ----------------------------------------------------------------------------
  60.  
  61. This application provides a 'screen blanking' program to help prevent
  62. 'screen burn in' when your monitor is left on for long periods of time
  63. with an unchanging display.
  64.  
  65. Other desktop programs will continue to run while Out to Lunch is blanking
  66. the screen. Thus printing and file transfer via the serial port (for
  67. example) will continue to work.
  68.  
  69. Out to Lunch only works while you are using the desktop. If you run a
  70. non-multitasking application it will cease to function until you return
  71. to the desktop.
  72.  
  73. The program runs as a module task and normally uses around 5k of memory. The
  74. amount used depends on the configured display; some may use a lot more than
  75. 5k.
  76.  
  77. Because Out to Lunch is a module it will survive an exit and return to the
  78. desktop (via CTRL-SHIFT-f12 or 'Exit' from the Task Manager). It will also,
  79. in most circumstances survive a soft reset.
  80.  
  81. After a pre-set time in which Out to Lunch detects no key presses or mouse
  82. movements (and serial port activity if this option is set) it will blank out
  83. the screen, replacing it with a simple animation (which lets you know that
  84. your monitor is actually on!). If you press any key or move the mouse the
  85. desktop will reappear. The desktop will also reappear if another program
  86. opens a window on the top of the window 'stack'.
  87.  
  88. The screen can also be blanked at any time by moving the pointer to the
  89. "sleep corner". After a few seconds delay Out to Lunch will blank the
  90. screen.
  91.  
  92. If the pointer is moved to the "no sleep corner" of the screen then Out to
  93. Lunch will not blank the screen after the period of inactivity.
  94.  
  95. The sleep and no-sleep corners are configurable and may be turned off
  96. altogether if required.
  97.  
  98. The speed at which the animation runs will depend on how often other
  99. applications are polling the wimp. It will probably run very slowly, if
  100. at all, whilst printing from applications such as Impression.
  101.  
  102.  
  103. Configuring Out to Lunch
  104. ========================
  105.  
  106. Running the Configure program
  107. -----------------------------
  108. Hold down one of the ALT keys when you double click !Lunch. Instead of
  109. running Out to Lunch the configuration program will run and open its window.
  110.  
  111. If the window does not appear try again but this time hold down the ALT key
  112. for a couple of seconds after double clicking !Lunch
  113.  
  114. Choosing the display
  115. --------------------
  116. The current display is shown in an icon at the top of the window. Click menu
  117. over this, or click Select on the arrow next to it, to show the list of
  118. displays available. Select the display you wish to use.
  119.  
  120. Setting the 'Sleep' and 'No sleep' corners
  121. ------------------------------------------
  122. To set the 'sleep' corner click Select in a corner of the rectangle labelled
  123. 'sleep corner'. The corner will light up in red. The previously selected
  124. corner will be dimmed.
  125.  
  126. To set Out to Lunch so that there isn't a sleep corner click Adjust on the
  127. currently selected sleep corner.
  128.  
  129. Setting the 'no sleep' corner is done in the same way as setting the 'sleep'
  130. corner but using the rectangle labelled 'no sleep corner'.
  131.  
  132. It is not possible to have the same corner selected for both 'sleep' and 'no
  133. sleep'.
  134.  
  135. Setting the inactivity delay
  136. ----------------------------
  137. The inactivity delay is the time, in minutes, after which Out to Lunch will
  138. blank the screen. For example, if the time is set to 5 minutes then if you
  139. don't move the mouse or touch a key for 5 minutes the screen will be
  140. blanked.
  141.  
  142. To set the delay click Select on the up and down arrows next to the delay
  143. icon. Clicking with Adjust reverses the actions of the arrows.
  144.  
  145. Holding down a Shift key while clicking the arrows changes the time in steps
  146. of 10 minutes.
  147.  
  148. The delay can be set to any value between 1 and 999 minutes.
  149.  
  150. The time which you set is approximate. The exact time after which Out to
  151. Lunch will blank the screen depends on other applications polling the
  152. wimp frequently.
  153.  
  154. Monitor serial port
  155. -------------------
  156. Select this icon if you want serial port activity to stop Out to Lunch
  157. from blanking the screen.
  158.  
  159. Saving the configuration
  160. ------------------------
  161. Click OK to save the configuration. The configuration window will close and
  162. Out to Lunch will be run.
  163.  
  164. Abandoning changes
  165. ------------------
  166. To abandon any changes you have made since running the configuration program
  167. click on the window's Close icon. Out to Lunch will then be run with its
  168. previous configuration.
  169.  
  170.  
  171. Quitting Out to Lunch
  172. =====================
  173. To close down the program open the Task display from the Task Manager's icon
  174. on the icon bar. You will find Out to Lunch listed under the Module tasks.
  175. Click 'Menu' over its name and choose 'Quit' from the resulting menu. This
  176. closes down Out to Lunch as a task (and releases its workspace).
  177.  
  178. This does not remove the module. Exiting from the desktop and then returning
  179. will restart the program. To kill the program entirely, close it down and
  180. then type "*RMKILL OutToLunch" via f12.
  181.  
  182.  
  183.  
  184.  
  185.  
  186. Further displays may become available in future. It is possible to write
  187. your own. If you want to do this please contact me for details of the
  188. format. You need to have a knowledge of ARM assembly language in order to
  189. write displays though you do not need to know how to program the WIMP.
  190.  
  191.  
  192.  
  193.  
  194. If you experience any problems with this application please feel free
  195. to contact me via email
  196.  
  197.                Prestel (014511332) Note - this is NOT my phone number!
  198.                Telecom Gold (84:MAG10849)
  199.                Arcade BBS (Tel. 081 654 2212, user #617)
  200.  
  201.