agi.foundation.terrain

(agi.foundation.terrainreaders-2024r3.jar)

Class TerrainPostsFloat

java.lang.Object

agi.foundation.terrain.TerrainPosts

agi.foundation.terrain.TerrainPostsFloat

public class TerrainPostsFloat
extends TerrainPosts

A collection of posts from a RasterTerrainProvider where each post is stored as a float.

Constructor Summary

Constructors

Constructor and Description
TerrainPostsFloat(RasterTerrainProvider provider, RasterTerrainIndexExtent indexExtent, float voidValue) Initializes a new instance.

Method Summary

Modifier and Type	Method and Description
float	get(int longitudeIndex, int latitudeIndex) Gets the post height at a particular set of indices.
void	getFourPostHeights(int west, int south, int east, int north, double[] southWest, double[] southEast, double[] northEast, double[] northWest) Gets the heights of four posts, specified by index.
double	getPostHeight(int longitudeIndex, int latitudeIndex) Gets the height at a post.
long	getSize() Gets the size of the post data, in bytes.
float	getVoidValue() Gets the float value that indicates a void (or post with unknown height).
void	set(int longitudeIndex, int latitudeIndex, float value) Sets the post height at a particular set of indices.

Methods inherited from class agi.foundation.terrain.TerrainPosts

getBoundingExtent, getFourSurroundingPosts, getIndexExtent, getTerrainProvider, indexToLatitude, indexToLongitude, latitudeToIndex, longitudeToIndex

Methods inherited from class java.lang.Object

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

Constructor Detail

TerrainPostsFloat

public TerrainPostsFloat(RasterTerrainProvider provider,
                         @Nonnull
                         RasterTerrainIndexExtent indexExtent,
                         float voidValue)

Initializes a new instance.

Parameters:

provider - The terrain provider that provided this collection of posts.

indexExtent - The extent of indices of this instance in the overall terrain provider.

voidValue - The value that indicates a void (or post with unknown height).

Method Detail

getFourPostHeights

public void getFourPostHeights(int west,
                               int south,
                               int east,
                               int north,
                               @Nonnull
                               double[] southWest,
                               @Nonnull
                               double[] southEast,
                               @Nonnull
                               double[] northEast,
                               @Nonnull
                               double[] northWest)

Gets the heights of four posts, specified by index.

Specified by:

getFourPostHeights in class TerrainPosts

Parameters:

west - The index of the two western posts. 0 refers to western-most post stored by this instance.

south - The index of the two southern posts. 0 refers to southern-most post stored by this instance.

east - The index of the two eastern posts. 0 refers to western-most post stored by this instance.

north - The index of the two northern posts. 0 refers to southern-most post stored by this instance.

southWest - On input, an array with one element. On return, the array is populated with the height of the southwest post, in the native units of the terrain provider.

southEast - On input, an array with one element. On return, the array is populated with the height of the southeast post, in the native units of the terrain provider.

northEast - On input, an array with one element. On return, the array is populated with the height of the northeast post, in the native units of the terrain provider.

northWest - On input, an array with one element. On return, the array is populated with the height of the northwest post, in the native units of the terrain provider.

Throws:

IndexOutOfBoundsException - Thrown when an index is outside the extent of this collection of posts.

get

public final float get(int longitudeIndex,
                       int latitudeIndex)

Gets the post height at a particular set of indices.

Parameters:

longitudeIndex - The longitude index of the post. 0 refers to the western-most post stored by this instance.

latitudeIndex - The latitude index of the post. 0 refers to the southern-most post stored by this instance.

Returns:

The height of the post, in the native units of the terrain provider.

set

public final void set(int longitudeIndex,
                      int latitudeIndex,
                      float value)

Sets the post height at a particular set of indices.

Parameters:

longitudeIndex - The longitude index of the post. 0 refers to the western-most post stored by this instance.

latitudeIndex - The latitude index of the post. 0 refers to the southern-most post stored by this instance.

getVoidValue

public final float getVoidValue()

Gets the float value that indicates a void (or post with unknown height).

getSize

public long getSize()

Gets the size of the post data, in bytes.

Specified by:

getSize in class TerrainPosts

getPostHeight

public double getPostHeight(int longitudeIndex,
                            int latitudeIndex)

Gets the height at a post.

In performance critical code, consider using TerrainPostsFloat.getFourPostHeights(int, int, int, int, double[], double[], double[], double[]) instead of calling this method four times. Doing so will avoid unnecessary function call overhead.

Specified by:

getPostHeight in class TerrainPosts

Parameters:

longitudeIndex - The longitude index of the post. 0 refers to the western-most post stored by this instance.

latitudeIndex - The latitude index of the post. 0 refers to the southern-most post stored by this instance.

Returns:

The height of the post, in the native units of the terrain provider.

Throws:

IndexOutOfBoundsException - Thrown when longitudeIndex or latitudeIndex is outside the extent of this collection of posts.