WorldWind Kotlin/earth.worldwind.globe.elevation.coverage.dted/DtedElevationCoverage

DtedElevationCoverage

open class DtedElevationCoverage : TiledElevationCoverage

A single tiled elevation coverage over a local directory of DTED tiles (.dt0/.dt1/.dt2), built by create: each 1° cell is served from the finest level present (dt2 > dt1 > dt0) — one pyramid, one cache, no duplicated data. Coarse cells upsample smoothly via bilinear windowed reads; zoomed-out grids sparse-sample a per-cell overview off the render thread (the ATAK NodeElevationData pattern).

Types

Companion

object Companion

Properties

boundingSector

open val boundingSector: Sector

Bounding sector of the elevation coverage.

cachedSourceInfo

val TiledElevationCoverage.cachedSourceInfo: CachedSourceInfo?

See TiledImageLayer.cachedSourceInfo — same shape for elevation coverages. The cache provider here is the elevation source factory, not a tile-source decorator.

cacheRetrievalQueueSize

var cacheRetrievalQueueSize: Int

Concurrent cache-only reads allowed. Generous vs retrievalQueueSize: cache reads are cheap local I/O and must get their own budget separate from the network-retrieval budget, so a slow network DEM fetch holding the network slots can't stall cached tiles behind it.

displayName

open override var displayName: String?

Human-readable elevation coverage name

elevationSourceFactory

var elevationSourceFactory: ElevationSourceFactory

isEnabled

open override var isEnabled: Boolean

Determines if current elevation coverage should be processed during rendering

retrievalQueueSize

var retrievalQueueSize: Int

Controls how many concurrent tile requests are allowed for this coverage.

sector

override val sector: Sector

Elevation content bounding sector

tileCount

val tileCount: Int

Number of 1° cells served (one file per cell — the finest level present there).

tileMatrixSet

var tileMatrixSet: TileMatrixSet

Tile matrix which defines elevation coverage area.

timestamp

open override val timestamp: Long

Last elevation update timestamp

type

val type: String

Unique identifier of the coverage type, defined by elevation source factory content type

Functions

clear

open override fun clear()

Clears elevation runtime data

clone

open override fun clone(): ERROR CLASS: Unresolved name: also

Makes a copy of this elevation coverage.

contentEntry

fun TiledElevationCoverage.contentEntry(contentManager: ContentManager? = null): ContentEntry?

Elevation-coverage counterpart of TiledImageLayer.contentEntry — coverages have no "self-contained file factory" case in the current factory set, so this is just the ContentManager adapter behind a uniform call site.

getElevation

open override fun getElevation(latitude: Angle, longitude: Angle, retrieve: Boolean): Float

Gets elevation at specified location

getElevationGrid

open override fun getElevationGrid(gridSector: Sector, gridWidth: Int, gridHeight: Int, result: FloatArray)

Gets elevation values for the specified sector with required width and height resolution

getElevationLimits

open override fun getElevationLimits(sector: Sector, result: FloatArray)

Gets elevation limits at specified sector

getUserProperty

open override fun getUserProperty(key: Any): Any?

Gets optional user property

hasUserProperty

open override fun hasUserProperty(key: Any): Boolean

Checks optional user property exists

isChangedSince

open override fun isChangedSince(time: Long, sector: Sector): Boolean

Checks if coverage data influencing the specified sector could have changed after the specified timestamp

launchBulkRetrieval

fun TiledElevationCoverage.launchBulkRetrieval(sector: Sector, resolution: ClosedRange<Angle>, scope: CoroutineScope = GlobalScope, maxRetries: Int = 3, retryTimeoutShort: Duration = 5.seconds, retryTimeoutLong: Duration = 15.seconds, overrideCache: Boolean = false, onProgress: (downloaded: Long, skipped: Long, total: Long) -> Unit? = null): Job?

Download every elevation tile that intersects sector across every tile matrix whose pixel-resolution falls in resolution, writing each tile through to the coverage's cache.

putUserProperty

open override fun putUserProperty(key: Any, value: Any): Any?

Puts optional user property

removeUserProperty

open override fun removeUserProperty(key: Any): Any?

Removes optional user property

setOfflineOnly

fun TiledElevationCoverage.setOfflineOnly(offlineOnly: Boolean = true)

See setOfflineOnly on TiledImageLayer. The OfflineToggleable lives on the coverage's elevationSourceFactory (the platform-specific CachedElevationSourceFactory / GpkgCachedElevationSourceFactory both implement it). No-op when the coverage is wired to a network-only factory.

setupCoverageCache

fun setupCoverageCache(capacity: Long, lowWater: Long = (capacity * 0.75).toLong())

Setup custom coverage cache size according to device capabilities and user needs.