WLife2d.RTF WinHelp for
Game of Life Cellular Automaton

This source file is compiled by the Windows Help Compiler to produce the WLife2d.hlp Windows 3.1 WinHelp file for the WLIFE2D project. This RTF file describes features specific to WLife2d's calculations and commands. A second RTF file (sdibwin.rtf) is compiled along with this one. It describes the graphics features that are common to several of my programs.

If you use Microsoft Word, these WinHelp source files are based on the helpfile.dot template, which you might find useful.

WLife2d.RTF

^{# $ K +} WLife2D (Game of Life) Help Contents

Note that this help file was copied from another program, and has not yet been fully customized for this one.

OverviewHID_OVERVIEW
File FormatsHID_FILEFORMATS
More File FormatsHID_MOREFILEFORMATS
File Menu CommandsHID_FILEMENUCOMMANDS
Colors Menu CommandsHID_COLORSMENU
More Colors Menu CommandsHID_MORECOLORSMENUCOMMANDS
View Menu CommandsHID_VIEWMENUCOMMANDS
References and Further ReadingHID_FURTHERREADING

^{# $ K +} Overview

The Game of Life is an example of a cellular automaton. The field consists of numerous cells, which can be on (alive) or off (dead). Whether a currently live cell survives to the next generation is determined by the number of neighbors it has. Also, a currently dead cell can become alive if it has the right number of neighbors.

^{# $ K +} More File Formats

These file formats are specific to the Game of Life.

Survive/Born rules are stored in ASCII text files with the extension .RUL, and containing at least 2 lines. You can use additional lines for comments. Maximum total file size is 2000 bytes.

File Format:

• 2 3 <- A cell survives if its number of neighbors is any of these (digits 0 through 8 legal)

• 3 <- A new cell is born if its number of neighbors is any of these (digits 0 through 8 legal)

• Standard game <- Comment line for any desired descriptive or other text

Game boards are saved and loaded as .BMP files. Due to possible version differences in .BMP files used by various applications, if you want to create a game board, it is safest to first create a board with the dimensions you want, Save it as .BMP, and then edit it with a bitmap editor. Creating the file initially with the bitmap editor can cause load errors.

^{# $ K +} File Menu Commands

Next or New Random

Abandons the current design.

If there are one or more designs waiting in the display queue to be displayed, it moves on to the next one in the queue.

If the queue is empty,

The display queue may contain filenames to display if you have:

1. Invoked the program with filenames on the command line.
2. Selected multiple files in the File|Load dialog box. In both cases, the files are added to the queue for display in sequence.

Open

Displays a dialog box in which you can select one or more files to load and display in sequence, the same as if you specified them on the command line when you started the program. The files selected are added to the queue. Note that if you do this when files are still in the queue, the next file displayed will be the next in the queue, not the one you just selected.

Edit File

Displays a dialog box in which you can select one file to edit as text.

Edit Again

Immediately (no dialog box) opens the file corresponding to the design currently displayed, for text editing.

Save

SaveAs .BMP

Saves the currently-displayed design (in the size it occupies in the currently displayed window) and its color palette to disk as a .BMP file. You can then import the file into a bitmap editor. To create a design with a specific size or proportions, size the display window as needed, wait for the design to be sufficiently filled in, and then SaveAs .BMP.

^{# $ K +} More Colors Menu Commands

(Commands specific only to this program.)

Set Monochrome Color

Displays a dialog box in which you can specify the color to use when drawing in monochrome mode. It also automatically switches to monochrome mode and turns AutoRandomizeColorsHID_VIEWMENUCOMMANDS OFF, so that the color you selected remains the drawing color until you change the color or change the point coloring mode or turn AutoRandomizeColors on again.

^{# $ K +} View Menu Commands and View Options Dialog Settings

Auto-Cycle Generations

If on, new generations are automatically calculated and displayed. When off, the application does nothing.

Auto-Randomize Colors

When ON, the palette is automatically filled with random colors before every new game. When OFF, the palette stays the same.

AutoAbort Tests

If on, the application continually tries to determine whether anything interesting is happening on the screen. If it detects no activity, it automatically starts a new game.

Random Rules for each new rule set

When the file list (if any) is exhausted, new boards (created with File|New or due to AutoAbort) normally continue to use the last rule set that was in effect. When this option is on, each new board also gets a new randomly generated rule set.

Color by Neighborcount

Pixels (dots) are normally colored by whether they are "live" or "dead". This option colors each pixel according to how many live neighbors it has, which will determine whether or not it survives into the next generation, and makes for a colorful display.

Use Sound

Toggles the use of sound in the application.

Fit to Window

If on, the game board is stretched to fill the current display window, which makes the activity easier to see. If off, the game board is displayed in its true size in the window's upper left corner, which is harder to see, but the generations cycle much faster.

Board Size (width height) or (0 0)

The dimensions of the game board you want to use, which does not have to be the same size as the window. The board is then stretched to fit the window for display. Larger values for width and height increase calculation times, and the tiny dots can be difficult to see. Use 0 0 to match the board size to the current window size. It is not advisable to use a board size that is larger than the window.

Percent Fill (1 to 99)

When a new randomly generated board is created, a percentage of it is filled with random dots. Enter the percentage of it that you want filled with dots.

Time Limit (minutes, fractional ok)

If AutoAbort is on while random rule sets are being generated, the program will move on to a new rule set after this amount of time, even if it detects continuing activity on the screen. Many rule sets never do settle down, but nonetheless become boring. This allows you to set a time limit for each set, in addition to the Population Lookback test.

Population Lookback

If AutoAbort is on, the program keeps track of the total population of "live" cells. If this population does not change for multiple generations, it decides that the game board is dead or uninteresting, and moves on to a new rule set. If you enter a low number such as 1, it may decide that a board is dead before it really is. (This explains the AutoAbort test, but the lookback may be fixed at 10, not changeable by user.)

^{# $ K +} For Further Reading

Books:

• Choas Under Control, David Peak and Michael Frame

• Complexity, M. Mitchell Waldrop

Magazine Articles:

Computer Programs:

Authors:

Chris Langton