Launcher: frame rate and frame rate counter in Settings

Settings > Graphics > Frame rate: 30, 60, 120 (the game's own, default)
or 240 frames a second, passed as NFSU2_FPS, and a switch for the
on-screen counter (NFSU2_FPSCOUNTER, off by default).  Restore Original
Game puts them back to 120 and off.

Author: TalhaMudo

launcher/Game.swift

@@ -71,13 +71,17 @@ enum Prefs {
     static let engine = "LauncherEngine"           // "original" | "hd"
     static let showAtStartup = "LauncherShowAtStartup"
     static let wideHUD = "LauncherWideHUD"         // HUDPOS=1 for the engine
+    static let frameRate = "LauncherFrameRate"      // 30 | 60 | 120 | 240 -> NFSU2_FPS
+    static let fpsCounter = "LauncherFPSCounter"    // -> NFSU2_FPSCOUNTER
 
     /// Each game option with its value in the original, unmodified game: Settings ›
     /// Restore Original Game sets them all.  A new option adds its line here.  (The
     /// game folder, full screen and showAtStartup are not game options.)
     static let originalGame: [OriginalValue] = [
         OriginalValue(\.engine, .original),
         OriginalValue(\.wideHUD, false),
+        OriginalValue(\.frameRate, 120),
+        OriginalValue(\.fpsCounter, false),
     ]
 }
 

launcher/Model.swift

@@ -21,6 +21,10 @@ final class LauncherModel: ObservableObject {
     @Published var showAtStartup: Bool { didSet { defaults.set(showAtStartup, forKey: Prefs.showAtStartup) } }
     @Published var wideHUD: Bool { didSet { defaults.set(wideHUD, forKey: Prefs.wideHUD) } }
     private var setHUDPOS = false        // HUDPOS was set by us (not by the caller)
+    /// Frames a second (the game's own is 120); passed as NFSU2_FPS.
+    @Published var frameRate: Int { didSet { defaults.set(frameRate, forKey: Prefs.frameRate) } }
+    @Published var fpsCounter: Bool { didSet { defaults.set(fpsCounter, forKey: Prefs.fpsCounter) } }
+    private var setFPS = false           // NFSU2_FPS / NFSU2_FPSCOUNTER were set by us
     @Published var controller: Bool { didSet { defaults.set(controller, forKey: Prefs.controller) } }
     @Published var stickDeadzone: Double { didSet { defaults.set(stickDeadzone, forKey: Prefs.stickDeadzone) } }
     private var setPad = false           // NFSU2_PAD / NFSU2_PAD_DEADZONE were set by us
@@ -54,6 +58,9 @@ final class LauncherModel: ObservableObject {
         fullscreen = defaults.bool(forKey: Prefs.fullscreen)
         showAtStartup = defaults.bool(forKey: Prefs.showAtStartup)
         wideHUD = defaults.bool(forKey: Prefs.wideHUD)
+        let fr = defaults.integer(forKey: Prefs.frameRate)
+        frameRate = [30, 60, 120, 240].contains(fr) ? fr : 120
+        fpsCounter = defaults.bool(forKey: Prefs.fpsCounter)
         controller = defaults.bool(forKey: Prefs.controller)
         stickDeadzone = min(0.5, max(0, defaults.double(forKey: Prefs.stickDeadzone)))
     }
@@ -123,6 +130,12 @@ final class LauncherModel: ObservableObject {
             if wideHUD { setenv("HUDPOS", "1", 1); setHUDPOS = true }
             else if setHUDPOS { unsetenv("HUDPOS"); setHUDPOS = false }
         }
+        // Frame rate and counter (engine: overrides.c, metal.m); values set by hand win.
+        if setFPS || (env["NFSU2_FPS"] == nil && env["NFSU2_FPSCOUNTER"] == nil) {
+            if frameRate == 120 { unsetenv("NFSU2_FPS") } else { setenv("NFSU2_FPS", String(frameRate), 1) }
+            setenv("NFSU2_FPSCOUNTER", fpsCounter ? "1" : "0", 1)
+            setFPS = true
+        }
         // Controller settings; NFSU2_PAD / NFSU2_PAD_DEADZONE set by hand still win.  Ours
         // are overwritten on every Play, so a change takes effect without restarting.
         if setPad || (env["NFSU2_PAD"] == nil && env["NFSU2_PAD_DEADZONE"] == nil) {

launcher/Settings.swift

@@ -102,6 +102,18 @@ struct GraphicsSettings: View {
                            description: "On wide screens the minimap moves to the left and the gauges to the right. Off: the HUD stays in the 4:3 middle.",
                            isOn: $model.wideHUD)
             }
+            Card("Frame rate") {
+                SettingRow(title: "Frames a second",
+                           description: "The game's own limit is 120. 60 uses less power and suits 60 Hz screens; the screen's refresh rate is the upper limit. The game runs at the same speed either way.") {
+                    Picker("", selection: $model.frameRate) {
+                        Text("30").tag(30); Text("60").tag(60); Text("120").tag(120); Text("240").tag(240)
+                    }
+                    .pickerStyle(SegmentedPickerStyle()).labelsHidden().fixedSize()
+                }
+                SettingRow(title: "Show the frame rate",
+                           description: "Frames a second in the top left corner while playing.",
+                           isOn: $model.fpsCounter)
+            }
         }
     }
 }