Command line support (#28)

* Introduce command-line argument parsing with `System.CommandLine`

* More command line options

* Refactor initialization

* Add support for custom ROM file handling and enhance command-line options.

* Add AY stereo mode command-line options.

* Extend command-line options to support Time Machine and Resume.

* Update README

Author: voytas

README.md

@@ -72,6 +72,42 @@ dotnet build -c Release
 dotnet run --project ./src/Spectron   
 ```
 
+### Command line options
+Command lines allow overriding most of the default options and loading specified file.
+```
+Options:
+  -?, -h, --help                                                                      Show help and usage information
+  --version                                                                           Show version information
+  -f, --file                                                                          Specifies the file to load. This can be any supported file type: TAP | TZX | Z80 | SNA | 
+                                                                                      SZX | POK | ZIP
+  -ts, --tape-load-speed <Accelerated|Instant|Normal>                                 Specifies the tape loading speed
+  -c, --computer <Spectrum128K|Spectrum16K|Spectrum48K>                               Specifies the computer to emulate
+  -r, --rom <BrendanAlford|BusySoft|Custom|GoshWonderful|Harston|Original|Retroleum>  Specifies the ROM to load
+  -rf, --rom-file                                                                     Specifies the custom ROM file
+  -j, --joystick <Cursor|Fuller|Kempston|None|Sinclair1|Sinclair2>                    Specifies the emulated joystick type
+  -m, --mouse <Kempston|None>                                                         Specifies the emulated mouse type
+  -t, --theme <Dark|Light>                                                            Specifies the application theme
+  -b, --border <Full|Large|Medium|None|Small>                                         Specifies the border size
+  -m, --mute                                                                          Mutes the audio playback [default: False]
+  --ay                                                                                Enables AY sound emulation
+  --no-ay                                                                             Disables AY sound emulation
+  --ay-mode <Mono|StereoABC|StereoACB>                                                Specifies AY mono or stereo mode
+  --zx-printer                                                                        Enables ZX Printer emulation
+  --no-zx-printer                                                                     Disables ZX Printer emulation
+  --ula-plus                                                                          Enables ULA+ emulation
+  --no-ula-plus                                                                       Disables ULA+ emulation
+  --divmmc                                                                            Enables divMMC emulation, --divmmc-image is required
+  --no-divmmc                                                                         Disables divMMC emulation
+  --divmmc-image                                                                      Specifies the SD card image to use with divMMC
+  --divmmc-readonly                                                                   Specifies the SD card image is readonly, SD card writes will be cached in-memory only
+  --divmmc-writable                                                                   Specifies the SD card image is writable, SD card writes will persisted
+  --time-machine                                                                      Enables Time Machine
+  --no-time-machine                                                                   Disables Time Machine
+  --resume                                                                            Resume emulator state assuming there is a previously saved state
+  --no-resume                                                                         Do not resume emulator state
+
+```
+
 ## Testing and compatibility
 - [x] Passes floatspy v0.33 (RAMSOFT) floating bus test in both 48k and 128k mode
 - [x] Passes HALT2INT v3 (Mark Woodmass) test in both 48k and 128k mode

Spectron.sln.DotSettings

@@ -1,5 +1,7 @@
 <wpf:ResourceDictionary xml:space="preserve" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:s="clr-namespace:System;assembly=mscorlib" xmlns:ss="urn:shemas-jetbrains-com:settings-storage-xaml" xmlns:wpf="http://schemas.microsoft.com/winfx/2006/xaml/presentation">
 	<s:Boolean x:Key="/Default/CodeEditing/SuppressNullableWarningFix/Enabled/@EntryValue">False</s:Boolean>
+	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=ABC/@EntryIndexedValue">ABC</s:String>
+	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=ACB/@EntryIndexedValue">ACB</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=AF/@EntryIndexedValue">AF</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=AY/@EntryIndexedValue">AY</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=BC/@EntryIndexedValue">BC</s:String>

src/Spectron.Emulation/Devices/Audio/AudioManager.cs

@@ -150,11 +150,11 @@ internal AudioBuffer EndFrame()
                         sample = MonoMix(sample, Ay.ChannelA.Samples[i], Ay.ChannelB.Samples[i], Ay.ChannelC.Samples[i]);
                         break;
 
-                    case StereoMode.StereoAbc:
+                    case StereoMode.StereoABC:
                         (sampleL, sampleR) = StereoMix(sample, Ay.ChannelA.Samples[i], Ay.ChannelB.Samples[i], Ay.ChannelC.Samples[i]);
                         break;
 
-                    case StereoMode.StereoAcb:
+                    case StereoMode.StereoACB:
                         (sampleL, sampleR) = StereoMix(sample, Ay.ChannelA.Samples[i], Ay.ChannelC.Samples[i], Ay.ChannelB.Samples[i]);
                         break;
                 }

src/Spectron.Emulation/Devices/Audio/StereoMode.cs

@@ -4,7 +4,7 @@ public enum StereoMode
 {
     Mono,
 
-    StereoAbc,
+    StereoABC,
 
-    StereoAcb,
+    StereoACB,
 }

src/Spectron.Emulation/Extensions/ArrayExtensions.cs

@@ -2,11 +2,11 @@
 
 namespace OldBit.Spectron.Emulation.Extensions;
 
-internal static class ArrayExtensions
+public static class ArrayExtensions
 {
     [return: NotNullIfNotNull(nameof(first))]
     [return: NotNullIfNotNull(nameof(second))]
-    internal static T[]? Concatenate<T>(this T[]? first, T[]? second)
+    public static T[]? Concatenate<T>(this T[]? first, T[]? second)
     {
         if (first is null)
         {

src/Spectron/CommandLine/CommandLineArgs.cs

@@ -0,0 +1,31 @@
+using OldBit.Spectron.Emulation;
+using OldBit.Spectron.Emulation.Devices.Audio;
+using OldBit.Spectron.Emulation.Devices.Joystick;
+using OldBit.Spectron.Emulation.Devices.Mouse;
+using OldBit.Spectron.Emulation.Rom;
+using OldBit.Spectron.Emulation.Tape;
+using OldBit.Spectron.Screen;
+using OldBit.Spectron.Theming;
+
+namespace OldBit.Spectron.CommandLine;
+
+public record CommandLineArgs(
+    string? FilePath,
+    TapeSpeed? TapeLoadSpeed,
+    ComputerType? ComputerType,
+    RomType? RomType,
+    string[]? CustomRomFiles,
+    JoystickType? JoystickType,
+    MouseType? MouseType,
+    bool IsAudioMuted,
+    bool? IsAyEnabled,
+    StereoMode? AyStereoMode,
+    bool? IsDivMmcEnabled,
+    string? DivMmcImageFile,
+    bool? IsDivMmcReadOnly,
+    bool? IsZxPrinterEnabled,
+    bool? IsUlaPlusEnabled,
+    bool? IsTimeMachineEnabled,
+    bool? IsResumeEnabled,
+    BorderSize? BorderSize,
+    Theme? Theme);