Package eu.svjatoslav.sixth.e3d.gui

Class CullingStatistics

java.lang.Object

eu.svjatoslav.sixth.e3d.gui.CullingStatistics

public class CullingStatistics
extends Object

Statistics for frustum culling, tracking composite-level culling efficiency.

Updated each frame during the rendering pipeline:

• totalComposites - incremented before each composite's frustum test
• culledComposites - incremented when a composite fails the frustum test

Thread safety: counters are AtomicInteger because the parallel transform phase increments them from multiple worker threads.

Displayed in the DeveloperToolsPanel to help developers understand culling efficiency and optimize scene graphs.

See Also:

• DeveloperToolsPanel
• Frustum

Field Summary

Fields

Modifier and Type	Field	Description
final AtomicInteger	culledComposites	Number of composite shapes that were entirely outside the frustum and skipped.
final AtomicInteger	totalComposites	Total number of composite shapes tested against the frustum this frame.

Constructor Summary

Constructors

Constructor	Description
CullingStatistics()

Method Summary

Modifier and Type	Method	Description
double	getCulledPercentage()	Returns the percentage of composites that were culled.
void	reset()	Resets all statistics to zero.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

totalComposites

public final AtomicInteger totalComposites

Total number of composite shapes tested against the frustum this frame. Incremented before each composite's AABB frustum test. Does not include the root composite (which is never frustum-tested).

culledComposites

public final AtomicInteger culledComposites

Number of composite shapes that were entirely outside the frustum and skipped. When a composite is culled, all its children (shapes and nested composites) are skipped without individual testing.

Constructor Details

CullingStatistics

public CullingStatistics()

Method Details

reset

public void reset()

Resets all statistics to zero. Called at the start of each frame before computing new statistics.

getCulledPercentage

public double getCulledPercentage()

Returns the percentage of composites that were culled.

Returns:

the culled percentage (0-100), or 0 if there are no composites