Automatic merge of T1.5.1-1088-g264349b1ce and 20 pull requests

- Pull request #891 at 9a1d6b2: Auto save
- Pull request #959 at 2452cb0: Fix TrackViewer crash on big zoom value
- Pull request #972 at e90a2aa: On Map window color changed switch or signal is not changed
- Pull request #839 at d00beb9: First phase of https://blueprints.launchpad.net/or/+spec/additional-cruise-control-parameters
- Pull request #882 at 8f695a4: Blueprint/train car operations UI window
- Pull request #892 at 1f5ba4c: Signal Function OPP_SIG_ID_TRAINPATH
- Pull request #922 at a3bc9e7: Autopilot for timetable mode
- Pull request #953 at a519452: Fix Lights Crash on Corrupt Shapes
- Pull request #962 at 46d0472: Fix pantographs on unpowered cars
- Pull request #970 at 6fa5eed: feat: Remove unnecessary Windows.Forms usage
- Pull request #900 at c27f32d: DMI updates
- Pull request #903 at 9dabe97: Downloading route content (Github, zip)
- Pull request #799 at dfc715e: Consolidated wind simulation
- Pull request #876 at f92de76: docs: add source for documents previously on website to source Documentation folder
- Pull request #885 at a9b02ac: feat: Add notifications to Menu
- Pull request #896 at 5866028: First implementation of https://blueprints.launchpad.net/or/+spec/specific-sounds-for-ai-trains
- Pull request #946 at 91a03af: Advanced track sounds
- Pull request #952 at 8347095: Investigation - Pulsing graphics
- Pull request #954 at f837ffd: Multiple Track Profiles & Superelevation Improvements
- Pull request #968 at a88cb26: Initial build of adding track section identifier for rack railway

Author: openrails-bot

Source/Documentation/Notifications.docx

@@ -136,7 +136,6 @@ void MainForm_Shown(object sender, EventArgs e)
         {
             var options = Environment.GetCommandLineArgs().Where(a => (a.StartsWith("-") || a.StartsWith("/"))).Select(a => a.Substring(1));
             Settings = new UserSettings(options);
-            NotificationManager = new NotificationManager(this, UpdateManager, Settings);
 
             Cursor = Cursors.Default;
 
@@ -247,6 +246,13 @@ orderby tool.Text
                 }
                 else
                     buttonDocuments.Enabled = false;
+
+                NotificationManager = new NotificationManager(this, UpdateManager, Settings, panelDetails
+                    , (Image)Resources.GetObject("Notification_previous")
+                    , (Image)Resources.GetObject("Notification_next")
+                    , (Image)Resources.GetObject("Notification_first")
+                    , (Image)Resources.GetObject("Notification_last")
+                    );
             }
 
             ShowEnvironment();
@@ -1569,13 +1575,6 @@ void comboBoxTimetable_EnabledChanged(object sender, EventArgs e)
         }
 
         #region NotificationPages
-        public int CurrentNotificationNo = 0;
-        private bool firstVisible = true;
-        private bool previousVisible = false;
-        private bool lastVisible = false;
-        private bool nextVisible = true;
-
-
         private void pbNotificationsNone_Click(object sender, EventArgs e)
         {
             ToggleNotificationPages();
@@ -1606,111 +1605,51 @@ private void ToggleNotificationPages()
 
         private void FiddleNewNotificationPageCount()
         {
-            //NotificationManager.LastPageViewed = 1;
+            //NotificationManager.LastPageViewed = 1; //TODO
             UpdateNotificationPageAlert();
         }
 
-        public void UpdateNotificationPageAlert()
-        {
-            if (NotificationManager.LastPageViewed >= NotificationManager.NewPageCount)
-            {
-                pbNotificationsSome.Visible = false;
-                lblNotificationCount.Visible = false;
-            }
-        }
-
-        void ShowNotificationPages()
+        public void ShowNotificationPages()
         {
             Win32.LockWindowUpdate(Handle);
             ClearPanel();
             NotificationManager.PopulatePage();
-            var notificationPage = GetCurrentNotificationPage();
-            notificationPage.FlowNDetails();
+            UpdateNotificationPageAlert();
+            NotificationManager.Page.FlowNDetails();
             Win32.LockWindowUpdate(IntPtr.Zero);
         }
 
-        /// <summary>
-        ///  INCOMPLETE
-        /// </summary>
-        /// <returns></returns>
-        NotificationPage GetCurrentNotificationPage()
-        {
-            return NotificationManager.Page;
-        }
-
-        /// <summary>
-        /// Returns a new notificationPage with default images and label
-        /// </summary>
-        /// <returns></returns>
-        public NotificationPage CreateNotificationPage()
-        // Located in MainForm to get access to MainForm.Resources
+        public void UpdateNotificationPageAlert()
         {
-            var previousImage = (Image)Resources.GetObject("Notification_previous");
-            var nextImage = (Image)Resources.GetObject("Notification_next");
-            var firstImage = (Image)Resources.GetObject("Notification_first");
-            var lastImage = (Image)Resources.GetObject("Notification_last");
-            var pageCount = $"{CurrentNotificationNo + 1}/{NotificationManager.Notifications.NotificationList.Count}";
-            return new NotificationPage(this, panelDetails, nextImage, previousImage, firstImage, lastImage, pageCount,
-                previousVisible, firstVisible, nextVisible, lastVisible);
+            if (NotificationManager.LastPageViewed >= NotificationManager.NewPageCount)
+            {
+                pbNotificationsSome.Visible = false;
+                lblNotificationCount.Visible = false;
+            }
         }
 
         // 3 should be enough, but is there a way to get unlimited buttons?
         public void Button0_Click(object sender, EventArgs e)
         {
-            GetCurrentNotificationPage().DoButton(UpdateManager, 0);
+            NotificationManager.Page.DoButton(UpdateManager, 0);
         }
         public void Button1_Click(object sender, EventArgs e)
         {
-            GetCurrentNotificationPage().DoButton(UpdateManager, 1);
+            NotificationManager.Page.DoButton(UpdateManager, 1);
         }
         public void Button2_Click(object sender, EventArgs e)
         {
-            GetCurrentNotificationPage().DoButton(UpdateManager, 2);
+            NotificationManager.Page.DoButton(UpdateManager, 2);
         }
 
         public void Next_Click(object sender, EventArgs e)
         {
-            ChangePage(1);
-            // GetCurrentNotificationPage().DoNext(1);
+            NotificationManager.ChangePage(1);
         }
 
         public void Previous_Click(object sender, EventArgs e)
         {
-            ChangePage(-1);
-            //GetCurrentNotificationPage().DoNext(-1);
-        }
-
-        private void ChangePage(int step)
-        {
-            SetVisibility(step);
-            CurrentNotificationNo += step;
-            ShowNotificationPages();
-        }
-
-        private void SetVisibility(int step)
-        {
-            if (step < 0)
-            {
-                if (CurrentNotificationNo + step <= 0)
-                {
-                    previousVisible = false;
-                    firstVisible = true;
-                    return;
-                }
-            }
-            else
-            {
-                if (CurrentNotificationNo + step >= NotificationManager.Notifications.NotificationList.Count - 1)
-                {
-                    nextVisible = false;
-                    lastVisible = true;
-                    return;
-                }
-            }
-            nextVisible = true;
-            lastVisible = false;
-            previousVisible = true;
-            firstVisible = false;
+            NotificationManager.ChangePage(-1);
         }
 
         #endregion NotificationPages