Click or drag to resize

RasterTerrainCache Class

A cache of raster terrain posts. A cache instance is associated with exactly one RasterTerrainProvider.
Inheritance Hierarchy

Namespace:  AGI.Foundation.Terrain
Assembly:  AGI.Foundation.TerrainReaders (in AGI.Foundation.TerrainReaders.dll) Version: 19.4.401.0 (19.4.401.0)
Syntax
public class RasterTerrainCache : TerrainCache

The RasterTerrainCache type exposes the following members.

Constructors
  NameDescription
Public methodRasterTerrainCache
Initializes a new instance.
Top
Properties
  NameDescription
Public propertyCacheTileSize
Gets or sets the size, in posts, of a terrain region in the cache. Some RasterTerrainProviders set this to their natural tile size during construction in order to improve read performance. It cannot be set after the cache is used for the first time. Because adjacent cache blocks share rows or columns of posts, the actual number of posts requested from the terrain provider will be one post greater than this number in each direction. For example, if the tile size is 1200, a westernmost cache block will cover posts 0 through 1200 (inclusive, for a total of 1201 posts) in the longitude direction. The next cache block to the east will cover posts 1200 through 2400 (1201 posts again).
Public propertyGroup
Gets the TerrainCacheGroup that contains this cache.
(Inherited from TerrainCache.)
Public propertyLeastRecentlyUsedRegion
Gets the region in this cache that was least recently used.
(Overrides TerrainCacheLeastRecentlyUsedRegion.)
Public propertySize
Gets the total memory, in bytes, used by all regions in the cache.
(Overrides TerrainCacheSize.)
Top
Methods
  NameDescription
Public methodEquals
Determines whether the specified object is equal to the current object.
(Inherited from Object.)
Protected methodFinalize
Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
(Inherited from Object.)
Public methodGetCacheRegionContainingPoint
Gets the extents of the cache region that contains a specified longitude and latitude.
Public methodGetHashCode
Serves as the default hash function.
(Inherited from Object.)
Public methodGetPosts
Gets the collection of posts containing a specified longitude and latitude. If a region satisfying the request is in the cache it will be returned. Otherwise, a minimal region will be loaded to satisfy the request and a load of a larger region will be queued to the TerrainCacheGroup thread.
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Protected methodLoadRegion
Loads the specified region into the cache.
(Overrides TerrainCacheLoadRegion(TerrainRegion).)
Protected methodMemberwiseClone
Creates a shallow copy of the current Object.
(Inherited from Object.)
Public methodPreloadExtent
Loads the terrain data in a given extent into the terrain cache. This method does not return until the terrain data is fully loaded. All terrain data within the extent is loaded into memory even if doing so would exceed the TerrainCacheGroup'sMaximumSize. Furthermore, the loaded terrain data is locked in memory (meaning it will not be unloaded) until the user calls UnloadExtent(CartographicExtent). This method is safe to call from any thread.
Protected methodRemoveRegion
Removes the specified region from the cache.
(Overrides TerrainCacheRemoveRegion(TerrainRegion).)
Public methodToString
Returns a string that represents the current object.
(Inherited from Object.)
Public methodUnloadExtent
Unloads the cached terrain data for a given extent. This method unloads all cached regions where any part of the region falls within the extent. It does not return until the regions have been unloaded. However, if a region within the extent is being used in another thread while this method is executing, the region may be reloaded immediately after this method unloads it. This method is safe to call from any thread.
Top
See Also