Struct AppConfig 

pub struct AppConfig {

    pub title: String,
    pub width: u32,
    pub height: u32,
    pub vsync: bool,
    pub fixed_timestep: Option<Duration>,
    pub max_frame_time: Duration,
    pub asset_root: PathBuf,
    pub web_preload: Option<Vec<String>>,
    pub canvas_id: Option<String>,
    pub random_seed: u64,
    pub depth_format: Option<TextureFormat>,
    pub msaa_samples: u32,
    pub touch_emulates_mouse: bool,
}

Runtime configuration passed to run.

Construct it with ..Default::default() so new fields added in future minor releases don’t break your call site: AppConfig { title: "game".into(), ..Default::default() }.

Fields

title: String

width: u32

height: u32

vsync: bool

fixed_timestep: Option<Duration>

Some(step) calls update with a fixed dt of step: zero, one or several times per frame, as many as the real time elapsed allows. None (default) calls it once per frame with the frame’s dt. Either way render runs once per frame; with a fixed step, Time::alpha says how far the frame is into the next step, for interpolating motion between steps.

Leave this None if the game steps a simulation itself, e.g. a sillyecs world whose apply_system_phases runs its own fixed phases from real time; otherwise those fixed phases nest inside the toolkit’s steps.

Input edges (key_pressed, mouse_delta, …) are seen by the first update of a frame and carried over to the next frame when no step ran, so presses aren’t dropped.

max_frame_time: Duration

Upper bound on the time one frame advances the game (default 250 ms). After a long frame - the window was dragged, the tab was in the background, a breakpoint hit - the game slows down for that frame instead of fast-forwarding through the gap: dt is capped at this, and with a fixed timestep at most max_frame_time / step updates run. Time::delta still reports the real frame time. Duration::ZERO disables the cap.

asset_root: PathBuf

Asset root directory. Defaults to ./assets. On the web it is a URL path relative to the page, and the files listed in its manifest.txt are fetched before Game::init.

web_preload: Option<Vec<String>>

Web only: asset paths to preload instead of reading manifest.txt. Ignored natively.

canvas_id: Option<String>

Web only: id of an existing <canvas> to render into. None (default) appends a new canvas to <body>. Ignored natively.

random_seed: u64

Seed for deterministic runtime RNG (ctx.rng).

depth_format: Option<TextureFormat>

Depth attachment format. None (default) keeps the 2D path depth-less; Some(fmt) (e.g. wgpu::TextureFormat::Depth32Float) allocates a depth buffer for depth-tested rendering. The built-in 2D pipelines never write depth, so enabling it is harmless.

msaa_samples: u32

MSAA sample count for the surface. 1 (default) disables MSAA; 2/4/8 enable it (the value must be supported by the adapter for the surface format).

touch_emulates_mouse: bool

Let the first finger on a touchscreen act as the mouse: it moves the cursor and presses, holds and releases MouseButton::Left, so a game written for the mouse also works on a phone. Off by default; toggle later with Input::set_touch_emulates_mouse, which has the details. No effect on Windows, where the OS already does this.

Trait Implementations

impl Clone for AppConfig

fn clone(&self) -> AppConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for AppConfig

fn default() -> AppConfig

Returns the “default value” for a type.