Skip to main content

Class: ModelLoader

Defined in: src/utils/ModelLoader.ts:92

Manages the loading of 3D models, automatically handling dependencies like DRACO and KTX2 loaders as well as dual-backend 3D Gaussian Splatting.

Constructors​

Constructor​

new ModelLoader(manager): ModelLoader

Defined in: src/utils/ModelLoader.ts:104

Creates an instance of ModelLoader.

Parameters​

manager​

LoadingManager = THREE.DefaultLoadingManager

The loading manager to use, required for KTX2 texture support.

Returns​

ModelLoader

Methods​

load()​

load(__namedParameters): Promise<GLTF | RadixSplatObject | SplatMesh & object | null>

Defined in: src/utils/ModelLoader.ts:131

Loads a model based on its file extension. Supports .gltf, .glb, .ply, .spz, .rad, .rdx, .splat, and .ksplat.

Parameters​

__namedParameters​

ModelLoaderLoadOptions

Returns​

Promise<GLTF | RadixSplatObject | SplatMesh & object | null>

A promise that resolves with the loaded model data (e.g., a glTF object, a RadixSplatObject, or a Spark SplatMesh).


loadGLTF()​

loadGLTF(options): Promise<GLTF>

Defined in: src/utils/ModelLoader.ts:270

Loads a GLTF or GLB model.

Parameters​

options​

ModelLoaderLoadGLTFOptions

The loading options.

Returns​

Promise<GLTF>

A promise that resolves with the loaded glTF object.


loadSplat()​

loadSplat(__namedParameters): Promise<RadixSplatObject | SplatMesh & object>

Defined in: src/utils/ModelLoader.ts:164

Loads a 3D Gaussian Splatting model.

@sparkjsdev/radix is built on TSL (NodeMaterial), so it handles all THREE.WebGPURenderer sessions—both native WebGPU compute and WebGPURenderer's WebGL2 + worker-sort fallback (forceWebGL: true). @sparkjsdev/spark is retained for classic THREE.WebGLRenderer (which cannot compile TSL) and legacy .splat / .ksplat assets.

Parameters​

__namedParameters​

ModelLoaderLoadSplatOptions = {}

Returns​

Promise<RadixSplatObject | SplatMesh & object>