home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-Update.iso / CDROM / Contents / READMEs / Peanuts-3 / Tools / screen / backspace / GrayAquarium.README < prev    next >
Encoding:
Text File  |  1996-11-09  |  3.1 KB  |  77 lines
  1. This is the README file for a modified version
  2. of Brian Glaeske's Aquarium BackSpace module.  The file GrayAquarium.tar.Z
  3. contains both source and a m68k/i386 binary for the module.
  4.  
  5. As the name indicates, GrayAquarium is primarily designed for grayscale next
  6. machines. The fish in this distribution are in grayscale, and the drawing 
  7. methods use a buffered background.  For a 24 bit color system, buffering eats 
  8. up 3 meg of memory, while for my 2 bit nextstation it is only 250K.  (The 
  9. original Aquarium BackSpace module does not use a buffered background.) 
  10.  
  11. BackSpace.app is a screensaver/background program written by Samuel G. 
  12. Streeper of NeXT Computer Inc., and provided (for free!) as an example
  13. on the developer versions of nextstep 3.0, 3.1, and 3.2.
  14.  
  15. Improvements:  
  16.  
  17. 1.  Arbitrary background water color.  Since a non-black background color
  18. is not a particularly good screen saver, I suggest that you use this feature
  19. in conjunction with the BackSpaceDuo hack of BackSpace that was posted on
  20. the cs.orst.edu and ftp.informatik.uni-muenchen.de next archives a little
  21. while back.  With BackSpaceDuo, you can use GrayAquarium as a background
  22. and some other more appropriate BackSpace module as the true screen saver.  
  23.  
  24. 2.  A simplified fish drawing routine eliminates strange looking fish when
  25. the fish overlap.  This is where a buffered background is used. 
  26.  
  27. 3.  Flipped Images are stored after the first flip.  Your computer will not jerk to a stop every time a fish gets to a border and has to flip.
  28.  
  29. 4.  Lots of control over number, type, and speed of fish.  El-cheapo 
  30. postscript special effects too!
  31.  
  32. Major Known Bugs:
  33.  
  34. 1.  On my grayscale nextstation, I can see the boxes that the fish are drawn
  35. in if I don't choose a `primary' (white, lightgray, darkgray, black)
  36. background color.  I imagine that color machines will have a similar
  37. problem.
  38.  
  39. 2.  If you change the background color while the background is running, 
  40. the background and the background in the boxes drawn around the fish 
  41. don't initially match.  You have to kill the background and start it up again.
  42.  
  43. 3.  Because I am using a buffered background, this module is a 
  44. memory hog on color machines, as discussed above.
  45.  
  46. 4.  This code will only compile on 3.x machines.  Please excuse me.
  47.  
  48. Installation:
  49.  
  50. Using Terminal.app (or even better, Stuart.app), uncompress (or gunzip)
  51. and then tar -xvf the file Aquaruim.tar.Z(gz). Change directory (cd) into
  52. the GrayAquaruim directory.  Type `make install'.  AquaruimView.BackModule will
  53. be created in your Library/BackSpaceViews directory.    
  54.  
  55. As a courtesy to those of you who have jumped on to the next bandwagon 
  56. recently and have opted not to pay for the NeXT application kit, a copy of 
  57. AquaruimView.BackModule is included with this distribution.  I compiled it with 
  58. the -arch m68k -arch i386 flags, so it should (crossing my fingers here) work 
  59. for both above named architectures. 
  60.  
  61.  
  62. Wishing the NeXT community a happy and fulfilling new year,
  63.  
  64. Paul Griffin   (pgriffin@phys.ufl.edu)
  65. Physics Department
  66. University of Florida
  67. Gainesville, FL 32611
  68.  
  69. 1/5/94
  70.  
  71. Fixed a couple of initialization bugs that showed up when I tried to use color
  72. fish.
  73.  
  74. 1/9/94
  75.  
  76.  
  77.