Automatic merge of T1.6-89-ga2a9bbcc8 and 13 pull requests

- Pull request #1156 at f46d5f2: Fix incorrectly disabled options in train operations window
- Pull request #1086 at d8d61eb: Add Settings Exporter tool (copy settings to INI, etc)
- Pull request #1091 at e813c42: Automatic speed control
- Pull request #1115 at 270f22f: Do not activate ETS switch if no suitable cars are attached
- Pull request #1120 at ba3c47f: Automatically Calculate Friction Values if Missing
- Pull request #1121 at 91d2d26: Manually Override Articulation
- Pull request #1124 at e241a0d: Built-in PBL2 brake controller
- Pull request #1157 at 39cd994: Dynamic brake authorization by TCS
- Pull request #1159 at 48c9a63: Skip OR warnings about TSRE-specific token Ruler
- Pull request #1161 at 6cfe4e2: Fix string trim in .ini files
- Pull request #1082 at 5845a1a: Allow variable water level in glass gauge
- Pull request #1128 at 1d7643d: Particle Emitter Overhaul
- Pull request #1160 at 3390e80: Route Based TTrack Sounds

Author: openrails-bot

Source/Documentation/Manual/sound.rst

@@ -446,6 +446,62 @@ Trigger       Function
 =========     =====================================
 
 
+Track Based Sounds for Routes
+-----------------------------
+
+As track based sounds (such as track joints, curve squeal, etc) are common to all rolling stock these types of sounds can be added at a route level, rather then 
+at an individual rolling stock level. This has the advantage of ensuring a level of consistency for all individual stock rather then requiring each piece of stock 
+to have appropriate sounds associated with it. It means that all rolling stock will be "automaticvally" have track sounds given to it.
+
+This approach relies on use of the Track Region sounds configured in the TType.dat file. A base SMS file is created for the first track region sound which is played 
+continuously and contains all track related sounds that need to be played despite the region that the train is in. Further track region SMS files can be created for 
+different track type regions, such as different bridge types (such as wood, concrete or steel).
+
+To enable this approach the following parameters need to be set accordingly in the route TRK file.
+
+``ORTSPlayTrackSoundsBaseContinuous`` - this causes the first SMS file in the TType file to be played continuously. Set to 1 for continuous play or 0 for legacy operation.
+
+``ORTSDistanceBetweenTrackJoints`` - this defines the distance between the track joints, and the value is any valid distance.
+
+``ORTSConcreteSleepers`` - Allows sounds to be adjusted according to whether track is wood or concrete supported. Set to 1 if concrete sleepers are used throughout the route.
+
+The following control parameters can be used in the relevant track region SMS files to vary a frequency or volume curve for the sound being played:
+
+``AngleofAttackControlled`` - Varies as the Angle of Attack of a car on a curve varies.
+
+``CarFrictionControlled`` - Varies as friction of car changes, typically between 0 and 1.
+
+``WheelRPMControlled`` - Varies as RPM of wheel changes.
+
+``CarDistanceTrackControlled`` - Distance that the car is from the camera in metres.
+
+``CarTunnelDistanceControlled`` - Varies based upon the distance as a car travels into and out of a tunnel. Typically this value is between 0 and 25 metres.
+
+The following control parameters can be used to trigger, enable or disable different WAV sound files within a SMS file:
+
+``Joint_2Axle_Trigger``, ``Joint_3Axle_Trigger``, ``Joint_4Axle_Trigger``, ``Joint_6Axle_Trigger``, ``Joint_8Axle_Trigger`` - these triggers are operated when the car passes 
+over a joint, and can be varied in accordance with the number of axles defined in the WAG file.
+
+``Switch_2Axle_Trigger``, ``Switch_3Axle_Trigger``, ``Switch_4Axle_Trigger``, ``Switch_6Axle_Trigger``, ``Switch_8Axle_Trigger`` - these triggers are operated when the car 
+passes over a switch, and can be varied in accordance with the number of axles defined in the WAG file.
+
+``Xover_2Axle_Trigger``, ``Xover_3Axle_Trigger``, ``Xover_4Axle_Trigger``, ``Xover_6Axle_Trigger``, ``Xover_8Axle_Trigger`` - these triggers are operated when the car passes 
+over a Cross over, and can be varied in accordance with the number of axles defined in the WAG file. Note that the cross over needs to have been defined within the route editor.
+
+``AngleofAttack_inc_past``, ``Angleofattack_dec_past`` - Varies as the Angle of Attack of a car on a curve varies.
+
+``WheelRPM_inc_past``, ``WheelRPM_dec_past`` - Varies as RPM of wheel changes.
+
+``ConcreteSleepers_inc_past``, ``ConcreteSleepers_dec_past`` - 0 = wood sleepers, 1 = concrete sleepers
+
+``CarInTunnel_inc_past``, ``CarInTunnel_dec_past`` - 0 = car not in tunnel, 1 = car in tunnel.
+
+``CarCameraDistance_inc_past``, ``CarCameraDistance_dec_past`` - Distance that the car is from the camera, in metres.
+
+Note: If rolling stock already has track sounds set up in tyhe wagon SMS file, then these will be played at the same time as the route based sounds. For best sound outcomes, 
+the number of axles for each wagon should be correctly set in the WAG file.
+
+
 Variable Triggers
 -----------------