Automatic merge of T1.5.1-689-g9d41208f0 and 18 pull requests

- Pull request #570 at c59c788: 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 #865 at 67014b7: Dispatcher window improvements
- Pull request #874 at f8dbeab: Dynamic brake controller refactoring
- Pull request #875 at 43bf33e: Bug fix for https://bugs.launchpad.net/or/+bug/2036346 Player train switching doesn't work with 3D cabs
- Pull request #876 at f92de76: docs: add source for documents previously on website to source Documentation folder
- Pull request #878 at a088cf7: Implement Polach Adhesion
- Pull request #882 at 1734b59: Blueprint/train car operations UI window
- Pull request #883 at edcc2dd: SwitchPanel disconnect/connect handling
- Pull request #885 at c81447b: feat: Add notifications to Menu
- Pull request #886 at 34e8cae: Scene viewer extension to TrackViewer
- Pull request #888 at d7daf62: docs: Document player application model
- Pull request #890 at 39a9fa4: Allow depart early
- Pull request #892 at 1f5ba4c: Signal Function OPP_SIG_ID_TRAINPATH
- Pull request #893 at bf8876b: Signal errors
- Pull request #894 at 794fddf: Correct Decrease Colour
- Pull request #896 at 5866028: First implementation of https://blueprints.launchpad.net/or/+spec/specific-sounds-for-ai-trains
- Pull request #897 at 64a29c8: feat: Improved system information collection

Author: openrails-bot

Source/Documentation/Manual/_static/readme.txt

@@ -0,0 +1 @@
+this empty directory supresses a warning during sphinx build

Source/Documentation/Manual/driving.rst

@@ -38,7 +38,7 @@ can select different views using the keyboard, as described in
 :ref:`Changing the View <driving-changing-view>`.
 
 Cab Letter-Boxing
-----------------
+-----------------
 
 OR manages not only cab interiors using 2D images in a MSTS-compatible
 way, but also supports 3D models. Most 2D cab images follow MSTS practice,
@@ -576,6 +576,97 @@ appears on the car's display line until the air pressure has fallen to zero.
 More information about manipulating the brakes during coupling and 
 uncoupling can also be found :ref:`here <driving-hud-brake>`.
 
+.. _train-operations-monitor:
+
+Ctrl-Alt-F9 Train Operations Monitor
+------------------------------------
+
+This Open Rails Train Operations window has a vertical view of the entire train:
+
+.. image:: images/TrainCarOperations-01.png
+  :align: center
+  :scale: 100%
+
+|
+
+This window shows the whole train in vertical mode. Any car can be selected by clicking on the Car ID. 
+Two arrows will then appear pointing to the selected car.
+
+By clicking on the selected CarId the "Train Operations Viewer" window will be displayed:
+
+.. image:: images/TrainOperationsViewer-02.png
+  :align: center
+  :scale: 100%
+
+|
+
+From the "Train Operations Viewer" window, we can set all the available systems, as in the “Car Operation menu”:
+
+- FrontBrakeHose
+- FrontAngleCock
+- CouplerFront
+- CouplerRear
+- RearAngleCock
+- RearBrakeHose
+- HandBrake
+- BleedOffValve
+- ToggleElectricTrainSupplyCable
+- ToggleMU
+- TogglePower
+- ToggleBatterySwitch
+
+This is where all the symbols are placed:
+
+.. image:: images/TrainOperationsViewer.png
+  :align: center
+  :scale: 100%
+
+|
+
+The red cross on the handbrake symbol (or another), indicates that it is not available.
+
+Any changes made in this window will also appear in the "Train Car Operations" window:
+
+.. image:: images/TrainOperationsViewer-03.png
+  :align: center
+  :scale: 100%
+
+|
+
+After a change in the braking system that keeps the train stopped, the CarID changes to a cyan colour. 
+In this way, it is easy for the user, to find out which car is stopping the train.
+
+A click on the right arrow hides all non-system brake symbols, inside the "Train Car Operations" window:
+
+.. image:: images/TrainCarOperations-04.png
+  :align: center
+  :scale: 100%
+
+|
+
+To make the text bold, click the left arrow:
+
+.. image:: images/TrainCarOperations-05.png
+  :align: center
+  :scale: 100%
+
+|
+
+While the "Train Operations Viewer" window is visible, we can modify the "Train Car Operations" window, 
+but if we open the "Train Operations" window <F9> and click on any CarID, the "Car Operation Menu" will 
+appear and it will point to the previously selected CarID in the "Train Operations Viewer" window.
+The "Car Operations Menu" is updated from the "Train Operations Viewer" window.
+A click on the CarID in the “Train Operations Viewer” will close the window.
+
+If the train is very long and not all the cars are displayed in the "Train Car Operations" window, we can scroll by clicking on the white down arrow (vertical scroll bar) at the bottom right.
+Once the required car has been selected, it will remain visible on the last row:
+
+.. image:: images/TrainCarOperations-06.png
+  :align: center
+  :scale: 100%
+
+|
+
 .. _driving-activity:
 
 F10 Activity Monitor
@@ -637,7 +728,7 @@ within the cabview, see :ref:`here <cabs-odometer>`.
 
 
 Activity Evaluation
-------------------
+-------------------
 
 ``Description``
 '''''''''''''''
@@ -710,8 +801,6 @@ This report is made up of several sections.
    :scale: 80%
    :align: center
 
-.. raw:: latex
-
 The report file OpenRailsEvaluation.txt is saved alongside the log file OpenRailsLog.txt and
 the default location for this is the Windows Desktop.
 

Source/Documentation/Manual/images/TrainCarOperations-01.png

@@ -154,6 +154,11 @@ If you choose to develop your own pages, please consider sharing them with the O
 
 .. image:: images/switch-panel.png
 
+- The Train Car Operations page has the same functionality as the :ref:`Ctrl-Alt-F9 Train Operations Monitor <train-operations-monitor>`.
+  Advantage of having this windows as a web page is that it can be shown outside the Open Rails main window.
+  Even on another display like for instance a tablet. It has more or less the same functionality, more details
+  to be found :ref:`here <train-operations-monitor>`.
+
 .. _web-server-api:
 
 Application Programming Interfaces (APIs)