Class Tiles3D<TMaterial, UserData>

A 3D Tiles dataset.

Type Parameters

TMaterial extends Material = Material
UserData extends EntityUserData = EntityUserData

Hierarchy (view full)

Entity3D<Entity3DEventMap, UserData>
- Tiles3D

Implements

Index

Constructors

constructor

new Tiles3D<TMaterial, UserData>(source, options?): Tiles3D<TMaterial, UserData>
Constructs a Tiles3D object.
Type Parameters
- TMaterial extends Material = Material
- UserData extends EntityUserData = EntityUserData
Parameters
- source: Tiles3DSource
  The data source.
- options: Tiles3DOptions<TMaterial> = {}
  Optional properties.
Returns Tiles3D<TMaterial, UserData>
Overrides Entity3D.constructor
- Defined in entities/Tiles3D.ts:158

Properties

`Protected`_distance

_distance: {
max: number;
min: number;
}

cleanupDelay

cleanupDelay: number

The delay, in milliseconds, to cleanup unused objects.

`Readonly`hasLayers

hasLayers: true = ...

Read-only flag to check if a given object is of type HasLayers.

`Readonly`id

id: string

The unique identifier of this entity.

`Readonly`imageSize

imageSize: Vector2 = ...

`Readonly`isEntity

isEntity: boolean = ...

Read-only flag to check if a given object is of type Entity.

`Readonly`isEntity3D

isEntity3D: boolean = ...

Read-only flag to check if a given object is of type Entity3D.

`Readonly`isMemoryUsage

isMemoryUsage: true = ...

Readonly flag to indicate that his object implements MemoryUsage.

`Readonly`isPickable

isPickable = true

`Readonly`isTiles3D

isTiles3D: true = ...

Read-only flag to check if a given object is of type Tiles3D.

`Optional`material

material?: TMaterial

The material to use

name

name: undefined | string

The name of this entity.

sseThreshold

sseThreshold: number

The Screen Space Error (SSE) threshold to use for this tileset.

`Readonly`type

type: "Tiles3D" = ...

The name of the type of this object.

`Readonly`userData

userData: UserData

An object that can be used to store custom data about the Entity.

`Optional`wireframe

wireframe?: boolean

Accessors

asset

get asset(): $3dTilesAsset
Returns $3dTilesAsset
- Defined in entities/Tiles3D.ts:142

clippingPlanes

get clippingPlanes(): null | Plane[]
Gets or sets the clipping planes set on this entity. Default is null (no clipping planes).

Note: custom entities must ensure that the materials and shaders used do support the clipping plane feature of three.js. Refer to the three.js documentation for more information.

Returns null | Plane[]
Inherited from Entity3D.clippingPlanes
- Defined in entities/Entity3D.ts:171
set clippingPlanes(planes): void
Parameters
- planes: null | Plane[]
Returns void
Inherited from Entity3D.clippingPlanes
- Defined in entities/Entity3D.ts:175

distance

get distance(): {
max: number;
min: number;
}
Returns {
max: number;
min: number;
}
- max: number
- min: number
Inherited from Entity3D.distance
- Defined in entities/Entity3D.ts:61

frozen

get frozen(): boolean
Gets or sets the frozen status of this entity. A frozen entity is still visible but will not be updated automatically.

Useful for debugging purposes.

Returns boolean
Inherited from Entity3D.frozen
- Defined in entities/Entity.ts:144
set frozen(v): void
Parameters
- v: boolean
Returns void
Inherited from Entity3D.frozen
- Defined in entities/Entity.ts:148

instance

get instance(): Instance
Returns Instance
Inherited from Entity3D.instance
- Defined in entities/Entity.ts:96

layerCount

get layerCount(): number
Returns the number of layers currently in this object.

Returns number
Implementation of HasLayers.layerCount
- Defined in entities/Tiles3D.ts:245

loading

get loading(): boolean
Gets whether this entity is currently loading data.

Returns boolean
Overrides Entity3D.loading
- Defined in entities/Tiles3D.ts:215

object3d

get object3d(): Object3D<Object3DEventMap>
Returns the root object of this entity.

Returns Object3D<Object3DEventMap>
Inherited from Entity3D.object3d
- Defined in entities/Entity3D.ts:114

opacity

get opacity(): number
Gets or sets the opacity of this entity.

Returns number
Inherited from Entity3D.opacity
- Defined in entities/Entity3D.ts:152
set opacity(v): void
Parameters
- v: number
Returns void
Inherited from Entity3D.opacity
- Defined in entities/Entity3D.ts:156

progress

get progress(): number
Gets the current loading progress (between 0 and 1). Note: This property is only meaningful if loading is true.

Returns number
Overrides Entity3D.progress
- Defined in entities/Tiles3D.ts:219

ready

get ready(): boolean
Determine if this entity is ready to use.

Returns boolean
Inherited from Entity3D.ready
- Defined in entities/Entity.ts:92

renderOrder

get renderOrder(): number
Gets or sets the render order of this entity.

Returns number
Inherited from Entity3D.renderOrder
- Defined in entities/Entity3D.ts:137
set renderOrder(v): void
Parameters
- v: number
Returns void
Inherited from Entity3D.renderOrder
- Defined in entities/Entity3D.ts:141

root

get root(): Tile
Returns Tile
- Defined in entities/Tiles3D.ts:146

url

get url(): string
Returns string
- Defined in entities/Tiles3D.ts:126

visible

get visible(): boolean
Gets or sets the visibility of this entity. A non-visible entity will not be automatically updated.

Returns boolean
Inherited from Entity3D.visible
- Defined in entities/Entity3D.ts:122
set visible(v): void
Parameters
- v: boolean
Returns void
Inherited from Entity3D.visible
- Defined in entities/Entity3D.ts:126

Methods

addEventListener

addEventListener<T>(type, listener): void
Adds a listener to an event type.
Type Parameters
- T extends
      | "initialized"
      | "frozen-property-changed"
      | "visible-property-changed"
      | "opacity-property-changed"
      | "clippingPlanes-property-changed"
      | "renderOrder-property-changed"
      | "object-created"
Parameters
- type: T
  The type of event to listen to.
- listener: EventListener<(Entity3DEventMap & EntityEventMap)[T], T, Tiles3D<TMaterial, UserData>>
  The function that gets called when the event is fired.
Returns void
Inherited from Entity3D.addEventListener
- Defined in ../node_modules/@types/three/src/core/EventDispatcher.d.ts:52
addEventListener<T>(type, listener): void
Type Parameters
- T extends string
Parameters
- type: T
- listener: EventListener<{}, T, Tiles3D<TMaterial, UserData>>
Returns void
Inherited from Entity3D.addEventListener
- Defined in ../node_modules/@types/three/src/core/EventDispatcher.d.ts:56

`Protected`assignRenderOrder

assignRenderOrder(obj): void
Assigns the render order of this object.

This may be overriden to perform custom logic.
Parameters
- obj: Object3D<Object3DEventMap>
Returns void
Inherited from Entity3D.assignRenderOrder
- Defined in entities/Entity3D.ts:329

attach

attach(colorLayer): Promise<void>
Parameters
- colorLayer: ColorLayer<LayerUserData>
Returns Promise<void>
- Defined in entities/Tiles3D.ts:210

`Protected`cleanup3dTileset

cleanup3dTileset(n, depth?): void
Parameters
- n: Tile
- depth: number = 0
Returns void
- Defined in entities/Tiles3D.ts:548

contains

contains(obj): boolean
Test whether this entity contains the given object.

The object may be a component of the entity, or a 3D object.
Parameters
- obj: unknown
  The object to test.
Returns boolean
true if the entity contains the object.
Inherited from Entity3D.contains
- Defined in entities/Entity3D.ts:342

dispatchEvent

dispatchEvent<T>(event): void
Fire an event type.
Type Parameters
- T extends
      | "initialized"
      | "frozen-property-changed"
      | "visible-property-changed"
      | "opacity-property-changed"
      | "clippingPlanes-property-changed"
      | "renderOrder-property-changed"
      | "object-created"
Parameters
- event: BaseEvent<T> & (Entity3DEventMap & EntityEventMap)[T]
  The event that gets fired.
Returns void
Inherited from Entity3D.dispatchEvent
- Defined in ../node_modules/@types/three/src/core/EventDispatcher.d.ts:84

dispose

dispose(): void
Disposes this entity and all resources associated with it.

The default implementation of this method does nothing. You should implement it in your custom entities to handle any special logic of disposal.

For example: disposing materials, geometries, stopping HTTP requests, etc.

Returns void
Inherited from Entity3D.dispose
- Defined in entities/Entity.ts:330

executeCommand

executeCommand(metadata, requester?): Promise<Tile>
Parameters
- metadata: ProcessedTile
- Optionalrequester: Tile
Returns Promise<Tile>
- Defined in entities/Tiles3D.ts:747

filterChangeSources

filterChangeSources(updateSources): Set<unknown>
Filters what objects need to be updated, based on updatedSources. The returned objects are then passed to preUpdate and postUpdate.

Inherited classes should override shouldFullUpdate and shouldUpdate if they need to change this behavior.
Parameters
- updateSources: Set<unknown>
  Sources that triggered an update
Returns Set<unknown>
Set of objects to update
Inherited from Entity3D.filterChangeSources
- Defined in entities/Entity.ts:254

forEachLayer

forEachLayer(callback): void
Applies the callback to each layer in the object.
Parameters
- callback: ((layer: Layer<LayerEvents, LayerUserData>) => void)
  - - (layer): void
    - Parameters
      layer: Layer<LayerEvents, LayerUserData>
      Returns void
Returns void
Implementation of HasLayers.forEachLayer
- Defined in entities/Tiles3D.ts:239

getBoundingBox

getBoundingBox(): null | Box3
Returns an approximated bounding box of this entity in the scene.

Returns null | Box3
the resulting bounding box, or null if it could not be computed.
Overrides Entity3D.getBoundingBox
- Defined in entities/Tiles3D.ts:188

getLayers

getLayers(predicate?): Layer<LayerEvents, LayerUserData>[]
Returns a new array containing the layers in this object. Optionally, the predicate can be used to filter out unwanted layers.
```
// Get all layers from the object.
const allLayers = obj.getLayers();

// Get all color layers from the object.
const colorLayers = obj.getLayers((layer) => layer.isColorLayer);
```
Parameters
- Optionalpredicate: ((arg0: Layer<LayerEvents, LayerUserData>) => boolean)
  - - (arg0): boolean
    - Parameters
      arg0: Layer<LayerEvents, LayerUserData>
      Returns boolean
Returns Layer<LayerEvents, LayerUserData>[]
Implementation of HasLayers.getLayers
- Defined in entities/Tiles3D.ts:229

getMemoryUsage

getMemoryUsage(context): void
Returns an approximation of the memory used by this object, in bytes.
Parameters
- context: GetMemoryUsageContext
Returns void
Overrides Entity3D.getMemoryUsage
- Defined in entities/Tiles3D.ts:196

hasEventListener

hasEventListener<T>(type, listener): boolean
Checks if listener is added to an event type.
Type Parameters
- T extends
      | "initialized"
      | "frozen-property-changed"
      | "visible-property-changed"
      | "opacity-property-changed"
      | "clippingPlanes-property-changed"
      | "renderOrder-property-changed"
      | "object-created"
Parameters
- type: T
  The type of event to listen to.
- listener: EventListener<(Entity3DEventMap & EntityEventMap)[T], T, Tiles3D<TMaterial, UserData>>
  The function that gets called when the event is fired.
Returns boolean
Inherited from Entity3D.hasEventListener
- Defined in ../node_modules/@types/three/src/core/EventDispatcher.d.ts:63
hasEventListener<T>(type, listener): boolean
Type Parameters
- T extends string
Parameters
- type: T
- listener: EventListener<{}, T, Tiles3D<TMaterial, UserData>>
Returns boolean
Inherited from Entity3D.hasEventListener
- Defined in ../node_modules/@types/three/src/core/EventDispatcher.d.ts:67

`Protected`isOwned

isOwned(obj): boolean
Returns true if this object belongs to this entity.
Parameters
- obj: unknown
  The object to test.
Returns boolean
Inherited from Entity3D.isOwned
- Defined in entities/Entity3D.ts:245

`Protected`markTileForDeletion

markTileForDeletion(node): void
Parameters
- node: Tile
Returns void
- Defined in entities/Tiles3D.ts:528

`Protected`notifyChange

notifyChange(source?): void
Notifies the parent instance that a change occured in the scene.
Parameters
- Optionalsource: unknown
Returns void
Inherited from Entity3D.notifyChange
- Defined in entities/Entity.ts:337

`Protected`onObjectCreated

onObjectCreated(obj): void
Applies entity-level setup on a new object.

Note: this method should be called from the subclassed entity to notify the parent class that a new 3D object has just been created, so that it can be setup with entity-wide parameters.
Parameters
- obj: Object3D<Object3DEventMap>
  The object to prepare.
Returns void
Example
```
// In the subclass
const obj = new Object3D();

// Notify the parent class
this.onObjectCreated(obj);
```
Inherited from Entity3D.onObjectCreated
- Defined in entities/Entity3D.ts:309

onRenderingContextLost

onRenderingContextLost(options): void
Called when the rendering context has been lost.
Parameters
- options: {
  canvas: HTMLCanvasElement;
  }
  The options.
  - canvas: HTMLCanvasElement
Returns void
Inherited from Entity3D.onRenderingContextLost
- Defined in entities/Entity3D.ts:102

onRenderingContextRestored

onRenderingContextRestored(): void
Called when the rendering context has been restored.

Returns void
Overrides Entity3D.onRenderingContextRestored
- Defined in entities/Tiles3D.ts:183

pick

pick(coordinates, options?): Tiles3DPickResult[]
Parameters
- coordinates: Vector2
  Coordinates on the rendering canvas
- Optionaloptions: PickOptions
  Options
Returns Tiles3DPickResult[]
Target
Implementation of Pickable.pick
Overrides Entity3D.pick
- Defined in entities/Tiles3D.ts:842

postUpdate

postUpdate(context): void
Method called after Entity.update.
Parameters
- context: Context
  the update context.
Returns void
Overrides Entity3D.postUpdate
- Defined in entities/Tiles3D.ts:515

preprocess

preprocess(): Promise<void>
Asynchronously preprocess the entity. This method may be overriden to perform any operation that must be done before the entity can be used in the scene, such as fetching metadata about a dataset, etc.

Returns Promise<void>
A promise that resolves when the entity is ready to be used.
Overrides Entity3D.preprocess
- Defined in entities/Tiles3D.ts:270

preUpdate

preUpdate(): Tile[]
This method is called just before update() to filter and select which elements should be actually updated. For example, in the case of complex entities made of a hierarchy of elements, the entire hierarchy may not need to be updated.

Use this method to optimize the update step by reducing the number of elements to process.

Note: if this functions returns nothing, update() will not be called.

Returns Tile[]
the elements to update during update().
Overrides Entity3D.preUpdate
- Defined in entities/Tiles3D.ts:370

removeEventListener

removeEventListener<T>(type, listener): void
Removes a listener from an event type.
Type Parameters
- T extends
      | "initialized"
      | "frozen-property-changed"
      | "visible-property-changed"
      | "opacity-property-changed"
      | "clippingPlanes-property-changed"
      | "renderOrder-property-changed"
      | "object-created"
Parameters
- type: T
  The type of the listener that gets removed.
- listener: EventListener<(Entity3DEventMap & EntityEventMap)[T], T, Tiles3D<TMaterial, UserData>>
  The listener function that gets removed.
Returns void
Inherited from Entity3D.removeEventListener
- Defined in ../node_modules/@types/three/src/core/EventDispatcher.d.ts:74
removeEventListener<T>(type, listener): void
Type Parameters
- T extends string
Parameters
- type: T
- listener: EventListener<{}, T, Tiles3D<TMaterial, UserData>>
Returns void
Inherited from Entity3D.removeEventListener
- Defined in ../node_modules/@types/three/src/core/EventDispatcher.d.ts:78

`Protected`setMaterialOpacity

setMaterialOpacity(material): void
Calculate and set the material opacity, taking into account this entity opacity and the original opacity of the object.
Parameters
- material: Material
  a material belonging to an object of this entity
Returns void
- Defined in entities/Tiles3D.ts:730

`Protected`setupMaterial

setupMaterial(material): void
Applies entity-level setup on new object's material.

Subclasses can override this to setup custom logic, for instance if the entity can produce objects that are naturally transparent.
Parameters
- material: Material
  the material of the newly created object
Returns void
Overrides Entity3D.setupMaterial
- Defined in entities/Tiles3D.ts:737

shouldCheckForUpdate

shouldCheckForUpdate(): boolean
This method is called before update to check if the MainLoop should try to update this entity or not. For better performances, it should return false if the entity has no impact on the rendering (e.g. the element is not visible).

The inherited child can completely ignore this value if it makes sense.

Returns boolean
true if should check for update
Inherited from Entity3D.shouldCheckForUpdate
- Defined in entities/Entity3D.ts:228

shouldExecute

shouldExecute(node): boolean
Parameters
- node: undefined | Tile
  The tile to evaluate;
Returns boolean
true if the request can continue, false if it must be cancelled.
- Defined in entities/Tiles3D.ts:819

shouldFullUpdate

shouldFullUpdate(updateSource): boolean
This method is called at the beginning of the update step to determine if we should do a full render of the object. This should be the case if, for instance, the source is the camera.

You can override this depending on your needs. The inherited child should not ignore this value, it should do a boolean OR, e.g.: return super.shouldFullUpdate(updateSource) || this.contains(updateSource);
Parameters
- updateSource: unknown
  Source of change
Returns boolean
true if requires a full update of this object
Inherited from Entity3D.shouldFullUpdate
- Defined in entities/Entity3D.ts:232

shouldUpdate

shouldUpdate(updateSource): boolean
This method is called at the beginning of the update step to determine if we should re-render updateSource. Not used when shouldFullUpdate returns true.

You can override this depending on your needs. The inherited child should not ignore this value, it should do a boolean OR, e.g.: return super.shouldUpdate(updateSource) || this.contains(updateSource);
Parameters
- updateSource: unknown
  Source of change
Returns boolean
true if requires an update of updateSource
Inherited from Entity3D.shouldUpdate
- Defined in entities/Entity3D.ts:236

`Protected`subdivideNode

subdivideNode(context, node): void
Parameters
- context: Context
- node: Tile
Returns void
- Defined in entities/Tiles3D.ts:713

`Protected`subdivideNodeAdditive

subdivideNodeAdditive(context, node): void
Parameters
- context: Context
- node: Tile
Returns void
- Defined in entities/Tiles3D.ts:596

`Protected`subdivideNodeSubstractive

subdivideNodeSubstractive(node): void
Parameters
- node: Tile
Returns void
- Defined in entities/Tiles3D.ts:649

`Protected`subdivisionTest

subdivisionTest(context, node): boolean
Parameters
- context: Context
- node: Tile
Returns boolean
- Defined in entities/Tiles3D.ts:581

traverse

traverse(callback, root?): void
Traverses all objects in the hierarchy of this entity.
Parameters
- callback: ((arg0: Object3D<Object3DEventMap>) => void)
  The callback.
  - - (arg0): void
    - Parameters
      arg0: Object3D<Object3DEventMap>
      Returns void
- root: undefined | Object3D<Object3DEventMap> = undefined
  The traversal root. If undefined, the traversal starts at the root object of this entity.
Returns void
Inherited from Entity3D.traverse
- Defined in entities/Entity3D.ts:393

traverseMaterials

traverseMaterials(callback, root?): void
Traverses all materials in the hierarchy of this entity.
Parameters
- callback: ((arg0: Material) => void)
  The callback.
  - - (arg0): void
    - Parameters
      arg0: Material
      Returns void
- root: undefined | Object3D<Object3DEventMap> = undefined
  The traversal root. If undefined, the traversal starts at the root object of this entity.
Returns void
Inherited from Entity3D.traverseMaterials
- Defined in entities/Entity3D.ts:353

traverseMeshes

traverseMeshes(callback, root?): void
Traverses all meshes in the hierarchy of this entity.
Parameters
- callback: ((arg0: Mesh<BufferGeometry<NormalBufferAttributes>, Material | Material[], Object3DEventMap>) => void)
  The callback.
  - - (arg0): void
    - Parameters
      arg0: Mesh<BufferGeometry<NormalBufferAttributes>, Material | Material[], Object3DEventMap>
      Returns void
- root: undefined | Object3D<Object3DEventMap> = undefined
  The raversal root. If undefined, the traversal starts at the root object of this entity.
Returns void
Inherited from Entity3D.traverseMeshes
- Defined in entities/Entity3D.ts:376

`Protected`unmarkTileForDeletion

unmarkTileForDeletion(node): void
Parameters
- node: undefined | Tile
Returns void
- Defined in entities/Tiles3D.ts:535

update

update(context, node): undefined | Tile[]
Performs an update on an element of the entity.

Note: this method will be called for each element returned by preUpdate().
Parameters
- context: Context
  the update context. This is the same object that the entity whose update() is being called.
- node: Tile
Returns undefined | Tile[]
New elements to update
Overrides Entity3D.update
- Defined in entities/Tiles3D.ts:397

updateClippingPlanes

updateClippingPlanes(): void
Updates the clipping planes of all objects under this entity.

Returns void
Inherited from Entity3D.updateClippingPlanes
- Defined in entities/Entity3D.ts:222

updateOpacity

updateOpacity(): void
Updates the opacity of the entity. Note: this method can be overriden for custom implementations.

Returns void
Overrides Entity3D.updateOpacity
- Defined in entities/Tiles3D.ts:252

updateRenderOrder

updateRenderOrder(): void
Updates the render order of the entity. Note: this method can be overriden for custom implementations.

Returns void
Inherited from Entity3D.updateRenderOrder
- Defined in entities/Entity3D.ts:212

updateVisibility

updateVisibility(): void
Updates the visibility of the entity. Note: this method can be overriden for custom implementations.

Returns void
Inherited from Entity3D.updateVisibility
- Defined in entities/Entity3D.ts:186

Class Tiles3D<TMaterial, UserData>

Type Parameters

Hierarchy (view full)

Implements

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Type Parameters

Parameters

Returns Tiles3D<TMaterial, UserData>

Properties

Protected_distance

cleanupDelay

ReadonlyhasLayers

Readonlyid

ReadonlyimageSize

ReadonlyisEntity

ReadonlyisEntity3D

ReadonlyisMemoryUsage

ReadonlyisPickable

ReadonlyisTiles3D

Optionalmaterial

name

sseThreshold

Readonlytype

ReadonlyuserData

Optionalwireframe

Accessors

asset

Returns $3dTilesAsset

clippingPlanes

Returns null | Plane[]

Parameters

Returns void

distance

Returns { max: number; min: number; }

max: number

min: number

frozen

Returns boolean

Parameters

Returns void

instance

Returns Instance

layerCount

Returns number

loading

Returns boolean

object3d

Returns Object3D<Object3DEventMap>

opacity

Returns number

Parameters

Returns void

progress

Returns number

ready

Returns boolean

renderOrder

Returns number

Parameters

Returns void

root

Returns Tile

url

Returns string

visible

Returns boolean

Parameters

Returns void

Methods

addEventListener

Type Parameters

Parameters

Returns void

Type Parameters

`Protected`_distance

`Readonly`hasLayers

`Readonly`id

`Readonly`imageSize

`Readonly`isEntity

`Readonly`isEntity3D

`Readonly`isMemoryUsage

`Readonly`isPickable

`Readonly`isTiles3D

`Optional`material

`Readonly`type

`Readonly`userData

`Optional`wireframe

Returns {
max: number;
min: number;
}

`Protected`assignRenderOrder

`Protected`cleanup3dTileset

`Protected`isOwned

`Protected`markTileForDeletion

`Protected`notifyChange

`Protected`onObjectCreated