X-Git-Url: http://git.subgeniuskitty.com/screensavers/.git/blobdiff_plain/89ff0c45f60d0ed38e6bcd67b8925b0dee7cecc0..6b4b1b563ebbd3ddc4069eff5e56a260f2e92828:/hacks/WolframAutomata/README.md diff --git a/hacks/WolframAutomata/README.md b/hacks/WolframAutomata/README.md index 6bbd56a..d3546d1 100644 --- a/hacks/WolframAutomata/README.md +++ b/hacks/WolframAutomata/README.md @@ -84,23 +84,6 @@ are re-randomized every time the simulation is reset, such as after a simulation completes or after resizing the window. -CLI: Simulation Seed --------------------- - -If none of the following options are specified, the starting seed will contain -randomly interspersed active/inactive cells at a 30/70, 50/50, or 70/30 ratio, -itself also randomly selected. - - - **`-seed-left`**: Seeds a single active cell on the left side of the - display. All other cells are inactive. - - - **`-seed-center`**: As above, but in the center. - - - **`-seed-right`**: As above, but on the right side. - - - **`-seed-density N`**: Generates random seed with `N` percent active cells. - - CLI: Rule Selection ------------------- @@ -114,21 +97,26 @@ from `curated_ruleset_list[]` in `WolframAutomata.c`. from 0-255 inclusive are valid. -CLI: Simulation Speed ---------------------- +CLI: Simulation Seed +-------------------- -If neither of the following two options are passed, the simulation runs as -though `-delay 25000` was passed. +The following seed related CLI flags apply only when using the +`-true-random-rule` or `-rule N` flags. Without these flags, the program draws +rules from `curated_ruleset_list[]` which also includes curated seeds, all of +which override any seed related CLI flags. - - **`-random-delay`**: A random delay is selected, but not truly random. For - more details, read `WolframAutomata.c` starting around the comment, "When - randomly setting the delay, the problem is to avoid ..." +If the curated rule list is not in use and none of the following options are +specified, the starting seed will contain randomly interspersed active/inactive +cells at a 30/70, 50/50, or 70/30 ratio, itself also randomly selected. - - **`-delay N`**: Request `N` microsecond delay between each frame/generation - of the simulation. Note that this is only a request; XScreensaver reserves - the right to ignore requested values, and of course we execute at the mercy - of the kernel's scheduling. In practice, non-absurd values are reasonably - well respected. + - **`-seed-left`**: Seeds a single active cell on the left side of the + display. All other cells are inactive. + + - **`-seed-center`**: As above, but in the center. + + - **`-seed-right`**: As above, but on the right side. + + - **`-seed-density N`**: Generates random seed with `N` percent active cells. CLI: Simulation Length @@ -149,6 +137,23 @@ generations is cell_size dependent. This is a soft limit and may be increased if ..." +CLI: Simulation Speed +--------------------- + +If neither of the following two options are passed, the simulation runs as +though `-delay 25000` was passed. + + - **`-random-delay`**: A random delay is selected, but not truly random. For + more details, read `WolframAutomata.c` starting around the comment, "When + randomly setting the delay, the problem is to avoid ..." + + - **`-delay N`**: Request `N` microsecond delay between each frame/generation + of the simulation. Note that this is only a request; XScreensaver reserves + the right to ignore requested values, and of course we execute at the mercy + of the kernel's scheduling. In practice, non-absurd values are reasonably + well respected. + + CLI: Cell Dimensions --------------------