Function LoadAndApplyDisplayConfig

apps/cwr/Game/GameApplication.cpp:307–351

Eager-write defaults if the file is missing, then apply the cfg values to the live graphics engine. Normalize-but-don't-persist so a temporarily disconnected monitor keeps its remembered name.

// values to the live graphics engine.  Normalize-but-don't-persist
// so a temporarily disconnected monitor keeps its remembered name.
void LoadAndApplyDisplayConfig()
{
    if (!GEngine)
        return;

    const std::string path = DisplayConfigPath();
    DisplayConfig cfg;
    if (!cfg.Load(path))
    {
        cfg.LoadDefaults();
        cfg.Save(path);
        LOG_INFO(Graphics, "LoadDisplayConfig: created defaults at '{}'", path);
    }

    LiveDisplayEnv env(GEngine);
    if (cfg.Normalize(env))
        LOG_INFO(Graphics, "LoadDisplayConfig: normalized invalid fields (not persisted)");

    DisplayStartupOverrides overrides = GetCliDisplayOverrides(AppConfig::Instance());
    if (ApplyDisplayStartupOverrides(cfg, overrides))
        LOG_INFO(Graphics, "LoadDisplayConfig: applied explicit CLI display overrides");

    // Apply order matters: monitor first (window may move),
    // window mode next, resolution + refresh rate last.
    if (cfg.monitor != GEngine->GetCurrentMonitor())
        GEngine->SwitchMonitor(cfg.monitor);

    // Honour the --window CLI override — when the user/test runner
    // explicitly asked for Windowed, applying the cfg's Borderless or
    // Fullscreen via SetWindowMode would route through
    // SDL_SetWindowFullscreen(true), which fires WINDOW_ENTER_FULLSCREEN
    // and flips the engine's _windowed back to false.  Tests that boot
    // with --window then assert IsWindowed() would race-fail.
    const auto effectiveWindowMode =
        ENGINE_CONFIG.useWindow ? DisplayConfig::Windowed : static_cast<DisplayConfig::WindowMode>(cfg.windowMode);
    GEngine->SetWindowMode(static_cast<WindowMode>(effectiveWindowMode));
    if (cfg.resolutionWidth > 0 && cfg.resolutionHeight > 0)
        GEngine->SwitchRes(cfg.resolutionWidth, cfg.resolutionHeight, /*bpp*/ 32);
    if (cfg.refreshRate > 0 && effectiveWindowMode == DisplayConfig::Fullscreen)
        GEngine->SwitchRefreshRate(cfg.refreshRate);
    ApplyAspectPolicy(cfg);

    LOG_DEBUG(Graphics, "LoadDisplayConfig: monitor={} mode={} res={}x{} refresh={}", cfg.monitor, (int)cfg.windowMode,
              cfg.resolutionWidth, cfg.resolutionHeight, cfg.refreshRate);
}

// GraphicsConfig::Environment impl — only consults system RAM today.
struct LiveGraphicsEnv : GraphicsConfig::Environment