Interface WebGPUDeviceRecoveryDeps

Host side-effects, passed once at construction.

interface WebGPUDeviceRecoveryDeps {
    getDevice(): GpuDeviceLike | undefined;
    recreateRenderer(): Promise<boolean>;
    onLost(info: DeviceLostInfo): void;
    onRestored(): void;
    onUnrecoverable(info: DeviceLostInfo): void;
    delay?: (ms: number) => Promise<void>;
    retryDelayMs?: number;
}

Index

Properties

delay? retryDelayMs?

Methods

getDevice recreateRenderer onLost onRestored onUnrecoverable

Properties

`Optional`delay

delay?: (ms: number) => Promise<void>

Wait before the second attempt. Injected for tests; defaults to setTimeout.

`Optional`retryDelayMs

retryDelayMs?: number

Pause between the two attempts (ms).

Methods

getDevice

getDevice(): GpuDeviceLike | undefined
The device the CURRENT renderer draws with; undefined on the WebGL2 bridge.

Returns GpuDeviceLike | undefined
- Defined in src/scene/scene-manager/render-pipeline/webgpu-device-recovery.ts:45

recreateRenderer

recreateRenderer(): Promise<boolean>
Build a renderer on a fresh native device and rewire the host to it. Resolves false (or rejects) when no native device could be obtained.

Returns Promise<boolean>
- Defined in src/scene/scene-manager/render-pipeline/webgpu-device-recovery.ts:50

onLost

onLost(info: DeviceLostInfo): void
The device was lost without an explicit destroy; recovery starts right after.
Parameters
- info: DeviceLostInfo
Returns void
- Defined in src/scene/scene-manager/render-pipeline/webgpu-device-recovery.ts:52

onRestored

onRestored(): void
A new renderer is live and the scene has been rewired to it.

Returns void
- Defined in src/scene/scene-manager/render-pipeline/webgpu-device-recovery.ts:54

onUnrecoverable

onUnrecoverable(info: DeviceLostInfo): void
Every attempt failed; the page has to reload.
Parameters
- info: DeviceLostInfo
Returns void
- Defined in src/scene/scene-manager/render-pipeline/webgpu-device-recovery.ts:56