Struct VehicleTelemetry

Namespace

rF2SharedMemoryNet.RF2Data.Structs

Assembly

rF2SharedMemoryNet.dll

Represents telemetry data for a vehicle in rFactor 2, including positional, orientation, vehicle status, driver input, aerodynamics, and other detailed metrics.

public struct VehicleTelemetry

Inherited Members

ValueType.Equals(object)

ValueType.GetHashCode()

ValueType.ToString()

object.Equals(object, object)

object.GetType()

object.ReferenceEquals(object, object)

Remarks

This structure provides comprehensive telemetry information for a vehicle in rFactor 2, including real-time data such as position, velocity, acceleration, engine status, driver inputs, and aerodynamic properties. It is designed for use in applications that require detailed simulation data, such as telemetry analysis tools or custom plugins. Many fields in this structure represent instantaneous values, such as engine RPM, throttle input, and aerodynamic forces. Some fields, such as lap time and impact data, provide historical context for the current state of the vehicle. Note that certain fields, such as arrays for vehicle and track names, are encoded as byte arrays and may require conversion to strings for human-readable use. Additionally, some fields, such as orientation matrices, require specialized handling for interpretation.

Fields

AntiStallActivated

Anti-stall activated status.

public byte AntiStallActivated

Field Value

byte

BatteryChargeFraction

Battery charge fraction.

public double BatteryChargeFraction

Field Value

double

ClutchRPM

Clutch RPM

public double ClutchRPM

Field Value

double

CurrentSector

Represents the current sector of the track, with the pitlane status stored in the sign bit.

public int CurrentSector

Field Value

int

Remarks

The value is zero-based, where the least significant bits indicate the sector number. If the sign bit is set, the value represents the pitlane status. For example, entering the pitlane from the third sector would result in a value of 0x80000002.

DeltaTime

Time since the last update in seconds.

public double DeltaTime

Field Value

double

DentSeverity

Represents the severity of dents at eight locations around the car.

public byte[] DentSeverity

Field Value

byte[]

Remarks

See DentSeverity for the possible values.

Detached

Any parts besides wheels have been detached.

public byte Detached

Field Value

byte

Drag

Drag coefficient.

public double Drag

Field Value

double

ElapsedTime

Game session time in seconds.

public double ElapsedTime

Field Value

double

ElectricBoostMotorRPM

RPM of the electric boost motor.

public double ElectricBoostMotorRPM

Field Value

double

ElectricBoostMotorState

Electric boost motor state.

public byte ElectricBoostMotorState

Field Value

byte

Remarks

See BoostMotorState for the possible values.

ElectricBoostMotorTemperature

Temperature of the electric boost motor.

public double ElectricBoostMotorTemperature

Field Value

double

ElectricBoostMotorTorque

Torque of the boost motor.

public double ElectricBoostMotorTorque

Field Value

double

Remarks

Negative values indicate regenerative braking.

ElectricBoostWaterTemperature

Current water temperature of the electric boost motor cooler if present.

public double ElectricBoostWaterTemperature

Field Value

double

EngineMaxRPM

Max engine RPM.

public double EngineMaxRPM

Field Value

double

EngineOilTemp

Engine oil temperature in celsius.

public double EngineOilTemp

Field Value

double

EngineRPM

Represents the current revolutions per minute (RPM) of the engine.

public double EngineRPM

Field Value

double

EngineTorque

Current engine torque, including any additive torque.

public double EngineTorque

Field Value

double

EngineWaterTemp

Engine water temp in celsius.

public double EngineWaterTemp

Field Value

double

Expansion

For future use.

public byte[] Expansion

Field Value

byte[]

FilteredBrake

ABS filtered brake

public double FilteredBrake

Field Value

double

FilteredClutch

Filtered clutch

public double FilteredClutch

Field Value

double

FilteredSteering

Filtered steering

public double FilteredSteering

Field Value

double

FilteredThrottle

TC filtered throttle

public double FilteredThrottle

Field Value

double

Front3rdDeflection

Represents the deflection at the front third spring.

public double Front3rdDeflection

Field Value

double

FrontDownforce

Front downforce

public double FrontDownforce

Field Value

double

FrontFlapActivated

Indicates whether the front flap is activated.

public byte FrontFlapActivated

Field Value

byte

FrontRideHeight

Front ride height

public double FrontRideHeight

Field Value

double

FrontTyreCompoundIndex

Front tyre compound index

public byte FrontTyreCompoundIndex

Field Value

byte

FrontTyreCompoundName

Front tyre compound name.

public byte[] FrontTyreCompoundName

Field Value

byte[]

Remarks

Stored as a byte array of size 18.

FrontWingHeight

Front wing height

public double FrontWingHeight

Field Value

double

Fuel

Fuel level in liters.

public double Fuel

Field Value

double

FuelCapacity

Fuel capacity in liters.

public double FuelCapacity

Field Value

double

Gear

Gear information

public int Gear

Field Value

int

Remarks

-1 indicates reverse gear, 0 indicates neutral, and positive values indicate forward gears.

Headlights

Headlights are on.

public byte Headlights

Field Value

byte

ID

Identifier for the telemetry slot.

public int ID

Field Value

int

IgnitionStarter

Igninition and starter status.

public byte IgnitionStarter

Field Value

byte

Remarks

See IgnitionStarterStatus for the possible values.

LapNumber

Current lap number.

public int LapNumber

Field Value

int

LapStartTime

Time this las was started

public double LapStartTime

Field Value

double

LastImpactMagnitude

Magnitude of the last impact.

public double LastImpactMagnitude

Field Value

double

LastImpactPosition

Location of last impact

public Vec3 LastImpactPosition

Field Value

Vec3

LastImpactTime

Time of last impact.

public double LastImpactTime

Field Value

double

LocalAcceleration

Acceleration (meters/sec^2) in local vehicle coordinates

public Vec3 LocalAcceleration

Field Value

Vec3

LocalRotationalAcceleration

Rotational acceleration (radians/sec^2) in local vehicle coordinates

public Vec3 LocalRotationalAcceleration

Field Value

Vec3

LocalRotationalSpeed

Rotation (radians/sec) in local vehicle coordinates

public Vec3 LocalRotationalSpeed

Field Value

Vec3

LocalVelocity

Velocity in world coordinates (meters/sec)

public Vec3 LocalVelocity

Field Value

Vec3

MaxGears

Represents the maximum number of forward gears available.

public byte MaxGears

Field Value

byte

Orientation

rows of orientation matrix

public Vec3[] Orientation

Field Value

Vec3[]

Overheating

Overheating icon is shown.

public byte Overheating

Field Value

byte

PhysicalSteeringWheelRange

Represents the physical range of the steering wheel in degrees.

public float PhysicalSteeringWheelRange

Field Value

float

PhysicsToGraphicsOffset

Represents the offset from the static center of gravity (CG) to the graphical center.

public float[] PhysicsToGraphicsOffset

Field Value

float[]

Position

World position in meters

public Vec3 Position

Field Value

Vec3

Rear3rdDeflection

Represents the deflection at the rear third spring.

public double Rear3rdDeflection

Field Value

double

RearBrakeBias

Rear brake bias fraction.

public double RearBrakeBias

Field Value

double

RearDownforce

Rear downforce

public double RearDownforce

Field Value

double

RearFlapActivated

Indicates whether the rear flap is activated.

public byte RearFlapActivated

Field Value

byte

RearFlapLegalStatus

Rear flap legal status.

public byte RearFlapLegalStatus

Field Value

byte

Remarks

See RearFlapLegalStatus for the possible values.

RearRideHeight

Rear ride height

public double RearRideHeight

Field Value

double

RearTyreCompoundIndex

Rear tyre compound inde

public byte RearTyreCompoundIndex

Field Value

byte

RearTyreCompoundName

Rear tyre compound name.

public byte[] RearTyreCompoundName

Field Value

byte[]

Remarks

Stored as a byte array of size 18.

ScheduledStops

Number of scheduled pit stops.

public byte ScheduledStops

Field Value

byte

SpeedLimiter

Indicates whether the speed limiter is enabled.

public byte SpeedLimiter

Field Value

byte

SpeedLimiterAvailable

Is speed limiter available.

public byte SpeedLimiterAvailable

Field Value

byte

SteeringShaftTorque

Torque around the steering shaft.

public double SteeringShaftTorque

Field Value

double

TrackName

Name of track

public byte[] TrackName

Field Value

byte[]

Remarks

Stored as a byte array of size 64.

TurboBoostPressure

Curren turbo boost pressure if available.

public double TurboBoostPressure

Field Value

double

UnfilteredBrake

Unfiltered brake

public double UnfilteredBrake

Field Value

double

UnfilteredClutch

Unfiltered clutch

public double UnfilteredClutch

Field Value

double

UnfilteredSteering

Unfiltered steering

public double UnfilteredSteering

Field Value

double

UnfilteredThrottle

Unfiltered throttle

public double UnfilteredThrottle

Field Value

double

Unused

Unused

public byte[] Unused

Field Value

byte[]

VehicleName

Vehicle name

public byte[] VehicleName

Field Value

byte[]

Remarks

Stored as a byte array of size 64.

VisualSteeringWheelRange

Visual steering wheel range.

public float VisualSteeringWheelRange

Field Value

float

Wheels

Wheel information.

public Wheel[] Wheels

Field Value

Wheel[]

Remarks

Layout is as follows: front left, front right, rear left, rear right.