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
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
Parameter | Type | Description |
---|---|---|
world | World | The 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
Parameter | Type |
---|---|
fileName | string |
Returns
Promise
<Response
| File
>
load()
load(
settings
,coordinate
,properties
?):Promise
<FragmentsGroup
>
Loads a new fragment group into the scene using streaming.
Parameters
Parameter | Type | Description |
---|---|---|
settings | StreamLoaderSettings | The settings for the new fragment group. |
coordinate | boolean | Whether to federate this model with the rest. |
properties ? | StreamPropertiesSettings | Optional 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
Parameter | Type | Description |
---|---|---|
modelID | string | The 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
Parameter | Type | Description |
---|---|---|
ids | Iterable <string > | The list of fragment IDs to make static. |
active | boolean | Whether these items should be static or not. |
culled ? | boolean | Whether 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
Parameter | Type | Description |
---|---|---|
visible | boolean | The visibility state to set. |
filter | FragmentIdMap | A map of fragment IDs to arrays of item IDs. Only items with IDs present in the arrays will be visible. |
Returns
void