Automatic merge of T1.5.1-1288-g58b2418aa6 and 16 pull requests

- Pull request #980 at 86bcd3a: Downloading route content (Github, zip) second part 
- Pull request #839 at d00beb9: First phase of https://blueprints.launchpad.net/or/+spec/additional-cruise-control-parameters
- Pull request #891 at 9a1d6b2: Auto save
- Pull request #892 at 1f5ba4c: Signal Function OPP_SIG_ID_TRAINPATH
- Pull request #952 at 8347095: Investigation - Pulsing graphics
- Pull request #953 at a519452: Fix Lights Crash on Corrupt Shapes
- Pull request #954 at e4ba0d7: Multiple Track Profiles & Superelevation Rewrite
- Pull request #972 at e90a2aa: On Map window color changed switch or signal is not changed
- Pull request #981 at 10d297f: Multiple type trainset lightglows
- Pull request #982 at efcf19c: WEB based Switch Panel enhancement: Alerter
- Pull request #984 at 0f8122e: Player train switching for timetable mode
- Pull request #986 at 5d7e692: Fix: The TrainCarOperations window does not resize correctly.
- Pull request #987 at 232e8fb: fix: Temporary workaround for building with NET 5+
- Pull request #900 at c27f32d: DMI updates
- Pull request #876 at f92de76: docs: add source for documents previously on website to source Documentation folder
- Pull request #988 at a0ebdf9: Conditional sound, blueprint https://blueprints.launchpad.net/or/+spec/conditional-sound

Author: openrails-bot

Source/Orts.Formats.Msts/SoundManagmentFile.cs

@@ -176,6 +176,12 @@ public class SMSStream
         public float Volume = 1.0f;
         public List<VolumeCurve> VolumeCurves = new List<VolumeCurve>();
         public FrequencyCurve FrequencyCurve;
+        public bool[] Season;
+        public bool[] Weather;
+        public int[] TimeInterval;
+        public List<int[]> TimeIntervals;
+
+
 
         public SMSStream(STFReader stf)
         {
@@ -186,6 +192,42 @@ public SMSStream(STFReader stf)
                 new STFReader.TokenProcessor("volumecurve", ()=>{ VolumeCurves.Add(new VolumeCurve(stf)); }),
                 new STFReader.TokenProcessor("frequencycurve", ()=>{ FrequencyCurve = new FrequencyCurve(stf); }),
                 new STFReader.TokenProcessor("volume", ()=>{ Volume = stf.ReadFloatBlock(STFReader.UNITS.None, Volume); }),
+                new STFReader.TokenProcessor("ortstimeofday", ()=>{
+                    if (TimeIntervals == null)
+                        TimeIntervals = new List<int[]>();
+                    var timeInterval = new int[2];
+                    stf.MustMatch("(");
+                    timeInterval[0] = stf.ReadInt(null);
+                    timeInterval[1] = stf.ReadInt(null);
+                    TimeIntervals.Add(timeInterval);
+                    stf.SkipRestOfBlock();
+                }),
+                new STFReader.TokenProcessor("ortsseason", ()=>{ 
+                    Season = new bool[4];
+                    stf.MustMatch("(");
+                    stf.ParseBlock(new STFReader.TokenProcessor[] {
+                        new STFReader.TokenProcessor("spring", ()=>{ if(stf.ReadBoolBlock(true))
+                                Season[(int)SeasonType.Spring] = true; }),
+                        new STFReader.TokenProcessor("summer", ()=>{ if(stf.ReadBoolBlock(true))
+                                Season[(int)SeasonType.Summer] = true; }),
+                        new STFReader.TokenProcessor("autumn", ()=>{ if(stf.ReadBoolBlock(true))
+                                Season[(int)SeasonType.Autumn] = true; }),
+                        new STFReader.TokenProcessor("winter", ()=>{ if(stf.ReadBoolBlock(true))
+                                Season[(int)SeasonType.Winter] = true; }),
+                    });
+                }),
+                new STFReader.TokenProcessor("ortsweather", ()=>{
+                    Weather = new bool[3];
+                    stf.MustMatch("(");
+                    stf.ParseBlock(new STFReader.TokenProcessor[] {
+                        new STFReader.TokenProcessor("clear", ()=>{ if(stf.ReadBoolBlock(true))
+                                Weather[(int)WeatherType.Clear] = true; }),
+                        new STFReader.TokenProcessor("snow", ()=>{ if(stf.ReadBoolBlock(true))
+                                Weather[(int)WeatherType.Snow] = true; }),
+                        new STFReader.TokenProcessor("rain", ()=>{ if(stf.ReadBoolBlock(true))
+                                Weather[(int)WeatherType.Rain] = true; }),
+                    });
+                }),
             });
             //if (Volume > 1)  Volume /= 100f;
         }

Source/RunActivity/Viewer3D/Sound.cs

@@ -1444,6 +1444,32 @@ private void SetFreqAndVolume()
                     volume *= ((MSTSWagon)SoundSource.Viewer.Camera.AttachedCar).TrackSoundPassThruPercent * 0.01f;
             }
 
+            // check if time of day, season and weather enable the sound; if not, set volume to zero
+            if (MSTSStream?.TimeIntervals != null)
+            {
+                var outOfInterval = true;
+                foreach (var timeInterval in MSTSStream.TimeIntervals)
+                {
+                    int hourOfDay = (int)SoundSource.Viewer.Simulator.ClockTime / 3600;
+                    if (hourOfDay >= timeInterval[0] && hourOfDay < timeInterval[1])
+                    {
+                        outOfInterval = false;
+                        break;
+                    }
+                }
+                if (outOfInterval)
+                    volume = 0;
+            }
+            if (MSTSStream?.Season != null )
+            {
+                if (!MSTSStream.Season[(int)(SoundSource.Viewer.Simulator.Season)])
+                    volume = 0;
+            }
+            if (MSTSStream?.Weather != null )
+            {
+                if (!MSTSStream.Weather[(int)(SoundSource.Viewer.Simulator.WeatherType)])
+                    volume = 0;
+            }
             ALSoundSource.Volume = volume;
         }