Interface AssetResolver

Caller-supplied asset resolution for component construction. Every method is optional; a factory that needs one the resolver doesn't provide should degrade gracefully (e.g. leave a placeholder). All are async — factories build the component synchronously and fill the asset in when the promise resolves, exactly as the editor's load path does.

interface AssetResolver {
    loadAssembly?(asset: string): Promise<AssemblyDoc>;
    loadMesh?(
        ref: { type: "gltf"; asset: string },
        device: GPUDevice,
    ): Promise<Mesh>;
    loadMaterial?(ref: MaterialRef, device: GPUDevice): Promise<Material>;
    readBytes?(ref: string): Promise<ArrayBuffer>;
    resolvePath?(ref: string): Promise<string | null>;
}

Implemented by

PackAssetResolver

Index

Methods

loadAssembly? loadMesh? loadMaterial? readBytes? resolvePath?

Methods

`Optional`loadAssembly

loadAssembly?(asset: string): Promise<AssemblyDoc>
Load a referenced assembly (by opaque guid) for a nested / scene-node link.
Parameters
- asset: string
Returns Promise<AssemblyDoc>
- Defined in src/engine/scene_runtime/component_factory.ts:54

`Optional`loadMesh

loadMesh?(
ref: { type: "gltf"; asset: string },
device: GPUDevice,
): Promise<Mesh>
Load a glTF mesh referenced by a { type: 'gltf' } MeshRef.
Parameters
- ref: { type: "gltf"; asset: string }
- device: GPUDevice
Returns Promise<Mesh>
- Defined in src/engine/scene_runtime/component_factory.ts:56

`Optional`loadMaterial

loadMaterial?(ref: MaterialRef, device: GPUDevice): Promise<Material>
Load a material referenced by a .material / .mtlx asset reference.
Parameters
- ref: MaterialRef
- device: GPUDevice
Returns Promise<Material>
- Defined in src/engine/scene_runtime/component_factory.ts:58

`Optional`readBytes

readBytes?(ref: string): Promise<ArrayBuffer>
Resolve an asset reference (opaque guid/path) to bytes.
Parameters
- ref: string
Returns Promise<ArrayBuffer>
- Defined in src/engine/scene_runtime/component_factory.ts:60

`Optional`resolvePath

resolvePath?(ref: string): Promise<string | null>
Resolve an opaque asset reference to a project-relative path (editor IPC analog).
Parameters
- ref: string
Returns Promise<string | null>
- Defined in src/engine/scene_runtime/component_factory.ts:62