ems_rust_template/README.md

# Emscripten Rust/C Template

This is a template for an emscripten project with a "Rust backend".

## Setting up

(Note that this has only been tested in a Linux environment.)

1. Clone `https://github.com/emscripten-core/emsdk` to `${HOME}/git/emsdk`.
2. Set up `emsdk` with `${HOME}/git/emsdk/emsdk install latest` and
`${HOME}/git/emsdk/emsdk activate latest`.
3. Set up `rustup`.
4. Get the `wasm32-unknown-emscripten` target with
`rustup target add wasm32-unknown-emscripten`.

## Build

Just run `make` in the root of this project.

## Other Notes

The current set up of the update/draw loop uses
`emscripten_set_main_loop_arg(...)` with parameters that should call the
browser's `requestAnimationFrame` that should call `update` and `draw` once per
each frame at the fps that the browser decides, which should match the fps of
your display.

If you want to use graphics, I suggest using/building `raylib`, but that will
require building it separately with `emsdk` and linking to it in the Makefile.