Struct Game 

pub struct Game { /* private fields */ }

A running guest. gasm_frame guests are called once per frame; gasm_run guests run in one suspended call (stack switching) that each Game::frame resumes until its next yield_frame.

Implementations

impl Game

pub fn load(wasm: &[u8], host: Host, opts: LoadOptions) -> Result<Game, Stop>

pub fn compile(wasm: &[u8], allow_precompiled: bool) -> Result<Module, Stop>

Compile a module (or load a .cwasm) for Game::load_module: the slow part of loading, and possible on another thread.

pub fn load_module( module: Module, host: Host, opts: LoadOptions, ) -> Result<Game, Stop>

Instantiate a compiled module and run its init.

pub fn set_asset(&mut self, name: &str, bytes: Vec<u8>) -> u32

Add or replace an asset between frames: the guest sees it from the next frame on, with a new gasm.asset_version. Returns that version.

pub fn remove_asset(&mut self, name: &str) -> bool

Remove an asset between frames. False if there was none.

pub fn watch_asset(&mut self, name: &str, path: &Path)

Re-read path as asset name whenever the file changes (in place or by a rename), checked before each frame.

pub fn add_watch(&mut self, watch: AssetWatch)

Game::watch_asset with a watch made earlier (when the asset was first opened).

pub fn uses_gl(&self) -> bool

Whether the guest imports gasm:gl.

pub fn switching(&self) -> bool

Whether the guest runs through gasm_run (the runner switches stacks).

pub fn frame(&mut self) -> Result<(), Stop>

One frame: call gasm_frame, or resume gasm_run until its next yield_frame.

pub fn exit(&mut self)

Best-effort “the player is quitting” notification (optional gasm_exit export). A suspended gasm_run guest gets it on top of its run, which then ends.

pub fn with_host<R>(&mut self, f: impl FnOnce(&mut Host) -> R) -> R

Run f on the host: directly, or (a suspended gasm_run guest) through the guest’s yield_frame, which owns the store meanwhile. Runners use this between frames for everything they read or set.

pub fn host(&self) -> &Host

The host of a guest that isn’t suspended in gasm_run (every gasm_frame guest; a gasm_run guest before its first frame and after it ended). Otherwise use Game::with_host.

pub fn host_mut(&mut self) -> &mut Host