Class MapPlaneNode

Represents a basic plane tile node.

Hierarchy (view full)

Constructors

constructor

Properties

childrenCache disposed isMesh level location mapView nodesLoaded parentNode subdivided x y baseGeometry childrens defaultTexture defaultTransparentTexture geometry

Methods

createChildNodes dispose initialize loadData nodeReady raycast simplify subdivide

Constructors

constructor

  • new MapPlaneNode(parentNode?, mapView?, location?, level?, x?, y?): MapPlaneNode

  • Parameters

    • parentNode: any = null
    • mapView: any = null
    • location: number = QuadTreePosition.root
    • level: number = 0
    • x: number = 0
    • y: number = 0

    Returns MapPlaneNode

Properties

childrenCache

childrenCache: Object3D<Object3DEventMap>[] = null

Cache with the children objects created from subdivision.

Used to avoid recreate object after simplification and subdivision.

The default value is null. Only used if "cacheTiles" is set to true.

disposed

disposed: boolean = false

Flag to indicate if the map node was disposed.

When a map node is disposed its resources are dealocated to save memory.

isMesh

isMesh: true = true

Flag to check if the node is a mesh by the renderer.

Used to toggle the visibility of the node. The renderer skips the node rendering if this is set false.

level

level: number

Tile level of this node.

location

location: number

Index of the map node in the quad-tree parent node.

Position in the tree parent, can be topLeft, topRight, bottomLeft or bottomRight.

mapView

mapView: MapView = null

The map view object where the node is placed.

nodesLoaded

nodesLoaded: number = 0

Indicates how many children nodes are loaded.

The child on become visible once all of them are loaded.

parentNode

parentNode: MapNode = null

Parent node (from an upper tile level).

subdivided

subdivided: boolean = false

Variable to check if the node is subdivided.

To avoid bad visibility changes on node load.

x

x: number

Tile x position.

y

y: number

Tile y position.

Static baseGeometry

baseGeometry: BufferGeometry<NormalBufferAttributes> = MapPlaneNode.geometry

Base geometry is attached to the map viewer object.

It should have the full size of the world so that operations over the MapView bounding box/sphere work correctly.

Static childrens

childrens: number = 4

How many children each branch of the tree has.

For a quad-tree this value is 4.

Static defaultTexture

defaultTexture: Texture = ...

Default texture used when texture fails to load.

Static defaultTransparentTexture

defaultTransparentTexture: Texture = ...

Static geometry

geometry: BufferGeometry<NormalBufferAttributes> = ...

Map node plane geometry.

Methods

createChildNodes

  • createChildNodes(): void

  • Create the child nodes to represent the next tree level.

    These nodes should be added to the object, and their transformations matrix should be updated.

    Returns void

dispose

  • dispose(): void

  • Dispose the map node and its resources.

    Should cancel all pending processing for the node.

    Returns void

initialize

  • initialize(): Promise<void>

  • Initialize resources that require access to data from the MapView.

    Called automatically by the constructor for child nodes and MapView when a root node is attached to it.

    Returns Promise<void>

loadData

  • loadData(): Promise<void>

  • Load tile texture from the server.

    This base method assumes the existence of a material attribute with a map texture.

    Returns Promise<void>

nodeReady

  • nodeReady(): void

  • Increment the child loaded counter.

    Should be called after a map node is ready for display.

    Returns void

raycast

  • raycast(raycaster, intersects): void

  • Overrides normal raycasting, to avoid raycasting when isMesh is set to false.

    Parameters

    • raycaster: Raycaster
    • intersects: Intersection<Object3D<Object3DEventMap>>[]

    Returns void

simplify

  • simplify(): void

  • Simplify node, remove all children from node, store them in cache.

    Reset the subdivided flag and restore the visibility.

    This base method assumes that the node implementation is based off Mesh and that the isMesh property is used to toggle visibility.

    Returns void

subdivide

  • subdivide(): void

  • Subdivide node,check the maximum depth allowed for the tile provider.

    Uses the createChildNodes() method to actually create the child nodes that represent the next tree level.

    Returns void

Settings

Member Visibility

Theme

On This Page