Struct FrameProfiler 

pub struct FrameProfiler { /* private fields */ }

Rolling-window CPU frame profiler.

Spans are identified by string name. Begin/end calls must be paired. Stats are available as averages, min, max, and last value.

Implementations

impl FrameProfiler

pub fn new(window_frames: usize) -> Self

Create a profiler with a rolling window of window_frames frames.

pub fn begin(&mut self, name: &str)

Begin timing a named span.

pub fn end(&mut self, name: &str)

End timing a named span.

pub fn begin_frame(&mut self)

Mark the start of a new frame (measures total frame time under “frame”).

pub fn end_frame(&mut self)

Mark the end of a frame.

pub fn avg_us(&self, name: &str) -> u64

Average duration of a span in microseconds.

pub fn max_us(&self, name: &str) -> u64

Maximum duration of a span in microseconds.

pub fn min_us(&self, name: &str) -> u64

Minimum duration of a span in microseconds.

pub fn last_us(&self, name: &str) -> u64

Last recorded duration of a span in microseconds.

pub fn fps(&self) -> f32

Average FPS derived from the “frame” span.

pub fn frame_count(&self) -> u64

Total frame count since creation.

pub fn report(&self) -> Vec<(&str, u64)>

Sorted list of (name, avg_us) for all tracked spans.

pub fn format_report(&self) -> String

Format the profiler report as a multi-line string.

pub fn reset(&mut self)

Reset all span accumulators.

pub fn over_budget(&self, budget_ms: f32) -> bool

Returns true if the “frame” span average exceeds budget_ms milliseconds.