tiramisu/debug

Debug utilities for performance monitoring.

This module provides tools for profiling and optimizing your game. Track draw calls, triangle counts, and other render statistics.

Render Statistics

import tiramisu/debug

fn update(model: Model, msg: Msg, ctx: Context) {
  let stats = debug.get_render_stats(ctx.renderer)

  // Log if draw calls are too high
  case stats.draw_calls > 100 {
    True -> io.println("Warning: " <> int.to_string(stats.draw_calls) <> " draw calls")
    False -> Nil
  }

  // ...
}

Performance Tips

Draw calls: Each unique material/mesh combination is a draw call. Use instancing or merge similar meshes to reduce draw calls.
Triangles: High triangle counts impact GPU performance. Use LOD (Level of Detail) for distant objects.

Types

RenderStats

</>

Render statistics from the WebGL renderer.

Contains per-frame render metrics useful for optimization.

Fields

draw_calls: Number of draw calls in the last frame (lower is better)
triangles: Total number of triangles rendered in the last frame

pub type RenderStats {
  RenderStats(draw_calls: Int, triangles: Int)
}

Constructors

RenderStats(draw_calls: Int, triangles: Int)

Values

get_render_stats

</>

pub fn get_render_stats(
  renderer: savoiardi.Renderer,
) -> RenderStats

Get render statistics from the WebGL renderer.

Returns the number of draw calls and triangles rendered in the current frame. Use this for optimization - fewer draw calls generally means better performance.

Example

import tiramisu/debug
import gleam/io
import gleam/int

pub fn update(model: Model, msg: Msg, ctx: tiramisu.Context) {
  let stats = debug.get_render_stats(ctx.renderer)

  // Track draw calls for optimization
  case stats.draw_calls > 100 {
    True -> io.println("Too many draw calls: " <> int.to_string(stats.draw_calls))
    False -> Nil
  }

  // ... rest of update logic
}