Automatic merge of T1.5.1-913-g91804456c and 16 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 1a5693d: Blueprint/train car operations UI window
- 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 #903 at 9bead33: Downloading route content (Github, zip)
- Pull request #910 at 97d4569: Allow building code using .NET 6 (Windows)
- Pull request #911 at 6834af0: docs: Add refactoring as a special type of PR
- Pull request #912 at f7b85e4: New Triple Valve Features Vol. 2
- Pull request #919 at e6c08a2: Added mouse wheel support for controls which can be moved by pressing t…
- Pull request #920 at a94e403: Update RailDriver in Manual
- Pull request #923 at e0f3c55: Add curve squeal to route
- Pull request #924 at 6c2c3cd: Default Asset Improvements
- Pull request #925 at e3b1688: Fix brakeshoe force bug

Author: openrails-bot

Source/RunActivity/Viewer3D/Popups/TrainCarOperationsViewerWindow.cs

@@ -74,20 +74,20 @@ public class TrainCarOperationsViewerWindow : Window
         internal static Texture2D ResetBrakesOff;
         internal static Texture2D ResetBrakesOn;
 
-        public int WindowHeightMin;
-        public int WindowHeightMax;
-        public int WindowWidthMin;
-        public int WindowWidthMax;
-        public string PowerSupplyStatus;
         public string BatteryStatus;
         string CircuitBreakerState;
-        public int SpacerRowCount;
-        public int SymbolsRowCount;
         public int LocoRowCount;
+        public string PowerSupplyStatus;
         public int RowsCount;
+        public int SpacerRowCount;
+        public int SymbolsRowCount;
         const int SymbolWidth = 32;
         public static bool FontChanged;
         public static bool FontToBold;
+        public int WindowHeightMin;
+        public int WindowHeightMax;
+        public int WindowWidthMin;
+        public int WindowWidthMax;
         public int windowHeight { get; set; } //required by TrainCarWindow
         public int CarPosition
         {
@@ -132,10 +132,10 @@ public struct ListLabel
         public List<ListLabel> Labels = new List<ListLabel>();
 
         Train PlayerTrain;
-        int LastPlayerTrainCars;
         bool LastPlayerLocomotiveFlippedState;
+        int LastPlayerTrainCars;
         int OldCarPosition;
-        bool ResetAllSymbols = false;
+        bool ResetAllSymbols;
         public TrainCarOperationsViewerWindow(WindowManager owner)
             : base(owner, Window.DecorationSize.X + CarListPadding + ((owner.TextFontDefault.Height + 12) * 20), Window.DecorationSize.Y + ((owner.TextFontDefault.Height + 12) * 2), Viewer.Catalog.GetString("Train Operations Viewer"))
         {
@@ -375,11 +375,19 @@ void buttonClose_Click(Control arg1, Point arg2)
         public override void PrepareFrame(ElapsedTime elapsedTime, bool updateFull)
         {
             base.PrepareFrame(elapsedTime, updateFull);
+            if (UserInput.IsPressed(UserCommand.CameraCarNext) && CarPosition > 0)
+                CarPosition--;
+            else if (UserInput.IsPressed(UserCommand.CameraCarPrevious) && CarPosition < Owner.Viewer.PlayerTrain.Cars.Count - 1)
+                CarPosition++;
+            else if (UserInput.IsPressed(UserCommand.CameraCarFirst))
+                CarPosition = 0;
+            else if (UserInput.IsPressed(UserCommand.CameraCarLast))
+                CarPosition = Owner.Viewer.PlayerTrain.Cars.Count - 1;
 
             if (updateFull)
             {
                 var carOperations = Owner.Viewer.CarOperationsWindow;
-                var trainCarOperations = Owner.Viewer.TrainCarOperationsWindow;                
+                var trainCarOperations = Owner.Viewer.TrainCarOperationsWindow;
 
                 if (CouplerChanged || PlayerTrain != Owner.Viewer.PlayerTrain || Owner.Viewer.PlayerTrain.Cars.Count != LastPlayerTrainCars || (Owner.Viewer.PlayerLocomotive != null &&
                 LastPlayerLocomotiveFlippedState != Owner.Viewer.PlayerLocomotive.Flipped))

Source/RunActivity/Viewer3D/Popups/TrainCarOperationsWindow.cs

@@ -71,43 +71,44 @@ public class TrainCarOperationsWindow : Window
         internal static Texture2D RearAngleCockClosed;
         internal static Texture2D RearAngleCockOpened;
 
-        public int DisplaySizeY;
-        public bool LayoutUpdated = false;
         public bool AllSymbolsMode = true;
+        public int DisplaySizeY;
+        public bool LayoutUpdated;
         public int LocoRowCount;
         public int RowsCount;
         public int SeparatorCount;
         public int SpacerRowCount;
         public int SymbolsRowCount;
 
-        public int CarPositionVisible;
         public ControlLayout Client;
+        public bool CarPositionChanged;
+        public int CarPositionVisible;
         public int CurrentCarPosition;
         public int LabelTop;
-        public bool LastRowVisible = false;
+        public bool LastRowVisible;
         public int LocalScrollPosition;
         public int SelectedCarPosition;
         const int SymbolSize = 16;
 
+        public int CurrentDisplaySizeY;
+        public bool IsFullScreen;
+        public int OldPositionHeight;
+        public int RowHeight;
+        public bool UpdateTrainCarOperation;
         public int WindowHeightMax;
         public int WindowHeightMin;
         public int WindowWidthMax;
         public int WindowWidthMin;
-        public int CurrentDisplaySizeY;
-        public bool IsFullScreen = false;
-        public int RowHeight;
-        public int OldPositionHeight;
-        public bool UpdateTrainCarOperation = false;
         public List<int> LabelPositionTop = new List<int>();
 
         //Rectangle carLabelPosition;
+        public ControlLayoutVertical Vbox;
         public string CarLabelText;
         public int CarPosition;
         public int CarUIDLenght;
         public int DesiredHeight;
         public static bool FontChanged;
         public static bool FontToBold;
-        public ControlLayoutVertical Vbox;
 
         //Electrical power
         public string BatteryStatus;
@@ -116,10 +117,10 @@ public class TrainCarOperationsWindow : Window
         public string PowerSupplyStatus;
         public bool PowerSupplyUpdating;
         public bool SupplyStatusChanged;
-        public bool UpdatingPowerSupply = false;
+        public bool UpdatingPowerSupply;
 
-        public bool WarningEnabled = false;
-        public bool CarIdClicked = false;
+        public bool CarIdClicked;
+        public bool WarningEnabled;
         public bool ModifiedSetting
         {
             set;
@@ -460,7 +461,7 @@ public void topCarPositionVisible()
                             break;
                         }
                     }
-                }               
+                }
             }
         }
         public void localScrollLayout(int selectedCarPosition)
@@ -502,6 +503,9 @@ public override void PrepareFrame(ElapsedTime elapsedTime, bool updateFull)
         {
             base.PrepareFrame(elapsedTime, updateFull);
 
+            if (UserInput.IsPressed(UserCommand.CameraCarNext) || UserInput.IsPressed(UserCommand.CameraCarPrevious) || UserInput.IsPressed(UserCommand.CameraCarFirst) || UserInput.IsPressed(UserCommand.CameraCarLast))
+                CarPositionChanged = true;
+
             if (updateFull)
             {
                 var trainCarViewer = Owner.Viewer.TrainCarOperationsViewerWindow;
@@ -580,14 +584,16 @@ public override void PrepareFrame(ElapsedTime elapsedTime, bool updateFull)
                     carOperations.CarOperationChanged = carOperations.Visible && carOperations.CarOperationChanged;
                 }
 
-                if (trainCarWebpage != null && CarPosition != trainCarViewer.CarPosition && trainCarWebpage.Connections > 0)
+                if (CarPositionChanged || (trainCarWebpage != null && CarPosition != trainCarViewer.CarPosition && trainCarWebpage.Connections > 0))
                 {
                     // Required to scroll the main window from the web version
                     UpdateTrainCarOperation = true;
                     CarPosition = trainCarViewer.CarPosition;
+                    SelectedCarPosition = CarPositionChanged ? CarPosition : SelectedCarPosition;
                     LabelTop = LabelPositionTop[SelectedCarPosition];
                     Layout();
                     localScrollLayout(SelectedCarPosition);
+                    CarPositionChanged = false;
                 }
                 //Resize this window after the font has been changed externally
                 else if (MultiPlayerWindow.FontChanged)