Rally Transcripts Vehicle Snapshot
Lightweight class representing a single vehicle position/rotation snapshot within a transcript. Acts as a data holder for position, quaternion, steering angle, timestamp, and corner call.
Lightweight class representing a single vehicle position/rotation snapshot within a transcript. Acts as a data holder for position, quaternion, steering angle, timestamp, and corner call.
Constructor
local VehicleSnapshot = require('gameplay/rally/transcripts/vehicleSnapshot')
local snap = VehicleSnapshot(path, name, forceId)| Parameter | Type | Description |
|---|---|---|
path | object | Parent path with getNextUniqueIdentifier() |
name | string? | Display name (defaults to "t_"..id) |
forceId | number? | Override auto-generated ID |
Methods
| Method | Signature | Returns | Description |
|---|---|---|---|
onSerialize | () | table | Serialize snapshot (returns oldId, name, text) |
onDeserialized | (data, oldIdMap) | nil | Stub - deserialization fields are commented out |
Fields
| Field | Type | Description |
|---|---|---|
id | number | Unique identifier |
name | string | Display name |
sortOrder | number | Sort priority (default 999999) |
pos | vec3? | Vehicle position |
quat | quat? | Vehicle rotation quaternion |
steering | number? | Steering angle |
timestamp | number? | Capture timestamp |
cornerCall | string? | Corner classification string |
How It Works
This is a minimal data class used as part of the sorted list pattern. It stores raw vehicle telemetry captured during a recce recording session. The deserialization method is largely stubbed out (fields commented), suggesting this class is primarily used for in-memory data during recording rather than persistent storage.
local snap = VehicleSnapshot(parentPath, "snapshot_1")
snap.pos = vec3(100, 200, 50)
snap.quat = quat(0, 0, 0.7, 0.7)
snap.steering = -45.5
snap.timestamp = os.clockhp()
snap.cornerCall = "3R"Notes
- Implements the
sortedListitem interface (id,name,sortOrder,onSerialize,onDeserialized) - Deserialization is incomplete - this class appears to be a work-in-progress or used only for runtime data
| Function | Signature | Returns | Description |
|---|---|---|---|
M.init | (path, name, forceId) | nil | init |
See Also
- Rally Transcripts Entry - Related reference
- Rally Transcripts Path - Related reference
- Gameplay Systems Guide - Guide
Rally Transcripts Path
Class-based container managing a sorted list of transcript entries. Handles loading/saving transcript files and debug visualization of all entries.
Rally Utility Colors
Constants module defining all color values and visual parameters used throughout the rally editor and pacenote system. Colors are RGB float arrays `{r, g, b}` or ImGui `ImVec4` for UI elements.