Skip to main content

Viewport & Heatmap

After a bake, Scene Insight overlays every cluster's bounding box directly in your editor viewports, colored by performance. The overlay updates live as you change heatmap mode, render style or selection.

Heatmap mode — what the color means

The Heatmap dropdown in the toolbar chooses which metric drives the box color:

ModeColor reflects
Composite Score (default)The overall budget score — the headline view
Draw CallsEstimated draw calls vs budget
TrianglesTriangle count vs budget
MaterialsUnique material count vs budget
LightsLight count (all types) vs budget
Texture MemoryTexture memory vs budget
OffNo color (boxes drawn neutral)

Each per-metric mode normalizes against that metric's limit in the active budget profile, so 1.0 always means "at budget" regardless of which mode you pick.

Color scale

Score rangeColor
below Green threshold (default 0.6)🟢 Green
up to Yellow threshold (default 1.0)🟡 Amber
above Red threshold (default 1.5)🔴 Saturated red / magenta

All thresholds and the exact RGB values are configurable in Settings.

Viewport mode — how boxes are drawn

The Viewport dropdown controls the render style of the overlay:

ModeDescription
OffHide the overlay entirely
Wireframe (default)Bounding-box edges only — least intrusive
Filled (semi-transparent)Translucent filled boxes — easiest to read color at a glance
Outline + LabelWireframe plus the cluster name and score as a viewport label
X-RayBoxes drawn through geometry so occluded zones stay visible

You can set the default viewport mode (used when Scene Insight first activates) in Settings.

Labels

When Show Cluster Labels is enabled (default on), each box can display its name and composite score. The Outline + Label viewport mode always shows them; other modes respect the setting. Label visibility and line thickness (0.58.0, default 2.0) are in Settings.

Selection & focus

The overlay reacts to the cluster table:

  • Select a row → that cluster's box is highlighted in the viewport.
  • Double-click a row → all viewports focus on that cluster's bounds.
tip

Use Composite Score to find problem zones, then flip to Triangles, Lights or Texture Memory to see why a zone is hot — the metric whose heatmap stays red is your culprit.