home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d5xx / d588 / fracblank.lha / FracBlank / FracBlank.doc < prev    next >
Text File  |  1992-01-04  |  7KB  |  141 lines
  1. ============================== FracBlank 1.8 ==============================
  2. ===========================================================================
  3. A  screen  blanker  to  be used with Kickstart 2.x, written by Olaf `Olsen'
  4. Barthel.   ©  Copyright  1991 by Olaf `Olsen' Barthel, Giftware, all rights
  5. reserved.
  6.    No  guarantee  of any kind is made that the program(s) described in this
  7. document are 100% reliable.  You use this material on your own risk.
  8.  
  9. ================================= Purpose ================================
  10. ===========================================================================
  11. FracBlank is yet another custom screen blanker created to live in symbiosis
  12. with  Kickstart  2.x  and  the Commodities Exchange toolkit, similar to the
  13. `Blanker' program to be found in Tools/Commodities, just more wonderful.
  14.    Apart  from the usual job (turning the screen black after a given period
  15. of  time to prevent the phosphorus of your monitor from burning in) it will
  16. draw  some neat patterns while mouse and keyboard are inactive.  Instead of
  17. bouncing polygons, the Amiga logo, the Boing!  ball or other assorted items
  18. around the screen, real plane fractals (yes, real fractals) will be drawn.
  19.    The algorithm employed comes from the September 1986 issue of Scientific
  20. American;  some of you who are familiar with OpenWindows Version 2 (such as
  21. running  on  the  Sun4) will know it from the popular `xlock' program.  The
  22. patterns  created  may  remind  you  of  spiders'  webs,  lace  or even the
  23. Chladnian  patterns  formed  by  grains  of  sand strewn across a vibrating
  24. surface.   I  haven't seen an implementation of this algorithm on the Amiga
  25. yet, so it was time to program it ;-)
  26.  
  27. ============================== Installation ===============================
  28. ===========================================================================
  29. I  have  provided  two  versions of `FracBlank', one has been compiled with
  30. standard  Motorola  FFP  support  (this one will run on any Amiga which has
  31. Kickstart  2.x  installed), the other one will only work on Amiga computers
  32. which  have  an  MC68020/030  and  an  FPU68881/882  (or MC68040) installed
  33. (namely the A3000/T/UX line of computers).
  34.    Drop the approriate file into your WbStartup drawer or add the line `run
  35. >nil:  <nil:  fracblank' to your `s:user-startup' file.
  36.    There  are  a  number  of  command  line  switches  available which also
  37. correspond  to  tooltype  entries  to  be  changed/created by selecting the
  38. approriate icon and choosing the Workbench item `Information...':
  39.  
  40. CX_PRIORITY...... The  Cx priority to assign this tool to.  You may want to
  41.                   change  this  value  if  there is more than one Commodity
  42.                   tool    running   to   use  the  same  key  sequences  as
  43.                   `FracBlank'.   The  one  which  has  the  higher priority
  44.                   assigned will receive the keystrokes first.
  45.  
  46. CX_POPKEY........ The  keys to press to open the `FracBlank' control panel.
  47.                   The  control  panel allows you to set the hotkeys, adjust
  48.                   the timeouts, to  select the hotkeys and to terminate the
  49.                   program.
  50.  
  51. CX_POPUP......... This   is  a  boolean  switch  which  determines  whether
  52.                   `FracBlank' is to open the control panel on startup or to
  53.                   remain quiet.  Place `yes' here to open it.
  54.  
  55. BLANKSCREEN...... The keys to depress to force the screen blanker to become
  56.                   active.  If the blanker is already active, pressing these
  57.                   keys will cause the pattern to change.
  58.  
  59. MONO............. There are two display modes available for the patterns to
  60.                   be  drawn:   high  resolution  monochrome  mode  and  low
  61.                   resolution  multicolour mode.  Place `yes' here to select
  62.                   high resolution monochrome mode.
  63.  
  64. CYCLE............ In multicolour mode the program can either use a fixed 32
  65.                   colours  palette,  or  a  dynamically changing 75 colours
  66.                   palette.  Place `yes' here to use the 75 colours palette.
  67.  
  68. SCREENTIMEOUT.... The  number  of seconds to wait before the screen blanker
  69.                   is  activated.   This  period of time must elapse without
  70.                   any  mouse movements or keys being pressed.  If the value
  71.                   placed here is zero, screen blanking will be disabled.
  72.                      You  may  either enter the number of seconds (60, 120,
  73.                   etc.)  or  provide  a  string of the format mm:ss (11:30,
  74.                   12:25, etc.).
  75.  
  76. PATTERNTIMEOUT... While  the  screen  blanker  is  running,  the  number of
  77.                   seconds  to wait before changing the fractal pattern.  If
  78.                   the  value  placed  here  is  zero, a single pattern will
  79.                   remain.
  80.                      You  may  either enter the number of seconds (60, 120,
  81.                   etc.)  or  provide  a  string of the format mm:ss (11:30,
  82.                   12:25, etc.).
  83.  
  84.    Running  `FracBlank'  twice  will cause it to open the control panel; to
  85. terminate  `FracBlank'  send  it  a  ^E signal (such as by `break 3 e' with
  86. `FracBlank'  running  as  CLI  task  3) or conjure up the control panel and
  87. press the `Quit' gadget.
  88.  
  89. ==================== Author's Request & Gift-Ware fee =====================
  90. ===========================================================================
  91. By  releasing  this program and the accompanying source code as Gift-Ware I
  92. do  not  place any obligations on you, feel free to share this program with
  93. your  friends (and enemies) to study and to learn from it.  But, should you
  94. feel the need to make any contributions, send them to:
  95.  
  96.                                Olaf Barthel
  97.                              Brabeckstrasse 35
  98.                             D-3000 Hannover 71
  99.  
  100.                         Federal Republic of Germany
  101.  
  102.    (If you don't have an idea about what to contribute:  I am still looking
  103. for  old  Infocom  adventure  games,  since they are no longer available in
  104. Germany)
  105.  
  106.    I  may  also  answer  questions  asked  via  electronic  mail.  My email
  107. addresses are:
  108.  
  109.                     Z-Net: O.BARTHEL@A-Link-H
  110.                    Usenet: o.barthel@a-link-h.zer.sub.org
  111.                            cbmvax.commodore.com!cbmehq!sourcery!olsen
  112.  
  113.    The  entire  FracBlank  package  may  be  noncommercially redistributed,
  114. provided  that  the  package is always distributed in its complete form.  A
  115. small  copy  fee  for  media  costs  is  okay  but  any  kind of commercial
  116. distribution is strictly forbidden!
  117.    Comments  and  suggestions  how  to  improve  this program are generally
  118. appreciated!
  119.  
  120. =============== Revision history (most recent change first) ===============
  121. ===========================================================================
  122. 1.8    Numerous bug fixes and some enhancements.
  123.  
  124. 1.7    Removed sprite blanker code, replaced it by a user copper list.
  125.  
  126. 1.6    Added cycle gadget.
  127.  
  128. 1.5    Added multicolour mode.
  129.  
  130. 1.4    The  sprite  pointer  used  to  pop  up  randomly now and then; the
  131.     interrupt  server  has  been  rewritten  to turn off the sprite DMA
  132.     twice instead of only once.
  133.  
  134. 1.3    Added VBlank interrupt server (disables sprites), idea turned up by
  135.     Adam  Keith  Levin's  `Disabling  Sprite  DMA From a Vertical Blank
  136.     Interrupt' article published in AmigaMail November/December 1989.
  137.  
  138. 1.2    First public release.
  139.  
  140. 1.1,1.0    Before written history.
  141.