Skip to main content

FrameProfileSummary

Kindtypedef
Packagedebug
Full namedebug.FrameProfileSummary
Sourcesource/debug/FrameProfiler.hx

Aggregated statistical summary across the profiling session and ring buffer.

Percentile & Low-FPS Semantics:

  • Percentiles (p50, p95, p99, p999) use Hyndman-Fan Type 7 linear interpolation (pos = q * (N - 1)) over the ring buffer (up to 2,048 frames).
  • onePercentLowFps = 1000.0 / p99FrameTimeMs (reciprocal of P99 frametime).
  • pointOnePercentLowFps = 1000.0 / p999FrameTimeMs (reciprocal of P99.9 frametime).
  • slowest1PctAvgFps and slowest01PctAvgFps = harmonic mean FPS of the slowest ceil(0.01 * N) and ceil(0.001 * N) buffered frames.
  • cpuTimeAvailable, rssAvailable, heapStatsAvailable explicitly indicate whether the underlying platform/runtime metrics are available.

Internals​

Private / internal members
FieldTypeStatic
totalFramesIntno
bufferedFramesIntno
sessionDurationMsFloatno
targetFpsFloatno
targetFrameTimeMsFloatno
currentFpsFloatno
avgFpsFloatno
minFpsFloatno
maxFpsFloatno
onePercentLowFpsFloatno
pointOnePercentLowFpsFloatno
slowest1PctAvgFpsFloatno
slowest01PctAvgFpsFloatno
lastFrameTimeMsFloatno
avgFrameTimeMsFloatno
minFrameTimeMsFloatno
maxFrameTimeMsFloatno
stdDevFrameTimeMsFloatno
p50FrameTimeMsFloatno
p95FrameTimeMsFloatno
p99FrameTimeMsFloatno
p999FrameTimeMsFloatno
avgUpdateTimeMsFloatno
maxUpdateTimeMsFloatno
p95UpdateTimeMsFloatno
avgRenderTimeMsFloatno
maxRenderTimeMsFloatno
p95RenderTimeMsFloatno
avgAudioTimeMsFloatno
maxAudioTimeMsFloatno
p95AudioTimeMsFloatno
avgOtherTimeMsFloatno
maxOtherTimeMsFloatno
totalGcCountIntno
totalExplicitGcCountIntno
totalImplicitGcCountIntno
framesWithGcIntno
totalGcPauseMsFloatno
avgGcPauseMsFloatno
maxGcPauseMsFloatno
maxGcPauseFrameIntno
totalGcReclaimedBytesFloatno
totalAllocBytesFloatno
totalAllocCountIntno
avgAllocBytesPerFrameFloatno
allocRateBytesPerSecFloatno
peakFrameAllocBytesFloatno
peakFrameAllocFrameIntno
currentHeapUsedBytesFloatno
currentHeapReservedBytesFloatno
peakHeapUsedBytesFloatno
peakHeapReservedBytesFloatno
currentRssBytesFloatno
peakRssBytesFloatno
droppedFramesIntno
spikeCount16MsIntno
spikeCount25MsIntno
spikeCount33MsIntno
spikeCount50MsIntno
avgDrawCallsFloatno
maxDrawCallsIntno
cpuTimeMsFloatno
cpuUtilizationPctFloatno
cpuNormalizedPctFloatno
logicalCpuCountIntno
cpuTimeAvailableBoolno
rssAvailableBoolno
heapStatsAvailableBoolno
rssSampleIntervalFramesIntno