FragmentsModel

The main class for managing a 3D model loaded from a fragments file. Handles geometry, materials, visibility, highlighting, sections, and more. This class orchestrates multiple specialized managers to handle different aspects of the model like mesh management, item data, raycasting, etc. It maintains the overall state and provides the main interface for interacting with the model. The model data is loaded and processed asynchronously across multiple threads.

Constructors

new FragmentsModel()

new FragmentsModel(modelId, meshManager, threads, editor): FragmentsModel

The constructor of the fragments model. Don't use this directly. Use the FragmentsModels.load instead.

Parameters

Parameter	Type
modelId	string
meshManager	MeshManager
threads	FragmentsConnection
editor	Editor

Returns

FragmentsModel

Properties

attrsChanges

readonly attrsChanges: Map<number, AttrsChange>

A map of attribute changes that have occurred in the model. The key is the local ID of the item, and the value is the change.

---

graphicsQuality

graphicsQuality: number = 0

The graphics quality of the model. It ranges from 0 (lowest) to 1 (highest).

---

object

object: Object3D<Object3DEventMap>

The object that represents the model in the Three.js scene.

---

relsChanges

readonly relsChanges: Map<number, RelsModifyChange>

A map of relation changes that have occurred in the model. The key is the local ID of the item, and the value is the change.

---

threads

readonly threads: FragmentsConnection

The connection to the threads that handle the model data.

---

tiles

readonly tiles: DataMap<string | number, BIMMesh>

A map of tiles that have been loaded for the model. The key is the tile ID, and the value is the tile.

Accessors

box

get box(): Box3

The bounding box of the whole model.

Returns

Box3

---

frozen

get frozen(): boolean

Whether the model should stop updating..

set frozen(value): void

Whether the model should stop updating..

Parameters

Parameter	Type
value	boolean

Returns

boolean

---

getClippingPlanesEvent

get getClippingPlanesEvent(): () => Plane[]

The event that is triggered when the clipping planes are needed in the thread. Set this method to pass your Three.js clipping planes to the model.

set getClippingPlanesEvent(value): void

The event that is triggered when the clipping planes are needed in the thread. Set this method to pass your Three.js clipping planes to the model.

Parameters

Parameter	Type
value	() => Plane[]

Returns

Function

Returns

Plane[]

---

isBusy

get isBusy(): boolean

Whether the model is busy loading data.

Returns

boolean

---

modelId

get modelId(): string

The ID of the model.

Returns

string

Methods

_edit()

_edit(requests): Promise<object>

Internal method to edit the model. Don't use this directly.

Parameters

Parameter	Type	Description
requests	EditRequest[]	The requests to edit the model.

Returns

Promise<object>

deltaModelBuffer

deltaModelBuffer: Uint8Array

ids

ids: number[]

---

_finishProcessing()

_finishProcessing(): void

Internal method to finish processing. Don't use this directly.

Returns

void

---

_getRequests()

_getRequests(): Promise<object>

Internal method to get the requests of the model. Don't use this directly.

Returns

Promise<object>

requests

requests: EditRequest[]

undoneRequests

undoneRequests: EditRequest[]

---

_refreshView()

_refreshView(): Promise<void>

Internal method to refresh the view of the model. You shouldn't call this directly. Instead, use FragmentsModels.update.

Returns

Promise<void>

---

_reset()

_reset(): Promise<void>

Internal method to reset the model. Don't use this directly.

Returns

Promise<void>

---

_save()

_save(): Promise<Uint8Array>

Internal method to save the model. Don't use this directly.

Returns

Promise<Uint8Array>

---

_selectRequest()

_selectRequest(index): Promise<void>

Internal method to select a request of the model. Don't use this directly.

Parameters

Parameter	Type	Description
index	number	The index of the request to select.

Returns

Promise<void>

---

_setRequests()

_setRequests(data): Promise<void>

Internal method to set the requests of the model. Don't use this directly.

Parameters

Parameter	Type	Description
data	object	The data to set the requests of the model.
data.requests?	EditRequest[]	-
data.undoneRequests?	EditRequest[]	-

Returns

Promise<void>

---

_setup()

_setup(data, raw?, config?): Promise<void>

Internal method to set up the model. Don't use this directly.

Parameters

Parameter	Type
data	Uint8Array | ArrayBuffer
raw?	boolean
config?	VirtualModelConfig

Returns

Promise<void>

---

dispose()

dispose(): Promise<void>

Dispose the model. Use this when you're done with the model. If you use the FragmentsModels.dispose method, this will be called automatically for all models.

Returns

Promise<void>

---

getAlignmentStyles()

getAlignmentStyles(): Promise<object>

Get the civil alignment styles of the model (if any).

Returns

Promise<object>

exterior

exterior: PointsMaterial

interior

interior: PointsMaterial

---

getAlignments()

getAlignments(): Promise<Group<Object3DEventMap>>

Get the absolute alignments of the model (if any).

Returns

Promise<Group<Object3DEventMap>>

---

getAttributeNames()

getAttributeNames(): Promise<string[]>

Retrieves the names of all attributes associated with the model.

Returns

Promise<string[]>

A promise that resolves to an array of strings, where each string is the name of an attribute.

---

getAttributeTypes()

getAttributeTypes(): Promise<string[]>

Retrieves the attribute types associated with the model.

Returns

Promise<string[]>

A promise that resolves to an array of attribute types.

---

getAttributeValues()

getAttributeValues(): Promise<any[]>

Retrieves the attribute values associated with the model.

Returns

Promise<any[]>

A promise that resolves to an array of attribute values.

---

getBoxes()

getBoxes(localIds?): Promise<Box3[]>

Get the individual bounding boxes of the specified items.

Parameters

Parameter	Type	Description
localIds?	number[]	The local IDs of the items to look up.

Returns

Promise<Box3[]>

---

getBuffer()

getBuffer(raw): Promise<ArrayBuffer>

Get the buffer of the model.

Parameters

Parameter	Type	Default value	Description
raw	boolean	false	Whether to get the raw buffer. If false, it will be compressed.

Returns

Promise<ArrayBuffer>

---

getCategories()

getCategories(): Promise<string[]>

Get all the categories of the model.

Returns

Promise<string[]>

---

getCoordinates()

getCoordinates(): Promise<number[]>

Gets coordinates of the model.

Returns

Promise<number[]>

---

getCoordinationMatrix()

getCoordinationMatrix(): Promise<Matrix4>

Retrieves the coordination matrix for the current model.

This method utilizes the _coordinatesManager to compute and return a THREE.Matrix4 object based on the original model coordinates.

Returns

Promise<Matrix4>

---

getEditedElements()

getEditedElements(): Promise<number[]>

Gets the edited elements of the model.

Returns

Promise<number[]>

---

getGlobalTranformsIdsOfItems()

getGlobalTranformsIdsOfItems(ids): Promise<number[]>

Gets the global transforms IDs of the items of the model.

Parameters

Parameter	Type	Description
ids	number[]	The local IDs of the items to get the global transforms IDs of.

Returns

Promise<number[]>

---

getGlobalTransforms()

getGlobalTransforms(localIds?): Promise<Map<number, RawGlobalTransformData>>

Gets the global transforms of the model.

Parameters

Parameter	Type	Description
localIds?	Iterable<number>	The local IDs of the global transforms to get. If undefined, it will return all global transforms.

Returns

Promise<Map<number, RawGlobalTransformData>>

---

getGlobalTransformsIds()

getGlobalTransformsIds(): Promise<number[]>

Gets all the global transforms IDs of the model.

Returns

Promise<number[]>

---

getGrids()

getGrids(): Promise<Group<Object3DEventMap>>

Get the grids of the model (if any).

Returns

Promise<Group<Object3DEventMap>>

---

getGuidsByLocalIds()

getGuidsByLocalIds(localIds): Promise<(null | string)[]>

Get the GUIDs corresponding to the specified local IDs.

Parameters

Parameter	Type	Description
localIds	number[]	Array of local IDs to look up.

Returns

Promise<(null | string)[]>

---

getHighlight()

getHighlight(localIds?): Promise <MaterialDefinition[]>

Gets the highlight of the specified items.

Parameters

Parameter	Type	Description
localIds?	number[]	The local IDs of the items to get the highlight of. If undefined, it will return the highlight of all items.

Returns

Promise <MaterialDefinition[]>

---

getHighlightItemIds()

getHighlightItemIds(): Promise<number[]>

Gets the item IDs of the items that are highlighted.

Returns

Promise<number[]>

---

getHorizontalAlignments()

getHorizontalAlignments(): Promise<Group<Object3DEventMap>>

Get the horizontal alignments of the model (if any).

Returns

Promise<Group<Object3DEventMap>>

---

getItem()

getItem(id): Item

Get an item by its ID.

Parameters

Parameter	Type	Description
id	Identifier	The ID of the item to look up.

Returns

Item

---

getItems()

getItems(localIds?): Promise<Map<number, RawItemData>>

Gets the items of the model.

Parameters

Parameter	Type	Description
localIds?	Iterable<number>	The local IDs of the items to get. If undefined, it will return all items.

Returns

Promise<Map<number, RawItemData>>

---

getItemsByQuery()

getItemsByQuery(params, config?): Promise<number[]>

Retrieves items based on the specified query parameters.

Parameters

Parameter	Type	Description
params	ItemsQueryParams	The query parameters used to filter and retrieve items.
config?	ItemsQueryConfig	-

Returns

Promise<number[]>

A promise that resolves to the items matching the query.

---

getItemsByVisibility()

getItemsByVisibility(visible): Promise<number[]>

Gets the items by visibility.

Parameters

Parameter	Type	Description
visible	boolean	Whether the items should be visible.

Returns

Promise<number[]>

---

getItemsChildren()

getItemsChildren(ids): Promise<number[]>

Get the spatial structure children of the specified items.

Parameters

Parameter	Type	Description
ids	Identifier[]	The IDs of the items to look up.

Returns

Promise<number[]>

---

getItemsData()

getItemsData(ids, config?): Promise <ItemData[]>

Get all the data of the specified items.

Parameters

Parameter	Type	Description
ids	Identifier[]	The IDs of the items to look up.
config?	Partial <ItemsDataConfig>	The configuration of the items data.

Returns

Promise <ItemData[]>

---

getItemsGeometry()

getItemsGeometry(localIds, lod): Promise <MeshData[][]>

Retrieves the geometry data for the specified local IDs.

The returned data is structured as an array of arrays of MeshData, which contains the necessary information to reconstruct a THREE.BufferGeometry.

Parameters

Parameter	Type	Default value	Description
localIds	number[]	undefined	An array of local IDs for which the geometry data is requested.
lod	CurrentLod	CurrentLod.GEOMETRY	-

Returns

Promise <MeshData[][]>

---

getItemsIds()

getItemsIds(): Promise<number[]>

Gets all the items IDs of the model.

Returns

Promise<number[]>

---

getItemsIdsWithGeometry()

getItemsIdsWithGeometry(): Promise<number[]>

Get all the items ids of the model that have geometry.

Returns

Promise<number[]>

---

getItemsOfCategories()

getItemsOfCategories(categories): Promise<object>

Get all the items of the model that belong to the specified category.

Parameters

Parameter	Type
categories	RegExp[]

Returns

Promise<object>

---

getItemsVolume()

getItemsVolume(localIds): Promise<number>

Retrieves the total volume of items based on their local IDs.

Parameters

Parameter	Type	Description
localIds	number[]	An array of local IDs representing the items.

Returns

Promise<number>

A promise that resolves to the total volume of the specified items.

---

getItemsWithGeometry()

getItemsWithGeometry(): Promise<Item[]>

Get all the items of the model that have geometry.

Returns

Promise<Item[]>

---

getLocalIdsByGuids()

getLocalIdsByGuids(guids): Promise<(null | number)[]>

Get the local IDs corresponding to the specified GUIDs.

Parameters

Parameter	Type	Description
guids	string[]	Array of GUIDs to look up.

Returns

Promise<(null | number)[]>

---

getLocalTransforms()

getLocalTransforms(localIds?): Promise<Map<number, RawTransformData>>

Gets the local transforms of the model.

Parameters

Parameter	Type	Description
localIds?	Iterable<number>	The local IDs of the local transforms to get. If undefined, it will return all local transforms.

Returns

Promise<Map<number, RawTransformData>>

---

getLocalTransformsIds()

getLocalTransformsIds(): Promise<number[]>

Gets all the local transforms IDs of the model.

Returns

Promise<number[]>

---

getMaterials()

getMaterials(localIds?): Promise<Map<number, RawMaterial>>

Gets the materials of the model.

Parameters

Parameter	Type	Description
localIds?	Iterable<number>	The local IDs of the materials to get. If undefined, it will return all materials.

Returns

Promise<Map<number, RawMaterial>>

---

getMaterialsIds()

getMaterialsIds(): Promise<number[]>

Gets all the materials IDs of the model.

Returns

Promise<number[]>

---

getMaxLocalId()

getMaxLocalId(): Promise<number>

Get the maximum local ID of the model.

Returns

Promise<number>

---

getMergedBox()

getMergedBox(localIds): Promise<Box3>

Get the merged bounding box of the specified items.

Parameters

Parameter	Type	Description
localIds	number[]	The local IDs of the items to look up.

Returns

Promise<Box3>

---

getMetadata()

getMetadata<T>(): Promise<T>

Get the metadata of the model.

Type parameters

Type parameter	Value
T extends Record<string, any>	Record<string, any>

Returns

Promise<T>

---

getPositions()

getPositions(localIds?): Promise<Vector3[]>

Get the absolute positions of the specified items.

Parameters

Parameter	Type	Description
localIds?	number[]	The local IDs of the items to look up.

Returns

Promise<Vector3[]>

---

getRelationNames()

getRelationNames(): Promise<string[]>

Retrieves the names of all relations associated with this model.

Returns

Promise<string[]>

A promise that resolves to an array of strings, where each string is the name of a relation.

---

getRelations()

getRelations(localIds?): Promise<Map<number, RawRelationData>>

Gets the relations of the model.

Parameters

Parameter	Type	Description
localIds?	number[]	The local IDs of the relations to get. If undefined, it will return all relations.

Returns

Promise<Map<number, RawRelationData>>

---

getRepresentations()

getRepresentations(localIds?): Promise<Map<number, RawRepresentation>>

Gets the representations of the model.

Parameters

Parameter	Type	Description
localIds?	Iterable<number>	The local IDs of the representations to get. If undefined, it will return all representations.

Returns

Promise<Map<number, RawRepresentation>>

---

getRepresentationsIds()

getRepresentationsIds(): Promise<number[]>

Gets all the representations IDs of the model.

Returns

Promise<number[]>

---

getSamples()

getSamples(localIds?): Promise<Map<number, RawSample>>

Gets the samples of the model.

Parameters

Parameter	Type	Description
localIds?	Iterable<number>	The local IDs of the samples to get. If undefined, it will return all samples.

Returns

Promise<Map<number, RawSample>>

---

getSamplesIds()

getSamplesIds(): Promise<number[]>

Gets all the samples IDs of the model.

Returns

Promise<number[]>

---

getSection()

getSection(plane, localIds?): Promise<ModelSection>

Gets the section (edges and fills) between the model and a given clipping plane.

Parameters

Parameter	Type	Description
plane	Plane	The plane to get the section of.
localIds?	number[]	-

Returns

Promise<ModelSection>

---

getSequenced()

Experimental

getSequenced<T, U>(result, fromItems, inputs?): Promise <InformationResultType<T>>

Processes a sequence of actions in the worker and computes the result based on the provided input.

Type parameters

Type parameter
T extends ItemInformationType
U extends ItemSelectionType

Parameters

Parameter	Type	Description
result	T	The type of item information to compute, used to select the appropriate result function.
fromItems	U[]	An array of selection types, each corresponding to an items selector function.
inputs?	object	-
inputs.result?	ResultInputType<T>	-
inputs.selector?	Partial<Record<U, SelectionInputType<U>>>	-

Returns

Promise <InformationResultType<T>>

The computed result after processing the sequence of actions, or null if the result function is not found.

---

getSpatialStructure()

getSpatialStructure(): Promise <SpatialTreeItem>

Get the spatial structure of the model.

Returns

Promise <SpatialTreeItem>

---

getVerticalAlignments()

getVerticalAlignments(): Promise<Group<Object3DEventMap>>

Get the vertical alignments of the model (if any).

Returns

Promise<Group<Object3DEventMap>>

---

getVisible()

getVisible(localIds): Promise<boolean[]>

Gets the items by visibility.

Parameters

Parameter	Type	Description
localIds	number[]	The local IDs of the items to get the visibility of.

Returns

Promise<boolean[]>

---

highlight()

highlight(localIds, highlightMaterial): Promise<void>

Highlights the specified items.

Parameters

Parameter	Type	Description
localIds	undefined | number[]	The local IDs of the items to highlight. If undefined, all items will be highlighted.
highlightMaterial	MaterialDefinition	The material to use for the highlight.

Returns

Promise<void>

---

raycast()

raycast(data): Promise<null | RaycastResult>

Performs a raycast on the model.

Parameters

Parameter	Type	Description
data	RaycastData	The data of the raycast.

Returns

Promise<null | RaycastResult>

---

raycastAll()

raycastAll(data): Promise<null | RaycastResult[]>

Performs a raycast on the model and returns all the results.

Parameters

Parameter	Type	Description
data	RaycastData	The data of the raycast.

Returns

Promise<null | RaycastResult[]>

---

raycastWithSnapping()

raycastWithSnapping(data): Promise<null | RaycastResult[]>

Performs a raycast on the model with snapping.

Parameters

Parameter	Type	Description
data	SnappingRaycastData	The data of the raycast.

Returns

Promise<null | RaycastResult[]>

---

rectangleRaycast()

rectangleRaycast(data): Promise<null | RectangleRaycastResult>

Performs a rectangle raycast on the model.

Parameters

Parameter	Type	Description
data	RectangleRaycastData	The data of the rectangle raycast.

Returns

Promise<null | RectangleRaycastResult>

---

resetHighlight()

resetHighlight(localIds?): Promise<void>

Resets the highlight of the specified items.

Parameters

Parameter	Type	Description
localIds?	number[]	The local IDs of the items to reset the highlight of. If undefined, it will reset the highlight of all items.

Returns

Promise<void>

---

resetVisible()

resetVisible(): Promise<void>

Resets the visibility of all items.

Returns

Promise<void>

---

setLodMode()

setLodMode(lodMode): Promise<void>

Sets the LOD / culling mode of the model.

Parameters

Parameter	Type	Description
lodMode	LodMode	The LOD / culling mode to set.

Returns

Promise<void>

---

setVisible()

setVisible(localIds, visible): Promise<void>

Sets the visibility of the specified items.

Parameters

Parameter	Type	Description
localIds	undefined | number[]	The local IDs of the items to set the visibility of.
visible	boolean	Whether the items should be visible.

Returns

Promise<void>

---

toggleVisible()

toggleVisible(localIds?): Promise<void>

Toggles the visibility of the specified items.

Parameters

Parameter	Type	Description
localIds?	number[]	The local IDs of the items to toggle the visibility of.

Returns

Promise<void>

---

useCamera()

useCamera(camera): void

Sets a camera for the model. The model will use it to load tiles dinamically depending on the users view (e.g. hiding items that are not in the view, setting the LOD to far away items, etc).

Parameters

Parameter	Type	Description
camera	PerspectiveCamera | OrthographicCamera	The camera to use.

Returns

void