Debugging

A guide to using the rendering debugger in Flora.

Flora integrates with Unity’s Rendering Debugger to provide tools for visualizing and inspecting instance behavior, culling, and performance in real time.

---

Accessing the Rendering Debugger

Flora adds a dedicated tab to Unity’s Rendering Debugger window.

Access Options

• From the menu bar: Window → Flora → Rendering Debugger

• In a development build (Play Mode or standalone): Ctrl + Shift + Backspace

---

Debug Properties

Debug Shading Mode

Visualizes internal instance data using different color modes:

• LOD – Colors instances based on their active LOD index

• Instance ID – Colors each instance using its unique ID

• Draw ID – Colors each instance using its draw ID

• Prefab ID – Colors instances by the prefab they originated from

• Batch ID – Colors instances by their BRG batch (when using BRG)

---

Freeze Culling

• Freezes culling for all cameras

• Lets you inspect which instances were culled that frame from alternate perspectives

---

Display Culling Stats

• Enables GPU dispatch counters and debug overlays

• Shows per-camera and per-view statistics on:

  • Instances drawn

  • Instances culled

  • Compute workloads dispatched

---

LOD Mode

Controls how LODs are rendered:

• Force LOD – Forces all instances to render at a specific LOD index

• Only LOD – Renders only the selected LOD; other LODs are culled

---

Spatial Hash

Displays gizmos representing Flora's multi-level spatial hash structure.

Options include:

• Blocks – The top-level, coarse-grained partitioning

• Cells – Mid-level subdivisions used for culling

• Computed Cell Bounds – Actual calculated bounds of cells based on instance positions

• Chunks – The fine-grained instance groups within cells

These overlays are useful for understanding how Flora groups and culls instances across different spatial resolutions.