TerminalRenderStats class abstract final

Process-wide counters for the paint path, used to make render work observable from a benchmark or an embedder's debug overlay.

The counters are plain integer increments on paths that are already doing map lookups or paragraph layout, so they are not worth gating behind a compile-time flag. They are cumulative and process-wide - a single terminal per process is the normal case, and aggregating across every TerminalView is what a benchmark wants anyway. Call reset to start a measurement window.

A cache hit ratio is only meaningful when read over a window that starts after the caches have warmed up; the first frames after a font, theme or size change necessarily miss.

Properties

hashCode → int
The hash code for this object.
no setterinherited
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited

Methods

noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited

Static Properties

glyphCacheHitRatio → double?
Fraction of procedural glyph cache lookups that hit, or null if there were no lookups at all.
no setter
glyphCacheHits ↔ int
Lookups in the procedural glyph cache that found a rasterised picture.
getter/setter pair
glyphCacheMisses ↔ int
Lookups in the procedural glyph cache that had to rebuild the path.
getter/setter pair
linesPerPaint → double?
Average number of lines repainted per frame, or null if nothing has been painted.
no setter
paintedLines ↔ int
Total lines visited by the per-line paint loops, summed over paints.
getter/setter pair
paints ↔ int
Number of times the terminal's paint method has run.
getter/setter pair
paragraphCacheHitRatio → double?
Fraction of paragraph cache lookups that hit, or null if there were no lookups at all.
no setter
paragraphCacheHits ↔ int
Lookups in the shaped-text cache that found a laid out paragraph.
getter/setter pair
paragraphCacheMisses ↔ int
Lookups in the shaped-text cache that had to shape and lay out the text.
getter/setter pair

Static Methods

reset() → void
Zeroes every counter, starting a new measurement window.
summary() → String
A one line summary, suitable for printing next to frame timings.