home *** CD-ROM | disk | FTP | other *** search
/ No Fragments Archive 10: Diskmags / nf_archive_10.iso / MAGS / INFO / IINFO51.MSA / PROGRAMS_IDLE.TXT < prev    next >
Text File  |  1991-03-14  |  9KB  |  189 lines
  1.       Idle Version 2.2 - The GEM-based Screen Saver / Corner Clock
  2.       ============================================================
  3.  
  4. Simply put IDLE.ACC on the root directory of your boot disk, and
  5. you'll have a desk accessory called "Idle", which will turn your
  6. screen black and make a little Atari logo slide around the screen (to
  7. remind you that the machine is in fact switched on).  Hitting any key
  8. or moving the mouse will restore the screen.
  9.  
  10. Unlike most other screen savers, this one will run on any ST with any
  11. type of monitor; even a Moniterm, an Image Systems board, or an ST
  12. that's had the "overscan" modification.
  13.  
  14. Idle can also be run as a program simply by renaming/copying the file
  15. to IDLE.PRG, but this does NOT mean you can put Idle in your \AUTO
  16. folder.  Using it as a program simply means that you can run it
  17. whenever you want to have your screen blanked and the accessory
  18. version isn't installed, for example, when you are about to head out
  19. for lunch.  Idle relies on GEM for its graphics and background
  20. activity monitoring, which is why it only takes up about 24K - even
  21. with animation & large-screen support, but this also means that Idle
  22. will be ineffective while a non-GEM program is running.
  23.  
  24. NOTE:  Idle will usually cause a crash during a change of resolution.
  25. This is due to the fact that Idle has to install itself in a couple of
  26. system vectors in order to monitor printer and GEM text output.  The
  27. problem is that there's no way for Idle to see a res. change coming
  28. and remove itself from these vectors (and even if it could, there's no
  29. 100% reliable way for it to completely remove itself).  The best way
  30. to avoid this problem is to buy MultiDesk from CodeHead software and
  31. use it to load Idle.  You can then simply instruct MultiDesk to clear
  32. out all of its accessories before a res. change and everything should
  33. be fine.  Make sure to enable the MultiDesk "timers" option if you're
  34. using Idle with MultiDesk, or Idle won't work at all.
  35.  
  36. As an aside, it's lots of fun to configure Idle to ignore GEM text
  37. and allow screen updates, then load 4 or 5 of them and watch them all
  38. kick-in at the same time.  MultiDesk makes this easy since you don't
  39. have to reboot to load new accessories, although you can do it the
  40. "normal" way too if you like.
  41.  
  42.  
  43. The Corner Clock
  44. ----------------
  45.  
  46. Idle has a simple corner clock / caps lock indicator that it displays
  47. in the upper right corner of the screen.  The caps lock indicator
  48. shows as an underscore when caps lock is not active, and an up-arrow
  49. when caps lock is active.  You can change the format of the date /
  50. time display by clicking the RIGHT mouse button near the caps lock
  51. indicator.  There are a total of 6 formats that Idle will cycle
  52. through:
  53.  
  54.                    15:10 _        { 24 hour time format      }
  55.       May 24, 1990 15:10 _        { date + 24 hour time      }
  56.                 03:10 PM _        { AM/PM time format        }
  57.    May 24, 1990 03:10 PM _        { date + AM/PM time        }
  58.                          _        { caps lock indicator only }
  59.                                   { nothing at all           }
  60.  
  61. The date / time format is saved with the rest of the configuration
  62. when the "Save" button is selected (see the next section).
  63.  
  64.  
  65. Configuring Idle
  66. ----------------
  67.  
  68. Once Idle has been installed as an accessory, you can configure
  69. several of its options simply by holding down one of the shift keys
  70. while selecting Idle from the "Desk" menu.  Idle will present you with
  71. a dialog which allows you to set some options and/or save the
  72. configuration.
  73.  
  74. If you select the "Save" button, Idle will attempt to save the current
  75. configuration to IDLE.ACC or IDLE.PRG (depending on how you ran Idle)
  76. in the current directory.  If it doesn't find itself in the current
  77. directory it will present you with a file selector and ask you to
  78. locate the appropriate IDLE.ACC/PRG file.
  79.  
  80. The options you're allowed to change are:
  81.  
  82.   -  The events to monitor for activity in order to determine that
  83.      the system is idle.  The keyboard is always monitored, but there
  84.      are 4 other items you can individually select.  Enabling an
  85.      option will prevent Idle from blanking the screen when activity
  86.      is present, and it will cause Idle to restore the screen if
  87.      activity occurs while it is blanked.
  88.  
  89.      o  The mouse - this will watch for mouse movement.  Mouse button
  90.         clicks are not monitored, but it's pretty hard to click
  91.         without moving the mouse at all.  Unlike the other options,
  92.         any mouse movement once the screen is blank will restore it -
  93.         even if this option is disabled.
  94.  
  95.      o  The modem (RS232) port - this will watch for RS232 port
  96.         activity.
  97.  
  98.      o  Printer output - this will watch for output to the printer.
  99.         Note that this watches the documented system call for printer
  100.         output, so the output of programs which bypass the system call
  101.         and go directly to the hardware will not be noticed by Idle.
  102.  
  103.      o  GEM text - this will watch for GEM text output calls.  This
  104.         will catch the output of most GEM programs as well as things
  105.         like dialog and alert box output.  For you programmers out
  106.         there, the v_gtext() and v_justified() VDI calls are watched.
  107.  
  108.   -  What Idle will do once the screen has been blanked.
  109.  
  110.      o  Whether or not to allow other applications to write to the screen 
  111.         while it is blank.  Normally, Idle will prevent other GEM 
  112.         applications from writing to the screen while it is blank [by 
  113.         making a wind_update() call].  In 99.9% of the cases Idle would 
  114.         automatically wake up before a program needed to output to the 
  115.         screen anyway, usually due to activity on the modem or printer 
  116.         port assuming you have Idle configured in such a manner.
  117.  
  118.         If you enable this option, output from other programs will be
  119.         allowed to "bleed through" the blackened screen while Idle is doing
  120.         its thing.  There aren't too many programs that would even bother
  121.         to output to the screen without direct user input, but for ones
  122.         that do (ex. the STalker terminal accessory) the results can be
  123.         rather amusing.  One additional word of caution:  Idle uses the 
  124.         GEM menu/alert buffer in order to save the contents of the menu 
  125.         bar just before it blanks the screen.  This is one of the reasons 
  126.         why Idle uses just under 24K of RAM, even on an Image Systems 
  127.         hi-res colour monitor where the menu bar consumes over 9K alone;
  128.         but the down side is that if an alert is drawn or a menu drops 
  129.         down while the screen is blank the menu bar won't restore properly.
  130.  
  131.         It is highly recommended that you leave this option off, but it's
  132.         there in case you need it.
  133.  
  134.      o  Whether the Atari Fuji symbol should rotate or sit still as
  135.         it glides across the screen.
  136.  
  137.      o  Whether the screen background should be plain black or a
  138.         bunch of twinkling stars.  If you hold down the Alternate key
  139.         while invoking Idle it will display the other background
  140.         without the need to bring up the configuration screen.
  141.  
  142.   -  When to blank the screen.
  143.  
  144.      o  After the specified number of minutes has passed with no
  145.         "activity" (based on what Idle has been told to watch).  A
  146.         value of 0 minutes means that Idle will never kick-in on its
  147.         own.
  148.  
  149.      o  When the mouse pointer enters a particular corner of the
  150.         screen.  This allows you to invoke Idle at any time simply by
  151.         moving the mouse pointer into (by default) the top right-hand
  152.         corner.
  153.  
  154.  
  155. Copyright etc.
  156. --------------
  157.  
  158. Idle is freeware, and may be distributed freely as long as this text
  159. file is included (unmodified).  Idle may not be part of a commercial
  160. product or package without the written consent of Eric Rosenquist.
  161.  
  162. If you have so much goodness in your heart that you would like to
  163. compensate me for my efforts, feel free to send a donation to the
  164. following address (please specify *why* if you do - unexplained
  165. cheques are very mysterious):
  166.  
  167.     Eric Rosenquist
  168.     Strata Software
  169.     94 Rowe Drive
  170.     Kanata Ontario Canada
  171.     K2L 3Y9
  172.     Phone/Fax: (613) 591-1922
  173.  
  174. Questions, comments, or suggestions may be directed to the above address, 
  175. or to:
  176.  
  177. GEnie:      E.ROSENQUIST
  178. Bix:        e_rosenquist
  179. CompuServe: 72711,2503
  180.  
  181.  
  182. Look for our STalker/STeno package at your local dealer, or call or
  183. write us for information.  STalker is a full featured communication
  184. program that runs as a desk accessory and does *everything* in the
  185. background, including uploading, downloading, and sequence dialing.
  186. STeno is a text editor accessory / program with word-wrap, search and
  187. replace, cut and paste, paragraph reformatting, and much more.  You
  188. get both for $30 US ($35 CAN - Ontario residents add 8% PST).
  189.