Struct Engine 

pub struct Engine;

A zero-sized namespace struct providing static engine entry points.

This struct follows the same pattern as euv::App, serving as the single root namespace for all top-level engine operations: creating engine handles, initializing rendering backends, and starting the fixed-timestep game loop.

All engine usage flows through Engine::xxx static calls, mirroring how euv::App::use_signal / euv::App::mount are the public entry points of the core framework.

Implementations

impl Engine

Implements the top-level static engine entry points on the Engine namespace.

Mirrors the role of euv::App: every public engine operation begins with an Engine::xxx call, and Engine itself holds no state.

pub fn new_handle(config: EngineConfig) -> EngineHandle

Creates a new engine handle bound to the given configuration.

The handle is uninitialized; call init_canvas / init_webgpu and start on the returned handle to begin the game loop, or use Engine::run for the one-line equivalent.

Arguments

• EngineConfig - The engine configuration.

Returns

• EngineHandle - The new uninitialized engine handle.

pub async fn run(config: EngineConfig, handler: TickHandlerRc) -> EngineHandle

Runs the engine through its complete lifecycle in a single async call.

Equivalent to calling Engine::new_handle(config) followed by init_canvas / init_webgpu (matching the chosen backend) and start(handler). The returned handle can still be used to stop the loop later via handle.stop().

Arguments

• EngineConfig - The engine configuration.
• TickHandlerRc - The tick handler receiving update and render callbacks.

Returns

• EngineHandle - A handle to the running engine. If renderer initialization failed the handle’s renderer field will be None and is_running will be false. Initialization errors are not logged inside the engine; callers should call init_webgpu directly if they need access to the typed WebGpuInitError.

pub fn default_config() -> EngineConfig

Returns the default engine configuration.

Uses RenderConfig::default() (Canvas 2D backend) and the default scheduler configuration (60 Hz fixed timestep).

Returns

• EngineConfig - The default engine configuration.

pub fn canvas_renderer(config: &RenderConfig) -> Option<CanvasRenderer>

Creates a Canvas 2D renderer directly from a render configuration.

Use this when you want a CanvasRenderer without going through the full EngineHandle lifecycle (for example, in a custom render loop that does not use the fixed-timestep scheduler).

Arguments

• &RenderConfig - The rendering configuration.

Returns

• Option<CanvasRenderer> - The renderer, or None if the canvas element was not found.

pub async fn webgpu_renderer( config: &RenderConfig, ) -> Result<WebGpuRenderer, WebGpuInitError>

Creates a WebGPU renderer directly from a render configuration.

Async because GPU adapter and device acquisition returns JavaScript Promises that must be awaited. Mirrors Engine::canvas_renderer for callers that want the renderer without the full engine handle.

Failures are surfaced as WebGpuInitError so the caller can decide how to react (typically by logging via Console::error or by falling back to the Canvas 2D backend).

Arguments

• &RenderConfig - The rendering configuration.

Returns

• Result<WebGpuRenderer, WebGpuInitError> - The initialized renderer, or a typed error describing the specific failure.

Trait Implementations

impl Clone for Engine

fn clone(&self) -> Engine

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Engine

impl Debug for Engine

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Engine

fn default() -> Engine

Returns the “default value” for a type.

impl Eq for Engine

impl Hash for Engine

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Engine

fn cmp(&self, other: &Engine) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Engine

fn eq(&self, other: &Engine) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialOrd for Engine

fn partial_cmp(&self, other: &Engine) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for Engine