WIP

src/game-loop/frame-performance.ts

@@ -0,0 +1,73 @@
+import { appConfig } from '../config';
+
+interface TelemetrySnapshot {
+  frameCpuStartedAt: number;
+  encodeCpuMs: number;
+  activeAgentCount: number;
+  targetAgentBudget: number;
+  canvas: HTMLCanvasElement;
+  devicePixelRatio: number;
+  renderSpeed: number;
+}
+
+export class FramePerformance {
+  public latestFps = 60;
+  public smoothedFps = 60;
+  public refreshTargetFps = 60;
+
+  private lastTelemetryAt = 0;
+
+  public markCpuStart(): number {
+    return appConfig.telemetry.enabled ? performance.now() : 0;
+  }
+
+  public measureSince(startedAt: number): number {
+    return appConfig.telemetry.enabled ? performance.now() - startedAt : 0;
+  }
+
+  public update(deltaTime: number): void {
+    const fps = 1 / Math.max(deltaTime, appConfig.deltaTime.minDeltaTimeSeconds);
+    this.latestFps = fps;
+    this.refreshTargetFps = Math.max(
+      this.refreshTargetFps * appConfig.simulation.budget.refreshTargetDecay,
+      fps
+    );
+    this.smoothedFps =
+      this.smoothedFps * appConfig.simulation.budget.fpsSmoothingRetain +
+      fps * appConfig.simulation.budget.fpsSmoothingNew;
+  }
+
+  public renderTelemetry({
+    frameCpuStartedAt,
+    encodeCpuMs,
+    activeAgentCount,
+    targetAgentBudget,
+    canvas,
+    devicePixelRatio,
+    renderSpeed,
+  }: TelemetrySnapshot): void {
+    if (!appConfig.telemetry.enabled) {
+      return;
+    }
+
+    const now = performance.now();
+    if (now - this.lastTelemetryAt < appConfig.telemetry.intervalMs) {
+      return;
+    }
+
+    this.lastTelemetryAt = now;
+    console.debug('Fleeting Garden telemetry', {
+      fps: Math.round(this.latestFps),
+      smoothedFps: Math.round(this.smoothedFps),
+      refreshTargetFps: Math.round(this.refreshTargetFps),
+      activeAgentCount,
+      targetAgentBudget,
+      canvasWidth: canvas.width,
+      canvasHeight: canvas.height,
+      dpr: devicePixelRatio,
+      renderSpeed,
+      frameCpuMs: now - frameCpuStartedAt,
+      encodeCpuMs,
+    });
+  }
+}