public class

NMLModelLODTreeLayer

extends Layer
java.lang.Object
   ↳ com.carto.layers.Layer
     ↳ com.carto.layers.NMLModelLODTreeLayer

Class Overview

An advanced layer for 3D models that supports automatic Level of Detail (LOD) calculation based on view.
Should be used together with corresponding data source.

Summary

Public Constructors
NMLModelLODTreeLayer(NMLModelLODTreeDataSource dataSource)
Constructs a NMLModelLODTreeLayer object from a data source.
Public Methods
synchronized void delete()
NMLModelLODTreeDataSource getDataSource()
Returns the data source of this layer.
float getLODResolutionFactor()
Returns relative model LOD resolution.
long getMaxMemorySize()
Returns memory usage constraints for the layer.
NMLModelLODTreeEventListener getNMLModelLODTreeEventListener()
Returns the NML model event listener.
boolean isUpdateInProgress()
Tests whether this layer is being currently updated.
void setLODResolutionFactor(float factor)
Set relative model LOD resolution.
void setMaxMemorySize(long size)
Set memory usage constraints for the layer.
void setNMLModelLODTreeEventListener(NMLModelLODTreeEventListener nmlModelLODTreeEventListener)
Sets the NML model event listener.
[Expand]
Inherited Methods
From class com.carto.layers.Layer
From class java.lang.Object

Public Constructors

public NMLModelLODTreeLayer (NMLModelLODTreeDataSource dataSource)

Constructs a NMLModelLODTreeLayer object from a data source.

Parameters
dataSource The data source from which this layer loads data.

Public Methods

public synchronized void delete ()

public NMLModelLODTreeDataSource getDataSource ()

Returns the data source of this layer.

Returns
  • The data source that was bound to this vector layer on construction.

public float getLODResolutionFactor ()

Returns relative model LOD resolution.

Returns
  • The relative model LOD resolution.

public long getMaxMemorySize ()

Returns memory usage constraints for the layer.

Returns
  • The memory usage constraints for the layer.

public NMLModelLODTreeEventListener getNMLModelLODTreeEventListener ()

Returns the NML model event listener.

Returns
  • The NML model event listener.

public boolean isUpdateInProgress ()

Tests whether this layer is being currently updated.

Returns
  • True when the layer is being updated or false when the layer is in steady state.

public void setLODResolutionFactor (float factor)

Set relative model LOD resolution. Higher values than 1 result in higher details
(but slower performance and higher memory usage), while lower values give better
performance but lower quality. The default is 1.

Parameters
factor The relative LOD resolution factor.

public void setMaxMemorySize (long size)

Set memory usage constraints for the layer. The specified limit is not exact,
but should be relatively close to the actual memory usage of the layer.
If specific view requires more data than specified limit, then lower LOD levels
of the models are used. The default is 80MB.

Parameters
size The memory limit in bytes.

public void setNMLModelLODTreeEventListener (NMLModelLODTreeEventListener nmlModelLODTreeEventListener)

Sets the NML model event listener.

Parameters
nmlModelLODTreeEventListener The vector element event listener.