The RMF Site Editor

The RMF Site Editor is an experimental approach to visualizing and editing large RMF deployment sites. It is built in Rust using Bevy, an open-source Rust-based game engine.

Rust and Bevy allow The RMF Site Editor to target both desktop (Windows/Linux/Mac) and web (WebAssembly+WebGL/WebGPU) using the same codebase:

• Web build: the browser application provides maximum convenience, since there is nothing to build or install.
• Desktop build: maximum performance, thanks to multithreading and lower-level GPU integration.

Click here to use the web build in your browser.

Helpful Links

• Bevy Engine
• Bevy Cheat Book
• Rust Book

Install dependencies (Ubuntu 20.04)

We need a newer Rust than what comes with Ubuntu 20.04.

First make sure you don't have any distro-installed Rust stuff on your machine:

$ sudo apt remove rustc cargo

If you don't have it already, install rustup from the Rust website: https://www.rust-lang.org/tools/install

$ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Just select the normal defaults (option 1). A bunch of stuff will happen. Be sure to close and re-open your terminal afterwards, so that it gets all the new stuff.

Alternatively, if you already have a Rust installation managed by rustup, you can just do this to bring it up-to-date: rustup update

Finally, we need some library packages:

$ sudo apt install libgtk-3-dev libasound2-dev libudev-dev

Install dependencies (Windows 11)

Make sure you install rust from the main rust website. Cargo should take care of the rest of the magic for you.

⚠️ Note: If you are building inside of a Windows Subsystem for Linux (WSL) environment, you should follow the Ubuntu instructions. We do not have build instructions for other choices of Linux distros inside of WSL.

Install extra dependencies for WebAssembly

These are only needed if you're going to build a WebAssembly binary:

$ sudo apt install binaryen
$ cargo install wasm-bindgen-cli basic-http-server
$ rustup target add wasm32-unknown-unknown

Build and Run (Desktop)

Currently tested on Ubuntu 20.04.4 LTS and windows 11.

From the root directory:

$ cargo run

Use the --features bevy/dynamic_linking flag to improve compile time through dynamic linking. Use the --release flag for better runtime performance.

Build and Run (WebAssembly)

TODO: The web assembly version is highly experimental, currently it lacks important features like saving/loading of map files.

$ scripts/build-web.sh
$ scripts/serve-web.sh

Then use your favorite web browser to visit http://localhost:1234