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.