Struct BrickCache 

pub struct BrickCache { /* private fields */ }

Persistent, cross-frame brick occupancy cache (Substage DDA.7 perf). Keyed by (chunk x, y, z, mip) with the chunk’s edit version; an entry is reused until its chunk’s version changes, so a static / streamed-once world pays zero brick-build cost after the first frame (the per-frame rebuild was the dominant DDA cost).

Owned by the caller across frames (the scene’s Grid), populated single-threaded via Self::ensure, then borrowed immutably by the parallel render bands.

Implementations

impl BrickCache

pub fn new() -> Self

An empty cache (same as Default). Entries appear via ensure as chunks are first rendered.

pub fn ensure( &mut self, chunk: [i32; 3], mip: u32, version: u64, view: &GridView<'_>, )

Ensure a current mip-mip brick map exists for chunk (built from view); rebuilds only when the cached version differs.

pub fn retain_chunks(&mut self, keep: impl Fn([i32; 3]) -> bool)

Drop cached entries whose chunk fails keep — bounds memory as streaming evicts chunks. Called once per frame by the scene.

pub fn brick_occupied_at( &self, chunk: [i32; 3], mip: u32, cell: [i32; 3], ) -> Option<bool>

PF.9 — occupancy of the BRICK³ block containing chunk-local mip-mip cell cell of chunk. None when no map is cached for that (chunk, mip) — the caller must fall back to dense stepping. Some(false) guarantees the whole 8³ block holds no solid voxel, so an external shadow march may skip it wholesale.

pub fn super_occupied_at( &self, chunk: [i32; 3], mip: u32, cell: [i32; 3], ) -> Option<bool>

PF.9 — like Self::brick_occupied_at for the SUPER³ (64³ at mip 0) super-brick level.

Trait Implementations

impl Debug for BrickCache

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

Formats the value using the given formatter.

impl Default for BrickCache

fn default() -> BrickCache

Returns the “default value” for a type.