com.nutiteq.datasources

Class LocalVectorDataSource

java.lang.Object

com.nutiteq.datasources.VectorDataSource

com.nutiteq.datasources.LocalVectorDataSource

public class LocalVectorDataSource
extends VectorDataSource

A modifiable vector data source that keeps all the elements in the local memory.
Optionally vector elements can be kept in a spatial index and only the visible elements get rendered.
There can be a small delay before previously invisible elements become visible after view changes.
This makes it suitable for cases where there are a large number of static vector elements.

The draw order of vector elements within the data source is undefined.

Field Summary

Fields inherited from class com.nutiteq.datasources.VectorDataSource

swigCMemOwn

Constructor Summary

Constructors

Constructor and Description
LocalVectorDataSource(long cPtr, boolean cMemoryOwn)
LocalVectorDataSource(Projection projection) Constructs an LocalVectorDataSource object with no spatial index.
LocalVectorDataSource(Projection projection, LocalSpatialIndexType spatialIndexType) Constructs an LocalVectorDataSource object with specified spatial index.

Method Summary

Modifier and Type	Method and Description
void	add(VectorElement element) Adds a vector element to the data source.
void	addAll(VectorElementVector elements) Adds multiple vector elements to the data source.
void	delete()
protected void	finalize()
VectorElementVector	getAll() Returns all vector elements added to this data source using add() and addAll() methods.
static long	getCPtr(LocalVectorDataSource obj)
MapBounds	getDataExtent() Returns the extent of this data source.
GeometrySimplifier	getGeometrySimplifier() Returns the active geometry simplifier of the data source.
VectorElementVector	loadElements(CullState cullState) Loads all the elements within the defined envelope.
boolean	remove(VectorElement elementToRemove) Removes a vector element from the data source.
VectorElementVector	removeAll() Removes all vector elements from the data source.
void	setAll(VectorElementVector elements) Replaces all vector elements in the data source with the given list of vector elements.
void	setGeometrySimplifier(GeometrySimplifier simplifier) Attaches geometry simplifier to the data source.
static LocalVectorDataSource	swigCreatePolymorphicInstance(long cPtr, boolean cMemoryOwn) Creates a polymorphic instance of the given native object.
protected void	swigDirectorDisconnect()
java.lang.String	swigGetClassName() Returns the actual class name of this object.
java.lang.Object	swigGetDirectorObject() Returns the connected director object.
void	swigReleaseOwnership()
void	swigTakeOwnership()

Methods inherited from class com.nutiteq.datasources.VectorDataSource

getCPtr, getProjection, notifyElementsChanged

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

LocalVectorDataSource

public LocalVectorDataSource(long cPtr,
                             boolean cMemoryOwn)

LocalVectorDataSource

public LocalVectorDataSource(Projection projection)

Constructs an LocalVectorDataSource object with no spatial index.

Parameters:

projection - The projection used by this data source.

LocalVectorDataSource

public LocalVectorDataSource(Projection projection,
                             LocalSpatialIndexType spatialIndexType)

Constructs an LocalVectorDataSource object with specified spatial index.

Parameters:

projection - The projection used by this data source.

spatialIndexType - The spatial index type to use.

Method Detail

getCPtr

public static long getCPtr(LocalVectorDataSource obj)

finalize

protected void finalize()

Overrides:

finalize in class VectorDataSource

delete

public void delete()

Overrides:

delete in class VectorDataSource

swigDirectorDisconnect

protected void swigDirectorDisconnect()

Overrides:

swigDirectorDisconnect in class VectorDataSource

swigReleaseOwnership

public void swigReleaseOwnership()

Overrides:

swigReleaseOwnership in class VectorDataSource

swigTakeOwnership

public void swigTakeOwnership()

Overrides:

swigTakeOwnership in class VectorDataSource

swigCreatePolymorphicInstance

public static LocalVectorDataSource swigCreatePolymorphicInstance(long cPtr,
                                                                  boolean cMemoryOwn)

Creates a polymorphic instance of the given native object. This is used internally by the SDK.

loadElements

public VectorElementVector loadElements(CullState cullState)

Description copied from class: VectorDataSource

Loads all the elements within the defined envelope.

Overrides:

loadElements in class VectorDataSource

Parameters:

cullState - State for describing view parameters and conservative view envelope.

Returns:

The vector of loaded vector elements. If no elements are available, null may be returned.

getAll

public VectorElementVector getAll()

Returns all vector elements added to this data source using add() and addAll() methods.

Returns:

A vector containing all the vector elements in this data source.

setAll

public void setAll(VectorElementVector elements)

Replaces all vector elements in the data source with the given list of vector elements.

Parameters:

elements - The list of new vector elements

add

public void add(VectorElement element)

Adds a vector element to the data source. The vector element's coordinates are expected to be
in the data source's projection's coordinate system. The order in which the elements are added has
no effect on the order they get rendered.

Parameters:

element - The vector element to be added.

addAll

public void addAll(VectorElementVector elements)

Adds multiple vector elements to the data source. The vector elements' coordinates are expected to be
in the data source's projection's coordinate system. The order in which the elements are added has
no effect on the order they get rendered.

Parameters:

elements - A vector of vector elements to be added.

remove

public boolean remove(VectorElement elementToRemove)

Removes a vector element from the data source.

Parameters:

elementToRemove - The vector element to be removed.

Returns:

True if the vector element existed in the data source.

removeAll

public VectorElementVector removeAll()

Removes all vector elements from the data source.

Returns:

The removed vector elements.

getGeometrySimplifier

public GeometrySimplifier getGeometrySimplifier()

Returns the active geometry simplifier of the data source.

Returns:

The current geometry simplifier (can be null)

setGeometrySimplifier

public void setGeometrySimplifier(GeometrySimplifier simplifier)

Attaches geometry simplifier to the data source. If the specified simplifier is null, detaches any active simplifier.

Parameters:

simplifier - The new geometry simplifier to use (can be null).

getDataExtent

public MapBounds getDataExtent()

Returns the extent of this data source. Extent is the minimal bounding box encompassing all the elements.

Returns:

The minimal bounding box for the elements.

swigGetClassName

public java.lang.String swigGetClassName()

Returns the actual class name of this object. This is used internally by the SDK.

Overrides:

swigGetClassName in class VectorDataSource

Returns:

The class name of this object.

swigGetDirectorObject

public java.lang.Object swigGetDirectorObject()

Returns the connected director object. This is used internally by the SDK.

Overrides:

swigGetDirectorObject in class VectorDataSource

Returns:

The connected director object or null if director is not connected.