Struct CompileSpans 

pub struct CompileSpans {
    pub validate: Duration,
    pub prepare: Duration,
    pub classify: Duration,
    pub admit: Duration,
    pub walk: Duration,
    pub glyphs: Duration,
    pub finish: Duration,
}

What one SceneCompiler::compile call spent, phase by phase.

Zero across the board in a build without perf-trace — see [PhaseClock]. The phases partition the call in the order they run, so their sum is the whole compile minus call overhead. Two edges are worth naming rather than leaving to be inferred: the frame record and its depth counter are built after the admit lap, so walk spans their construction as well as the command walk itself; and the frust-perf img line a perf-trace build emits is written after the last lap, so no phase is charged the cost of reporting on one.

1. validate — the up-front finiteness and geometry sweep over every command. A frame is refused whole or not at all, so this sweep runs before the walk records anything and is paid on every frame in the command count.
2. prepare — resetting the per-frame scratch (strip generator, clip/group/snapshot stacks, punches) and ageing the two caches that span frames (image residency, glifo’s prep cache).
3. classify — routing every glyph run through [crate::text::atlas_policy] before any of them is drawn.
4. admit — closing the glyph atlas’s own frame, which is where admission packs what the routing pass asked for.
5. walk — building the frame record the walk fills, then the command walk itself: strip generation and paint encoding, and on a text-heavy scene the bulk of the call. The part of it spent inside glyph runs is reported separately by glyphs, which is a subset of this rather than a phase of its own.
6. finish — closing open groups, generating the hole punches, ageing the glyph atlas and taking the frame’s image plan.

Observational only: nothing downstream branches on any of it.

Fields

validate: Duration

The up-front finiteness and geometry sweep over every command.

prepare: Duration

Per-frame scratch resets and the two cross-frame caches’ ageing.

classify: Duration

Glyph-run routing, ahead of the walk.

admit: Duration

Glyph atlas admission, closing the routing pass.

walk: Duration

The command walk: strip generation and paint encoding.

glyphs: Duration

The part of walk spent inside glyph runs.

A subset of walk, not a seventh phase beside it, and so deliberately excluded from Self::total: adding it would count the glyph work twice. It exists because “the walk dominates” is not on its own an actionable measurement on a text-heavy scene — whether the cost is the text or everything drawn around it is the question that decides where a lever could go.

Accumulated per Command::GlyphRun rather than per glyph: a run is the unit the cache and the atlas policy both work in, and two clock reads a glyph would cost more than the phase being measured.

finish: Duration

Closing groups, punch generation, atlas ageing, the image plan.

Implementations

impl CompileSpans

pub fn total(&self) -> Duration

What the six phases sum to.

Saturating rather than +: a sum is only ever read by a diagnostic line, and overflowing one must not take the frame with it (E17).

Trait Implementations

impl Clone for CompileSpans

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for CompileSpans

impl Debug for CompileSpans

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

Formats the value using the given formatter.

impl Default for CompileSpans

fn default() -> Self

Returns the “default value” for a type.

impl Eq for CompileSpans

impl PartialEq for CompileSpans

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for CompileSpans