FragmentsModels

The main class for managing multiple 3D models loaded from fragments files. Handles loading, disposing, updating, raycasting, highlighting and coordinating multiple FragmentsModel instances. This class acts as the main entry point for working with fragments models. A FragmentsModels instance needs a worker to process fragments off the main thread. The recommended way to obtain the worker URL is via the static FragmentsModels.getWorker method, which fetches the version-matched worker from unpkg. Check the method docs for more info.

Constructors

new FragmentsModels()

new FragmentsModels(workerURL?, options?): FragmentsModels

Creates a new FragmentsModels instance.

The recommended way to obtain the worker URL is via FragmentsModels.getWorker, which fetches the version-matched worker from unpkg. See its docs for an example.

Parameters

Parameter	Type	Description
workerURL?	string	The URL of the worker script that will handle the fragments processing. If omitted, it falls back to the worker bundled with the package (only works with bundlers that can resolve new URL("./Worker/worker.mjs", import.meta.url)).
options?	object	Optional configuration.
options.classicWorker?	boolean	If true, creates classic (non-module) workers. Use together with toClassicWorker().

Returns

FragmentsModels

Properties

baseCoordinates

baseCoordinates: null | number[] = null

Coordinates of the first loaded model, used for coordinate system alignment

---

editor

editor: Editor

The editor instance for managing model edits and changes

---

models

models: MeshManager

The manager that handles all loaded fragments models. Provides functionality to:

• Store and retrieve models by ID
• Track model loading/unloading
• Coordinate updates across models
• Handle model disposal

---

settings

settings: object

Settings that control the behavior of the FragmentsModels system

autoCoordinate

autoCoordinate: boolean = true

Whether to automatically coordinate model positions relative to the first loaded model

forceUpdateBuffer

forceUpdateBuffer: number = 200

Force update buffer time in milliseconds

forceUpdateRate

forceUpdateRate: number = 200

Force update rate in milliseconds

graphicsQuality

graphicsQuality: number = 0

Graphics quality level - 0 is low quality, 1 is high quality

maxUpdateRate

maxUpdateRate: number = 100

Maximum rate (in milliseconds) at which visual updates are performed

Methods

abort()

abort(modelId): void

Aborts an in-flight load() for the given model ID. The pending load() promise will reject with a LoadAbortedError and any partial state (on both the main thread and the worker) is disposed.

Has no effect if the model finished loading or isn't currently loading.

Parameters

Parameter	Type	Description
modelId	string	The unique identifier of the model to abort.

Returns

void

---

dispose()

dispose(): Promise<void>

Disposes of all models managed by this FragmentsModels instance. After calling this method, the FragmentsModels instance should not be used anymore.

Returns

Promise<void>

---

disposeModel()

disposeModel(modelId): Promise<void>

Disposes of a specific model by its ID.

Parameters

Parameter	Type	Description
modelId	string	The unique identifier of the model to dispose.

Returns

Promise<void>

---

load()

load(buffer, options): Promise <FragmentsModel>

Loads a fragments model from an ArrayBuffer.

Parameters

Parameter	Type	Description
buffer	Uint8Array | ArrayBuffer	The ArrayBuffer containing the fragments data to load.
options	object	Configuration options for loading the model.
options.camera?	PerspectiveCamera | OrthographicCamera	Optional camera to use for model culling and LOD.
options.modelId	string	Unique identifier for the model.
options.onProgress?	(event) => void	Optional callback for receiving loading progress updates.
options.raw?	boolean	If true, loads raw (uncompressed) data. Default is false.
options.userData?	Record<string, any>	Optional custom data to attach to the model.
options.virtualModelConfig?	VirtualModelConfig	Optional configuration for virtual model setup.

Returns

Promise <FragmentsModel>

Promise resolving to the loaded FragmentsModel instance.

---

update()

update(force): Promise<void>

Updates all models managed by this FragmentsModels instance.

Parameters

Parameter	Type	Default value	Description
force	boolean	false	If true, it will force all the models to finish all the pending requests.

Returns

Promise<void>

---

getWorker()

static getWorker(): Promise<string>

Fetches the fragments worker from unpkg for the exact version of this @thatopen/fragments package and returns a blob URL you can pass to the FragmentsModels constructor. The result is cached, so calling this method more than once is cheap.

This is the recommended way to obtain the worker URL — it guarantees the worker version matches the library version and requires no copying of files into your project.

Returns

Promise<string>

A blob URL pointing to the fragments worker script.

Example

const workerURL = await FragmentsModels.getWorker();
const fragments = new FragmentsModels(workerURL);

Events

onModelLoaded

readonly onModelLoaded: Event <FragmentsModel>

Event triggered when a model is loaded.