Struct LightWorkset 

pub struct LightWorkset {
    layout: LightCacheLayout,
    chunks: LightChunkSlotArray<LightWorksetChunk>,
}

Scoped chunk admission for one light operation.

This keeps the ScalableLux cache-window admission rules without storing long-lived borrows into chunk internals. The workset pins admitted chunk holders, then builds short-lived read caches with locks acquired in stable cache-slot order.

Fields

layout: LightCacheLayout

chunks: LightChunkSlotArray<LightWorksetChunk>

Implementations

impl LightWorkset

pub fn setup( layout: LightCacheLayout, radius: LightCacheSetupRadius, relaxed: bool, chunk_for_lighting: impl FnMut(ChunkPos) -> Option<Arc<ChunkHolder>>, can_use_chunk: impl FnMut(&Chunk) -> bool, ) -> Result<Self, LightWorksetSetupError>

Creates a scoped cache window by scanning chunks in ScalableLux setup order.

pub fn setup_with_scopes( layout: LightCacheLayout, radius: LightCacheSetupRadius, relaxed: bool, chunk_for_lighting: impl FnMut(ChunkPos) -> Option<Arc<ChunkHolder>>, can_use_chunk: impl FnMut(CachedLightChunk, &ChunkHolder, &Chunk) -> (bool, bool), ) -> Result<Self, LightWorksetSetupError>

Creates a scoped cache window with separate section-read and light-write admission.

pub const fn layout(&self) -> LightCacheLayout

Returns this workset’s cache layout.

pub fn chunk_holder( &self, cached_chunk: CachedLightChunk, ) -> Option<&Arc<ChunkHolder>>

Returns the holder for a cached chunk slot.

pub fn can_read_sections(&self, cached_chunk: CachedLightChunk) -> bool

Returns whether a cached chunk was admitted for section reads.

pub fn can_write_light(&self, cached_chunk: CachedLightChunk) -> bool

Returns whether a cached chunk was admitted for light writes.

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

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

The workset keeps holder Arcs alive, while this cache borrows the chunks installed in their stable OnceLock storage for the scoped operation.

fn try_get_holder( cached_chunk: CachedLightChunk, relaxed: bool, chunk_for_lighting: &mut impl FnMut(ChunkPos) -> Option<Arc<ChunkHolder>>, ) -> Result<Option<Arc<ChunkHolder>>, LightWorksetSetupError>