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
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
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>