feat: Add renderer swaps to debug stats

Author: eonarheim

src/engine/Debug/DebugConfig.ts

@@ -148,6 +148,7 @@ export interface PhysicsStatistics {
 export interface GraphicsStatistics {
   drawCalls: number;
   drawnImages: number;
+  rendererSwaps: number;
 }
 
 /**
@@ -424,7 +425,8 @@ export class FrameStats implements FrameStatistics {
 
   private _graphicsStats: GraphicsStatistics = {
     drawCalls: 0,
-    drawnImages: 0
+    drawnImages: 0,
+    rendererSwaps: 0
   };
 
   /**
@@ -444,12 +446,13 @@ export class FrameStats implements FrameStatistics {
       this._physicsStats.reset(otherStats.physics);
       this.graphics.drawCalls = otherStats.graphics.drawCalls;
       this.graphics.drawnImages = otherStats.graphics.drawnImages;
+      this.graphics.rendererSwaps = otherStats.graphics.rendererSwaps;
     } else {
       this.id = this.elapsedMs = this.fps = 0;
       this.actors.alive = this.actors.killed = this.actors.ui = 0;
       this.duration.update = this.duration.draw = 0;
       this._physicsStats.reset();
-      this.graphics.drawnImages = this.graphics.drawCalls = 0;
+      this.graphics.drawnImages = this.graphics.drawCalls = this.graphics.rendererSwaps = 0;
     }
   }
 

src/engine/Engine.ts

@@ -1801,6 +1801,7 @@ O|===|* >________________>\n\
       this.stats.currFrame.duration.draw = afterDraw - afterUpdate;
       this.stats.currFrame.graphics.drawnImages = GraphicsDiagnostics.DrawnImagesCount;
       this.stats.currFrame.graphics.drawCalls = GraphicsDiagnostics.DrawCallCount;
+      this.stats.currFrame.graphics.rendererSwaps = GraphicsDiagnostics.RendererSwaps;
 
       this.emit('postframe', new PostFrameEvent(this, this.stats.currFrame));
       this.stats.prevFrame.reset(this.stats.currFrame);

src/engine/Graphics/Context/ExcaliburGraphicsContextWebGL.ts

@@ -43,6 +43,7 @@ import { ParticleRenderer } from './particle-renderer/particle-renderer';
 import { ImageRendererV2 } from './image-renderer-v2/image-renderer-v2';
 import { Flags } from '../../Flags';
 import { Debug } from '../Debug';
+import { GraphicsDiagnostics } from '../GraphicsDiagnostics';
 
 export const pixelSnapEpsilon = 0.0001;
 
@@ -804,6 +805,7 @@ export class ExcaliburGraphicsContextWebGL implements ExcaliburGraphicsContext {
             currentRenderer!.flush();
             currentRendererName = this._drawCalls[i].renderer;
             currentRenderer = this.get(currentRendererName);
+            GraphicsDiagnostics.RendererSwaps++;
           }
 
           // ! hack to grab screen texture before materials run because they might want it

src/engine/Graphics/GraphicsDiagnostics.ts

@@ -1,8 +1,10 @@
 export class GraphicsDiagnostics {
   public static DrawCallCount: number = 0;
   public static DrawnImagesCount: number = 0;
+  public static RendererSwaps: number = 0;
   public static clear(): void {
     GraphicsDiagnostics.DrawCallCount = 0;
     GraphicsDiagnostics.DrawnImagesCount = 0;
+    GraphicsDiagnostics.RendererSwaps = 0;
   }
 }