ilog.views.maps.defense.terrain3d.model

Class Ilv3DModel

java.lang.Object

ilog.views.maps.defense.terrain3d.model.Ilv3DModel

public class Ilv3DModel
extends Object

This class is a lightweight model for a 3D scene, holding a terrain structure, a list of Ilv3DComponent objects and an Ilv3DSymbolManager. To render this 3D model, it must be connected to an Ilv3DView.

Since:

JViews 7.5

Constructor Summary

Constructors

Constructor and Description
Ilv3DModel(IlvManager manager) Constructs an Ilv3DModel object from the specified parameter

Method Summary

Modifier and Type	Method and Description
void	add3DComponent(Ilv3DComponent component) Adds an Ilv3DComponent to this 3D model.
void	buildTerrain(double lonMin, double latMin, double lonMax, double latMax) Creates internal 3D terrain structure for the specified region.
void	buildTerrain(double lonMin, double latMin, double lonMax, double latMax, int tilingLevel) Creates internal 3D terrain structure for the specified region.
void	dispose() Releases any resource held by this Ilv3DModel, and removes any listener that it had added.
Collection	get3DComponents() Returns a collection containing all Ilv3DComponent objects contained by this 3D model
Ilv3DDoubleVector	getCentroid() Returns the centroid (i.e. the center of gravity) of the current terrain.
double	getGroundHeightAt(double x, double z) Computes and returns the elevation (above ground) at the specified location in 3D space coordinates.
IlvManager	getManager() Returns the IlvManager associated with this Ilv3DModel.
Ilv3DView	getModelView() Returns the Ilv3DView currently associated with this 3D model.
double	getRadius() Returns the radius of the smallest sphere containing the terrain.
Ilv3DSymbolManager	getSymbolManager() Returns the Ilv3DSymbolManager that manages 3D symbols for this 3D model.
int	getTextureOversampling() Returns the factor that forces higher resolution texture.
Ilv3DTile[]	getTiles() Returns the current list of Ilv3DTile objects used by the 3D model to represent the region built by the last call to buildTerrain method .
boolean	isKeepElevationDataCache() Returns whether the model must keep a copy of downsampled elevation data (depending on the camera position), or rather compute it at rendering time.
boolean	isUse2DViewAsTexture() Returns whether the associated 2D view must be used as a texture for the 3D terrain.
void	regenerateTerrainTexture() Forces terrain texture refresh.
Ilv3DComponent	remove3DComponent(Ilv3DComponent component) Removes an Ilv3DComponent from this 3D model.
void	setKeepElevationDataCache(boolean keepElevationDataCache) Sets whether the model should keep a copy of downsampled elevation data (depending on the camera position), or rather compute it at rendering time.
void	setModelView(Ilv3DView modelView) Sets the Ilv3DView currently associated with this 3D model.
void	setSymbolManager(Ilv3DSymbolManager symbolmanager) Sets the Ilv3DSymbolManager that manages 3D symbols for this 3D model.
void	setTextureOversampling(int level) Sets the factor that forces higher resolution texture.
void	setUse2DViewAsTexture(boolean use2DViewAsTexture) Sets whether the associated 2D view must be use as a texture for the 3D terrain.

Methods inherited from class java.lang.Object

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

Constructor Detail

Ilv3DModel

public Ilv3DModel(IlvManager manager)

Constructs an Ilv3DModel object from the specified parameter

Parameters:

manager - The IlvManager containing the map description to build the 3D terrain model upon.

Method Detail

dispose

public void dispose()

Releases any resource held by this Ilv3DModel, and removes any listener that it had added.

add3DComponent

public void add3DComponent(Ilv3DComponent component)

Adds an Ilv3DComponent to this 3D model.

Parameters:

component - The Ilv3DComponent to add to the 3D scene.

remove3DComponent

public Ilv3DComponent remove3DComponent(Ilv3DComponent component)

Removes an Ilv3DComponent from this 3D model.

Parameters:

component - The Ilv3DComponent to remove.

Returns:

The component that was removed, or null if it was not found in the 3D model

get3DComponents

public Collection get3DComponents()

Returns a collection containing all Ilv3DComponent objects contained by this 3D model

Returns:

Acollection of Ilv3DComponent objects.

getGroundHeightAt

public double getGroundHeightAt(double x,
                                double z)

Computes and returns the elevation (above ground) at the specified location in 3D space coordinates.

Parameters:

x - The X coordinate of the point, in 3D model space.

z - The Z coordinate of the point, in 3D model space.

Returns:

The terrain elevation at specified location.

getTiles

public Ilv3DTile[] getTiles()

Returns the current list of Ilv3DTile objects used by the 3D model to represent the region built by the last call to buildTerrain method .

Returns:

An array of Ilv3DTile objects.

getRadius

public double getRadius()

Returns the radius of the smallest sphere containing the terrain. This approximation is used to determine the initial camera position of an associated Ilv3DView.

Returns:

The terrain radius in 3D coordinate space.

getCentroid

public Ilv3DDoubleVector getCentroid()

Returns the centroid (i.e. the center of gravity) of the current terrain.

Returns:

A vector containing centroid coordinates, in 3D space coordinates.

Since:

JViews 8.1

setSymbolManager

public void setSymbolManager(Ilv3DSymbolManager symbolmanager)

Sets the Ilv3DSymbolManager that manages 3D symbols for this 3D model.

Parameters:

symbolmanager - The Ilv3DSymbolManager

getSymbolManager

public Ilv3DSymbolManager getSymbolManager()

Returns the Ilv3DSymbolManager that manages 3D symbols for this 3D model. The Ilv3DSymbolManager stores and displays a list of 3D symbols in sync with a specified IlvSDMEngine symbology container.

Returns:

The Ilv3DSymbolManager.

See Also:

Ilv3DSymbolManager

getModelView

public Ilv3DView getModelView()

Returns the Ilv3DView currently associated with this 3D model.

Returns:

The Ilv3DView currently associated with this 3D model.

setModelView

public void setModelView(Ilv3DView modelView)

Sets the Ilv3DView currently associated with this 3D model.

Parameters:

modelView - The Ilv3DView currently associated with this 3D model.

buildTerrain

public void buildTerrain(double lonMin,
                         double latMin,
                         double lonMax,
                         double latMax)

Creates internal 3D terrain structure for the specified region.

Parameters:

lonMin - The minimum longitude of the region in radians.

latMin - The minimum latitude of the region in radians.

lonMax - The maximum longitude of the region in radians.

latMax - The maximum latitude of the region in radians.

buildTerrain

public void buildTerrain(double lonMin,
                         double latMin,
                         double lonMax,
                         double latMax,
                         int tilingLevel)

Creates internal 3D terrain structure for the specified region.

Parameters:

lonMin - The minimum longitude of the region in radians.

latMin - The minimum latitude of the region in radians.

lonMax - The maximum longitude of the region in radians.

latMax - The maximum latitude of the region in radians.

tilingLevel - The area subdivision level when creating tiles. level n+1 corresponds to a split in half (if need be) of a level n tile.

Since:

JViews 8.0

getManager

public IlvManager getManager()

Returns the IlvManager associated with this Ilv3DModel.

Returns:

The IlvManager associated with this Ilv3DModel.

isKeepElevationDataCache

public boolean isKeepElevationDataCache()

Returns whether the model must keep a copy of downsampled elevation data (depending on the camera position), or rather compute it at rendering time. If true, the higher the frame rate of the view, but also the bigger the memory usage (as part of the elevation data is duplicated).

Returns:

true if the model caches its elevation data.

setKeepElevationDataCache

public void setKeepElevationDataCache(boolean keepElevationDataCache)

Sets whether the model should keep a copy of downsampled elevation data (depending on the camera position), or rather compute it at rendering time. If true, the higher the frame rate of the view, but also the bigger the memory usage (as part of the elevation data is duplicated).

Parameters:

keepElevationDataCache - true if the model caches its elevation data.

isUse2DViewAsTexture

public boolean isUse2DViewAsTexture()

Returns whether the associated 2D view must be used as a texture for the 3D terrain. This way, you can see layers without elevation data (vectorial layers for instance) in the 3D view. If false, the terrain texture is generated from the color model of the elevation data source.

Returns:

true if the 2D view is rendered as a texture for the 3D terrain.

setUse2DViewAsTexture

public void setUse2DViewAsTexture(boolean use2DViewAsTexture)

Sets whether the associated 2D view must be use as a texture for the 3D terrain. This way, you can see layers without elevation data (vectorial layers for instance) in the 3D view. If false, the terrain texture is generated from the color model of the elevation data source.

Parameters:

use2DViewAsTexture - true if the 2D view is rendered as a texture for the 3D terrain.

regenerateTerrainTexture

public void regenerateTerrainTexture()

Forces terrain texture refresh. This is needed, for instance, to reflect the change in 3D view when new layers are added to the map.

setTextureOversampling

public void setTextureOversampling(int level)

Sets the factor that forces higher resolution texture. This is needed, for instance when the image used as a texture is of much higher precision than underlying elevation data. The texture size is doubled between level and (level +1). 0 means no oversampling.

Parameters:

level - The level of oversampling.

getTextureOversampling

public int getTextureOversampling()

Returns the factor that forces higher resolution texture. This is needed, for instance, when the image used as a texture is of much higher precision than underlying elevation data. The texture size is doubled between level and (level+1). 0 means no oversampling.

Returns:

level The level of oversampling.