Skip to main content

Interface: LocalLightStats

Mutated in place every update; never reallocated.

Properties​

atlasBytes​

• atlasBytes: number

GPU bytes held by the shadow atlas (0 until first allocation).

atlasEvictions​

• atlasEvictions: number

Cumulative slot evictions through the challenger hysteresis.

atlasOccupancy​

• atlasOccupancy: number

Active shadow slots over capacity, 0..1.

candidates​

• candidates: number

cellsOverflowed​

• cellsOverflowed: number

clustered​

• clustered: number

dataTextureUploads​

• dataTextureUploads: number

fadingLights​

• fadingLights: number

Lights still packed only to finish fading out of the selection.

fadingSlots​

• fadingSlots: number

Cell slots mid-fade after the last update.

gridTextureUploads​

• gridTextureUploads: number

highResolution​

• highResolution: number

1 while the drawing buffer is past the high-resolution gate.

ledgerUnitsCsm​

• ledgerUnitsCsm: number

Ledger units the CSM cascades consumed this frame.

ledgerUnitsLocal​

• ledgerUnitsLocal: number

Ledger units local faces consumed this frame.

packMs​

• packMs: number

packMsPeak​

• packMsPeak: number

registered​

• registered: number

scanMs​

• scanMs: number

scanMsPeak​

• scanMsPeak: number

sectionsPendingScan​

• sectionsPendingScan: number

selectMs​

• selectMs: number

Cost of the current frame's phases; 0 on frames that skipped them.

selectMsPeak​

• selectMsPeak: number

Worst frame since the last LocalLights.resetPeakStats.

selectionChurn​

• selectionChurn: number

shadowCacheHitRate​

• shadowCacheHitRate: number

Of the frames in which a shadowed light was live, the fraction served entirely from its cached static faces. Resets with peak stats.

shadowFacesDynamic​

• shadowFacesDynamic: number

shadowFacesRendered​

• shadowFacesRendered: number

Atlas faces rendered this frame (static + dynamic).

shadowFacesStatic​

• shadowFacesStatic: number

shadowInvalidations​

• shadowInvalidations: number

Cumulative cache invalidations (block edits, streaming, regions).

shadowScheduleMs​

• shadowScheduleMs: number

Main-thread cost of the shadow schedule + face renders this frame.

shadowScheduleMsPeak​

• shadowScheduleMsPeak: number

shadowed​

• shadowed: number

Lights currently holding a shadow slot.