mapsglmaps/com.xweather.mapsgl.sources/VectorTileSource/Companion

Companion

Types

data class DebugParseBreakdown(val featureCount: Int, val clusteredFeatureCount: Int?, val decodeAllMs: Long, val convertMs: Long, val clusterMs: Long)

Demo/debug-only: breakdown of one parseVectorTile call. decodeAllMs is the initial whole-tile com.xweather.mapsgl.mvt.MvtReader.decode used only to discover layer names; convertMs is the per-layer decode-plus-Feature-conversion loop (usually the expensive part for point-heavy layers); clusterMs is only nonzero when point de-duplication (>3000 point features) ran.

DebugRequestTiming

data class DebugRequestTiming(val networkMs: Long, val parseMs: Long)

Demo/debug-only: one completed requestTile call's timing. networkMs covers acquiring timeSeriesDownloadSemaphore (if applicable) plus the HTTP fetch itself; parseMs covers acquiring vectorParseSemaphore plus the actual MVT decode.

Properties

DEBUG_PARSE_SEMAPHORE_CAPACITY

const val DEBUG_PARSE_SEMAPHORE_CAPACITY: Int = 12

Demo/debug-only: total permits in vectorParseSemaphore.

TIME_SERIES_MAX_IN_FLIGHT_BEFORE_PREFETCH

const val TIME_SERIES_MAX_IN_FLIGHT_BEFORE_PREFETCH: Int = 24

Functions

debugAvailableParseSlots

fun debugAvailableParseSlots(): Int

Demo/debug-only: free MVT-decode slots (out of DEBUG_PARSE_SEMAPHORE_CAPACITY), shared by every VectorTileSource instance. 0 means decode concurrency is currently the bottleneck — tiles are downloaded but queued waiting for a free parse slot.

debugNativeCacheUsage

fun debugNativeCacheUsage(): List<Triple<String, Long, Long>>

Demo/debug-only: current bytes used / configured budget bytes for every native mesh/tile cache namespace (mvt/fillmesh/outlinemesh/circlemesh), plus a "total" row summing all four — see com.xweather.mapsgl.NativeCacheBudget. Bridged here (a public companion function) because com.xweather.mapsgl.NativeCacheBudget itself is internal and not reachable from a consuming app module. Returns an empty list before the first com.xweather.mapsgl.map.MapController has configured the budget.

debugRecentParseBreakdowns

fun debugRecentParseBreakdowns(): List<VectorTileSource.Companion.DebugParseBreakdown>

Demo/debug-only: the most recent (up to DEBUG_RECENT_TIMINGS_MAX) parse breakdowns across all vector sources, oldest first.

debugRecentRequestTimings

fun debugRecentRequestTimings(): List<VectorTileSource.Companion.DebugRequestTiming>

Demo/debug-only: the most recent (up to DEBUG_RECENT_TIMINGS_MAX) request timings across all vector sources, oldest first.