Automatic merge of T1.5.1-972-g193ebe1d0 and 14 pull requests

- Pull request #799 at dfc715e: Consolidated wind simulation
- 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 48aa537: Blueprint/train car operations UI window
- Pull request #891 at 9a1d6b2: Auto save
- 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 #900 at c27f32d: DMI updates
- Pull request #903 at c296b32: Downloading route content (Github, zip)
- Pull request #912 at df43405: New Triple Valve Features Vol. 2
- Pull request #919 at 26cc6a8: Added mouse wheel support for controls which can be moved by pressing t…
- Pull request #922 at abe2e52: Autopilot for timetable mode
- Pull request #923 at 4c27204: Add curve squeal to route
- Pull request #943 at 27fb483: Dynamic Brakes Behavior & Display Improvements

Author: openrails-bot

Source/Orts.Formats.Msts/CabViewFile.cs

@@ -1270,13 +1270,14 @@ public CVCDiscrete(STFReader stf, string basepath, DiscreteStates discreteState)
                             Positions.Add(0);
                             // We will need the FramesCount later!
                             // We use Positions only here
-                            Positions.Add(FramesCount);
+                            Positions.Add(FramesCount - 1);
 
                             // Fill empty Values
-                            for (int i = 0; i < FramesCount; i++)
+                            for (int i = 0; i < (FramesCount - 1); i++)
                                 Values.Add(0);
                             Values[0] = MinValue;
 
+                            // Add maximum value to the end
                             Values.Add(MaxValue);
                         }
                         else if (Values.Count == 2 && Values[0] == 0 && Values[1] < MaxValue && Positions[0] == 0 && Positions[1] == 1 && Values.Count < FramesCount)
@@ -1289,13 +1290,13 @@ public CVCDiscrete(STFReader stf, string basepath, DiscreteStates discreteState)
 			                //Orientation ( 0 )
 			                //DirIncrease ( 0 )
 			                //ScaleRange ( 0 1 )
-                            Positions.Add(FramesCount);
+                            Positions.Add(FramesCount - 1);
                             // Fill empty Values
-                            for (int i = Values.Count; i < FramesCount; i++)
+                            for (int i = Values.Count; i < (FramesCount - 1); i++)
                                 Values.Add(Values[1]);
+                            // Add maximum value to the end
                             Values.Add(MaxValue);                            
                         }
-
                         else
                         {
                             //This if clause covers among others following cases:
@@ -1321,11 +1322,6 @@ public CVCDiscrete(STFReader stf, string basepath, DiscreteStates discreteState)
                                 }
                                 iValues++;
                             }
-
-                            // Add the maximums to the end, the Value will be removed
-                            // We use Positions only here
-                            if (Values.Count > 0 && Values[0] <= Values[Values.Count - 1]) Values.Add(MaxValue);
-                            else if (Values.Count > 0 && Values[0] > Values[Values.Count - 1]) Values.Add(MinValue);
                         }
 
                         // OK, we have a valid size of Positions and Values
@@ -1351,9 +1347,6 @@ public CVCDiscrete(STFReader stf, string basepath, DiscreteStates discreteState)
                                 p = Positions[i];
                             }
                         }
-
-                        // Don't need the MaxValue added before, remove it
-                        Values.RemoveAt(Values.Count - 1);
                     }
                 }
 

Source/RunActivity/Viewer3D/RollingStock/MSTSLocomotiveViewer.cs

@@ -2080,6 +2080,7 @@ public class CabViewDiscreteRenderer : CabViewControlRenderer, ICabViewMouseCont
         float Scale = 1;
         int OldFrameIndex = 0;
         public bool ButtonState = false;
+        int SplitIndex = -1;
 
         /// <summary>
         /// Accumulated mouse movement. Used for controls with no assigned notch controllers, e.g. headlight and reverser.
@@ -2128,6 +2129,8 @@ public CabViewDiscreteRenderer(Viewer viewer, MSTSLocomotive locomotive, CVCWith
                     };
                     break;
             }
+            // The cab view control index shown when combined control is at the split position
+            SplitIndex = PercentToIndex(Locomotive.CombinedControlSplitPosition);
         }
 
         public override void PrepareFrame(RenderFrame frame, ElapsedTime elapsedTime)
@@ -2233,21 +2236,12 @@ public virtual int GetDrawIndex()
                                     index = PercentToIndex(dynBrakePercent);
                     break;
                 case CABViewControlTypes.CPH_DISPLAY:
-                    if (Locomotive.CombinedControlType == MSTSLocomotive.CombinedControl.ThrottleDynamic && Locomotive.DynamicBrakeController?.CurrentValue > 0)
-                        // TODO <CSComment> This is a sort of hack to allow MSTS-compliant operation of Dynamic brake indications in the standard USA case with 8 steps (e.g. Dash9)
-                        // This hack returns to code of previous OR versions (e.g. release 1.0).
-                        // The clean solution for MSTS compliance would be not to increment the percentage of the dynamic brake at first dynamic brake key pression, so that
-                        // subsequent steps become of 12.5% as in MSTS instead of 11.11% as in OR. This requires changes in the physics logic </CSComment>
-                        index = (int)((ControlDiscrete.FramesCount) * Locomotive.GetCombinedHandleValue(false));
-                    else
-                        index = PercentToIndex(Locomotive.GetCombinedHandleValue(false));
-                    break;
                 case CABViewControlTypes.CP_HANDLE:
-                    if (Locomotive.CombinedControlType == MSTSLocomotive.CombinedControl.ThrottleDynamic && Locomotive.DynamicBrakeController?.CurrentValue > 0
-                            || Locomotive.CombinedControlType == MSTSLocomotive.CombinedControl.ThrottleAir && Locomotive.TrainBrakeController?.CurrentValue > 0)
-                            index = PercentToIndex(Locomotive.GetCombinedHandleValue(false));
-                        else
-                            index = PercentToIndex(Locomotive.GetCombinedHandleValue(false));
+                    var combinedHandlePosition = Locomotive.GetCombinedHandleValue(false);
+                    index = PercentToIndex(combinedHandlePosition);
+                    // Make sure power indications are not shown when locomotive is in braking range
+                    if (combinedHandlePosition > Locomotive.CombinedControlSplitPosition)
+                        index = Math.Max(index, SplitIndex + 1);
                     break;
                 case CABViewControlTypes.ORTS_SELECTED_SPEED_DISPLAY:
                     if (Locomotive.CruiseControl == null)
@@ -2915,9 +2909,29 @@ protected int PercentToIndex(float percent)
             {
                 try
                 {
-                    var val = ControlDiscrete.Values[0] <= ControlDiscrete.Values[ControlDiscrete.Values.Count - 1] ?
-                        ControlDiscrete.Values.Where(v => (float)v <= percent + 0.00001).Last() : ControlDiscrete.Values.Where(v => (float)v <= percent + 0.00001).First();
-                    index = ControlDiscrete.Values.IndexOf(val);
+                    // Binary search process to find the control value closest to percent
+                    List<double> vals = ControlDiscrete.Values;
+                    // Check if control values were defined in reverse, reverse them back for this calculation
+                    // This is less efficient, so creators should be encouraged to not do this
+                    bool reversed = ControlDiscrete.Values[0] > ControlDiscrete.Values[ControlDiscrete.Values.Count - 1];
+                    if (reversed)
+                        vals.Reverse();
+
+                    // Returns index of first val larger than percent, or bitwise compliment of this index if percent isn't in the list
+                    int checkIndex = vals.BinarySearch(percent);
+
+                    if (checkIndex < 0)
+                        checkIndex = ~checkIndex;
+                    if (checkIndex > vals.Count - 1)
+                        checkIndex = vals.Count - 1;
+                    // Choose lower index if it is closer to percent
+                    if (checkIndex > 0 && Math.Abs(vals[checkIndex - 1] - percent) < Math.Abs(vals[checkIndex] - percent))
+                        checkIndex--;
+                    // Re-reverse the index as needed
+                    if (reversed)
+                        checkIndex = (vals.Count - 1) - checkIndex;
+
+                    index = checkIndex;
                 }
                 catch
                 {