Struct DiagnosticLog 

pub struct DiagnosticLog { /* private fields */ }

The dedup state behind every render-time diagnostic a windowed renderer can emit.

Each graphical backend holds one DiagnosticLog field (Default-constructed) instead of a separate BTreeSet<char> per diagnostic, so the diagnostics a backend emits are exactly this struct’s methods, not something a reader has to reconstruct by finding every warned_* field and the free function it feeds. The methods here are thin wrappers over the free functions in this module and in sprite_cache, which remain the implementation and stay public for any caller that wants the dedup set itself rather than one owned alongside the others.

Constructing a DiagnosticLog never allocates: every set starts empty, and BTreeSet::default does not allocate until its first insert, so a release build (where every method’s body is compiled out by dev_only!) pays nothing for carrying this field.

Implementations

impl DiagnosticLog

pub fn notdef_glyph(&mut self, ch: char) -> bool

Reports ch if it resolved to the fallback notdef glyph rather than its own, at most once per character. See warn_notdef_glyph for what this means and why it is worth a diagnostic.

pub fn sprite_needs_span( &mut self, glyph: char, sprite: (u32, u32), cell: (u32, u32), ) -> bool

Reports glyph’s sprite as drawn without a span reserving the cells it covers, at most once per glyph. See warn_sprite_needs_span for the full contract.

pub fn tint_needs_sprite(&mut self, glyph: char, tint: Tint) -> bool

Reports glyph’s tint as dropped because it resolved to a bitmap font glyph rather than a sprite, at most once per glyph. See warn_tint_needs_sprite for the full contract.

pub fn has_reported_notdef(&self, ch: char) -> bool

Whether notdef_glyph has already reported ch.

For a backend’s own test suite to assert the dedup behavior directly; production code only ever needs notdef_glyph’s own return value.

pub fn has_reported_dropped_tint(&self, glyph: char) -> bool

Whether tint_needs_sprite has already reported glyph.

For a backend’s own test suite to assert the dedup behavior directly; production code only ever needs tint_needs_sprite’s own return value.

pub fn dropped_tint_report_count(&self) -> usize

How many distinct glyphs tint_needs_sprite has reported so far.

For a backend’s own test suite to assert dedup collapses repeat reports to one; production code has no use for the count.

Trait Implementations

impl Debug for DiagnosticLog

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

Formats the value using the given formatter.

impl Default for DiagnosticLog

fn default() -> DiagnosticLog

Returns the “default value” for a type.