Recce Manager

High-level manager for rally recce (reconnaissance) recordings. Coordinates loading driveline recordings and voice cut markers, then converts them into pacenote data for the notebook.

Constructor

local Recce = require('/lua/ge/extensions/gameplay/rally/recce')
local recce = Recce(missionDir)

Public API

How It Works

Data Sources

1. Driveline: Timestamped position/orientation points recorded during a recce run, loaded via drivelineRecording.load() → returns a PointList
2. Cuts: Waypoint markers where the co-driver made voice recordings, loaded via cutsRecording.load() → includes transcript text from speech-to-text

Pacenote Import Flow (createPacenotesData)

1. Creates a Snaproad from the driveline for snap-to-road functionality
2. Iterates through cuts in order
3. For each cut:
   • Snaps the cut position to the closest snaproad point → corner end (CE)
   • Calculates corner start (CS) by walking backwards on the snaproad
   • Handles edge cases (first point, duplicate positions)
   • Merges duplicate cuts (same CE position) by concatenating transcript text
4. Returns array of pacenote data objects ready for notebook import

Pacenote Data Structure

{
  name = "Import_1 42",
  notes = { english = { note = "left 3 over crest" } },
  metadata = {},
  oldId = 42,
  pacenoteWaypoints = {
    { name = "corner start", pos = vec3(...), radius = 20, waypointType = "cornerStart", ... },
    { name = "corner end",   pos = vec3(...), radius = 20, waypointType = "cornerEnd", ... }
  }
}

Debug Visualization

Draws cuts as 3D car shapes (square prisms with wheel spheres) in teal, with transcript text displayed above each car.

-- Load and import recce data
local recce = Recce(missionDir)
recce:loadDrivelineAndCuts()

if recce:drivelineAndCutsLoaded() then
  local pacenotes = recce:createPacenotesData(notebook)
  -- pacenotes can be imported into the notebook
end

See Also

• Rally Audio Manager - Related reference
• Rally Camera Path Player - Related reference
• Rally Client - Related reference
• Gameplay Systems Guide - Guide