Driveline Recording

Loads a recorded driveline file from a recce run and returns a PointList. A driveline is a series of timestamped position/orientation points captured during reconnaissance driving.

Exports

How It Works

Load Flow

1. Resolves driveline file path via rallyUtil.drivelineFile(missionDir)
2. Parses JSONL file, converting each line to a driveline point with pos (vec3), quat (quat), and ts (timestamp)
3. Requires at least 3 points for a valid driveline
4. Creates a PointList from raw points
5. Calls setupPointRelationships() (links prev/next pointers)
6. Calls setupPointNormals() (calculates forward normals)
7. Logs load time and point count

Point Structure (per JSONL line)

{
  pos = vec3(x, y, z),    -- world position
  quat = quat(x, y, z, w), -- vehicle orientation
  ts = 1234.567           -- timestamp in seconds
}

Dependencies

• rallyUtil - file path helpers and timing
• jsonlUtils - JSONL parser
• PointList - linked-list point container with relationship/normal setup

local drivelineRecording = require('/lua/ge/extensions/gameplay/rally/recce/drivelineRecording')
local pointList = drivelineRecording.load(missionDir)
if pointList then
  -- pointList has .points array, each with .pos, .quat, .prev, .next, .normal
  local firstPoint = pointList.points[1]
end

See Also

• cutsRecording - Recce Cuts Loader - Related reference
• Gameplay Systems Guide - Guide