home *** CD-ROM | disk | FTP | other *** search
/ MORE WinGames / WINGAMES.iso / life / readme.txt < prev   
Text File  |  1991-05-29  |  6KB  |  108 lines
  1.                                  LIFE
  2.                A Simulation of the Famous Game of Life
  3.                            For Windows 3.0
  4.  
  5.                       Version 1.1  May 27, 1991
  6.                       Copyright 1991 Tom Wheeler
  7.                              [72037,1742]
  8.  
  9.  
  10. The programs and documentation contained herein are hereby placed in the
  11. public domain.  You may use any portion of this material as you see fit
  12. for your own personal use provided no part of anything contained herein
  13. is used or distributed commercially.
  14.  
  15. This material may not be distributed unless all modules listed below
  16. are included in the final distributed version:
  17.  
  18.                HAND     CUR       326 05-15-91   9:10p
  19.                LIFE     C       35455 05-27-91   5:48p
  20.                LIFE     DEF       410 05-18-91   9:30p
  21.                LIFE     EXE     35984 05-27-91   5:48p
  22.                LIFE     H         571 05-18-91   2:53p
  23.                LIFE     ICO       766 05-14-91   8:42p
  24.                LIFE     MAK      2267 05-27-91   5:11p
  25.                LIFE     RC       2593 05-22-91  10:33p
  26.                README   TXT      5725 05-29-91   8:38p
  27.  
  28. No claim of suitability of use is made for these programs.  The user is
  29. solely responsible to determine whether or not these programs perform
  30. properly on any given computer system.
  31.  
  32. This program provides a simulation of Life for Windows 3.0.  This is one
  33. of the more common simulations available in one form or another for just
  34. about every computer ever made.  The algorithm used to manipulate the
  35. cells was borrowed and heavily modifed from a Turbo Pascal for Windows
  36. program available on Compuserve in the Borland Forum named "PLIFE".
  37.  
  38. The rules of the basic simulation are simple.  If a "dead" cell has exactly 3
  39. neighbor cells, it is born (displayed as a green rectangle).  If an "alive"
  40. cell should ever have less than 2 neighbors it dies (of lonliness, I presume).
  41. If an "alive" cell should ever have more than 3 neighbors it also dies
  42. (overcrowding).  The simulation proceeds from cycle to cycle, calculating
  43. and updating the status of each cell displayed on the screen.
  44.  
  45. This version adds a twist to the basic simulation.  Every ten cycles that
  46. a cell is alive, it ages (transforms to a different state indicated by a
  47. change in color).  When a cell becomes too old (after 8 age cycles), it dies
  48. off regardless of the above conditions.
  49.  
  50. The world that the cells exist within consists of a 100 X 100 grid.  The grid
  51. does not wrap, that is, cells at the far left do not know about cells at the
  52. far right and cells at the top do not know about cells at the bottom.
  53.  
  54. When first started, an empty cell matrix is displayed.  You may place individual
  55. cells wherever you like by positioning the hand cursor over an empty cell and
  56. clicking the left mouse button.  After placing the desired cells, cycle the
  57. matrix by selecting "Start" or "Step" from the "Run" menu.  Cells may be
  58. added or deleted at any time by using the mouse as above.  If you do not place
  59. any cells, this program will randomly fill the grid with "alive" cells for 
  60. you.
  61.  
  62. To summarize functions available:
  63.  
  64.      RUN        HOTKEY                          DESCRIPTION
  65.   ----------   --------   ---------------------------------------------------
  66.    Start         ^R        Starts automatic cycling of the matrix.  The matrix
  67.                            cycles when a predefined timer expires.
  68.    Stop          ^R        Stops automatic cycling of the matrix.
  69.    Step          ^E        Cycles the matrix once.  Only available when the
  70.                            matrix is not in automatic cycle mode. 
  71.  
  72.    OPTIONS      HOTKEY                          DESCRIPTION
  73.   ----------   --------   ---------------------------------------------------
  74.    Clear         ^C        Clears the matrix.  If it is automatic cycle mode,
  75.                            it turns this feature off as well.
  76.    Grid On       ^G        Turns Gridlines ON.
  77.    Grid Off      ^G        Turns Gridlines OFF.
  78.    Set Timer     ^T        Allows entry of a different time value for the cycle
  79.                            timer.  Valid entries are 100-999 (milliseconds).
  80.    Small Grid    ^S        Displays the smallest possible grid size (zooms out)
  81.    Medium Grid   ^M        Displays the default grid size
  82.    Large Grid    ^L        Displays the largest possible grid size (zooms in)
  83.  
  84. You may move around the matrix by using the scroll bars and zooming in and
  85. out (also up, down, left, right, pgup, and pgdown keys work).  In the interest
  86. of run time efficiency (speed), only the cells actually displayed are cycled.
  87. Therefore, any cells defined but not displayed remain stationary.  If you move
  88. to an uninhabitated area while in automatic cycle mode, the program will
  89. automatically fill it with a random pattern of cells.
  90.  
  91. NOTE:  When in automatic cycle mode with the window zoomed to full screen and
  92. Small Grid size selected, this program can take a lot of CPU time to run
  93. (even on a fast 386/486 machine).  It is best to find a combination of grid
  94. size and window size that does not hog a lot of system time.  The default
  95. size does not seem to be too much of a burden even on slower PCs.  You can
  96. also increase the timer value to > 500 milliseconds to decrease the amount of
  97. overhead this program requires.
  98.  
  99. This program was written as an experiment to try out various Windows API
  100. functions, primarily the use of GDI Graphics calls and Scroll Bar manipulation.
  101. The make file was generated using the PWB (Programmers Work Bench) included with
  102. Microsoft C 6.00a.  The program was compiled and linked with Microsoft C 6.00a
  103. and Link 5.1.
  104.  
  105.  
  106.  
  107.  
  108.