agi.foundation.terrain

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

Class AGIProcessedDataTerrain

java.lang.Object

agi.foundation.terrain.TerrainProvider

agi.foundation.terrain.RasterTerrainProvider

agi.foundation.terrain.AGIProcessedDataTerrain

public class AGIProcessedDataTerrain
extends RasterTerrainProvider

A terrain provider for reading terrain from AGI Processed Data Terrain(PDTT) files.

Constructor Summary

Constructors

Constructor and Description
AGIProcessedDataTerrain(StreamFactory streamFactory) Initializes a new instance using the specified stream factory.
AGIProcessedDataTerrain(StreamFactory streamFactory, TerrainCacheGroup cacheGroup) Initializes a new instance using the specified stream factory and cache group.
AGIProcessedDataTerrain(String fileName) Initializes a new instance using the specified PDTT file.
AGIProcessedDataTerrain(String fileName, TerrainCacheGroup cacheGroup) Initializes a new instance using the specified PDTT file and cache group.

Method Summary

Modifier and Type	Method and Description
TerrainPosts	getPosts(RasterTerrainIndexExtent extent) Returns the altitude values for the input boundary.

Methods inherited from class agi.foundation.terrain.RasterTerrainProvider

cartographicExtentToIndexExtent, getCache, getDefaultInterpolator, getDeltaLatitude, getDeltaLatitudeNativeUnits, getDeltaLongitude, getDeltaLongitudeNativeUnits, getEasternPostOffsetNativeUnits, getFirstPartials, getFirstPartials, getHeight, getHeight, getHeightNativeUnits, getHeightNativeUnits, getHeightRelativeToShape, getLatitudePosts, getLongitudePosts, getMinimumSampleSpacing, getNeedsSpecialCoordinateProcessing, getNorthernPostOffsetNativeUnits, getSecondPartials, getSecondPartials, getSouthernPostOffsetNativeUnits, getWesternPostOffsetNativeUnits, indexToLatitude, indexToLongitude, latitudeToIndex, longitudeToIndex, preloadExtent, processCoordinates, setDefaultInterpolator, setDeltaLatitude, setDeltaLatitudeNativeUnits, setDeltaLongitude, setDeltaLongitudeNativeUnits, setEasternPostOffsetNativeUnits, setLatitudePosts, setLongitudePosts, setNeedsSpecialCoordinateProcessing, setNorthernPostOffsetNativeUnits, setSouthernPostOffsetNativeUnits, setWesternPostOffsetNativeUnits, unloadExtent

Methods inherited from class agi.foundation.terrain.TerrainProvider

getBoundingExtent, getBoundingExtentNativeUnits, getGradient, getHeightReference, getHeightRelativeToShape, getHessian, getLocalMinimumSampleSpacing, getNativeToMeters, getNormal, getRadiansToNative, getReferenceSurface, getShape, getShapeFixedFrame, inGlobalBounds, setBoundingExtent, setBoundingExtentNativeUnits, setHeightReference, setNativeToMeters, setRadiansToNative, setReferenceSurface, setShape, setShapeFixedFrame

Methods inherited from class java.lang.Object

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

Constructor Detail

AGIProcessedDataTerrain

public AGIProcessedDataTerrain(@Nonnull
                               String fileName)

Initializes a new instance using the specified PDTT file.

Parameters:

fileName - The full path and filename of the .PDTT file

Throws:

ArgumentNullException - Thrown when fileName is null.

AGIProcessedDataTerrain

public AGIProcessedDataTerrain(@Nonnull
                               String fileName,
                               @Nonnull
                               TerrainCacheGroup cacheGroup)

Initializes a new instance using the specified PDTT file and cache group.

Parameters:

fileName - The full path and filename of the .PDTT file

cacheGroup - The cache group with which to associate this terrain provider.

Throws:

ArgumentNullException - Thrown when fileName or cacheGroup is null.

AGIProcessedDataTerrain

public AGIProcessedDataTerrain(@Nonnull
                               StreamFactory streamFactory)

Initializes a new instance using the specified stream factory.

The streams created by streamFactory must support seeking. This means that the streams must implement ISeekableStream or FileInputStream.

Parameters:

streamFactory - The factory to use to create streams to read the terrain data.

Throws:

ArgumentNullException - Thrown when streamFactory is null.

AGIProcessedDataTerrain

public AGIProcessedDataTerrain(@Nonnull
                               StreamFactory streamFactory,
                               @Nonnull
                               TerrainCacheGroup cacheGroup)

Initializes a new instance using the specified stream factory and cache group.

The streams created by streamFactory must support seeking. This means that the streams must implement ISeekableStream or FileInputStream.

Parameters:

streamFactory - The factory to use to create streams to read the terrain data.

cacheGroup - The cache group with which to associate this terrain provider.

Throws:

ArgumentNullException - Thrown when streamFactory or cacheGroup is null.

Method Detail

getPosts

public TerrainPosts getPosts(@Nonnull
                             RasterTerrainIndexExtent extent)

Returns the altitude values for the input boundary.

Specified by:

getPosts in class RasterTerrainProvider

Parameters:

extent - The terrain extent over which to retrieve the posts

Returns:

The posts of the terrain contained within the area defined by the passed in extent