Automatic merge of T1.5.1-925-g1c557094e and 16 pull requests

- Pull request #570 at 3539862: 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 #876 at f92de76: docs: add source for documents previously on website to source Documentation folder
- Pull request #882 at 3ca0eb1: Blueprint/train car operations UI window
- Pull request #885 at fb6b812: feat: Add notifications to Menu
- Pull request #886 at 6c0785b: Scene viewer extension to TrackViewer
- 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 #903 at 7af1f91: Downloading route content (Github, zip)
- Pull request #912 at f7b85e4: 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 #923 at cc1b5b6: Add curve squeal to route
- Pull request #924 at 6c2c3cd: Default Asset Improvements
- Pull request #925 at e3b1688: Fix brakeshoe force bug
- Pull request #927 at 7bce293: AI Train Power Supply/Lights Fix
- Pull request #929 at a406a69: Add support for common circuit breaker variants

Author: openrails-bot

Source/Menu/DownloadContentForm.Designer.cs

@@ -142,6 +142,13 @@ private void dataGridViewDownloadContent_SelectionChanged(object sender, EventAr
         }
         #endregion
 
+        #region InstallPathTextBox
+        private void InstallPathTextBox_TextChanged(object sender, EventArgs e)
+        {
+            Settings.Content.InstallPath = InstallPathTextBox.Text;
+        }
+        #endregion
+
         #region InstallPathBrowseButton
         private void InstallPathBrowseButton_Click(object sender, EventArgs e)
         {
@@ -175,6 +182,14 @@ private async void DownloadContentButton_Click(object sender, EventArgs e)
 
             DisableButtons();
 
+            message = Catalog.GetStringFmt("Route to be installed in \"{0}\", are you sure?", installPathRoute);
+            if (MessageBox.Show(message, Catalog.GetString("Attention"), MessageBoxButtons.YesNo, MessageBoxIcon.Warning) != DialogResult.Yes)
+            {
+                // cancelled
+                EnableButtons();
+                return;
+            }
+
             // various checks for the directory where the route is installed
 
             string pathDirectoryExe = System.IO.Path.GetDirectoryName(System.Reflection.Assembly.GetExecutingAssembly().GetName().CodeBase);
@@ -191,39 +206,33 @@ private async void DownloadContentButton_Click(object sender, EventArgs e)
                 return;
             }
 
-            DriveInfo dInfo = new DriveInfo(installPathRoute);
-
-            long size = route.InstallSize + route.DownloadSize;
-
-            if (size > (dInfo.AvailableFreeSpace * 1.1))
+            try
             {
-                message = Catalog.GetStringFmt("Not enough diskspace on drive {0} ({1}), available {2} kB, needed {3} kB, still continue?",
-                    dInfo.Name,
-                    dInfo.VolumeLabel,
-                    (dInfo.AvailableFreeSpace / 1024).ToString("N0"),
-                    (size / 1024).ToString("N0"));
+                DriveInfo dInfo = new DriveInfo(installPathRoute);
 
-                if (MessageBox.Show(message, Catalog.GetString("Attention"), MessageBoxButtons.OKCancel, MessageBoxIcon.Warning) != DialogResult.OK)
-                {
-                    // cancelled
-                    EnableButtons();
-                    return;
-                }
-            }
+                long size = route.InstallSize + route.DownloadSize;
 
-            message = Catalog.GetStringFmt("Route to be installed in \"{0}\", are you sure?", installPathRoute);
+                if (size > (dInfo.AvailableFreeSpace * 1.1))
+                {
+                    message = Catalog.GetStringFmt("Not enough diskspace on drive {0} ({1}), available {2} kB, needed {3} kB, still continue?",
+                        dInfo.Name,
+                        dInfo.VolumeLabel,
+                        (dInfo.AvailableFreeSpace / 1024).ToString("N0"),
+                        (size / 1024).ToString("N0"));
 
-            if (MessageBox.Show(message, Catalog.GetString("Attention"), MessageBoxButtons.OKCancel, MessageBoxIcon.Warning) != DialogResult.OK)
-            {
-                // cancelled
-                EnableButtons();
-                return;
+                    if (MessageBox.Show(message, Catalog.GetString("Attention"), MessageBoxButtons.YesNo, MessageBoxIcon.Warning) != DialogResult.Yes)
+                    {
+                        // cancelled
+                        EnableButtons();
+                        return;
+                    }
+                }
             }
-
-            if (!Directory.Exists(installPath))
+            catch (System.IO.DriveNotFoundException)
             {
-                message = Catalog.GetStringFmt("Directory \"{0}\" does not exist", installPath);
+                message = Catalog.GetStringFmt("Drive not available");
                 MessageBox.Show(message, Catalog.GetString("Attention"), MessageBoxButtons.OK, MessageBoxIcon.Error);
+                // cancelled
                 EnableButtons();
                 return;
             }
@@ -255,8 +264,6 @@ private async void DownloadContentButton_Click(object sender, EventArgs e)
                 }
             }
 
-            Settings.Content.InstallPath = installPath;
-
             // the download
 
             dataGridViewDownloadContent.CurrentRow.Cells[1].Value = Catalog.GetString("Installing...");
@@ -922,7 +929,7 @@ private async void DeleteButton_Click(object sender, EventArgs e)
             DisableButtons();
 
             message = Catalog.GetStringFmt("Directory \"{0}\" is to be deleted, are you really sure?", route.DirectoryInstalledIn);
-            if (MessageBox.Show(message, Catalog.GetString("Attention"), MessageBoxButtons.OKCancel, MessageBoxIcon.Warning, MessageBoxDefaultButton.Button2) != DialogResult.OK)
+            if (MessageBox.Show(message, Catalog.GetString("Attention"), MessageBoxButtons.YesNo, MessageBoxIcon.Warning, MessageBoxDefaultButton.Button2) != DialogResult.Yes)
             {
                 // cancelled
                 EnableButtons();
@@ -935,7 +942,7 @@ private async void DeleteButton_Click(object sender, EventArgs e)
                 {
                     writeAndStartInfoFile();
                     message = Catalog.GetStringFmt("Changed or added local files found in Directory \"{0}\", see Info at the bottom for more information. Do you want to continue?", route.DirectoryInstalledIn);
-                    if (MessageBox.Show(message, Catalog.GetString("Attention"), MessageBoxButtons.OKCancel, MessageBoxIcon.Warning, MessageBoxDefaultButton.Button2) != DialogResult.OK)
+                    if (MessageBox.Show(message, Catalog.GetString("Attention"), MessageBoxButtons.YesNo, MessageBoxIcon.Warning, MessageBoxDefaultButton.Button2) != DialogResult.Yes)
                     {
                         // cancelled
                         EnableButtons();
@@ -1006,7 +1013,7 @@ private void updateButton_Click(object sender, EventArgs e)
             {
                 writeAndStartInfoFile();
                 message = Catalog.GetString("Remote updates found, see Info at the bottom for more information. Do you want to continue?");
-                if (MessageBox.Show(message, Catalog.GetString("Attention"), MessageBoxButtons.OKCancel, MessageBoxIcon.Warning, MessageBoxDefaultButton.Button2) != DialogResult.OK)
+                if (MessageBox.Show(message, Catalog.GetString("Attention"), MessageBoxButtons.YesNo, MessageBoxIcon.Warning, MessageBoxDefaultButton.Button2) != DialogResult.Yes)
                 {
                     // cancelled
                     EnableButtons();
@@ -1015,7 +1022,7 @@ private void updateButton_Click(object sender, EventArgs e)
                 if (areThereChangedAddedFiles(route))
                 {
                     message = Catalog.GetString("Changed or added local files found, Update might fail, see Info at the bottom for more information. Do you want to continue?");
-                    if (MessageBox.Show(message, Catalog.GetString("Attention"), MessageBoxButtons.OKCancel, MessageBoxIcon.Warning, MessageBoxDefaultButton.Button2) != DialogResult.OK)
+                    if (MessageBox.Show(message, Catalog.GetString("Attention"), MessageBoxButtons.YesNo, MessageBoxIcon.Warning, MessageBoxDefaultButton.Button2) != DialogResult.Yes)
                     {
                         // cancelled
                         EnableButtons();

Source/Menu/DownloadContentForm.cs

@@ -27,7 +27,7 @@ public class ContentSettings : SettingsBase
     {
         #region User Settings
 
-        [Default("C:\\OpenRailsRoutes")]
+        [Default("")]
         public string InstallPath { get; set; }
 
         #endregion
@@ -36,6 +36,10 @@ public ContentSettings(IEnumerable<string> options)
         : base(SettingsStore.GetSettingStore(UserSettings.SettingsFilePath, UserSettings.RegistryKey, "Content"))
         {
             Load(options);
+            if (string.IsNullOrEmpty(InstallPath))
+            {
+                InstallPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments) , "Open Rails", "Content");
+            }
         }
 
         public override object GetDefaultValue(string name)