Struct ClusterConfig 

pub struct ClusterConfig {
    pub cell_pixels: u32,
    pub z_slices: u32,
    pub max_clusters: u32,
    pub first_slice_depth: f32,
    pub far: f32,
}

How a frame’s view is divided into cells.

Fields

cell_pixels: u32

The target pixels one cell covers along x and y.

z_slices: u32

How many slices the view’s depth is cut into.

max_clusters: u32

The most cells the grid may hold, whatever the target size.

A finer grid costs only memory and CPU time — a fragment reads one cell however fine the grid is — but the whole grid is uploaded every frame, so it is bounded.

first_slice_depth: f32

The end of the first depth slice.

This is a scene-scale choice, not the camera’s near plane. The first slice absorbs everything nearer; the remaining slices divide the rest of the range logarithmically under a perspective projection.

far: f32

The farthest depth the slices span.

Implementations

impl ClusterConfig

pub const DEFAULT: Self

Cells of about 128 pixels, 8 depth slices, at most 4096 cells. The first slice ends at 5 world units and the range ends at 1000.

Both ends are fixed so the grid does not depend on which lights happen to be present: a light-only range cannot match the visible surfaces it did not measure. A light nearer than the first slice’s end lands in that slice, which is where a fragment that near looks it up too.

pub fn dims(&self, size: (u32, u32)) -> [u32; 3]

The grid this configuration gives a size-pixel target.

The x and y counts come from the target size, then shrink together until the grid fits Self::max_clusters, so the cells stay roughly square and the grid follows the target’s aspect. Depth keeps its slice count, which is what a caller sets for the depth range it cares about.

pub fn uniform(&self, size: (u32, u32), perspective: bool) -> ClusterUniform

The uniform the frame’s shaders read for a size-pixel target.

Trait Implementations

impl Clone for ClusterConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ClusterConfig

impl Debug for ClusterConfig

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

Formats the value using the given formatter.

impl PartialEq for ClusterConfig

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ClusterConfig