agi.foundation.terrain

(agi.foundation.terrainreaders-2025r1.jar)

Class QuantizedMeshTerrainTile

java.lang.Object

agi.foundation.terrain.QuantizedMeshTerrainTile

public class QuantizedMeshTerrainTile
extends Object

Represents an unpacked quantized-mesh terrain tile. See the quantized-mesh specification for more details on the format.

Method Summary

Modifier and Type	Method and Description
CartographicExtent	getBoundingExtent() Gets the bounding extent of the mesh stored by this instance.
Cartesian	getCenter() Gets the center coordinates of the tile in the fixed frame of the central body.
short	getHeight(long index) Gets the height of the vertex in the tile with the given index.
float	getMaximumHeight() Gets the maximum height in the area covered by this tile.
float	getMinimumHeight() Gets the minimum height in the area covered by this tile.
int	getNumberOfTriangles() Gets the number of triangles.
int	getNumberOfVertices() Gets the number of vertices.
long	getSize() Gets the approximate size of the terrain tile data, in bytes.
short	getUValue(long index) Gets the horizontal coordinate of the vertex in the tile with the given index.
long	getVertexIndex(int index) Gets the vertex index for the given index, with three indices per triangle.
short	getVValue(long index) Gets the vertical coordinate of the vertex in the tile with the given index.
static QuantizedMeshTerrainTile	readFromStream(CartographicExtent boundingExtent, InputStream stream) Reads an uncompressed quantized-mesh terrain data from the given stream and creates a tile.

Methods inherited from class java.lang.Object

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

Method Detail

readFromStream

@Nonnull
public static QuantizedMeshTerrainTile readFromStream(@Nonnull
                                                                CartographicExtent boundingExtent,
                                                                @Nonnull
                                                                InputStream stream)

Reads an uncompressed quantized-mesh terrain data from the given stream and creates a tile.

Parameters:

boundingExtent - The extent that this instance covers.

stream - A InputStream containing uncompressed tile data.

Returns:

A QuantizedMeshTerrainTile parsed from the data.

Throws:

ArgumentNullException - Thrown if boundingExtent or stream is null.

getSize

public final long getSize()

Gets the approximate size of the terrain tile data, in bytes.

getBoundingExtent

@Nonnull
public final CartographicExtent getBoundingExtent()

Gets the bounding extent of the mesh stored by this instance.

getCenter

@Nonnull
public final Cartesian getCenter()

Gets the center coordinates of the tile in the fixed frame of the central body. All vertex positions are relative to this.

getMinimumHeight

public final float getMinimumHeight()

Gets the minimum height in the area covered by this tile. The minimum may be lower than the height of any vertex in this tile in the case that the min vertex was removed during mesh simplification, but these are the appropriate values to use for analysis or visualization.

getMaximumHeight

public final float getMaximumHeight()

Gets the maximum height in the area covered by this tile. The maximum may be higher than the height of any vertex in this tile in the case that the max vertex was removed during mesh simplification, but these are the appropriate values to use for analysis or visualization.

getNumberOfVertices

public final int getNumberOfVertices()

Gets the number of vertices.

getUValue

public final short getUValue(long index)

Gets the horizontal coordinate of the vertex in the tile with the given index. When this value is 0, the vertex is on the Western edge of the tile. When this value is 32767, the vertex is on the Eastern edge of the tile. For other values, the vertex's longitude is a linear interpolation between the longitudes of the Western and Eastern edges of the tile.

Parameters:

index - The index of the vertex.

Returns:

The horizontal coordinate of the vertex.

getVValue

public final short getVValue(long index)

Gets the vertical coordinate of the vertex in the tile with the given index. When this value is 0, the vertex is on the Southern edge of the tile. When this value is 32767, the vertex is on the Northern edge of the tile. For other values, the vertex's latitude is a linear interpolation between the latitudes of the Southern and Northern edges of the tile.

Parameters:

index - The index of the vertex.

Returns:

The vertical coordinate of the vertex.

getHeight

public final short getHeight(long index)

Gets the height of the vertex in the tile with the given index. When this value is 0, the vertex's height is equal to the minimum height within the tile, as specified in the tile's header. When this value is 32767, the vertex's height is equal to the maximum height within the tile. For other values, the vertex's height is a linear interpolation between the minimum and maximum heights.

Parameters:

index - The index of the vertex.

Returns:

The height of the vertex.

getNumberOfTriangles

public final int getNumberOfTriangles()

Gets the number of triangles.

getVertexIndex

public final long getVertexIndex(int index)

Gets the vertex index for the given index, with three indices per triangle.

Parameters:

index - The index.

Returns:

The vertex index.