home *** CD-ROM | disk | FTP | other *** search
/ No Fragments Archive 10: Diskmags / nf_archive_10.iso / MAGS / ST_USER / 1992 / USERAU92.MSA / BOINK_READTHIS.1ST < prev    next >
Text File  |  1992-04-14  |  8KB  |  141 lines
  1. -- What should have been in this folder --------------------------------------
  2.    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  3.     Boink.PRG      BoinkSave Screen Saver.
  4.     BoinkCfg.PRG   The config program.
  5.     Faze.PRG       Faze Screen Saver.
  6.     ReadThis.1st   This file.
  7.     Images\        A folder containing several .BSI files.
  8.  
  9.  
  10. -- Freeware notice -----------------------------------------------------------
  11.    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  12. This program is Freeware.  You may distribute it as you see fit, but you can't
  13. charge for it, except reasonable charges to cover the cost of the media it's
  14. distributed on (read: PD/Shareware collections are okay).
  15.  
  16.  
  17. -- What this is --------------------------------------------------------------
  18.    ¯¯¯¯¯¯¯¯¯¯¯¯
  19. In the tradition of creating screen savers that are anything but tame (one of
  20. R. Glover's common complaints about screen savers), here are two screen savers
  21. I've written.
  22.  
  23.  
  24. -- Using the programs --------------------------------------------------------
  25.    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  26. Put Boink.PRG or Faze.PRG (don't use both at the same time) in your AUTO folder
  27. and if you don't press a key or move the mouse for two minutes, the screen
  28. saver will go to work.  Press any key or move the mouse to restore the screen.
  29. What the screen saver does depends on which one you use; Boink.PRG will display
  30. a bouncing, spinning ball (reminiscent of the old, old Boink demo), and
  31. Faze.PRG does a slow fractal faze through some colors.  Boink.PRG consumes a
  32. whopping 43K of RAM (34K for Faze.PRG), even though it's only 10K; that's the
  33. price you pay for interesting screen savers.  Fortunately BoinkSave only
  34. consumes 12% (11% for Faze) of processor time when actually bouncing the ball.
  35. Both programs should run on a TT, but I can't say for certain (I don't have a
  36. TT to test it on, do I?)  Neither program runs in monochrome; if you try, they
  37. won't install themselves.  That way you don't have to worry about turning them
  38. off when you switch monitors.
  39.  
  40. The BoinkCfg program will take some explaining.  Not that it's hard to use,
  41. just that there's a bit to it.  When you run it, from any resolution, you'll
  42. see a small alert box with three buttons on it: "Config", "Disable", and
  43. "Exit".  "Config" will bring up the configuration dialog.  "Disable" will
  44. disable the screen saver completely; you'll notice the button changes to
  45. "Enable!", which will re-enable the screen saver.  And "Exit" will turn on the
  46. screen saver and exit the program.  (The screen saver will shut off when you
  47. move the mouse or press a key, of course.)
  48.  
  49. In the "Config" dialog you will also find three buttons: "Time", "Boink", and
  50. "Exit".  Clicking on "Time" will allow you to set the time the screen saver
  51. will wait before kicking in.  Use the "<" and ">" buttons to change the time
  52. displayed; click on the time itself when you're satisfied.  "Boink" will bring
  53. up yet another dialog, allowing you to adjust aspects of the animation in
  54. BoinkSave (and only BoinkSave; these options are useless for Faze).  Here you
  55. can choose "Speed", "Graphic", or "Exit".  "Speed" will allow you to choose
  56. "Fast", "Medium", or "Slow".  On an unmodified ST, these consume 23%, 12%, and
  57. 8% of processor time, respectively.  Once one of these buttons is selected,
  58. BoinkSave will activate, showing you what the speed looks like.  Move the mouse
  59. or press a key to return to the dialog.  "Graphic" will allow you to load a
  60. .BSI file (contained in the Images folder) for a different graphic; once
  61. loaded, BoinkSave will activate, so you can see the new graphic.  Move the
  62. mouse or press a key to return to the dialog.  "Exit", as with the other "Exit"
  63. buttons in the program, exits back to the previous dialog.  If you exit from
  64. the "Config" dialog, you will be asked if you want to save the configuration;
  65. click on "Okay" to save to \AUTO\BOINK.PRG, "Locate" to find a different copy
  66. of the program (or FAZE.PRG), or "Cancel" to abort the save.
  67.  
  68. Phew!  That's just about everything you *need* to know to use these screen
  69. savers.  There are, however, a few more things I'd like to point out.  Both of
  70. these screen savers have been previously released; this time I've (hopefully)
  71. fixed a glitch in BoinkCfg (thus it's version 1.1).  This program replaces the
  72. Faze_Cfg, as it lets you configure both screen savers from the same program.
  73. It also lets you *disable* the screen savers, which in this case is *vital* for
  74. Spectrum & DigiSpec.  I have found no other compatibility problems with these
  75. two programs.
  76.  
  77. One more thing.  The "Disable" function only works if BoinkSave (or Faze) was
  78. the last program to install itself on the vertical blank interrupt.  You can
  79. make sure this is so by placing Boink.PRG or Faze.PRG _last_ in your AUTO
  80. folder.
  81.  
  82. Well, I didn't expect to write this much about these screen savers, let alone
  83. fix a bug.  If you have comments/questions/complaints/suggestions, you can
  84. write to:
  85.  
  86.      (US / Canada)                     (Europe)
  87.     Damien M. Jones                 Damien M. Jones
  88.     PSC 8 Box 657                   Postfach 657
  89.     APO AE 09109                    6541 Lautzenhausen
  90.                                        Germany
  91.  
  92. I wrote this program because I couldn't get the idea out of my head; I thought
  93. perhaps if I got it over and done with, I might be able to get back to my
  94. current project.  It didn't work.  Now I get all *kinds* of ideas for screen
  95. savers.  (Sigh)
  96.  
  97.     -dmj
  98.  
  99.  
  100. -- File format of .BSI files (for BoinkSave) ---------------------------------
  101.    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  102. Obviously, there are some of you out there who are itching to put together your
  103. own animations for BoinkSave.  Fine, no problem.  Here's the format of the .BSI
  104. files used by BoinkCfg.PRG:
  105.  
  106. [8 bytes]     ID bytes, read "dmj³.BSI".
  107. [2 bytes]     Number of X positions to use.
  108. [2 bytes]     Number of Y positions to use.
  109. [640 bytes]   X positions; these are values ranging from 0-288, as a list of
  110.               words.  Note that even though they must all be here, they are
  111.               not always used, depending on the value listed above.
  112. [400 bytes]   Y positions; these are values ranging from 0-168, as a list of
  113.               words.  Note that even though they must all be here, they are
  114.               not always used, depending on the value listed above.
  115. [32 bytes]    Palette, in standard 16*RGB format.  May be STe if you like.
  116. [8192 bytes]  The images.  These are sixteen 32x32 rasters in four bitplanes.
  117.               If you're using GFA BASIC, you can use GET; just remember to
  118.               clip off the first six characters of the GET string, since GFA
  119.               BASIC uses that part to record the size of the image.
  120.  
  121. That's really all there is to it.  Not very complicated, but adequate for the
  122. situation.  If you get any really good .BSI's, I'd be interested in seeing
  123. them... send them to the above address.
  124.  
  125.  
  126. -- Advertisement -------------------------------------------------------------
  127.    ¯¯¯¯¯¯¯¯¯¯¯¯¯
  128. Say, have you heard about DMJ GIF?  It's one of the most popular GIF converters
  129. for the ST, and with good reason!  DMJ GIF takes high quality GIF images and
  130. converts them to high quality Spectrum images.  Or DEGAS or Tiny pictures.  In
  131. full color, or grey scale, or monochrome.  With the ST's 512-color palette or
  132. the STe's 4096-color palette.  It also includes programs to convert Spectrum
  133. pictures to low or high resolution DEGAS pictures.  And it even includes a
  134. program to view STe Spectrum pictures on an ST, in 3375 colors!  There's even
  135. more, but I don't have space to list everything here.  So where can you get
  136. this marvel?  Try GEnie.  Or CompuServe.  Or your local BBS.  (You're looking
  137. for DMJ_GIF3.LZH.)  Can't find it on your local BBS?  I've got plenty of copies
  138. (grin).  Registered versions (which run twice as fast as distributed versions!)
  139. are available at the above address for only $15, and that includes a printed
  140. manual.  So what are *you* waiting for?
  141.