Skip to main content

IfcStreamer

The IfcStreamer component is responsible for managing and streaming tiled IFC data. It provides methods for loading, removing, and managing IFC models, as well as handling visibility and caching. 📕 Tutorial. 📘 API.

Extends

  • Component

Implements

  • Disposable

Properties

cancel

cancel: boolean = false

Flag to cancel the files that are being currently loaded.


enabled

enabled: boolean = true

OBC.Component.enabled

Overrides

OBC.Component.enabled


fileDB

fileDB: StreamerFileDb

Cache system that uses the File System API.


maxRamTime

maxRamTime: number = 5000

Maximum time in milliseconds for a geometry to stay in the RAM cache.


models

models: object = {}

The data of the streamed models. It defines the geometries, their instances, its bounding box (OBB) and the assets to which they belong.

Index signature

[modelID: string]: object


onDisposed

readonly onDisposed: Event<unknown>

OBC.Disposable.onDisposed

Implementation of

OBC.Disposable.onDisposed


onFragmentsDeleted

readonly onFragmentsDeleted: Event<Fragment[]>

Event triggered when fragments are deleted.


onFragmentsLoaded

readonly onFragmentsLoaded: Event<Fragment[]>

Event triggered when fragments are loaded.


serializer

serializer: StreamSerializer

Importer of binary IFC data previously converted to fragment tiles.


url

url: string = ""

The URL of the data source for the streaming service. It should be set before using the streaming service. Alternatively, you can use a custom fetch function.


useCache

useCache: boolean = true

Flag indicating whether to use the local cache for storing geometry files.


uuid

static readonly uuid: "22437e8d-9dbc-4b99-a04f-d2da280d50c8"

A unique identifier for the component. This UUID is used to register the component within the Components system.

Accessors

culler

get culler(): GeometryCullerRenderer

The culler used for managing and rendering the fragments. It is automatically created when the world is set.

Returns

GeometryCullerRenderer


world

get world(): World

The world in which the fragments will be displayed. It must be set before using the streaming service. If not set, an error will be thrown when trying to access the world.

set world(world): void

Sets the world in which the fragments will be displayed.

Parameters

ParameterTypeDescription
worldWorldThe new world to be set.

Returns

World

Methods

clearCache()

clearCache(): Promise<void>

Clears the local cache used for storing downloaded fragment files.

Returns

Promise<void>

A Promise that resolves when the cache is cleared.


dispose()

dispose(): void

OBC.Disposable.dispose

Returns

void

Implementation of

OBC.Disposable.dispose


fetch()

fetch(fileName): Promise<Response | File>

Function used to retrieve tiles. Can be overriden to work with specific backends.

Parameters

ParameterType
fileNamestring

Returns

Promise<Response | File>


load()

load(settings, coordinate, properties?): Promise<FragmentsGroup>

Loads a new fragment group into the scene using streaming.

Parameters

ParameterTypeDescription
settingsStreamLoaderSettingsThe settings for the new fragment group.
coordinatebooleanWhether to federate this model with the rest.
properties?StreamPropertiesSettingsOptional properties for the new fragment group.

Returns

Promise<FragmentsGroup>

The newly loaded fragment group.


remove()

remove(modelID): void

Removes a fragment group from the scene.

Parameters

ParameterTypeDescription
modelIDstringThe unique identifier of the fragment group to remove.

Returns

void

Deprecated

use OBC.FragmentsManager.disposeGroup instead.


setStatic()

setStatic(ids, active, culled?): Promise<void>

Sets or unsets the specified fragments as static. Static fragments are streamed once and then kept in memory.

Parameters

ParameterTypeDescription
idsIterable<string>The list of fragment IDs to make static.
activebooleanWhether these items should be static or not.
culled?booleanWhether these items should be culled or not. If undefined: active=true will set items as culled, while active=false will remove items from both the culled and unculled list.

Returns

Promise<void>


setVisibility()

setVisibility(visible, filter): void

Sets the visibility of items in fragments based on the provided filter.

Parameters

ParameterTypeDescription
visiblebooleanThe visibility state to set.
filterFragmentIdMap

A map of fragment IDs to arrays of item IDs.

Only items with IDs present in the arrays will be visible.

Returns

void