Struct LightChunkReadCache 

pub struct LightChunkReadCache<'a> {
    layout: LightCacheLayout,
    chunks: LightChunkSlotArray<&'a Chunk>,
    light_chunks: LightChunkSlotArray<&'a Chunk>,
}

Flat cached chunk reads for one scoped lighting operation.

Fields

layout: LightCacheLayout

chunks: LightChunkSlotArray<&'a Chunk>

light_chunks: LightChunkSlotArray<&'a Chunk>

Implementations

impl LightChunkReadCache<'_>

pub const fn layout(&self) -> LightCacheLayout

Returns this read cache’s layout.

pub fn chunk(&self, cached_chunk: CachedLightChunk) -> Option<&Chunk>

Returns the cached chunk for a chunk slot.

pub fn with_section_read_cache<R>( &self, f: impl FnOnce(&LightSectionReadCache<'_>) -> R, ) -> R

Builds a section-read cache for the duration of f.

Section locks are acquired in cache-slot order and released before this method returns. Emptiness maps are copied into the cache so propagation can query known section emptiness without keeping additional borrows.

pub fn with_light_edit<R>( &self, layer: LightLayer, f: impl FnOnce(LightLayerEdit<'_>) -> R, ) -> R

Builds a layer-specific light edit cache for the duration of f.

Committed chunk light storage is copied into the edit cache before propagation mutates it. The edit writes back only through LightLayerEdit::commit, so chunk-owned light does not regain the old persistent visible/updating split.