Telemetry HUD

Live · frame mode

Four-edge layout around a centred viewport. The consumer's map, 3D view, or video sits in the children slot; telemetry pins to the edges. Top: heading + platform. Left: speed + roll. Right: vertical + pitch. Bottom: battery, vertical rate, and any domain-specific cells. The centre stays clear.

Live · domains · strip mode

Four domains, four label dialects. The vertical concept changes — `ALT` for aerial, `ELEV` for ground, `DEPTH` for surface and underwater. Vertical rate reads `V/S` for aerial, `DIVE` for underwater. Domain-specific cells (`SLOPE` for ground, `BOT` for underwater) surface only when relevant.

Live · stale field

Heading has stopped updating. Rather than presenting a frozen `174°` as if it were live, the cell dims its value and carries a `STALE` age tag — the operator sees the degradation before acting on it. Fresh cells around it are unaffected. This is invariant 5 in the organism itself: mark stale, never hold a silent last-good value.

Anatomy

Same cells, two postures. The cell set is determined by what the consumer passes; the posture is determined by `mode`. Labels resolve from `domain`.

Props

Types

type UxvDomain = "aerial" | "ground" | "surface" | "underwater";

type SpeedUnit = "m/s" | "km/h" | "kn";

type VerticalUnit = "m" | "ft";

type HudMode = "strip" | "frame";

type TelemetryField =
  | "speed" | "vertical" | "heading"
  | "battery" | "fuel" | "roll" | "pitch"
  | "verticalRate" | "slope" | "altitudeAboveBottom";

Wiring

Read-only — pass whichever fields the platform surfaces. When a field stops updating, mark it stale via `stale` rather than letting a frozen value look live. Set `domain` to the platform class.

// Aerial — strip mode beside a video tile
<TelemetryHud
  domain="aerial"
  platform="UAV-09"
  speed={state.airspeed}
  speedUnit="kn"
  vertical={state.altitudeFt}
  verticalUnit="ft"
  verticalRef="AGL"
  heading={state.heading}
  battery={state.batteryPct}
  roll={state.attitude.roll}
  pitch={state.attitude.pitch}
  verticalRate={state.climbRate}
/>

// Underwater — DEPTH and DIVE labels resolve from domain
<TelemetryHud
  domain="underwater"
  platform="UUV-11"
  speed={state.speed}
  vertical={state.depth}
  heading={state.heading}
  battery={state.batteryPct}
  pitch={state.diveAngle}
  verticalRate={state.diveRate}
  altitudeAboveBottom={state.sounderM}
/>

// Frame mode — four-edge overlay around a map / 3D viewport
<TelemetryHud mode="frame" domain="aerial" ...telemetry>
  <YourMapEngine />
</TelemetryHud>

// Mark a field stale when it stops updating — invariant 5
<TelemetryHud
  domain="ground"
  platform="UGV-04"
  speed={state.speed}
  heading={state.lastHeading}
  battery={state.batteryPct}
  stale={{ heading: secondsSince(state.headingUpdatedAt) }}
/>

Behavioural rule

Accessibility

JavaFX

Ships in the PRIZM JavaFX library for thick-client C3 apps as Rc3TelemetryHud (extends StackPane). Run the gallery to see it natively.

import design.prizm.fx.rc3.Rc3TelemetryHud;

Rc3TelemetryHud()

Honours invariant 5 — a stale field never passes for live. Battery / fuel use semantic tones; the platform marker is Ember. Mirrors components/rc3/telemetry-hud.tsx.