agi.foundation.terrain

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

Class TerrainPostsInt32

java.lang.Object

agi.foundation.terrain.TerrainPosts

agi.foundation.terrain.TerrainPostsInt32

public class TerrainPostsInt32
extends TerrainPosts

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

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
int	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.
int	getVoidValue() Gets the integer value that indicates a void (or post with unknown height).
void	set(int longitudeIndex, int latitudeIndex, int 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

TerrainPostsInt32

public TerrainPostsInt32(RasterTerrainProvider provider,
                         @Nonnull
                         RasterTerrainIndexExtent indexExtent,
                         int 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 int 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,
                      int 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 int getVoidValue()

Gets the integer 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 TerrainPostsInt32.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.