Automatic merge of T1.5.1-1689-g72674c98d and 14 pull requests

- Pull request #900 at 4629736: DMI in 3D cab + two more dials
- Pull request #1030 at d3ae4a2: Refactor settings, in prep for settings exporter
- Pull request #1045 at cc4d53c: Bugfix: Empty Start Time for Explore, and other issues loading from Menu Selection and Content Routes
- Pull request #1052 at 5bbc476: Content Manager: Add axle count, and lowest derail force
- Pull request #1062 at 3b18c48: Train Forces popup Window.
- Pull request #1064 at 9b3415e: Add Train Info tab to Help window (F1)
- Pull request #1066 at 62c89c1: Log derailment, using TraceInformation.
- Pull request #892 at 1f5ba4c: Signal Function OPP_SIG_ID_TRAINPATH
- Pull request #1000 at d8d9709: Locomotive operation from control car
- Pull request #1029 at 92c74ef: Superelevation Follow Up Fixes
- Pull request #1057 at d9791e2: Switchable brake system
- Pull request #1065 at 409064d: Fix for PantographToggle sound event
- Pull request #1068 at d6e1f83: Build for online-only documentation files
- Pull request #896 at f1681df: First implementation of https://blueprints.launchpad.net/or/+spec/specific-sounds-for-ai-trains

Author: openrails-bot

Source/Orts.Simulation/Simulation/AIs/AITrain.cs

@@ -3990,6 +3990,7 @@ public override void InitializeBrakes()
                 base.InitializeBrakes();
                 return;
             }
+            SetInitialBrakeModes();
             float maxPressurePSI = 90;
             float fullServPressurePSI = 64;
             float maxPressurePSIVacuum = 21;

Source/Orts.Simulation/Simulation/Physics/Train.cs

@@ -4078,6 +4078,8 @@ public void UnconditionalInitializeBrakes()
             if (Simulator.Confirmer != null && IsActualPlayerTrain) // As Confirmer may not be created until after a restore.
                 Simulator.Confirmer.Confirm(CabControl.InitializeBrakes, CabSetting.Off);
 
+            SetInitialBrakeModes();
+
             float maxPressurePSI = 90;
             float fullServPressurePSI = 64;
             if (FirstCar != null && FirstCar.BrakeSystem is VacuumSinglePipe)
@@ -4563,6 +4565,38 @@ public void CheckFreight()
             if (TrainType == TRAINTYPE.AI_INCORPORATED && IncorporatingTrainNo > -1) IsPlayable = true;
         } // CheckFreight
 
+
+        public void SetInitialBrakeModes()
+        {
+            var lead = LeadLocomotive ?? Cars?.FirstOrDefault();
+            if (lead == null) return;
+
+            // Check if lead is vacuum-braked
+            if (lead.BrakeSystem is VacuumSinglePipe || (lead.BrakeSystems?.Any(b => b.Value is VacuumSinglePipe) ?? false) &&
+                Cars.Count(c => c.BrakeSystem is VacuumSinglePipe || c.BrakeSystem is ManualBraking ||
+                (c.BrakeSystems?.Any(b => b.Value is VacuumSinglePipe || b.Value is ManualBraking) ?? false)) > Cars.Count / 3)
+            {
+                foreach (var car in Cars.Cast<MSTSWagon>())
+                {
+                    if (car.BrakeSystems?.ContainsKey((BrakeModes.VP, 0)) ?? false) car.SetBrakeSystemMode(BrakeModes.VP, car.MassKG);
+                    else if (car.BrakeSystems?.ContainsKey((BrakeModes.VB, 0)) ?? false) car.SetBrakeSystemMode(BrakeModes.VB, car.MassKG);
+                    else if (car.BrakeSystems?.ContainsKey((BrakeModes.VU, 0)) ?? false) car.SetBrakeSystemMode(BrakeModes.VU, car.MassKG);
+                }
+            }
+            else
+            {
+                foreach (var car in Cars.Cast<MSTSWagon>())
+                {
+                    if (car.BrakeSystems?.ContainsKey((BrakeModes.R_MG, 0)) ?? false) car.SetBrakeSystemMode(BrakeModes.R_MG, car.MassKG);
+                    else if (car.BrakeSystems?.ContainsKey((BrakeModes.R, 0)) ?? false) car.SetBrakeSystemMode(BrakeModes.R, car.MassKG);
+                    else if (car.BrakeSystems?.ContainsKey((BrakeModes.P, 0)) ?? false) car.SetBrakeSystemMode(BrakeModes.P, car.MassKG);
+                    else if (car.BrakeSystems?.ContainsKey((BrakeModes.AP, 0)) ?? false) car.SetBrakeSystemMode(BrakeModes.AP, car.MassKG);
+                    else if (car.BrakeSystems?.ContainsKey((BrakeModes.G, 0)) ?? false) car.SetBrakeSystemMode(BrakeModes.G, car.MassKG);
+                    else if (car.BrakeSystems?.ContainsKey((BrakeModes.AG, 0)) ?? false) car.SetBrakeSystemMode(BrakeModes.AG, car.MassKG);
+                }
+            }
+        }
+
         public void CalculatePositionOfCars()
         {
             CalculatePositionOfCars(0, 0);

Source/Orts.Simulation/Simulation/RollingStocks/MSTSWagon.cs

@@ -3280,7 +3280,7 @@ private void UpdateTenderLoad()
 
         private void UpdateBrakeLoadCompensation(float massDiffRatio)
         {
-            // The LoadFull... and LoadEmpty... variables are set by the SetBrakeSystem() method based on the actually active brake mode.
+            // The LoadFull... and LoadEmpty... variables are set by the SetBrakeSystemMode() method based on the actually active brake mode.
             // The massDiffRatio is always 1 for manually switchable load stages, even for an empty wagon.
             // Only wagons with automatic continuous load compensation can have a massDiffRatio below 1.
             MaxBrakeForceN = ((LoadFullMaxBrakeForceN - LoadEmptyMaxBrakeForceN) * massDiffRatio) + LoadEmptyMaxBrakeForceN;