Defence

Defence (DEF)

The Defence functional area (F3) provides threat detection, classification, and tracking displays. It integrates with the DDS Battlespace Objects domain to present real-time threat information to the operator.

Radar View

The DEF screen features a top-down Radar View widget that displays a plan position indicator (PPI) centred on the vehicle's position. Threats appear as colour-coded diamond markers positioned by bearing and range:

Threat Radar

The zoomed view provides greater detail for closer threats, toggled with F2:

Threat Radar Zoom

Radar features:

  • Range rings at 2 km intervals (5 rings out to 10 km)
  • N/S/E/W compass markers that rotate with vehicle heading
  • Threat diamonds colour-coded by hostility:
    • Red — Hostile
    • Orange — Suspect
    • Yellow — Unknown
    • Green — Neutral
    • Blue — Friendly
  • Click-to-zoom toggle for close-range inspection

Threat Table

The tabular view lists all tracked battlespace objects with hostility classification, bearing, range, object type, and last update time:

Threat Table

LSAS Strip Threat Overlay

When the LSAS camera strip is visible, threat indicators are overlaid directly onto the camera thumbnails. Each threat diamond appears at the bearing position on the corresponding camera view, giving the operator immediate visual correlation between the camera feed and detected threats.

  • Closer threats appear lower on the thumbnail (near the direction bar)
  • Distant threats appear near the top
  • Colour coding matches the radar hostility scheme
  • Labels show threat identifiers (e.g. "H1", "S2") and range in metres

See Threats for the complete threat lifecycle and display details.

DEF Controls

Key Action
F1 Toggle radar zoom (min ↔ max range)
F2 Cycle map background (Off → Satellite → Topo → Street)
F3 Toggle Radar / FOV overlay
F4 Toggle Narrow / Wide FOV mode
F5 Toggle camera PIP
F6 Toggle weather radar overlay
F7 Toggle Track All trails
F9 Switch to Threats table
F19 Select next threat (further)
F20 Select previous threat (closer)

HID Controller

When a gamepad or joystick is connected via gva-gateway-joystick, the DEF radar supports hands-on control:

Input Action
Right Trigger Zoom in (proportional)
Left Trigger Zoom out (proportional)
RB Next threat + auto-centre
LB Previous threat + auto-centre
X Cycle map type
Y Toggle min/max zoom
Back Reset view to vehicle

See HID Controller Setup for full configuration details and JSON binding reference.

State Machine

stateDiagram-v2 [*] --> Radar : Enter DEF state "DEF Screen" as DEF { state "Radar Display" as Radar { ZoomOut : Wide Range ZoomIn : Close Range ZoomOut --> ZoomIn : F1 Zoom In ZoomIn --> ZoomOut : F1 Zoom Out } state "Map Background" as Map { MapOff : Off MapSat : Satellite MapTopo : Topographic MapOff --> MapSat : F2 Cycle MapSat --> MapTopo : F2 Cycle MapTopo --> MapOff : F2 Cycle } state "Radar Mode" as Mode { Overlay : Radar Overlay FOV : Camera Field of View Overlay --> FOV : F3 FOV FOV --> Overlay : F3 Overlay } state "Camera PIP" as PIP { PIPOff : Hidden PIPWide : Wide Angle (1x) PIPNarrow : Narrow / Zoom (2x) PIPOff --> PIPWide : F5 Camera On PIPWide --> PIPOff : F5 Camera Off PIPWide --> PIPNarrow : F4 Narrow PIPNarrow --> PIPWide : F4 Wide } state "Weather Radar" as Wx { WxOff : Off WxOn : On WxOff --> WxOn : F6 On WxOn --> WxOff : F6 Off } } DEF --> ThreatsTable : F9 Threat ThreatsTable --> DEF : Dismiss DEF --> Alarms : F14 Alarms Alarms --> DEF : Acknowledge / Close DEF --> Threats : F15 Threats Threats --> DEF : Dismiss / Close
  • Threats — Threat lifecycle, DDS topics, and display integration
  • PPI Widget — Radar overlay styles and configuration
  • SA — Situational Awareness with PPI overlay
  • HID Controller Setup — Gamepad/joystick setup and JSON binding reference