Struct ChunkSkyLightSources 

pub struct ChunkSkyLightSources {
    min_y: i32,
    pub(super) heightmap: [i32; 256],
}

Per-chunk cache of the lowest skylight source edge in each X/Z column.

Vanilla stores this in a 256-entry SimpleBitStorage. Steel keeps absolute i32 Y values instead; the cached semantics are the same, and this avoids a new bit-storage abstraction before another system needs one.

Fields

min_y: i32

heightmap: [i32; 256]

Implementations

impl ChunkSkyLightSources

pub const fn new( min_y: i32, height: i32, ) -> Result<Self, LightSectionRangeError>

Creates an empty skylight-source cache for a level height.

pub fn for_valid_world_height(min_y: i32, height: i32) -> Self

Creates a cache for world heights already accepted by chunk construction.

Invalid world heights are fatal because chunks and light sections cannot be indexed coherently without a valid vertical range.

Panics

Panics when the supplied world height cannot form a valid light-section range.

pub fn fill_from_sections(&mut self, sections: &Sections)

Fills this cache from a chunk’s sections.

pub fn update( &mut self, x: usize, y: i32, z: usize, state_at: impl FnMut(usize, i32, usize) -> BlockStateId, ) -> bool

Updates one column after a block change.

state_at is called with section-local X/Z and world Y coordinates. Returns true when the cached source edge changed.

pub const fn get_lowest_source_y(&self, x: usize, z: usize) -> i32

Returns the lowest skylight source Y for a local X/Z column.

pub fn get_highest_lowest_source_y(&self) -> i32

Returns the highest cached lowest-source Y across all columns.

fn find_lowest_source_y( &self, sections: &Sections, top_section_index: usize, x: usize, z: usize, ) -> i32

fn update_edge( &mut self, index: usize, old_top_edge_y: i32, x: usize, z: usize, checked_edge_y: i32, top_state: BlockStateId, bottom_y: i32, bottom_state: BlockStateId, state_at: &mut impl FnMut(usize, i32, usize) -> BlockStateId, ) -> bool

fn find_lowest_source_below( &self, x: usize, z: usize, start_y: i32, start_state: BlockStateId, state_at: &mut impl FnMut(usize, i32, usize) -> BlockStateId, ) -> i32

fn is_edge_occluded(top_state: BlockStateId, bottom_state: BlockStateId) -> bool

fn fill(&mut self, lowest_source_y: i32)

const fn set(&mut self, index: usize, value: i32)

const fn get(&self, index: usize) -> i32

const fn extend_sources_below_world(&self, value: i32) -> i32

const fn section_y_from_index(&self, section_index: usize) -> i32

const fn section_to_block_coord(section_y: i32) -> i32

const fn index(x: usize, z: usize) -> usize

fn air_state() -> BlockStateId

Trait Implementations

impl Clone for ChunkSkyLightSources

fn clone(&self) -> ChunkSkyLightSources

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ChunkSkyLightSources

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for ChunkSkyLightSources

impl PartialEq for ChunkSkyLightSources

fn eq(&self, other: &ChunkSkyLightSources) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ChunkSkyLightSources