Struct CapOverflow 

pub struct CapOverflow {
    pub dropped: usize,
    pub context: OverflowContext,
    pub cap: usize,
}

Reported when building a line scene’s geometry hit the segment cap and truncated. The cap must never be a silent cut (ADR-0007 Risks), so it travels to the frontend two ways: out of Scene::configure at preset load, and off Scene::mirror_overflow for the per-frame mirror. None is the normal case where geometry fit.

Fields

dropped: usize

How many draw segments were dropped at the cap.

context: OverflowContext

Where the drop happened, for the surfaced message.

cap: usize

The cap that bit, carried rather than read from a constant: it is a tier value now (Plan 0044), so the same preset overflows at 20 000 segments on the floor and not at all at 60 000 on rich. A message naming a cap the run was not using would be worse than no message.

Implementations

impl CapOverflow

pub fn top_tier_lifts(&self) -> bool

Whether the top tier’s cap for this context is above the one that bit, so that pinning it would draw more of what the preset asked.

Read off TierConfig::RICH rather than carried, so no producer has to know which tier it runs on: a cap below Rich’s can only have come from a lower tier, and a cap equal to it is the top tier’s own.

pub fn recovered(&self) -> Recovered<'_>

The clearing of this overflow, worded in the same terms its onset was.

Three of the five contexts clamp a structural parameter rather than cutting geometry, so one sentence cannot speak for all five: what came back is an iteration budget, a grid or a neighbourhood, not geometry and not segments. The shell holds the overflow that last bit and renders this off it, which keeps every word of the pair in this file.

Trait Implementations

impl Clone for CapOverflow

fn clone(&self) -> CapOverflow

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CapOverflow

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

Formats the value using the given formatter.

impl Display for CapOverflow

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

Formats the value using the given formatter.

impl PartialEq for CapOverflow

fn eq(&self, other: &CapOverflow) -> 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 CapOverflow

impl Eq for CapOverflow

impl StructuralPartialEq for CapOverflow