DocumentationAzkar Screen StatsConfiguration

Inspector settings

Configuration

Review build scope, camera, placement, presets, metric sections, graph controls, appearance, safe-area behavior, and cadence.

  • Placement and visibility
  • Metrics and presets
  • Graph and appearance
  • Cadence and limits

The ScreenStatsOverlay inspector groups settings into Metric Presets, Placement & Visibility, Visible Metrics, Frame-Time Graph, Appearance, and Update Cadence & Input. Public setters normalize values to the same limits as serialized inspector data.

Placement And Visibility

SettingDefaultPurpose
Visible On StartEnabledInitial requested visibility when Build Scope allows the component.
Build ScopeEditor + DevelopmentChoose Editor + Development, All Builds, or Editor Only activation.
Target CameraNoneOptional authoritative Game camera. Leave empty for automatic enabled-Game-camera selection.
Attached CameraRuntime statusRead-only camera currently selected by the overlay.
CornerTop LeftTop-left, top-right, bottom-left, or bottom-right camera-viewport anchor.
Margin(12, 12)Camera-pixel inset, clamped to 0–8192 on each axis.
Text Scale2Integer bitmap scale from 1–6. Fractional runtime input is rounded.
Auto-Fit Small ViewsEnabledReduces effective text scale, down to 1, when configured content does not fit.
Respect Screen Safe AreaDisabledAdds Screen.safeArea insets for display-camera output. Ignored for cameras targeting a RenderTexture.

An assigned Target Camera is authoritative. If it becomes unusable, the overlay waits instead of silently moving to another camera. Auto-fit changes text scale only; it does not resize the configured graph. ContentFits reports whether the complete layout fits after auto-fit.

Metric Presets

Presets change only built-in metric sections and the graph:

PresetEnabled content
CompactFPS + Frame Time and CPU + GPU Timing text.
StandardFPS, CPU/GPU timing, memory, render counters, and graph without verbose device text or Budget.
FullAll built-in measurements, Budget, and graph.

Custom rows, camera, layout, colors, cadence, and build scope remain unchanged when a preset is selected.

Visible Metrics

SectionNew-component defaultContent
Device DetailsOffDevice, OS, processor, GPU, graphics memory, and graphics API/version.
FPS + Frame TimeOnFPS and corresponding smoothed frame duration.
CPU + GPU TimingOnIndependent values supplied by Unity's FrameTimingManager.
MemoryOnManaged GC and system-memory profiler counters.
Render CountersOnDraw calls, batches, triangles, and vertices.
Frame Budget SummaryOffRecent maximum, P99, 1% low, and misses against Target FPS.
Custom Numeric StatsOffUp to four fixed rows supplied through the runtime API.

Unavailable profiler and timing measurements display --. Enabling a section cannot make an unsupported source available.

Frame-Time Graph

SettingDefaultAccepted range or behavior
Show GraphEnabledDisplays observed frame samples and a target-budget marker.
Width24060–600 camera pixels.
Height6424–200 camera pixels.
Bar Width21–8 camera pixels per observation.
Graph Ceiling (ms)33.331–1000 ms; taller observations are clipped visually.
Target FPS601–1000 FPS for marker, bar thresholds, and budget misses. Does not set application frame rate.
Color Bars By BudgetDisabledUses warning above one target budget and critical above two target budgets.

Appearance

The configurable colors are Text Color, Graph Bars, Budget Warning, Budget Critical, Graph Background, Target Marker, and Backdrop Color.

Timing Smoothing defaults to 0.9 retention and accepts 0–0.99. Higher values react more slowly. It affects only FPS and frame-duration text, not graph observations.

Text Backdrop is disabled by default. When enabled, it draws a translucent background behind the measured text without adding a second material or UI framework. Backdrop Padding defaults to 4 and accepts 0–16 camera pixels. Presets do not change appearance.

Update Cadence And Input

SettingDefaultBehavior
Text Updates / Second41–30. Controls text mesh refresh plus timing capture, recorder consumption, and Budget analysis when those sections are enabled.
Graph Updates / Second122–60. Controls graph geometry refresh, not frame-history sampling.
Legacy Toggle KeyNoneOptional legacy-input shortcut. Leave None for project-owned Input System actions or debug menus.

Increasing a visual refresh rate cannot make unavailable timing or profiler data appear. Configure the lowest cadence that answers the current diagnostic question on the actual target.