home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / screen / strbln.lha / STARBLANK.docs < prev    next >
Text File  |  1990-06-13  |  4KB  |  95 lines
  1. *************************************************************************
  2. *                         S T A R B L A N K  2.2                        *
  3. *                                                                       *
  4. *                            by Brian G. Neal                           *
  5. *                              June 13, 1990                            *
  6. *                                                                       *
  7. *     This program is hereby placed into the public domain.  Do with    *
  8. *  it as you will.  Legally, public domain means this program has no    *
  9. *  author, and therefore I cannot control how it is distributed.  But   *
  10. *  I appeal to the kindness of everyone to distribute StarBlank with    *
  11. *  it's icon and this file so interested persons may contact me.        *
  12. *  Thanks!                                                              *
  13. *     Credit must be given to Leo Schwab's "stars.c" program, from      *
  14. *  which my star routines are based on.  I found this gem on Fred Fish  *
  15. *  number 33.  Thanks Leo, for that one and all the rest!!!             *
  16. *     Any similiarity between this program and any other existing one   *
  17. *  is purely coincidental.                                              *
  18. *************************************************************************
  19.  
  20.  
  21. =================== StarBlank - What is it anyway?
  22.  
  23.    StarBlank is a monitor blanking program.  Once run, it waits for a
  24. period of user inactivity.  Once this time has occured, StarBlank kicks in
  25. and displays a moving star field.  This star field will be shown until
  26. StarBlank detects user activity, such as a key press, mouse move, or mouse
  27. click.  StarBlank will then restore the monitor to it's previous state, and
  28. go back to sleep.
  29.  
  30.  
  31. =================== StarBlank 2.2  What's new?
  32.  
  33.    StarBlank 2.0 had problems with the mouse pointer streaking.  This
  34. version attempts to correct this problem.  Please let me know if it still
  35. happens.  StarBlank 2.2 also opens an un-activated window, which will
  36. not redirect your input to other programs; version 2.0 didn't.  It was
  37. very annoying.
  38.  
  39.    This program differs from version 1.2 in that it doesn't open a
  40. window on the Workbench screen.  To quit StarBlank after it has been run,
  41. simply click on it's icon or type 'StarBlank' from the CLI.  StarBlank
  42. now looks for a previous incarnation of itself when first run, and if found
  43. will terminate it's elder and itself.  This version is in response to
  44. persons who don't like their Workbench screen cluttered up by all those
  45. little windows (you know who you are Eric Penn!).  If you would prefer
  46. a version with a small window & close gadget, contact me (see below).
  47.  
  48.  
  49. =================== Running from the CLI
  50.  
  51.    StarBlank may be run from the CLI by using the following syntax:
  52.  
  53.                    StarBlank  [timeout]
  54.  
  55.    where timeout is an optional argument.  StarBlank will wait for timeout
  56. seconds of inactivity before going to work.  If timeout is not specified
  57. the default timeout period of 60 seconds is assumed.
  58.    There is no need to RUN Starblank, StarBlank will launch itself as an
  59. independent process.  This is convenient for inclusion in a disk's
  60. startup-sequence.
  61.  
  62. =================== Running from the Workbench
  63.  
  64.    To run StarBlank from the Workbench, simply click on it's icon.  To
  65. override the default timeout period of 60 seconds, do the following:
  66.  
  67.    1) Click on StarBlank's icon __ONCE__
  68.    2) Select Info from the Workbench menu to display the Info requester.
  69.    3) There should be DELAY=60 appearing in the Tool Types gadget.  If not
  70.       click on the Add gadget, then type in DELAY=x, where x is your
  71.       preferred timeout period.  Else, replace the 60.
  72.    4) Click on Save!
  73.  
  74.    That's all there is to it!
  75.  
  76. =================== Just Who are You?
  77.  
  78.    Send comments, bug reports, questions to:
  79.  
  80.       US MAIL:    Brian Neal
  81.                   620 South Riverside Dr. Apt. 1
  82.                   Iowa City, IA  52246
  83.  
  84.       GEnie:      B.NEAL2
  85.  
  86.    If you would like the mostly C source code to StarBlank, send a blank,
  87. formatted disk and some money or stamps for postage to the above address.
  88.    The source code shows examples of writing your own input handler, using
  89. the timer and input devices, as well as getting arguments from the Workbench.
  90. Feel free to send me some of your own goodies, neat PD/Shareware finds,
  91. whatever.  Just no pirated stuff please!!!!
  92.    Hope you enjoy spacing out to this one!
  93.  
  94.       -Brian Neal
  95.