home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 1 / GoldFishApril1994_CD1.img / d1xx / d146 / blanker2 / readme < prev    next >
Internet Message Format  |  1988-05-27  |  2KB
  1. From: joe@vixen.uucp (Joe Hitchens)
  2.  
  3.     Blanker2 -- by Joe Hitchens -- v1.27.88
  4.  
  5.     A screen blanking program that turns the screen black after 90
  6.     seconds of keyboard and mouse inactivity.  Adds a tiny event
  7.     handler to the input.handler event stream and watches the events
  8.     go by.  If it doesn't see a mouse or keyboard event after 900
  9.     timer events (10 per second), it turns the screen black by turning
  10.     off DMA for rasters and the copper.
  11.  
  12.     If run from the CLI, a message will be printed out saying how long
  13.     the blank time is set to.
  14.  
  15.     If run from (my cool) icon, nothing will appear to happen, but 90
  16.     seconds later you will be able to tell if it installed itself ok.
  17.     This program cannot be removed once installed, so if you have a 
  18.     problem with it, all I can say is "Stop using it".
  19.  
  20.     I realize that it would be a lot nicer to have a true task running
  21.     in the background and message ports between the handler and the task
  22.     so the handler could be programmed and removed from the outside,
  23.     but, I opted to not do this because as it is, Blanker2 will take up
  24.     less than 256 bytes of ram, and doesn't require any more when it 
  25.     attempts to blank the screen (via opening black screens, etc.).
  26.     It's tiny and it does the job.  I think that may be worth alot to
  27.     most users.
  28.  
  29.     This program is PUBLIC DOMAIN.
  30.     Do me a favor though, and leave my name on it so I can get a little
  31.     recognition.  
  32.  
  33.     Usage: blanker2 [n]
  34.         n = number of seconds of inactivity after which blanking
  35.         occurs.  If n is not given, a default of 90 is used.
  36.         NOTE: blanker2 need not be 'run'.  It will install an event
  37.               handler and leave it behind when exiting.
  38.               Also, the CLI window it may have been run from can be 
  39.               closed after installation.
  40.  
  41.     Exit codes
  42.     0    Normal exit, everything went fine.
  43.     1    CreatePort() failed.
  44.     2    CreateStdIO() failed.
  45.     3    OpenDevice() on "input.device" failed.
  46.     4    Memory Allocation for Interrupt structure failed.
  47.     5    Memory Allocation for Blanker structure failed.
  48.     6    Memory Allocation for event handler code space failed.
  49.  
  50.     Please report any bugs you may find to me, so that I can try to
  51.     fix them.
  52.  
  53.     j.h.                      joe@sally.utexas.edu    
  54.  
  55.