Struct ClusterStats 

pub struct ClusterStats {
    pub total_cells: u32,
    pub non_empty_cells: u32,
    pub max_punctual: u32,
    pub median_punctual: u32,
    pub p99_punctual: u32,
    pub mean_punctual: f32,
    pub total_index_slots_used: u32,
    pub max_index_slots: u32,
    pub active_light_count: u32,
    pub fallback_active: bool,
}

GPU-side cluster-cell layout. 8 bytes per cluster; matches WGSL struct ClusterCell { offset: u32, count: u32 }. Per-frame diagnostics produced by reading back the cluster cell array.

Useful for verifying that the build pass is doing meaningful work and for choosing grid dimensions in tuning. Pulled by the host on demand via ViewportRenderer::cluster_stats; the readback is skipped when no consumer asks for it.

Fields

total_cells: u32

Total cluster cells in the grid (constant per build).

non_empty_cells: u32

Cells with at least one punctual (point or spot) light assigned.

max_punctual: u32

Maximum punctual count across all cells.

median_punctual: u32

Median punctual count across cells with at least one punctual.

p99_punctual: u32

99th-percentile punctual count across cells with at least one punctual.

mean_punctual: f32

Mean punctual count across non-empty cells.

total_index_slots_used: u32

Sum of cell.count across all cells : how much of the global light index list the build pass actually used this frame.

max_index_slots: u32

Capacity of the global light index list.

active_light_count: u32

Active light count after the CPU frustum cull.

fallback_active: bool

True if the frame ran the small-N or force-fallback path. In that case the cell stats are stale (last build) but active_light_count is still meaningful.

Trait Implementations

impl Clone for ClusterStats

fn clone(&self) -> ClusterStats

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ClusterStats

impl Debug for ClusterStats

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ClusterStats

fn default() -> ClusterStats

Returns the “default value” for a type.