ilog.views.maps.defense.terrain3d.model

Class IlvRasterMappedBuffer3DTile

java.lang.Object

ilog.views.maps.defense.terrain3d.model.Ilv3DTile

ilog.views.maps.defense.terrain3d.model.IlvRasterMappedBuffer3DTile

public class IlvRasterMappedBuffer3DTile
extends Ilv3DTile

This class is an Ilv3DTile based on an IlvRasterTileLoader. This tile loader provides a table of elevation values.

Since:

JViews 7.5

Constructor Summary

Constructors

Constructor and Description
IlvRasterMappedBuffer3DTile(IlvRasterTileLoader tileLoader, Ilv3DDoubleVector center, float tileWidth, float tileHeight, IlvManagerView view) Constructs an IlvRasterMappedBuffer3DTile from the specified parameters.

Method Summary

Modifier and Type	Method and Description
void	drawImageData(com.jogamp.opengl.GL2 gl, int width1, int height1) Method responsible for setting up the OpenGL texture that is used to draw the terrain.
double	getClipHeight() Returns the height of the clip
double	getClipWidth() Returns the width of the clip
double	getClipX() Returns the X coordinate of the clip.
double	getClipY() Returns the Y coordinate of the clip.
int	getTextureOversampling() Returns the factor that forces higher resolution texture.
boolean	isUse2DViewAsTexture() Returns whether the associated 2D view must be used as a texture for the 3D terrain represented by this tile.
void	loadDEM() Loads and sets up the underlying IlvTileElevationProvider.
void	loadImg(int imageLevel, IlvThreadedTaskProcessor.ThreadedTask preq) This method is responsible for generating the texture for the specified image level.
void	setImageClipping(double clipX, double clipY, double clipWidth, double clipHeight) Sets a clipping on the elevation data, so that only a subpart of it is used.
void	setTextureOversampling(int oversamplingFactor) Sets the factor that forces higher resolution texture.
void	setUse2DViewAsTexture(boolean useViewAsTexture) Sets whether the associated 2D view must be used as a texture for the 3D terrain represented by this tile.
void	setUseImageClipping(boolean useClipping) Activates/deactivates use of tile clipping.

Methods inherited from class ilog.views.maps.defense.terrain3d.model.Ilv3DTile

drawTile, drawTile, getApparentAreaFactors, getCenter, getGroundHeightAt, getTextureHeight, getTextureWidth, getTileElevationProvider, getTileHeight, getTileWidth, isKeepElevationDataCache, regenerateTexture, setImageSize, setKeepElevationDataCache, setSize, setTextureHeight, setTextureWidth, setTileElevationProvider, setupDEMLevel, setupImgLevel

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvRasterMappedBuffer3DTile

public IlvRasterMappedBuffer3DTile(IlvRasterTileLoader tileLoader,
                                   Ilv3DDoubleVector center,
                                   float tileWidth,
                                   float tileHeight,
                                   IlvManagerView view)

Constructs an IlvRasterMappedBuffer3DTile from the specified parameters.

Parameters:

tileLoader - The IlvRasterTileLoader containing elevation data.

center - The center of the tile in 3D space coordinates.

tileWidth - This tile's width, in 3D space coordinates.

tileHeight - This tile's height, in 3D space coordinates.

view - The IlvManagerView used to generate the terrain texture.

Since:

JViews 8.1

Method Detail

loadDEM

public void loadDEM()

Loads and sets up the underlying IlvTileElevationProvider.

Specified by:

loadDEM in class Ilv3DTile

loadImg

public void loadImg(int imageLevel,
                    IlvThreadedTaskProcessor.ThreadedTask preq)

This method is responsible for generating the texture for the specified image level. It is called from a dedicated loading thread, so that any intensive code will not block OpenGL drawing. Implementing a subclass will generate and store this image, which will be used to setup the texture in drawImageData() method.

Specified by:

loadImg in class Ilv3DTile

Parameters:

imageLevel - The downsampling level for image to generate.

preq - The threaded task that is calling this method.

drawImageData

public void drawImageData(com.jogamp.opengl.GL2 gl,
                          int width1,
                          int height1)

Method responsible for setting up the OpenGL texture that is used to draw the terrain. Use the image generated in the loadImg() method.

Specified by:

drawImageData in class Ilv3DTile

Parameters:

gl - The OpenGL context to set the texture onto.

width1 - The width of the texture image.

height1 - The height of the texture image.

setImageClipping

public void setImageClipping(double clipX,
                             double clipY,
                             double clipWidth,
                             double clipHeight)

Sets a clipping on the elevation data, so that only a subpart of it is used. Clipping coordinates are between 0 and 1.0, and are relative to the bounds of this tile. For instance, setting a clipping to (0,0,1.0,1.0) is equivalent to no clipping at all, whereas (0.5,0.5,0.5,0.5) defines the upper right quarter of the tile.

Parameters:

clipX - The clip start X coordinate (between 0 and 1.0).

clipY - THe clip start Y coordinate (between 0 and 1.0).

clipWidth - The clip width ((between 0 and (1.0 - clipX)).

clipHeight - The clip height ((between 0 and (1.0 - clipY)).

setUseImageClipping

public void setUseImageClipping(boolean useClipping)

Activates/deactivates use of tile clipping.

Parameters:

useClipping - true to use clipping

See Also:

setImageClipping(double, double, double, double)

getClipHeight

public double getClipHeight()

Returns the height of the clip

Returns:

The height of the clip.

getClipWidth

public double getClipWidth()

Returns the width of the clip

Returns:

The width of the clip.

getClipX

public double getClipX()

Returns the X coordinate of the clip.

Returns:

The X coordinate of the clip.

getClipY

public double getClipY()

Returns the Y coordinate of the clip.

Returns:

The Y coordinate of the clip.

isUse2DViewAsTexture

public boolean isUse2DViewAsTexture()

Returns whether the associated 2D view must be used as a texture for the 3D terrain represented by this tile. 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 useViewAsTexture)

Sets whether the associated 2D view must be used as a texture for the 3D terrain represented by this tile. 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:

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

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 the underlying elevation data. The texture size is doubled between level and (level+1). 0 means no oversampling.

Returns:

level The level of oversampling.

setTextureOversampling

public void setTextureOversampling(int oversamplingFactor)

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 the underlying elevation data. The texture size is doubled between level and (level +1). 0 means no oversampling.

Parameters:

oversamplingFactor - The level of oversampling.