Struct GameTracer 

pub struct GameTracer { /* private fields */ }

High-level game tracer that integrates all tracing components.

Provides a simple API for recording and querying game traces:

• begin_frame(): Start recording a new frame
• record_input(): Record an input event
• end_frame(): Finish the frame and optionally take a snapshot
• stats(): Get trace statistics for debugging

Example

use jugar_web::trace::{GameTracer, TracerConfig, InputEvent, InputEventType};

let mut tracer = GameTracer::new(TracerConfig::default());

// Each frame:
tracer.begin_frame();
tracer.record_input(InputEvent {
    event_type: InputEventType::KeyDown(32), // Space
    frame_offset_us: 0,
});
tracer.end_frame(None); // Or provide state hash

Implementations

impl GameTracer

pub fn new(config: TracerConfig) -> Self

Create a new game tracer with the given configuration.

pub fn debug() -> Self

Create a debug tracer (Andon Cord enabled).

pub fn production() -> Self

Create a production tracer (drop oldest on overflow).

pub fn begin_frame(&mut self)

Start recording a new frame.

Must be called at the start of each frame before recording inputs.

pub fn record_input(&mut self, event: InputEvent)

Record an input event for the current frame.

Panics

Panics in debug builds if begin_frame() was not called.

pub fn record_inputs(&mut self, events: impl IntoIterator<Item = InputEvent>)

Record multiple input events for the current frame.

pub fn end_frame(&mut self, state_hash: Option<[u8; 32]>) -> SnapshotDecision

End the current frame and commit it to the trace buffer.

Arguments

• state_hash - Optional state hash for verification and snapshot decisions.

Returns

The snapshot decision (Skip, DeltaSnapshot, or FullSnapshot).

pub fn stats(&self) -> TraceStats

Get trace statistics for debugging display.

pub fn start_recording(&mut self)

Start recording.

pub fn stop_recording(&mut self)

Stop recording.

pub const fn is_recording(&self) -> bool

Check if recording is active.

pub const fn current_frame(&self) -> u64

Get current frame number.

pub const fn buffer(&self) -> &TraceBuffer

Get a reference to the underlying buffer.

pub fn query(&self) -> TraceQuery<'_>

Create a query interface for the trace buffer.

pub fn clear(&mut self)

Clear the trace buffer and reset statistics.

pub fn drain(&mut self, count: usize) -> Vec<FrameRecord>

Drain frames from the buffer for export.

pub fn export_json(&self) -> Result<String, TraceError>

Export all frames as JSON.

Errors

Returns a serialization error if the frames cannot be serialized.

Trait Implementations

impl Debug for GameTracer

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

Formats the value using the given formatter.