Automatic merge of T1.5.1-797-gabb8eb9a4 and 13 pull requests

- Pull request #570 at 3539862: Experimental glTF 2.0 support with PBR lighting
- Pull request #839 at d00beb9: First phase of https://blueprints.launchpad.net/or/+spec/additional-cruise-control-parameters
- Pull request #876 at f92de76: docs: add source for documents previously on website to source Documentation folder
- Pull request #882 at a055bca: Blueprint/train car operations UI window
- Pull request #885 at 8f94333: feat: Add notifications to Menu
- Pull request #886 at 6c0785b: Scene viewer extension to TrackViewer
- Pull request #892 at 1f5ba4c: Signal Function OPP_SIG_ID_TRAINPATH
- Pull request #896 at 5866028: First implementation of https://blueprints.launchpad.net/or/+spec/specific-sounds-for-ai-trains
- Pull request #897 at 0a9d939: feat: Improved system information collection
- Pull request #899 at 628a9fb: Duplex steam engines - Booster Engine addition
- Pull request #907 at 9b0b04f: Bug fix for https://bugs.launchpad.net/or/+bug/2047300 Dynamic tracks disappear after long tunnel
- Pull request #908 at 4b4afe3: feat: supports switching adhesion precisions
- Pull request #909 at c3a572a: Correct Control Car crash bug

Author: openrails-bot

Source/Orts.Simulation/Simulation/RollingStocks/MSTSDieselLocomotive.cs

@@ -760,7 +760,7 @@ protected override void UpdateTractiveForce(float elapsedClockSeconds, float t,
                 DieselEngines.HandleEvent(PowerSupplyEvent.StopEngine);
             }
 
-            ApplyDirectionToTractiveForce(ref TractiveForceN);
+            ApplyDirectionToTractiveForce(ref TractiveForceN, 0);
 
             // Calculate the total tractive force for the locomotive - ie Traction + Dynamic Braking force.
             // Note typically only one of the above will only ever be non-zero at the one time.

Source/Orts.Simulation/Simulation/RollingStocks/MSTSLocomotive.cs

@@ -2401,7 +2401,7 @@ protected virtual void UpdateTractiveForce(float elapsedClockSeconds, float t, f
                 AverageForceN = w * AverageForceN + (1 - w) * TractiveForceN;
             }
 
-            ApplyDirectionToTractiveForce(ref TractiveForceN);
+            ApplyDirectionToTractiveForce(ref TractiveForceN, 0);
 
             // Calculate the total tractive force for the locomotive - ie Traction + Dynamic Braking force.
             // Note typically only one of the above will only ever be non-zero at the one time.
@@ -2456,7 +2456,7 @@ protected virtual void UpdateAxleDriveForce()
         /// <summary>
         /// This function applies a sign to the motive force as a function of the direction of the train.
         /// </summary>
-        protected virtual void ApplyDirectionToTractiveForce(ref float tractiveForceN)
+        protected virtual void ApplyDirectionToTractiveForce(ref float tractiveForceN, int numberofengine )
         {
             if (Train.IsPlayerDriven)
             {

Source/Orts.Simulation/Simulation/RollingStocks/MSTSSteamLocomotive.cs

@@ -6059,7 +6059,7 @@ protected override void UpdateTractiveForce(float elapsedClockSeconds, float loc
             // Update tractive effort across all steam engines
             for (int i = 0; i < SteamEngines.Count; i++)
             {
-                ApplyDirectionToTractiveForce(ref SteamEngines[i].TractiveForceN);
+                ApplyDirectionToTractiveForce(ref SteamEngines[i].TractiveForceN, i);
 
                 TractiveForceN += SteamEngines[i].TractiveForceN;
 
@@ -6122,6 +6122,45 @@ protected override void UpdateTractiveForce(float elapsedClockSeconds, float loc
         }
 
 
+        /// <summary>
+        /// This function applies a sign to the motive force as a function of the direction of the train.
+        /// </summary>
+        protected override void ApplyDirectionToTractiveForce(ref float tractiveForceN, int numberofengine)
+        {
+            if (Train.IsPlayerDriven)
+            {
+                // If booster engine tractive force will only ever be in the forward (+ve) direction
+                if (SteamEngines[numberofengine].AuxiliarySteamEngineType == SteamEngine.AuxiliarySteamEngineTypes.Booster)
+                    return;
+
+                switch (Direction)
+                {
+                    case Direction.Forward:
+                        //tractiveForceN *= 1;     //Not necessary
+                        break;
+                    case Direction.Reverse:
+                        tractiveForceN *= -1;
+                        break;
+                    case Direction.N:
+                    default:
+                        tractiveForceN *= 0;
+                        break;
+                }
+            }
+            else // for AI locomotives
+            {
+                switch (Direction)
+                {
+                    case Direction.Reverse:
+                        tractiveForceN *= -1;
+                        break;
+                    default:
+                        break;
+                }
+            }// end AI locomotive            
+        }
+
+
         /// <summary>
         /// Normalise booster engine crank angle so that it is a value between 0 and 360 starting at the real crank angle difference
         /// </summary>