Struct StreamRadius 

pub struct StreamRadius {
    pub r_active: f64,
    pub r_evict: f64,
}

Per-grid streaming activity / eviction radii (S7.1).

Both values are in grid-local voxel units — the same scale as a GridLocalPos::voxel coordinate. The math falls out cleanly from there: chunks span fixed integer voxel extents and the camera’s grid-local position is also expressed in voxels.

Semantics inside crate::Scene::pump_streaming_sync:

• A chunk whose AABB-to-camera distance is ≤ r_active MUST be loaded; if absent + a generator is attached, it gets streamed in via crate::Grid::ensure_chunk_generated.
• A chunk whose AABB-to-camera distance is > r_evict is dropped from the chunk map.
• Chunks in the hysteresis band (r_active, r_evict] are neither streamed in nor evicted — they’re left as-is. The gap prevents a camera oscillating near a boundary from thrashing generation + eviction.

The Default / Self::DISABLED value is r_active = 0, r_evict = ∞: crate::Scene::pump_streaming_sync is a no-op. Existing grids keep the pre-S7 “absent stays absent, present stays present” behaviour until a caller opts in.

Fields

r_active: f64

Chunks closer than this (grid-local voxels, AABB distance) are streamed in.

r_evict: f64

Chunks farther than this (grid-local voxels, AABB distance) are evicted. Must be ≥ r_active.

Implementations

impl StreamRadius

pub const DISABLED: Self

r_active = 0, r_evict = ∞ — pump_streaming_sync never streams a chunk in or evicts one. The default for pre-S7.1 grids.

pub fn new(r_active: f64, r_evict: f64) -> Self

New radius pair. Requires r_evict >= r_active so the hysteresis band is well-formed (or empty when ==).

Panics

Panics if r_evict < r_active, if r_active is NaN or negative, or if r_evict is negative. NaN and negative radii are policy bugs — failing loud at construction beats silently degenerating chunk-AABB tests later.

pub fn is_disabled(self) -> bool

true for the Self::DISABLED sentinel pair. Lets pump_streaming_sync skip the per-grid pass cheaply when streaming is off.

Trait Implementations

impl Clone for StreamRadius

fn clone(&self) -> StreamRadius

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StreamRadius

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

Formats the value using the given formatter.

impl Default for StreamRadius

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for StreamRadius

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for StreamRadius

impl StructuralPartialEq for StreamRadius