Struct TraceQuery 

pub struct TraceQuery<'a> { /* private fields */ }

Query-based trace analysis per Ko & Myers (2008).

Enables “Whyline-style” queries like:

• “Find all frames where condition X is true”
• “Why did the ball miss the paddle at frame N?”

Example

let query = TraceQuery::from_buffer(&buffer);
let frames_with_input = query.find_frames(|f| f.has_inputs());

Implementations

impl<'a> TraceQuery<'a>

pub fn from_buffer(buffer: &'a TraceBuffer) -> Self

Create a query interface from a trace buffer.

pub const fn from_frames(frames: Vec<&'a FrameRecord>) -> Self

Create a query interface from a slice of frame records.

pub fn find_frames(&self, predicate: impl Fn(&FrameRecord) -> bool) -> Vec<u64>

Find all frames matching a predicate.

pub fn find_frames_with_context( &self, predicate: impl Fn(&FrameRecord) -> bool, context_frames: usize, ) -> Vec<QueryResult>

Find frames with context (frames before and after).

pub fn count_frames(&self, predicate: impl Fn(&FrameRecord) -> bool) -> usize

Count frames matching a predicate.

pub fn frames_with_inputs(&self) -> Vec<u64>

Find frames with any input events.

pub fn frames_with_input_type( &self, event_type_matcher: impl Fn(&InputEventType) -> bool, ) -> Vec<u64>

Find frames with specific input event type.

pub fn get_frame(&self, frame_number: u64) -> Option<&FrameRecord>

Get frame at specific frame number.

pub fn get_frame_range(&self, start: u64, end: u64) -> Vec<&FrameRecord>

Get frame range (inclusive).

pub fn frame_count(&self) -> usize

Get total frame count.

pub fn first_frame(&self) -> Option<u64>

Get first frame number (if any).

pub fn last_frame(&self) -> Option<u64>

Get last frame number (if any).

pub fn input_density(&self) -> f64

Calculate input density (inputs per frame).

Trait Implementations

impl<'a> Debug for TraceQuery<'a>

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

Formats the value using the given formatter.