RasterTerrainCache Class |
A cache of raster terrain posts.
A cache instance is associated with exactly one RasterTerrainProvider.
Inheritance HierarchyNamespace: AGI.Foundation.Terrain
Assembly: AGI.Foundation.TerrainReaders (in AGI.Foundation.TerrainReaders.dll) Version: 24.1.418.0 (24.1.418.0)
SyntaxThe RasterTerrainCache type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | RasterTerrainCache |
Initializes a new instance.
|
Properties| Name | Description | |
|---|---|---|
 | CacheTileSize |
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).
|
| Group |
Gets the TerrainCacheGroup that contains this cache.
(Inherited from TerrainCache.) |
| LeastRecentlyUsedRegion |
Gets the region in this cache that was least recently used.
(Overrides TerrainCacheLeastRecentlyUsedRegion.) |
| Size |
Gets the approximate total memory, in bytes, used by all regions in the cache.
(Overrides TerrainCacheSize.) |
Methods| Name | Description | |
|---|---|---|
| Equals | Determines whether the specified object is equal to the current object. (Inherited from Object.) |
 | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
| GetCacheRegionContainingPoint |
Gets the extents of the cache region that contains a specified longitude and latitude.
|
| GetHashCode | Serves as the default hash function. (Inherited from Object.) |
| GetPosts |
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.
|
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| LoadRegion |
Loads the specified region into the cache.
(Overrides TerrainCacheLoadRegion(TerrainRegion).) |
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
| PreloadExtent |
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.
|
| RemoveRegion |
Removes the specified region from the cache.
(Overrides TerrainCacheRemoveRegion(TerrainRegion).) |
| ToString | Returns a string that represents the current object. (Inherited from Object.) |
| UnloadExtent |
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.
|
See Also