Struct LightLayerEdit 

pub struct LightLayerEdit<'a> {
    layout: LightCacheLayout,
    layer: LightLayer,
    chunks: LightChunkSlotArray<RwLockWriteGuard<'a, ChunkLightData>>,
    sections: LightSectionSlotArray<LightSectionEditEntry>,
    removed_missing_sections: LightSectionSlotArray<StoredLightSectionEdit>,
    edits: Vec<LightSectionEdit>,
}

Scoped mutable light edits for one layer and one workset.

Fields

layout: LightCacheLayout

layer: LightLayer

chunks: LightChunkSlotArray<RwLockWriteGuard<'a, ChunkLightData>>

sections: LightSectionSlotArray<LightSectionEditEntry>

removed_missing_sections: LightSectionSlotArray<StoredLightSectionEdit>

edits: Vec<LightSectionEdit>

Implementations

impl LightLayerEdit<'_>

pub const fn layout(&self) -> LightCacheLayout

Returns this edit cache’s layout.

pub const fn layer(&self) -> LightLayer

Returns this edit cache’s light layer.

pub fn get(&self, cached_block: CachedLightBlock) -> u8

Returns an edited light value for a cached light block.

pub fn has_non_missing(&self, cached_block: CachedLightBlock) -> bool

Returns whether a cached block has a non-missing edited section.

pub fn has_non_missing_section(&self, section_pos: SectionPos) -> bool

Returns whether a cached section has a non-missing edited section.

pub fn is_section_missing(&self, section_pos: SectionPos) -> bool

Returns whether a cached section has an edited missing section.

pub fn has_cached_section(&self, section_pos: SectionPos) -> bool

Returns whether a cached section was admitted into the edit cache.

pub fn has_light_data_section(&self, section_pos: SectionPos) -> bool

Returns true when a cached section has edited light data.

pub fn section_empty(&self, section_pos: SectionPos) -> Option<bool>

Returns known real-section emptiness for a writable cached chunk column.

pub fn set_section_empty( &mut self, section_pos: SectionPos, empty: bool, ) -> Option<bool>

Updates the cached light layer’s real-section emptiness map.

Returns the previous value when the target layer and section are writable.

pub fn set_section_non_missing(&mut self, section_pos: SectionPos) -> bool

Marks a cached light section non-missing without allocating packed bytes.

Returns false when the section has no writable cached edit entry.

pub fn set_section_missing(&mut self, section_pos: SectionPos) -> bool

Marks a cached light section missing and drops edited bytes.

Returns false when the section has no writable cached edit entry.

pub fn set_section_internal(&mut self, section_pos: SectionPos) -> bool

Hides a cached section from external packet/save conversion.

Missing and visible zero sections become missing, matching old Uninitialized -> Null hidden-state behavior.

pub fn reset_chunk_sections_to_missing(&mut self, chunk_pos: ChunkPos) -> bool

Replaces one cached chunk column’s layer sections with fresh missing sections.

Initial chunk lighting lights into a fresh center layer, so previous neighbor-written data cannot become the center chunk’s canonical light.

pub fn rewrite_missing_sections_for_skylight(&mut self)

Removes missing sky sections from the temporary edit cache.

Later materialization can create transient sections for propagation; those transient sections notify on commit but do not write into chunk storage.

pub fn materialize_removed_missing_section( &mut self, section_pos: SectionPos, ) -> bool

Materializes a sky section that was removed from the temporary edit cache.

Returns false when the section was not part of the writable cache or was not removed by Self::rewrite_missing_sections_for_skylight.

pub fn fill_section(&mut self, section_pos: SectionPos, value: u8) -> bool

Fills a cached section with one edited light value.

Returns false when the section has no writable cached edit entry.

pub fn extrude_lower_from_first_section_above( &mut self, section_pos: SectionPos, ) -> bool

Extrudes the lower row from the first non-missing cached section above.

Returns false when the target section or source section is unavailable.

pub fn get_at_section_index( &self, section_slot: usize, local_index: usize, ) -> u8

Returns an edited light value for a section slot and local light index.

pub fn set(&mut self, cached_block: CachedLightBlock, level: u8) -> bool

Sets an edited light value for a cached light block.

Returns false when no writable non-missing section was cached for the block.

pub fn set_at_section_index( &mut self, section_slot: usize, local_index: usize, level: u8, ) -> bool

Sets an edited light value for a section slot and local light index.

Returns false when no writable non-missing section was cached for the slot.

pub fn commit( self, notifications: Option<&LightUpdateNotificationCache>, on_update: impl FnMut(SectionPos), ) -> usize

Commits edited stored sections and publishes changed or notified sections.

fn build_section_edits( layout: LightCacheLayout, layer: LightLayer, chunks: &LightChunkSlotArray<RwLockWriteGuard<'_, ChunkLightData>>, edits: &mut Vec<LightSectionEdit>, ) -> LightSectionSlotArray<LightSectionEditEntry>

fn commit_stored_section( &mut self, target: StoredLightSectionEdit, edit_index: usize, ) -> bool

fn set_section_slot_non_missing(&mut self, section_slot: usize) -> bool

fn section_edit(&self, section_slot: usize) -> Option<&LightSectionEdit>

fn section_edit_mut( &mut self, section_slot: usize, ) -> Option<&mut LightSectionEdit>

const fn layer_storage( light_data: &ChunkLightData, layer: LightLayer, ) -> &ChunkLightLayerStorage

const fn layer_storage_mut( light_data: &mut ChunkLightData, layer: LightLayer, ) -> &mut ChunkLightLayerStorage