Class WheelSettings

Namespace

LibreRally.Vehicle.Physics

Assembly

LibreRally.dll

Holds wheel constraint references and metadata so RallyCarComponent can drive throttle, brake, steering, and suspension-travel measurement each frame. Also stores references to the tyre model and dynamics system.

[DataContract]
[ComponentCategory("LibreRally")]
public class WheelSettings : EntityComponent, IIdentifiable

Inheritance

object

EntityComponent

WheelSettings

Implements

IIdentifiable

Inherited Members

EntityComponent.Entity

EntityComponent.Id

EntityComponent.EnsureEntity

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Properties

CurrentSteerAngle

Rate-limited rack command (radians) that the steering servo tracks.

[DataMemberIgnore]
public float CurrentSteerAngle { get; set; }

Property Value

float

CurrentSurface

Current surface type under this wheel. Updated by raycast/contact detection.

[DataMemberIgnore]
public SurfaceType CurrentSurface { get; set; }

Property Value

SurfaceType

CurrentSurfaceProperties

Current blended surface properties under this wheel. Updated by the ground probe.

[DataMemberIgnore]
public SurfaceProperties CurrentSurfaceProperties { get; set; }

Property Value

SurfaceProperties

DriveMotor

Drives wheel spin in chassis-local space so the axle can steer without losing drive authority.

[DataMemberIgnore]
public AngularMotorConstraintComponent? DriveMotor { get; set; }

Property Value

AngularMotorConstraintComponent

DynamicsIndex

Index of this wheel in the VehicleDynamicsSystem arrays (0=FL, 1=FR, 2=RL, 3=RR).

[DataMemberIgnore]
public int DynamicsIndex { get; set; }

Property Value

int

GroundProbeHits

Reusable hit buffer for the tyre ground-contact probe.

[DataMemberIgnore]
public List<HitInfo> GroundProbeHits { get; }

Property Value

List<HitInfo>

StaticNormalLoad

Nominal wheel load for the tyre model, initialized during vehicle build from quarter-mass × gravity.

[DataMemberIgnore]
public float StaticNormalLoad { get; set; }

Property Value

float

SteerMotor

Steers the wheel around the chassis-up axis (front wheels only).

[DataMemberIgnore]
public AngularAxisMotorConstraintComponent? SteerMotor { get; set; }

Property Value

AngularAxisMotorConstraintComponent

SuspensionLocalAxis

Chassis-local suspension axis. Positive travel is bump/compression; negative is rebound.

[DataMemberIgnore]
public Vector3 SuspensionLocalAxis { get; set; }

Property Value

Vector3

SuspensionLocalOffsetA

Chassis-local suspension anchor used by the wheel's linear suspension constraints.

[DataMemberIgnore]
public Vector3 SuspensionLocalOffsetA { get; set; }

Property Value

Vector3

SuspensionLocalOffsetB

Wheel-local suspension anchor used by the wheel's linear suspension constraints.

[DataMemberIgnore]
public Vector3 SuspensionLocalOffsetB { get; set; }

Property Value

Vector3

SuspensionMaximumOffset

Maximum allowed suspension offset (bump stop) in metres.

[DataMemberIgnore]
public float SuspensionMaximumOffset { get; set; }

Property Value

float

SuspensionMinimumOffset

Minimum allowed suspension offset (rebound stop) in metres.

[DataMemberIgnore]
public float SuspensionMinimumOffset { get; set; }

Property Value

float

SuspensionTargetOffset

Neutral suspension offset target in metres for the spring servo.

[DataMemberIgnore]
public float SuspensionTargetOffset { get; set; }

Property Value

float

TyreModel

Slip-based tyre model with Pacejka/brush physics for this wheel.

[DataMemberIgnore]
public TyreModel? TyreModel { get; set; }

Property Value

TyreModel