home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / bbs / mar94 / os20 / gfx / fastlife.lha / FastLife / FastLife.doc < prev    next >
Text File  |  1994-01-17  |  27KB  |  793 lines
  1.  
  2.  
  3.  
  4. Document FastLife Version 2.7 documentation
  5.  
  6. FastLife Program Documentation
  7. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  8.  
  9.   Version 2.7 16-Jan-1994
  10.  
  11. FastLife is an Amiga implementation of Conway's Game of Life.
  12.  
  13. FastLife may be freely distributed.
  14.  
  15. Amiga Software Release 2.04+ and LIBS:reqtools.library 38+ are required
  16. to run FastLife.
  17.  
  18. 1. Quick Start
  19. ==============
  20.  
  21. NOTE - Kickstart 2.04+ and LIBS:reqtools.library 38.961+ are required to
  22. run FastLife.
  23.  
  24.  1. Double click on the FastLife Icon
  25.  2. Select "Cancel" in the screen mode requester
  26.  3. Select the "Control-Run" menu item
  27.  
  28.       OR
  29.  
  30.  1. Double-click on the FastLife Icon
  31.  2. Select "Cancel" in the screen mode requester
  32.  3. Select "Project-Open" menu item
  33.  4. Select "acorn.life" and press <return>
  34.  5. Click in the center of the screen
  35.  6. Select the "Control-Run" menu item
  36.  
  37. 2. Credits
  38. ==========
  39.  
  40.    o  Intuition interface and integration by Ron Charlton
  41.    o  Blitter life routines by Tomas Rokicki
  42.    o  Requesters use ReqTools by Nico Francois
  43.  
  44. 3. Features and Changes
  45. =======================
  46.  
  47. 3.1. Features
  48. -------------
  49.  
  50.    o  Full Intuition interface
  51.    o  Any screen width and height (if you have enough memory)
  52.    o  Screen mode and screen size requester
  53.    o  Random Field Generation
  54.    o  Torus mode (screen edge wraps around)
  55.    o  Speed control
  56.    o  Run for a specified number of generations
  57.    o  Run to a specified generation
  58.    o  Runs from Workbench and CLI under Kickstart 2.04+
  59.    o  150+ Life patterns in text file format
  60.    o  14 new "SpaceFiller" patterns
  61.  
  62. 3.2. Changes from FastLife 2.2
  63. ------------------------------
  64.  
  65. FastLife uses new, blazingly fast Life routines written by Tomas
  66. Rokicki. FastLife can now update a 320 by 200 screen at up to 170
  67. generations per second on a 25 MHz Amiga 3000, depending on what pattern
  68. is displayed. Your mileage may vary.
  69.  
  70. You can get Tomas' Life program, version 6.1, on Fred Fish disk 837.
  71. FastLife no longer has a CPU mode and BLITTER mode; it always uses
  72. Tomas' routines.
  73.  
  74. FastLife will generate a random field on request.
  75.  
  76. FastLife has a torus option that connects the top edge of the life
  77. universe to the bottom edge and the left edge to the right edge.
  78.  
  79. FastLife has AmigaGuide format documentation.
  80.  
  81. Miscelleanous corrections (that I hope no one has found a need for) have
  82. been made.
  83.  
  84. 4. The Game of Life
  85. ===================
  86.  
  87. In 1970 John Horton Conway, a mathematician at the University of
  88. Cambridge, invented the game of Life.  It was introduced by Martin
  89. Gardner in his October 1970 Scientific American column. Conway's goal
  90. was to create a board "game" with simple rules that would exhibit
  91. complex behavior.  The game is played on an infinite checkerboard.  Each
  92. cell on the checkerboard, is either alive or dead (ON or OFF).  Time
  93. moves in steps; each step marks the life of one generation.
  94.  
  95. Each cell's condition (ON or OFF) in the next generation is based on the
  96. life in it and its eight neighboring cells.  A cell is represented by
  97. the asterisk (*) below; its eight neighbors are numbered -
  98.  
  99.      123
  100.      4*5
  101.      678
  102.  
  103. Three rules decide a cell's state in the next generation:
  104.  
  105.      1.  If there are 2 ON neighbors the cell stays ON or OFF
  106.      2.  If there are 3 ON neighbors the cell is ON
  107.      3.  0, 1, 4, 5, 6, 7 or 8 ON neighbors the cell is OFF
  108.  
  109. The analogy to real life is this: too many neighbors and the cell dies
  110. from overcrowding, too few neighbors and the cell dies from loneliness.
  111. Three cells results in trisexual mating.
  112.  
  113. The ON/OFF state is determined for all cells on the board before
  114. changing to the next generation.
  115.  
  116. FastLife uses one pixel on the screen to represent one cell on the
  117. board.  The screen dimensions determine how many cells are available in
  118. FastLife, so the board is not infinite, as defined by Conway.
  119.  
  120. An excellent reference for learning more about the history and
  121. philosophical implications of Life is
  122.  
  123.      "The Recursive Universe" by William Poundstone,
  124.      Contemporary Books, Chicago, 1985
  125.  
  126. The book consists of alternating chapters about Conway's game of Life
  127. and modern physics, and what the game of Life can reveal about the
  128. beginning of biological life and its replication.
  129.  
  130. 5. About FastLife
  131. =================
  132.  
  133. I developed FastLife because I wanted to combine the speed of Tomas
  134. Rokicki's Life routines with an Intuition interface and access to many
  135. of the classic Life patterns.
  136.  
  137. The Life patterns supplied with FastLife are stored in a simple text
  138. file (see `File Format' below).  Although FastLife does not allow
  139. on-screen editing of Life patterns, you may use your favorite text
  140. editor to create text file patterns to load into FastLife.
  141.  
  142. Conway defined an infinite board for Life; FastLife limits itself to the
  143. size of a screen on your Amiga. Patterns that spread to the edge of the
  144. screen will be "eaten" away there, unless you have the `Torus' option
  145. turned on, so you should be sure that you select a screen size that will
  146. contain the entire pattern you want to view.  This corruption of the
  147. Life pattern at the edge of the screen is not detected by FastLife; you
  148. must observe for yourself when this happens.
  149.  
  150. The corruption occurs at the edge of the screen, which may not be the
  151. same as edge of what is visible to you, depending on whether you choose
  152. a screen size larger than the default for the screen mode.
  153.  
  154. 6. Starting FastLife
  155. ====================
  156.  
  157. You may start FastLife from either the Workbench or CLI (Shell).
  158.  
  159. 6.1. WORKBENCH
  160. --------------
  161.  
  162. You may start FastLife from Workbench by double-clicking its icon.
  163. Several ToolTypes may be used. To set a ToolType click once on
  164. FastLife's icon and then press Right-Amiga-I. Click on New or an
  165. existing ToolType to edit. Enter for example,
  166.  
  167.      ALIVECHAR=X
  168.  
  169. Finally, select Save.  FastLife will then honor the ToolType. The 
  170. supplied icon has parentheses around most of the ToolTypes. Remove the
  171. parentheses to use that ToolType.
  172.  
  173. The ToolTypes available are:
  174.  
  175.      ALIVECHAR=x
  176.  
  177.      FILEPAT=#?name.???
  178.  
  179. You must use uppercase for the text to the left of the equal sign for
  180. FastLife to recognize the ToolType.
  181.  
  182. Do not change the WINDOW= ToolType. It is used to display error messages
  183. under unusual circumstances.
  184.  
  185. The character that follows ALIVECHAR= indicates what character in
  186. Picture files represents an ON cell. All other characters in the pattern
  187. will indicate OFF cells.
  188.  
  189. The string that follows FILEPAT= determines what file names appear in
  190. the Open file requester. Amiga wildcards are supported. "?" (no quotes)
  191. in the string matches any one character. "#?" (no quotes) matches any
  192. number of characters. Upper/lowercase do not matter. Some examples:
  193.  
  194.   #?.life     any name ending in ".life"
  195.   #?.???      any name that has a three-character extension
  196.   #?breeder#? any name that contains "breeder" anywhere in it
  197.  
  198. 6.2. SHELL or CLI
  199. -----------------
  200.  
  201. You may start FastLife from a Shell or CLI by typing
  202.  
  203.      1> FastLife         or
  204.  
  205.      1> run FastLife
  206.  
  207. FastLife's template is  ALIVECHAR/K,FILEPAT/K.   Typing
  208.  
  209.      1> FastLife ?
  210.  
  211. will display the template and wait for you to enter arguments. 
  212.  
  213. To specify the Picture file character for ON pixels as the uppercase
  214. letter 'O' use
  215.  
  216.      1> FastLife ALIVECHAR O
  217.  
  218. Finally, 
  219.  
  220.      1> FastLife FILEPAT #?.lif
  221.  
  222. will set the file requester pattern to "#?.lif" initially. You can
  223. change the settings for CALCMODE and FILEPAT after FastLife has started.
  224.  
  225. NOTE - The Life files supplied with FastLife all end in ".life".
  226. "#?.life" is FastLife's default pattern.
  227.  
  228. 7. Using FastLife
  229. =================
  230.  
  231. 7.1. Effects of Screen Mode & Size
  232. ----------------------------------
  233.  
  234. WARNING - The Amiga is capable of producing screen modes that will cause
  235. physical damage to certain types of monitors. See your Amiga
  236. documentation for further information. Do not select screen modes that
  237. your monitor does not support.
  238.  
  239. You may choose a screen width, height, and one of several screen modes
  240. for the FastLife screen. The screen mode determines the maximum number
  241. of pixels visible vertically and horizontally. Width and height
  242. determine the actual size of the screen, part of which may not be
  243. visible.
  244.  
  245. For instance, if you select a screen mode of NTSC:Lores, width of 
  246.  600 and height of 512, then a life patte