Timeline Replay

Overview

• Node Name: Timeline Replay
• Category: (duration behaviour)
• File: extensions/flowgraph/nodes/vehicle/replay.lua

Plays a vehicle replay file at a specific time within a flowgraph timeline. This is a prototypical node and may not work correctly in all cases.

Todo: Prototypical node, not working correctly in all cases.

Pin Schema

Input Pins

Legacy Pin Mapping

• in.vehID → vehId

Internals

Key Methods

Custom Properties UI

The node provides an ImGui interface to:

1. Load available replays via core_replay.getRecordings().
2. Select a replay from a dropdown combo box.
3. The selected replay filename is stored in self.replayName.

How It Works

1. The node uses the flowgraph timeline system (_setupTimeline(5, 10)).
2. When the timeline begins, onTimelineBegin() sets a startReplay flag.
3. On the next work() tick, the replay is loaded via core_replay.loadFile() using either the pin filename or the UI-selected replay name.
4. When the timeline ends, onTimelineEnd() sets a stopReplay flag.
5. On the next tick, core_replay.stop() halts the replay.
6. If execution is stopped entirely, the replay is also stopped.

Usage Example

-- Load and play a replay file:
core_replay.loadFile("/path/to/replay.rpl")

-- Stop replay:
core_replay.stop()

-- Get available recordings:
local recordings = core_replay.getRecordings()
for _, r in ipairs(recordings) do
  print(r.filename)
end

Key Dependencies

• core_replay.loadFile(path) - loads and plays a replay file
• core_replay.stop() - stops the active replay
• core_replay.getRecordings() - lists available replay recordings
• Flowgraph timeline system (_setupTimeline, onTimelineBegin, onTimelineEnd)

See Also

• Align for Coupling (Flowgraph Node) - Related reference
• Apply Velocity to Vehicle (Flowgraph Node) - Related reference
• Boost Vehicle (Flowgraph Node) - Related reference
• FlowGraph Guide - Guide