WasmGPU.run¶

Summary¶

WasmGPU.run starts the engine frame loop and invokes your callback once per animation frame. Inside the callback, you typically update scene state and issue one render call for the active scene/camera. The loop also feeds PerformanceStats (if enabled) with per-frame timing data. Calling run() while the loop is already active is a no-op; stop the loop before replacing its callback.

Syntax¶

WasmGPU.run(callback: (dt: number, time: number, wgpu: WasmGPU) => void): void
wgpu.run(callback);

Parameters¶

Name	Type	Required	Description
`callback`	`(dt: number, time: number, wgpu: WasmGPU) => void`	Yes	Synchronous frame callback receiving delta-time seconds, the `requestAnimationFrame` timestamp converted to seconds, and the active engine instance.

Returns¶

void - Starts the RAF loop; no value is returned.

Example¶

const canvas = document.querySelector("canvas");
const wgpu = await WasmGPU.create(canvas);
const scene = wgpu.createScene([0.04, 0.05, 0.08]);
const camera = wgpu.createCamera.perspective({ fov: 60, aspect: canvas.width / Math.max(1, canvas.height), near: 0.1, far: 1000 });
camera.transform.setPosition(0, 0, 4);
wgpu.run((dt, time, engine) => {
    camera.transform.setPosition(Math.sin(time) * 0.5, 0, 4);
    engine.render(scene, camera);
});