added ini file support

Author: mkalkbrenner

README.md

@@ -36,6 +36,10 @@ These components are still in an early development stage and the documentation w
 * -c path
     * path to config file
     * required
+* --ini-file path
+    * path to a ppuc runtime ini file
+    * optional
+    * values from dedicated command line options override values from the ini file at runtime
 * -r rom name
     * rom to use, overwrites *rom* setting in config file
     * optional
@@ -78,6 +82,8 @@ These components are still in an early development stage and the documentation w
 * -h
     * help
 
+An example runtime ini file is available at `examples/ppuc-pinmame.ini`.
+
 ### PUP Trigger Rules
 
 Use `--pup-triggers <file>` to map switch/lamp/coil conditions to calls of `SetPUPTrigger(source, id, value)`.

examples/ppuc-pinmame.ini

@@ -0,0 +1,166 @@
+# Example runtime configuration for ppuc-pinmame.
+#
+# Precedence:
+# 1. Built-in defaults
+# 2. Values from this ini file via --ini-file
+# 3. Dedicated command line options, which override ini values at runtime
+
+[Paths]
+# Required unless passed with -c/--config.
+ConfigFile = examples/t2.yml
+
+# Optional ROM name or path. Overrides the ROM from the game YAML.
+Rom =
+
+# Optional serial device path. Overrides the serial device from the game YAML.
+Serial =
+
+# Optional PinMAME base folder. Defaults to the per-user pinmame folder.
+# Linux/macOS example: /home/pi/.pinmame/
+# Windows example: D:\PinMAME\
+PinmamePath =
+
+# Optional PUP trigger rules file.
+PUPTriggers =
+
+# Optional speech trigger text file.
+SpeechFile =
+
+# Optional translite image for in-game mode.
+Translite =
+
+# Optional translite image for attract mode.
+TransliteAttract =
+
+[Backbox]
+# Optional DMD/backbox host address.
+Address =
+
+# Optional DMD/backbox TCP port.
+Port = 6789
+
+[Runtime]
+# Skip serial communication to the boards entirely.
+NoSerial = false
+
+# Disable game audio output.
+NoSound = false
+
+# Enable full debug output.
+Debug = false
+
+# Enable communication/protocol error details without full debug.
+DebugErrors = false
+
+# Enable switch debug output.
+DebugSwitches = false
+
+# Enable coil debug output.
+DebugCoils = false
+
+# Enable lamp debug output.
+DebugLamps = false
+
+# Enable Serum colorization.
+Serum = false
+
+# Serum timeout in milliseconds to ignore unknown frames.
+SerumTimeout = 0
+
+# Serum number of unknown frames to skip.
+SerumSkipFrames = 0
+
+# Enable PUP video capture/matching.
+PUP = false
+
+# Render the DMD in the terminal.
+ConsoleDisplay = false
+
+# Write DMD txt dump files.
+DumpDisplay = false
+
+# CSV list of configured boards to skip, for example: 2,4,7
+SkipBoards =
+
+# Experimental per-board switch reply delay in microseconds.
+SwitchReplyDelayUs = 0
+
+# Force the configured coin-door-closed switch closed when virtualized.
+CloseCoinDoor = false
+
+# Use hard reset instead of soft restart on board startup.
+HardReset = false
+
+[Speech]
+# Enable speech callouts.
+Enabled = false
+
+# Speak a startup greeting.
+Greeting = false
+
+# Speech backend: auto, flite, espeak-ng
+Backend = auto
+
+# Optional speech voice name.
+Voice =
+
+# Optional speech rate in words per minute, mainly for espeak-ng.
+Rate =
+
+# Optional speech pitch 0-100, mainly for espeak-ng.
+Pitch =
+
+[BenchTest]
+# Enable one of the bench test modes below.
+SwitchTest = false
+CoilTest = false
+LampTest = false
+GITest = false
+FlasherTest = false
+
+# Interactive selection mode for coil/lamp/flasher tests.
+Interactive = false
+
+# Optional specific coil/lamp/GI/flasher number for bench tests.
+Number = 0
+
+[Translite]
+# Show the translite in a window instead of fullscreen.
+Window = false
+
+# Translite window width.
+Width = 1920
+
+# Translite window height.
+Height = 1080
+
+# Target screen index, or -1 for default placement.
+Screen = -1
+
+[VirtualDMD]
+# Enable the SDL virtual DMD window.
+Enabled = false
+
+# Use HD virtual DMD size (256x64 logical output instead of 128x32).
+HD = false
+
+# Show the virtual DMD in a window instead of fullscreen.
+Window = false
+
+# Virtual DMD window width.
+Width = 1280
+
+# Virtual DMD window height.
+Height = 320
+
+# Target screen index, or -1 for default placement.
+Screen = -1
+
+# X position relative to the selected screen.
+X = 0
+
+# Y position relative to the selected screen.
+Y = 0
+
+# Virtual DMD renderer: dots, smooth, xbrz
+Renderer = dots