feat(scoreboard): it ticks — the marquee is the design, not an option

Creator, plainly: "the entire point of a ticker is to tick… so, tick." The static strip was my
reading of an earlier exchange; it is gone.

How it ticks without becoming the compositor's most expensive layer:
- `ScoreboardRenderer.RenderRun` rasterises the run ONCE per value change at its natural width plus
  a gap.
- `ScoreboardPresenter` crops a 1920-wide window at a moving offset each tick — a row-wise byte
  copy, no text layout, no re-raster.
- `TickScoreboard` runs on the existing 30 Hz meter clock and only while the strip is shown, so a
  hidden or disabled scoreboard costs nothing.

The dev simulation uses the same path, so what is previewed is what ships.

Test updated to the real contract: no tick → identical pixels; a tick → different pixels; a value
change → re-rasterised run. (The old test asserted frame-instance identity, which a cropped window
can never satisfy.)
This commit is contained in:
2026-10-30 15:17:55 -07:00
parent 882b8551d9
commit 460b36204d
5 changed files with 141 additions and 14 deletions
+28 -1
View File
@@ -13,6 +13,8 @@ public sealed class ScoreboardPresenter
{
private readonly ScoreboardRecorder _recorder;
private VideoFrame? _frame;
private VideoFrame? _run; // the wide scrollable run (dev preview only)
private double _offsetPx;
private string? _tilesFingerprint;
private ScoreboardStyle _style;
private ScoreboardTiles _tiles = ScoreboardTiles.None;
@@ -24,6 +26,20 @@ public sealed class ScoreboardPresenter
_recorder.Changed += Invalidate;
}
/// <summary>The strip TICKS (creator ruling 2026-10-30: "the point is, it's a ticker… so,
/// tick"). True for the product, and the dev simulation uses the same path — so what the
/// creator previews is what ships.</summary>
public bool Scroll { get; set; } = true;
/// <summary>Advances the scroll by <paramref name="seconds"/>. The strip is a marquee: one
/// measured run, cropped to a moving window, so a tick is a row-wise byte copy rather than a
/// re-rasterisation.</summary>
public void Advance(double seconds, double pixelsPerSecond = 120)
{
if (!Scroll) return;
_offsetPx += seconds * pixelsPerSecond;
}
/// <summary>The strip frame for the current tallies, or null when nothing is enabled/shown.</summary>
public VideoFrame? Frame
{
@@ -31,8 +47,18 @@ public sealed class ScoreboardPresenter
{
var tiles = _tiles.Build(_recorder.State);
var fingerprint = $"{_tiles.CacheKey}|{string.Join('|', tiles)}|{_style}";
if (_frame != null && fingerprint == _tilesFingerprint) return _frame;
if (Scroll)
{
if (_run is null || fingerprint != _tilesFingerprint)
{
_tilesFingerprint = fingerprint;
_run = ScoreboardRenderer.RenderRun(tiles, _style);
}
return _run is null ? null : ScoreboardRenderer.Crop(_run, (int)_offsetPx, ScoreboardRenderer.Width);
}
if (_frame != null && fingerprint == _tilesFingerprint) return _frame;
_tilesFingerprint = fingerprint;
_frame = ScoreboardRenderer.Render(tiles, _style);
return _frame;
@@ -55,6 +81,7 @@ public sealed class ScoreboardPresenter
public void Invalidate()
{
_frame = null;
_run = null;
_tilesFingerprint = null;
}
}