Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/borisboutillier/rs-cellular-automata
Rust playground project on 1-dimension cellular automata, with command line and gtk GUI and WASM implementation
https://github.com/borisboutillier/rs-cellular-automata
cellular-automaton cli gtk gtk3 rust rust-lang wasm wasm-bindgen wasm-example wasm-pack
Last synced: 2 months ago
JSON representation
Rust playground project on 1-dimension cellular automata, with command line and gtk GUI and WASM implementation
- Host: GitHub
- URL: https://github.com/borisboutillier/rs-cellular-automata
- Owner: BorisBoutillier
- License: mit
- Created: 2020-04-27T15:49:49.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-01-07T18:04:06.000Z (almost 2 years ago)
- Last Synced: 2024-10-10T20:11:09.373Z (3 months ago)
- Topics: cellular-automaton, cli, gtk, gtk3, rust, rust-lang, wasm, wasm-bindgen, wasm-example, wasm-pack
- Language: Rust
- Homepage:
- Size: 1.01 MB
- Stars: 8
- Watchers: 1
- Forks: 1
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Cellular automata
This is playground project to tackle the Rust language.
The goal is to play around with 1-dimension cellular automata with different kind of user interaction, CLI, GUI or WEB.
The workspace consist in 4 crates:
- automata-lib : The main library that contains the automata computation and its rules.
- automata-cli : a CLI interface to automata-lib with output as text or direct image file.
- automata-gtk : a GUI interface to automata-lib in GTK.
- automata-wasm : A web page using WASM for interfacing with automata-lib and javascript for gui part
# Compiling
## Prerequisites
* [rust](https://www.rust-lang.org)
* [wasm-pck](https://rustwasm.github.io/wasm-pack/installer/)
* [npm](https://www.npmjs.com/get-npm)
## Compiling
The compilation for automata-lib, automata-cli and automata-gtk is simply using cargo build command:
```sh
cargo build --release
```
The compilation for automata-wasm requires using wasm-pack:
```sh
cd automata-wasm
wasm-pack build
```
# CLI
Help for all available option
```sh
automata-cli --help
```
## text output in the terminal
```sh
automata-cli --colors 2 --rule 30 --steps=10 --width=20
```
```
| * |
| *** |
| ** * |
| ** **** |
| ** * * |
| ** **** *** |
| ** * * * |
| ** **** ****** |
| ** * *** * |
| ** **** ** * ***|
```
## image output
```sh
automata-cli --colors 4 --rule 16673 --steps 320 --width 640 --output 4C_16673.320.png
```
# GUI
GUI with all controls is simply launched with :
```sh
automata-gtk
```
# WASM
To start the web-page using npm , after building with wasm-pack :
```sh
cd automata-wasm/www
npm install
npm run star
```
You can then open your browser on localhost:8080/ and play with cellular automata !
