Add setting for UTF-8-BOM

This setting allows to enable/disable writing the byte-order mark (BOM)
in case of UTF-8 encoded CUE sheets.

- Add setting:
  `WriteUTF8BOM`
  Default:
  `WriteUTF8BOM=1`
  The setting is enabled by default, to preserve previous behavior.
- For now, the setting can be modified by editing `settings.txt` after
  closing CUETools or CUERipper:
  Use bool value 0, to disable writing the BOM to UTF-8 encoded CUE
  sheets.
- The setting is available in the CUETools as well as the CUERipper
  `settings.txt` file.

CUETools.Processor/CUEConfig.cs

@@ -40,6 +40,7 @@ public class CUEConfig
         public bool embedLog;
         public bool extractLog;
         public bool alwaysWriteUTF8CUEFile;
+        public bool writeUTF8BOM;
         public bool fillUpCUE;
         public bool overwriteCUEData;
         public bool filenamesANSISafe;
@@ -110,6 +111,7 @@ public CUEConfig()
             embedLog = true;
             extractLog = true;
             alwaysWriteUTF8CUEFile = false;
+            writeUTF8BOM = true;
             fillUpCUE = true;
             overwriteCUEData = false;
             filenamesANSISafe = true;
@@ -197,6 +199,7 @@ public CUEConfig(CUEConfig src)
             embedLog = src.embedLog;
             extractLog = src.extractLog;
             alwaysWriteUTF8CUEFile = src.alwaysWriteUTF8CUEFile;
+            writeUTF8BOM = src.writeUTF8BOM;
             fillUpCUE = src.fillUpCUE;
             overwriteCUEData = src.overwriteCUEData;
             filenamesANSISafe = src.filenamesANSISafe;
@@ -285,6 +288,7 @@ public void Save(SettingsWriter sw)
             sw.Save("EmbedLog", embedLog);
             sw.Save("ExtractLog", extractLog);
             sw.Save("AlwaysWriteUTF8CUEFile", alwaysWriteUTF8CUEFile);
+            sw.Save("WriteUTF8BOM", writeUTF8BOM);
             sw.Save("FillUpCUE", fillUpCUE);
             sw.Save("OverwriteCUEData", overwriteCUEData);
             sw.Save("FilenamesANSISafe", filenamesANSISafe);
@@ -391,6 +395,7 @@ public void Load(SettingsReader sr)
             embedLog = sr.LoadBoolean("EmbedLog") ?? true;
             extractLog = sr.LoadBoolean("ExtractLog") ?? true;
             alwaysWriteUTF8CUEFile = sr.LoadBoolean("AlwaysWriteUTF8CUEFile") ?? false;
+            writeUTF8BOM = sr.LoadBoolean("WriteUTF8BOM") ?? true;
             fillUpCUE = sr.LoadBoolean("FillUpCUE") ?? true;
             overwriteCUEData = sr.LoadBoolean("OverwriteCUEData") ?? false;
             filenamesANSISafe = sr.LoadBoolean("FilenamesANSISafe") ?? true;

CUETools.Processor/CUESheet.cs

@@ -2387,7 +2387,7 @@ private int GetSampleLength(string path, out TagLib.File fileInfo)
         public static void WriteText(CUEConfig _config, string path, string text)
         {
             bool utf8Required = (_config.alwaysWriteUTF8CUEFile && Path.GetExtension(path) == ".cue") || (CUESheet.Encoding.GetString(CUESheet.Encoding.GetBytes(text)) != text);
-            var encoding = utf8Required ? Encoding.UTF8 : CUESheet.Encoding;
+            var encoding = utf8Required ? new UTF8Encoding(_config.writeUTF8BOM) : CUESheet.Encoding;
             // Preserve original UTF-16LE encoding of EAC log files, which contain a log checksum
             if ((text.StartsWith("Exact Audio Copy") || text.StartsWith("EAC extraction logfile")) && text.Contains("==== Log checksum"))
                 encoding = Encoding.Unicode;

CUETools/frmCUETools.cs

@@ -784,7 +784,7 @@ private void WriteAudioFilesThread(object o)
                         if (File.Exists(fullCueName))
                             throw new Exception("file already exists");
                         bool utf8Required = _profile._config.alwaysWriteUTF8CUEFile || (CUESheet.Encoding.GetString(CUESheet.Encoding.GetBytes(cueSheetContents)) != cueSheetContents);
-                        StreamWriter sw1 = new StreamWriter(fullCueName, false, utf8Required ? Encoding.UTF8 : CUESheet.Encoding);
+                        StreamWriter sw1 = new StreamWriter(fullCueName, false, utf8Required ? new UTF8Encoding(_profile._config.writeUTF8BOM) : CUESheet.Encoding);
                         sw1.Write(cueSheetContents);
                         sw1.Close();
                         BatchLog("created ok.", fullCueName);