Struct Session 

pub struct Session {
    pub name: String,
    pub wasm: Vec<u8>,
    pub assets: Assets,
    pub params: HashMap<String, String>,
    pub allow_net: bool,
    pub allow_hosts: Vec<String>,
    pub fetch: FetchMode,
    pub storage: Storage,
    pub load: LoadOptions,
    pub gl_lib: Option<PathBuf>,
    pub gl_software: bool,
    pub watch_assets: Vec<AssetWatch>,
}

Fields

name: String

shown in logs and the window title

wasm: Vec<u8>

a .wasm module, or a .cwasm if load.allow_precompiled

assets: Assets

params: HashMap<String, String>

allow_net: bool

allow_hosts: Vec<String>

with allow_net: only these hosts (--allow-net=a.org,*.b.org; empty: all)

fetch: FetchMode

gasm:fetch: live, recording or replaying responses (headless)

storage: Storage

load: LoadOptions

gl_lib: Option<PathBuf>

where ANGLE is (gasm:gl games): None searches the usual places (angle::find)

gl_software: bool

gasm:gl on SwiftShader (software Vulkan) instead of the GPU

watch_assets: Vec<AssetWatch>

--watch-asset name=path: files re-read as assets whenever they change (create each watch before opening its file, so no change is missed)

Implementations

impl Session

pub fn uses_gl(&self) -> bool

Whether the game imports gasm:gl (it then needs ANGLE to draw).

pub fn open_gl( &self, window: Option<NativeWindow>, size: (u32, u32), ) -> Result<Angle, String>

ANGLE for this session’s gasm:gl game: offscreen at w×h, or in a window.

pub fn start( self, audio: Option<Box<dyn AudioOut>>, gfx: Gfx, gl: Option<Angle>, reproducible: bool, hashing: bool, ) -> Result<Game, Stop>

Instantiate the guest and run its init. reproducible: headless rules (virtual time, fixed random sequence, hashing). gl: the GL that executes a gasm:gl guest’s calls (None: the null GL).