Cuts Recording

Loads recce cut recordings and their associated speech-to-text transcripts from JSONL files. Cuts are waypoint markers where the co-driver made voice recordings during reconnaissance.

Exports

How It Works

Load Flow

1. Loads transcripts from the transcripts JSONL file (indexed by cutId)
2. Loads cuts from the cuts JSONL file
3. For each cut, converts pos to vec3 and quat to quat
4. Attaches matching transcript data (text with word normalization applied)
5. Returns array of cut objects

Cut Object Structure

{
  id = 1,
  pos = vec3(...),       -- world position where cut was recorded
  quat = quat(...),      -- vehicle orientation at recording
  transcript = {
    error = nil,         -- error from speech-to-text (if any)
    text = "left 3",     -- normalized transcript text
  }
}

File Locations

• Cuts file: rallyUtil.cutsFile(missionDir) - JSONL format
• Transcripts file: rallyUtil.transcriptsFile(missionDir) - JSONL format

Dependencies

• rallyUtil - file path helpers
• jsonlUtils - JSONL line-by-line parser
• normalizer - word replacement/normalization for transcripts

local cutsRecording = require('/lua/ge/extensions/gameplay/rally/recce/cutsRecording')
local cuts = cutsRecording.load(missionDir)
-- Returns array of cut objects with pos, quat, and transcript

See Also

• drivelineRecording - Recorded Driveline Loader - Related reference
• Gameplay Systems Guide - Guide