Struct FrameStats 

pub struct FrameStats {

    pub total_objects: u32,
    pub visible_objects: u32,
    pub culled_objects: u32,
    pub draw_calls: u32,
    pub instanced_batches: u32,
    pub triangles_submitted: u64,
    pub shadow_draw_calls: u32,
    pub cpu_prepare_ms: f32,
    pub gpu_frame_ms: Option<f32>,
    pub total_frame_ms: f32,
    pub render_scale: f32,
    pub missed_budget: bool,
    pub upload_bytes: u64,
    pub gpu_culling_active: bool,
    pub gpu_visible_instances: Option<u32>,
    pub shadows_skipped: bool,
    pub volume_quality_reduced: bool,
    pub effects_throttled: bool,
}

Per-frame rendering statistics returned by crate::ViewportRenderer::prepare.

Fields

total_objects: u32

Total objects considered for rendering.

visible_objects: u32

Objects that passed visibility and frustum tests.

culled_objects: u32

Objects culled by frustum or visibility.

draw_calls: u32

Number of draw calls issued in the main pass.

instanced_batches: u32

Number of instanced batches (0 when using per-object path).

triangles_submitted: u64

Total triangles submitted to the GPU.

shadow_draw_calls: u32

Number of draw calls in the shadow pass.

cpu_prepare_ms: f32

CPU time spent in prepare(), in milliseconds.

gpu_frame_ms: Option<f32>

GPU scene-pass time in milliseconds, if timestamp queries are available.

Measured with TIMESTAMP_QUERY around the main scene render pass. None on backends that do not support TIMESTAMP_QUERY (e.g. WebGL).

Note: this value reflects the previous frame’s GPU cost due to async readback. The value lags by one frame and should not be used by the adaptation controller across mode transitions.

total_frame_ms: f32

Wall-clock duration since the previous prepare() call, in milliseconds.

Approximates the full frame interval. Zero on the first frame.

render_scale: f32

Current internal render scale (1.0 = native resolution).

Reflects the value tracked by the adaptation controller. Values below 1.0 cause the scene to render into a scaled intermediate texture that is bilinearly upscaled to the surface (requires allow_dynamic_resolution).

missed_budget: bool

True if the last frame exceeded the target frame budget.

Requires target_fps to be set in the PerformancePolicy. Always false when no target is configured.

upload_bytes: u64

Bytes of geometry data uploaded to the GPU since the previous prepare() call.

Counts full buffer reallocations triggered by crate::ViewportGpuResources::replace_mesh_data and initial uploads via upload_mesh_data / upload_mesh. Uniform buffer writes are not counted.

gpu_culling_active: bool

True when GPU-driven culling is active this frame.

False when the device does not support INDIRECT_FIRST_INSTANCE or culling has been disabled via disable_gpu_driven_culling().

gpu_visible_instances: Option<u32>

Number of instances that passed GPU culling and were submitted for drawing.

Populated only when gpu_culling_active is true. None on the first frame or when GPU culling is off. Lags by one frame due to async readback.

shadows_skipped: bool

True when the shadow depth pass was skipped this frame.

Set when allow_shadow_reduction is true and the previous frame missed the target budget. Always false in RuntimeMode::Capture.

volume_quality_reduced: bool

True when volume raymarch step size was doubled this frame.

Set when allow_volume_quality_reduction is true and the previous frame missed the target budget. Always false in RuntimeMode::Capture.

effects_throttled: bool

True when SSAO, contact shadows, and bloom were skipped this frame.

Set when allow_effect_throttling is true and the previous frame missed the target budget. Always false in RuntimeMode::Capture.

Trait Implementations

impl Clone for FrameStats

fn clone(&self) -> FrameStats

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FrameStats

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

Formats the value using the given formatter.

impl Default for FrameStats

fn default() -> FrameStats

Returns the “default value” for a type.

impl Copy for FrameStats