simvx.core.debug.profiler

Frame profiler with ring-buffer timing.

Module Contents

Classes

FrameProfiler

Ring-buffer frame timer. begin()/end() are no-ops when disabled.

Data

log
__all__

API

simvx.core.debug.profiler.log

‘getLogger(…)’

simvx.core.debug.profiler.__all__

[‘FrameProfiler’]

class simvx.core.debug.profiler.FrameProfiler

Ring-buffer frame timer. begin()/end() are no-ops when disabled.

Initialization

begin(phase: str)

end(phase: str)

end_frame()

count_nodes(tree)

Traverse tree and count nodes/controls. Call once per frame.

property fps: float

property frame_time_ms: float

property node_count: int

property control_count: int

property last_frame: dict[str, float]

Phase timings from the most recent completed frame.

phase_avg_ms(phase: str, count: int = 60) → float

Average time for a phase over the last count frames.

frame_times(count: int = 120) → list[float]

Recent ‘total’ phase times for graph rendering.