Files
mitch030504--Wiicompiled_VR…/runtime/include/runtime_config.h
T
iChris4andClaude Opus 5 ee5df403ac Merge upstream/main (v0.2.32) into openxr-work
Brings in the keyboard/mouse rebinding overhaul (#162), the Kamek
skip-return hook fixes (#182, #218), the exit button and controller LED
fix (#221), the autohide-cursor and mute hotkey fix (#211), the Linux
--sysroot plumbing (#224) and the switch to the theofficialgman
dawn-build fork (#215).

Conflicts resolved to keep the VR integration intact:

- settings_overlay.cpp/.h: kept both new declarations. The controller
  rebinding UI takes upstream's click-to-rebind widgets wholesale - our
  only edit there was wrapping the combo width in Scaled(), and
  upstream's bindingWidth is already font-relative, so the headset
  panel still scales. Kept our DrawResolutionMenu() extraction (the VR
  panel reuses it) while adopting upstream's DrawExitPrompt() and its
  new DrawTopBar() prologue; kept our Diagnostics menu alongside
  upstream's exit-button width math. HandleEvents merges both keyboard
  paths, with the VR recenter hotkey now guarded by !g_rebind.active so
  it cannot fire while a binding is being captured.

- AuroraDawnProvider.cmake: dropped our now-dead Android hash block.
  Upstream restructured the pins into an if/elseif chain that already
  covers android/aarch64, with the digest for the new dawn-build fork;
  our leftover block was unreachable and carried the old encounter
  digest.

- Version plumbing (Build-Installer.ps1, Setup.Windows Program.cs and
  csproj): kept this fork's own line, which is 0.2.39 and centralised in
  Launcher/Directory.Build.props, rather than regressing to upstream's
  hardcoded 0.2.32.

Verified: translator 654/654; runtime ctest 14/14 including every VR
test; WiiCompiled and RetroRewind link; aurora gx_fifo_tests 262/263,
the one failure being the TevRegisterLiveness case already documented as
pre-existing on this branch.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-17 23:02:33 +02:00

1510 lines
63 KiB
C++

#pragma once
#include <algorithm>
#include <array>
#include <cctype>
#include <cmath>
#include <cstddef>
#include <cstdint>
#include <filesystem>
#include <fstream>
#include <iomanip>
#include <iostream>
#include <limits>
#include <map>
#include <optional>
#include <sstream>
#include <string>
#include <string_view>
#include <utility>
#include <vector>
#include <toml.hpp>
#include "platform/host_platform.h"
#include "vr/frame_interpolation_pacing.h"
#ifdef _WIN32
#ifndef WIN32_LEAN_AND_MEAN
#define WIN32_LEAN_AND_MEAN
#endif
#include <windows.h>
#include <shlobj.h>
#else
#include <cstdlib>
#include <unistd.h>
#endif
struct RuntimeUserConfig {
std::optional<bool> widescreen;
std::optional<int32_t> windowPosX;
std::optional<int32_t> windowPosY;
std::optional<uint32_t> windowWidth;
std::optional<uint32_t> windowHeight;
std::optional<float> resolutionMultiplier;
std::optional<std::string> graphicsApi;
std::optional<std::string> displayMode;
std::optional<uint32_t> frameInterpolationFps;
std::optional<bool> skipUnreadyPipelines;
std::optional<bool> disableCopyFilter;
std::optional<bool> textureReplacements;
std::optional<bool> textureDumps;
std::optional<bool> showFps;
std::optional<uint32_t> disabledPostProcessingPaths;
std::optional<bool> vrEnabled;
std::optional<bool> vrRequired;
std::optional<float> vrRenderScale;
std::optional<float> vrWorldUnitsPerMeter;
std::optional<float> vrHudDistanceMeters;
std::optional<float> vrHudWidthMeters;
std::optional<bool> vrHudVirtualScreen;
std::optional<bool> vrStopAtDisplayCopy;
std::optional<bool> vrSkipCopyClears;
std::optional<std::string> vrMirrorView;
std::optional<std::string> vrControllerMode;
std::optional<uint32_t> vrFrameInterpolationFps;
std::optional<bool> vrFirstPerson;
std::optional<float> vrFirstPersonUnitsPerMeter;
std::optional<float> vrFirstPersonHeadUpMeters;
std::optional<float> vrFirstPersonHeadForwardMeters;
std::optional<float> vrFirstPersonHeadRightMeters;
std::optional<bool> vrFirstPersonHideDriver;
std::optional<int32_t> vrFirstPersonHiddenModel;
std::optional<std::string> vrFirstPersonRotation;
std::optional<std::string> vrRecenterKey;
std::optional<float> vrLeanBackDegrees;
// F10 > Diagnostics: OpenXR pacing and presentation logging in console.log.
// Off unless set; it is a bug-report aid, not something to leave running.
std::optional<bool> diagnosticsOpenXRLogging;
std::optional<float> audioVolume;
std::optional<float> audioMusicVolume;
std::optional<float> audioSoundEffectsVolume;
std::optional<float> audioUiVolume;
std::optional<float> audioVoicesVolume;
std::optional<bool> audioMuted;
std::optional<bool> audioMixWorker;
std::optional<bool> attenuateMusicWhenMediaPlays;
// Real Wii Remotes (with or without Nunchuk / Classic Controller) and Wii U Pro
// Controllers paired over Bluetooth, driven by SDL's HIDAPI Wii driver. The driver
// is opt-in on SDL's side, so this decides whether the runtime turns it on.
std::optional<bool> wiiRemotes;
// Keep re-enumerating Bluetooth HID devices while no Wii controller is connected
// (Dolphin's "continuous scanning"), so a remote that dropped or was switched on
// after launch shows up without restarting.
std::optional<bool> wiiContinuousScan;
// Accelerometer zero-point correction for the Bluetooth Wii Remote, in g and in
// SDL's sensor frame (x right, y out of the button face, z towards the user).
// SDL's Wii driver falls back to a nominal zero point when its read of the
// remote's calibration block times out (common over Bluetooth), so this is
// measured in the overlay with the remote at rest.
std::optional<double> wiiAccelOffsetX;
std::optional<double> wiiAccelOffsetY;
std::optional<double> wiiAccelOffsetZ;
// Debugging aid: append every KPAD sample of the Bluetooth remote (raw and
// corrected accelerometer, buttons) to wii_accel_trace.csv next to Config.toml.
std::optional<bool> wiiAccelTrace;
std::optional<bool> networkEnabled;
std::optional<bool> discordPresenceEnabled;
// The application ID of the WiiCompiled Discord application. This is only
// used by the base product; Retro Rewind supplies its own ID through the
// standard Dolphin /dev/dolphin interface.
std::optional<std::string> discordClientId;
std::optional<std::string> nandRoot;
std::optional<std::string> dvdRoot;
// The one canonical Retro Rewind installation, owned and updated by the frontend. Setup records
// it here instead of copying the pack, so an asset-only update is visible on the next launch.
std::optional<std::string> retroRewindRoot;
std::vector<std::string> overlayRoots;
// Controller mappings use Wii/GameCube button names as keys and up to two
// comma-separated SDL-style physical button names ("south", or
// "dpad_up,left_shoulder") as values; pressing either bound button counts.
std::array<std::optional<std::string>, 12> controllerButtons;
std::optional<bool> rumbleEnabled;
std::optional<int32_t> muteHotkey;
std::map<std::string, std::string> controllerExpressions;
};
namespace RuntimeConfigFile {
// Narrow path strings are UTF-8 everywhere in the runtime; string() and the
// char path constructor would use the ANSI codepage on Windows, which drops
// characters the codepage cannot represent.
inline std::string PathToUtf8(const std::filesystem::path& path) {
const std::u8string text = path.u8string();
return std::string(text.begin(), text.end());
}
inline std::filesystem::path PathFromUtf8(std::string_view text) {
return std::filesystem::path(std::u8string(text.begin(), text.end()));
}
inline constexpr const char* kConfigFileName = "Config.toml";
#if defined(_WIN32) || defined(__ANDROID__)
// The Quest activity (android/.../QuestActivity.kt) creates this directory
// under the app's external files dir and writes Config.toml into it.
inline constexpr const char* kApplicationDirectoryName = "WiiCompiledOpenXRVR";
#else
inline constexpr const char* kApplicationDirectoryName = "WiiCompiled";
#endif
// Portable layout. A directory holding kPortableMarkerFileName is a portable root; every piece of
// runtime user state (Config.toml, NAND, Cache, Logs) lives in <root>/UserData instead of
// %LOCALAPPDATA%. The marker is searched for from the executable's directory upwards, which is what
// makes an installation survive being moved or carried on removable media.
inline constexpr const char* kPortableMarkerFileName = "portable.txt";
inline constexpr const char* kPortableUserDataDirectoryName = "UserData";
// The installed layout puts products two levels below the root (<root>/Install/Base/game.exe). The
// bound is deliberately small so an unrelated marker far up a drive can never capture an ordinary
// installation.
inline constexpr int kPortableSearchDepth = 4;
// Post-processing paths the game is allowed to skip, as a mask of the engine's
// own path bits. Bloom is the only one exposed, and it starts off: its bright
// bleed is the effect that reads worst in a headset, and the F10 bar's tick box
// is the way back to it.
inline constexpr uint32_t kPostProcessingBloomPath = 0x10u;
inline constexpr uint32_t kDisabledPostProcessingPathsDefault = kPostProcessingBloomPath;
// First-person camera defaults and the range its head offsets accept, in one
// place: the config getters, the on-disk template and the F10 bar's reset all
// read them from here, so they cannot drift apart again.
inline constexpr float kVrFirstPersonUnitsPerMeterDefault = 50.0f;
inline constexpr float kVrFirstPersonHeadUpDefault = 1.50f;
inline constexpr float kVrFirstPersonHeadForwardDefault = 0.0f;
inline constexpr float kVrFirstPersonHeadRightDefault = 0.0f;
inline constexpr bool kVrFirstPersonHideDriverDefault = true;
inline constexpr int32_t kVrFirstPersonHiddenModelDefault = 0;
inline constexpr float kVrFirstPersonHeadOffsetLimit = 10.0f;
// "yaw", "yaw_pitch" or "full", matching FirstPersonRotation.
inline constexpr const char* kVrFirstPersonRotationDefault = "yaw";
inline bool IsSupportedVrFirstPersonRotation(std::string_view value) {
return value == "yaw" || value == "yaw_pitch" || value == "full";
}
// What the desktop window shows while the headset is running: "normal" leaves
// the ordinary desktop view alone, "both", "left" and "right" mirror the
// headset's eyes, and "none" blacks the window out. Matches
// AuroraStereoMirrorView.
inline constexpr const char* kVrMirrorViewDefault = "normal";
inline bool IsSupportedVrMirrorView(std::string_view value) {
return value == "normal" || value == "both" || value == "left" || value == "right" || value == "none";
}
// What the tracked VR controllers are to the game: "wii_remote" is a Wii
// Remote with a Nunchuk (motion and pointer included), "gamepad" one ordinary
// controller read as a GameCube pad. Matches mkw::vr::OpenXRControllerMode.
inline constexpr const char* kVrControllerModeDefault = "wii_remote";
inline bool IsSupportedVrControllerMode(std::string_view value) {
return value == "wii_remote" || value == "gamepad";
}
// SDL scancode name, spelled the way SDL_GetScancodeName produces it. An
// empty string leaves the recenter hotkey unbound, menu button only.
inline constexpr std::string_view kVrRecenterKeyDefault = "F9";
// Fixed pitch of the game camera for a player sitting reclined, in degrees.
// Positive leans the camera back with you; 0 disables it entirely.
inline constexpr float kVrLeanBackDegreesDefault = 0.0f;
inline constexpr float kVrLeanBackDegreesLimit = 45.0f;
inline std::string Trim(std::string_view text) {
size_t begin = 0;
while (begin < text.size() && std::isspace(static_cast<unsigned char>(text[begin]))) {
++begin;
}
size_t end = text.size();
while (end > begin && std::isspace(static_cast<unsigned char>(text[end - 1]))) {
--end;
}
return std::string(text.substr(begin, end - begin));
}
inline std::string RemoveComment(std::string_view line) {
bool inSingle = false;
bool inDouble = false;
bool escaped = false;
for (size_t i = 0; i < line.size(); ++i) {
const char ch = line[i];
if (inDouble && ch == '\\' && !escaped) {
escaped = true;
continue;
}
if (ch == '\'' && !inDouble) {
inSingle = !inSingle;
} else if (ch == '"' && !inSingle && !escaped) {
inDouble = !inDouble;
} else if (ch == '#' && !inSingle && !inDouble) {
return std::string(line.substr(0, i));
}
escaped = false;
}
return std::string(line);
}
inline bool IsSupportedResolutionMultiplier(float value) {
static constexpr std::array values{0.0f, 1.0f, 1.5f, 2.0f, 3.0f, 4.0f, 6.0f, 8.0f};
return std::find(values.begin(), values.end(), value) != values.end();
}
// Must stay in step with the backend table in main.cpp, which is what actually
// maps these to AuroraBackend.
inline bool IsSupportedGraphicsApi(std::string_view value) {
#if defined(__APPLE__)
static constexpr std::array<std::string_view, 2> values{"auto", "metal"};
// only vulkan for linux
#elif defined(__linux__)
static constexpr std::array<std::string_view, 2> values{"auto", "vulkan"};
#elif defined(_WIN32)
static constexpr std::array<std::string_view, 3> values{"auto", "d3d12", "vulkan"};
#endif
return std::find(values.begin(), values.end(), value) != values.end();
}
inline bool IsSupportedDisplayMode(std::string_view value) {
static constexpr std::array<std::string_view, 3> values{
"windowed", "borderless", "exclusive",
};
return std::find(values.begin(), values.end(), value) != values.end();
}
// 240 was offered by an early build and is no longer supported; a saved 240 is
// migrated to 180 at the parse site.
inline bool IsSupportedFrameInterpolationFps(uint32_t value) {
return value == 0 || value == 120 || value == 180;
}
inline std::optional<std::filesystem::path> ExecutableDirectory() {
#ifdef _WIN32
std::wstring buffer(MAX_PATH, L'\0');
for (;;) {
const DWORD length = GetModuleFileNameW(nullptr, buffer.data(), static_cast<DWORD>(buffer.size()));
if (length == 0) {
return std::nullopt;
}
if (length < buffer.size() - 1) {
buffer.resize(length);
return std::filesystem::path(buffer).parent_path();
}
buffer.resize(buffer.size() * 2);
}
#elif defined(__APPLE__) || defined(__ANDROID__)
// Android has no executable next to which assets could sit; the platform
// layer answers with the directory the activity unpacked the bundled
// runtime resources into, so the adjacent-file lookups below keep working.
return RuntimePlatform::ExecutableDirectory();
#else
// /proc/self/exe is a Linux-specific magic symlink to the running executable; readlink()
// does not NUL-terminate and silently truncates if the buffer is too small, so this grows
// the buffer until the result no longer fills it completely, the same doubling strategy as
// the Windows branch above uses for GetModuleFileNameW.
std::string buffer(256, '\0');
for (;;) {
const ssize_t length = readlink("/proc/self/exe", buffer.data(), buffer.size());
if (length < 0) {
return std::nullopt;
}
if (static_cast<size_t>(length) < buffer.size()) {
buffer.resize(static_cast<size_t>(length));
return std::filesystem::path(buffer).parent_path();
}
buffer.resize(buffer.size() * 2);
}
#endif
}
// The portable root this executable lives under, or nullopt for a normal installation. The answer
// cannot change while the process runs, so it is resolved exactly once: every user-state path
// derives from it and they must not disagree with each other.
inline const std::optional<std::filesystem::path>& PortableRootDirectory() {
static const std::optional<std::filesystem::path> root = []() -> std::optional<std::filesystem::path> {
const auto executableDirectory = ExecutableDirectory();
if (!executableDirectory) {
return std::nullopt;
}
std::filesystem::path current = *executableDirectory;
for (int level = 0; level <= kPortableSearchDepth; ++level) {
std::error_code ec;
if (std::filesystem::is_regular_file(current / kPortableMarkerFileName, ec)) {
return current;
}
const auto parent = current.parent_path();
if (parent.empty() || parent == current) {
break;
}
current = parent;
}
return std::nullopt;
}();
return root;
}
inline std::filesystem::path ApplicationDataDirectory() {
if (const auto& portableRoot = PortableRootDirectory()) {
return *portableRoot / kPortableUserDataDirectoryName;
}
#ifdef _WIN32
PWSTR rawPath = nullptr;
if (SUCCEEDED(SHGetKnownFolderPath(FOLDERID_LocalAppData, KF_FLAG_CREATE, nullptr, &rawPath)) && rawPath) {
const std::filesystem::path directory = std::filesystem::path(rawPath) / kApplicationDirectoryName;
CoTaskMemFree(rawPath);
return directory;
}
#elif defined(__APPLE__) || defined(__ANDROID__)
return RuntimePlatform::ApplicationDataDirectory(kApplicationDirectoryName);
#else
// XDG Base Directory spec equivalent of FOLDERID_LocalAppData: $XDG_DATA_HOME if set and
// non-empty, otherwise its default of $HOME/.local/share.
if (const char* xdgDataHome = std::getenv("XDG_DATA_HOME"); xdgDataHome && *xdgDataHome) {
return std::filesystem::path(xdgDataHome) / kApplicationDirectoryName;
}
if (const char* home = std::getenv("HOME"); home && *home) {
return std::filesystem::path(home) / ".local" / "share" / kApplicationDirectoryName;
}
#endif
return std::filesystem::current_path() / kApplicationDirectoryName;
}
inline std::filesystem::path ResolveConfigPath() {
return ApplicationDataDirectory() / kConfigFileName;
}
inline void EnsureConfigFile() {
const std::filesystem::path path = ResolveConfigPath();
std::error_code ec;
std::filesystem::create_directories(path.parent_path(), ec);
if (ec || std::filesystem::exists(path, ec)) {
return;
}
std::ofstream output(path);
if (!output) {
return;
}
output << "# WiiCompiled user configuration\n"
"# Set paths.dvd_root to an extracted Mario Kart Wii DATA directory.\n\n"
"[video]\n"
"widescreen = true\n"
"resolution_multiplier = 1.0\n"
"frame_interpolation_fps = 0\n"
"display_mode = \"windowed\"\n"
"graphics_api = \"auto\"\n"
"skip_unready_pipelines = true\n"
"disable_copy_filter = true\n"
"show_fps = true\n"
"# Dolphin-style custom textures. When enabled, the renderer indexes\n"
"# texture_replacements/ next to this file at startup and substitutes\n"
"# any tex1_<W>x<H>_<hash>[_<tlut hash>]_<format>.dds or .png it finds\n"
"# there for the matching game texture. texture_dumps writes every\n"
"# unmatched texture to Cache/texture_dumps under the name a\n"
"# replacement would need. Both are read once, at startup.\n"
"texture_replacements = false\n"
"texture_dumps = false\n\n"
"[vr]\n"
"# OpenXR is opt-in. If required is false, startup failures fall back\n"
"# to the ordinary desktop renderer. These values are read at launch.\n"
"enabled = false\n"
"required = false\n"
"# What the desktop window shows while the headset is running:\n"
"# \"normal\" keeps the ordinary desktop view, \"both\", \"left\" and\n"
"# \"right\" mirror the headset's eyes, and \"none\" blacks the window\n"
"# out. Changeable live from the F10 menu.\n"
"mirror_view = \"normal\"\n"
"# What the headset's controllers are to the game: \"wii_remote\"\n"
"# is a Wii Remote (right hand, with motion and a pointer aimed at\n"
"# the virtual screen) plus a Nunchuk (left hand); \"gamepad\" is one\n"
"# ordinary controller read as a GameCube pad. Changeable live from\n"
"# the F10 menu.\n"
"controller_mode = \"wii_remote\"\n"
"# VR interpolation: 0 = Off, 1 = Auto, or 72/90/120 FPS. Live.\n"
"frame_interpolation_fps = 0\n"
"render_scale = 1.0\n"
"world_units_per_meter = 500.0\n"
"hud_distance_meters = 2.0\n"
"hud_width_meters = 2.4\n"
"# During a race, put the game's 2D layer (minimap, position,\n"
"# item roulette, lap times) on a virtual screen fixed in front of\n"
"# the kart camera instead of stretching it across the whole view.\n"
"# Changeable live from the F10 menu; the two sizes above place\n"
"# that screen and the menu screen alike and are read at launch.\n"
"hud_virtual_screen = true\n"
"# EFB replay controls for the per-eye views, changeable live\n"
"# from the F10 menu. stop_at_display_copy ends each eye at the\n"
"# frame's final GXCopyDisp; skip_copy_clears drops the EFB\n"
"# reset a GX copy performs afterwards. Both keep that reset\n"
"# from erasing the eye, and both are safe to turn off.\n"
"stop_at_display_copy = true\n"
"skip_copy_clears = true\n"
"# Put the camera at the Player 1 driver's head instead of behind\n"
"# the kart, with the horizon kept level. Changeable live from the\n"
"# F10 menu, and only during a single-screen race. The world scale\n"
"# below replaces world_units_per_meter while it is engaged: 10 is\n"
"# life-size, where the 500 above makes the race a small diorama.\n"
"first_person = false\n"
"first_person_units_per_meter = 30.0\n"
"# Where the head sits in the kart's own frame, in metres.\n"
"first_person_head_up_meters = 3.0\n"
"first_person_head_forward_meters = 12.0\n"
"first_person_head_right_meters = 0.0\n"
"# In first person the driver sits where your eyes are. Hiding\n"
"# the driver removes the head that would otherwise be in the\n"
"# way; hiding the kart removes the vehicle around you too.\n"
"first_person_hide_driver = true\n"
"# 0 is the driver, which is the usual choice. -1 hides every\n"
"# model of your kart, the vehicle included.\n"
"first_person_hidden_model = 0\n"
"# Where the view's orientation comes from: \"yaw\" levels the\n"
"# horizon, \"yaw_pitch\" adds the kart's climb but no roll, and\n"
"# \"full\" takes the kart's whole orientation so the view banks.\n"
"first_person_rotation = \"yaw\"\n\n"
"# Keyboard shortcut that recenters the VR view, naming the key the\n"
"# way SDL does (F9, Home, Keypad 5, ...). It moves the race view to\n"
"# where you are sitting now and brings the menu screen back upright in\n"
"# front of you. The race view moves in position only: forward and the\n"
"# horizon come from the headset's own reference space, so recentering\n"
"# cannot tilt the game. Rebindable from the F10 menu under VR. Leave\n"
"# empty to unbind.\n"
"recenter_key = \"F9\"\n"
"# Fixed pitch of the game camera, in degrees, for a player sitting\n"
"# reclined. Positive tilts the camera back with you, so 20 here cancels\n"
"# reclining about 20 degrees and puts the track back in front of you.\n"
"# 0 disables it. Changeable live from the F10 menu under VR.\n"
"lean_back_degrees = 0.0\n\n"
"[audio]\n"
"volume = 1.0\n"
"music_volume = 1.0\n"
"sound_effects_volume = 1.0\n"
"ui_volume = 1.0\n"
"voices_volume = 1.0\n"
"muted = false\n"
"attenuate_music_when_media_plays = false\n"
"# Runs the AX/DSP voice mix on its own thread, joined before the\n"
"# guest can observe it. Set to false to mix inline on the guest\n"
"# thread exactly as the runtime did before.\n"
"mix_worker = true\n\n"
"[network]\n"
"enabled = true\n\n"
"[discord]\n"
"# Rich Presence talks only to a locally-running Discord client.\n"
"# Retro Rewind supplies its official app ID automatically. Set this\n"
"# to WiiCompiled's Discord application ID for basic base-game presence.\n"
"enabled = true\n"
"# client_id = \"123456789012345678\"\n\n"
"[paths]\n"
"# dvd_root = \"D:\\\\MarioKartWii\\\\DATA\"\n"
"# nand_root = \"D:\\\\WiiNand\"\n"
"# retro_rewind_root = \"D:\\\\RetroRewind\\\\RetroRewind6\"\n"
"# overlay_roots = [\"D:\\\\RetroRewind\"]\n";
}
template <typename T>
inline std::optional<T> FindConfigValue(
const toml::value& document, std::string_view section, std::string_view key) {
try {
return toml::find<T>(document, std::string(section), std::string(key));
} catch (const std::exception&) {
return std::nullopt;
}
}
inline std::optional<uint32_t> FindConfigUint(
const toml::value& document, std::string_view section, std::string_view key) {
const auto value = FindConfigValue<int64_t>(document, section, key);
if (!value || *value < 0 || static_cast<uint64_t>(*value) > UINT32_MAX) {
return std::nullopt;
}
return static_cast<uint32_t>(*value);
}
inline std::optional<int32_t> FindConfigInt(
const toml::value& document, std::string_view section, std::string_view key) {
const auto value = FindConfigValue<int64_t>(document, section, key);
if (!value || *value < INT32_MIN || *value > INT32_MAX) {
return std::nullopt;
}
return static_cast<int32_t>(*value);
}
inline std::optional<float> FindConfigFloat(
const toml::value& document, std::string_view section, std::string_view key) {
std::optional<double> value = FindConfigValue<double>(document, section, key);
if (!value) {
if (const auto integer = FindConfigValue<int64_t>(document, section, key)) {
value = static_cast<double>(*integer);
}
}
if (!value || !std::isfinite(*value) ||
*value < -static_cast<double>(std::numeric_limits<float>::max()) ||
*value > static_cast<double>(std::numeric_limits<float>::max())) {
return std::nullopt;
}
return static_cast<float>(*value);
}
inline void AppendOverlayRoots(RuntimeUserConfig& config, const std::string& roots) {
size_t begin = 0;
while (begin < roots.size()) {
const size_t end = roots.find(';', begin);
std::string root = Trim(std::string_view(roots).substr(begin, end - begin));
if (!root.empty()) {
config.overlayRoots.push_back(std::move(root));
}
if (end == std::string::npos) {
break;
}
begin = end + 1;
}
}
// Reads every supported setting out of a parsed Config.toml document.
inline RuntimeUserConfig ParseConfigDocument(const toml::value& document) {
RuntimeUserConfig config;
static constexpr std::array<std::string_view, 12> buttonKeys = {
"a", "b", "x", "y", "start", "z", "l", "r", "up", "down", "left", "right",
};
for (size_t index = 0; index < buttonKeys.size(); ++index) {
config.controllerButtons[index] =
FindConfigValue<std::string>(document, "controller", buttonKeys[index]);
}
config.rumbleEnabled = FindConfigValue<bool>(document, "controller", "rumble");
if (auto value = FindConfigInt(document, "audio", "mute_key")) {
config.muteHotkey = *value;
}
if (const auto* section = document.contains("controller") ? &document.at("controller") : nullptr;
section != nullptr && section->is_table()) {
for (const auto& [key, value] : section->as_table()) {
if (key.rfind("expr_", 0) == 0 && value.is_string()) {
config.controllerExpressions[key] = value.as_string();
}
}
}
config.widescreen = FindConfigValue<bool>(document, "video", "widescreen");
config.windowPosX = FindConfigInt(document, "video", "window_x");
config.windowPosY = FindConfigInt(document, "video", "window_y");
if (auto value = FindConfigUint(document, "video", "window_width"); value && *value != 0) {
config.windowWidth = *value;
}
if (auto value = FindConfigUint(document, "video", "window_height"); value && *value != 0) {
config.windowHeight = *value;
}
if (auto value = FindConfigFloat(document, "video", "resolution_multiplier");
value && IsSupportedResolutionMultiplier(*value)) {
config.resolutionMultiplier = *value;
}
if (auto value = FindConfigValue<std::string>(document, "video", "graphics_api")) {
if (IsSupportedGraphicsApi(*value)) {
config.graphicsApi = *value;
} else {
std::cerr << "[runtime] Unknown video.graphics_api=\"" << *value
<< "\", using the automatic backend" << std::endl;
}
}
if (auto value = FindConfigValue<std::string>(document, "video", "display_mode");
value && IsSupportedDisplayMode(*value)) {
config.displayMode = *value;
}
if (auto value = FindConfigUint(document, "video", "frame_interpolation_fps")) {
const uint32_t migrated = *value == 240u ? 180u : *value;
if (IsSupportedFrameInterpolationFps(migrated)) {
config.frameInterpolationFps = migrated;
}
}
config.skipUnreadyPipelines = FindConfigValue<bool>(document, "video", "skip_unready_pipelines");
config.disableCopyFilter = FindConfigValue<bool>(document, "video", "disable_copy_filter");
config.showFps = FindConfigValue<bool>(document, "video", "show_fps");
config.textureReplacements = FindConfigValue<bool>(document, "video", "texture_replacements");
config.textureDumps = FindConfigValue<bool>(document, "video", "texture_dumps");
if (auto value = FindConfigUint(document, "video", "disabled_post_processing_paths");
value && (*value & ~kPostProcessingBloomPath) == 0) {
config.disabledPostProcessingPaths = *value & kPostProcessingBloomPath;
}
config.vrEnabled = FindConfigValue<bool>(document, "vr", "enabled");
config.vrRequired = FindConfigValue<bool>(document, "vr", "required");
if (auto value = FindConfigFloat(document, "vr", "render_scale");
value && *value >= 0.25f && *value <= 2.0f) {
config.vrRenderScale = *value;
}
if (auto value = FindConfigFloat(document, "vr", "world_units_per_meter");
value && *value >= 1.0f && *value <= 10000.0f) {
config.vrWorldUnitsPerMeter = *value;
}
if (auto value = FindConfigFloat(document, "vr", "hud_distance_meters");
value && *value >= 0.25f && *value <= 10.0f) {
config.vrHudDistanceMeters = *value;
}
if (auto value = FindConfigFloat(document, "vr", "hud_width_meters");
value && *value >= 0.25f && *value <= 20.0f) {
config.vrHudWidthMeters = *value;
}
config.vrHudVirtualScreen = FindConfigValue<bool>(document, "vr", "hud_virtual_screen");
config.vrStopAtDisplayCopy = FindConfigValue<bool>(document, "vr", "stop_at_display_copy");
config.vrSkipCopyClears = FindConfigValue<bool>(document, "vr", "skip_copy_clears");
config.vrFirstPerson = FindConfigValue<bool>(document, "vr", "first_person");
if (auto value = FindConfigFloat(document, "vr", "first_person_units_per_meter");
value && *value >= 1.0f && *value <= 10000.0f) {
config.vrFirstPersonUnitsPerMeter = *value;
}
if (auto value = FindConfigFloat(document, "vr", "first_person_head_up_meters");
value && *value >= -kVrFirstPersonHeadOffsetLimit &&
*value <= kVrFirstPersonHeadOffsetLimit) {
config.vrFirstPersonHeadUpMeters = *value;
}
if (auto value = FindConfigFloat(document, "vr", "first_person_head_forward_meters");
value && *value >= -kVrFirstPersonHeadOffsetLimit &&
*value <= kVrFirstPersonHeadOffsetLimit) {
config.vrFirstPersonHeadForwardMeters = *value;
}
if (auto value = FindConfigFloat(document, "vr", "first_person_head_right_meters");
value && *value >= -kVrFirstPersonHeadOffsetLimit &&
*value <= kVrFirstPersonHeadOffsetLimit) {
config.vrFirstPersonHeadRightMeters = *value;
}
config.vrFirstPersonHideDriver =
FindConfigValue<bool>(document, "vr", "first_person_hide_driver");
if (auto value = FindConfigValue<std::string>(document, "vr", "recenter_key")) {
config.vrRecenterKey = *value;
}
if (auto value = FindConfigFloat(document, "vr", "lean_back_degrees");
value && *value >= -kVrLeanBackDegreesLimit && *value <= kVrLeanBackDegreesLimit) {
config.vrLeanBackDegrees = static_cast<float>(*value);
}
if (auto value = FindConfigValue<std::string>(document, "vr", "first_person_rotation");
value && IsSupportedVrFirstPersonRotation(*value)) {
config.vrFirstPersonRotation = *value;
}
if (auto value = FindConfigValue<std::string>(document, "vr", "mirror_view");
value && IsSupportedVrMirrorView(*value)) {
config.vrMirrorView = *value;
}
if (auto value = FindConfigValue<std::string>(document, "vr", "controller_mode");
value && IsSupportedVrControllerMode(*value)) {
config.vrControllerMode = *value;
}
config.vrFrameInterpolationFps = FindConfigValue<uint32_t>(document, "vr", "frame_interpolation_fps");
if (!config.vrFrameInterpolationFps) {
// Migrate the initial experimental checkbox to Auto.
if (const auto legacy = FindConfigValue<bool>(document, "vr", "frame_interpolation"))
config.vrFrameInterpolationFps = *legacy ? 1u : 0u;
}
if (auto value = FindConfigInt(document, "vr", "first_person_hidden_model");
value && *value >= -1 && *value <= 31) {
config.vrFirstPersonHiddenModel = static_cast<int32_t>(*value);
}
config.diagnosticsOpenXRLogging = FindConfigValue<bool>(document, "diagnostics", "openxr_logging");
auto readVolume = [&](std::string_view key) -> std::optional<float> {
auto value = FindConfigFloat(document, "audio", key);
return value && *value >= 0.0f && *value <= 1.0f ? value : std::nullopt;
};
config.audioVolume = readVolume("volume");
config.audioMusicVolume = readVolume("music_volume");
config.audioSoundEffectsVolume = readVolume("sound_effects_volume");
config.audioUiVolume = readVolume("ui_volume");
config.audioVoicesVolume = readVolume("voices_volume");
config.audioMuted = FindConfigValue<bool>(document, "audio", "muted");
config.audioMixWorker = FindConfigValue<bool>(document, "audio", "mix_worker");
config.attenuateMusicWhenMediaPlays =
FindConfigValue<bool>(document, "audio", "attenuate_music_when_media_plays");
config.wiiRemotes = FindConfigValue<bool>(document, "controller", "wii_remotes");
config.wiiContinuousScan = FindConfigValue<bool>(document, "controller", "wii_continuous_scan");
config.wiiAccelOffsetX = FindConfigValue<double>(document, "controller", "wii_accel_offset_x");
config.wiiAccelOffsetY = FindConfigValue<double>(document, "controller", "wii_accel_offset_y");
config.wiiAccelOffsetZ = FindConfigValue<double>(document, "controller", "wii_accel_offset_z");
config.wiiAccelTrace = FindConfigValue<bool>(document, "controller", "wii_accel_trace");
config.networkEnabled = FindConfigValue<bool>(document, "network", "enabled");
config.discordPresenceEnabled = FindConfigValue<bool>(document, "discord", "enabled");
config.discordClientId = FindConfigValue<std::string>(document, "discord", "client_id");
config.nandRoot = FindConfigValue<std::string>(document, "paths", "nand_root");
config.dvdRoot = FindConfigValue<std::string>(document, "paths", "dvd_root");
config.retroRewindRoot = FindConfigValue<std::string>(document, "paths", "retro_rewind_root");
if (auto roots = FindConfigValue<std::vector<std::string>>(document, "paths", "overlay_roots")) {
for (auto& root : *roots) {
root = Trim(root);
if (!root.empty()) {
config.overlayRoots.push_back(std::move(root));
}
}
} else if (auto roots = FindConfigValue<std::string>(document, "paths", "overlay_roots")) {
AppendOverlayRoots(config, *roots);
}
return config;
}
inline RuntimeUserConfig ParseConfig(std::istream& input, std::string sourceName = "Config.toml") {
try {
return ParseConfigDocument(toml::parse(input, std::move(sourceName)));
} catch (const std::exception& exception) {
std::cerr << "[runtime-config] Invalid TOML; using built-in defaults: "
<< exception.what() << std::endl;
return {};
}
}
inline RuntimeUserConfig LoadConfigFile() {
EnsureConfigFile();
std::ifstream file(ResolveConfigPath(), std::ios::binary);
return file ? ParseConfig(file, PathToUtf8(ResolveConfigPath())) : RuntimeUserConfig{};
}
inline const RuntimeUserConfig& Get() {
static RuntimeUserConfig config = LoadConfigFile();
return config;
}
inline RuntimeUserConfig& Mutable() {
return const_cast<RuntimeUserConfig&>(Get());
}
inline constexpr std::array<std::string_view, 12> kControllerButtonKeys = {
"a", "b", "x", "y", "start", "z", "l", "r", "up", "down", "left", "right",
};
inline const std::optional<std::string>& ControllerButton(size_t index) {
static const std::optional<std::string> empty;
return index < Get().controllerButtons.size() ? Get().controllerButtons[index] : empty;
}
// Update one TOML value without discarding comments, unrelated settings, or
// user-specific paths. This is used by the in-game F10 settings bar.
inline bool WriteSetting(std::string_view section, std::string_view key, std::string_view value) {
const auto path = ResolveConfigPath();
std::ifstream input(path);
std::vector<std::string> lines;
std::string line;
while (std::getline(input, line)) {
if (!line.empty() && line.back() == '\r') {
line.pop_back();
}
lines.push_back(std::move(line));
}
const std::string normalizedSection = Trim(section);
const std::string normalizedKey = Trim(key);
size_t sectionStart = lines.size();
size_t sectionEnd = lines.size();
for (size_t i = 0; i < lines.size(); ++i) {
const std::string trimmed = Trim(RemoveComment(lines[i]));
if (trimmed.size() >= 2 && trimmed.front() == '[' && trimmed.back() == ']') {
const std::string found = Trim(std::string_view(trimmed).substr(1, trimmed.size() - 2));
if (sectionStart != lines.size()) {
sectionEnd = i;
break;
}
if (found == normalizedSection) {
sectionStart = i;
}
}
}
const std::string replacement = normalizedKey + " = " + std::string(value);
if (sectionStart == lines.size()) {
if (!lines.empty() && !lines.back().empty()) {
lines.emplace_back();
}
lines.emplace_back("[" + normalizedSection + "]");
lines.push_back(replacement);
} else {
bool replaced = false;
for (size_t i = sectionStart + 1; i < sectionEnd; ++i) {
const std::string uncommented = Trim(RemoveComment(lines[i]));
const size_t equals = uncommented.find('=');
if (equals != std::string::npos && Trim(std::string_view(uncommented).substr(0, equals)) == normalizedKey) {
lines[i] = replacement;
replaced = true;
break;
}
}
if (!replaced) {
// Append after the section's last real line rather than after the blank line that
// separates it from the next header: this file is edited by hand and by the host
// installer as well, and a key parked below the separator reads as if it belonged to
// the next section. The host writer (Launcher/WiiCompiled.Setup/RuntimeConfiguration.cs)
// applies exactly this rule.
size_t insertAt = sectionEnd;
while (insertAt > sectionStart + 1 && Trim(lines[insertAt - 1]).empty()) {
--insertAt;
}
lines.insert(lines.begin() + static_cast<std::ptrdiff_t>(insertAt), replacement);
}
}
std::error_code ec;
if (path.has_parent_path()) {
std::filesystem::create_directories(path.parent_path(), ec);
}
std::ofstream output(path, std::ios::trunc);
if (!output) {
std::cerr << "[runtime-config] Unable to write " << PathToUtf8(path) << std::endl;
return false;
}
for (const auto& outputLine : lines) {
output << outputLine << '\n';
}
return static_cast<bool>(output);
}
inline std::string FormatString(std::string_view value) {
return toml::format(toml::value(std::string(value)));
}
inline bool SetResolutionMultiplier(float value) {
Mutable().resolutionMultiplier = value;
std::ostringstream formatted;
formatted << value;
return WriteSetting("video", "resolution_multiplier", formatted.str());
}
inline bool SetWindowSize(uint32_t width, uint32_t height) {
if (width == 0 || height == 0) {
return false;
}
Mutable().windowWidth = width;
Mutable().windowHeight = height;
const bool wroteWidth = WriteSetting("video", "window_width", std::to_string(width));
const bool wroteHeight = WriteSetting("video", "window_height", std::to_string(height));
return wroteWidth && wroteHeight;
}
inline bool SetWindowPosition(int32_t x, int32_t y) {
Mutable().windowPosX = x;
Mutable().windowPosY = y;
const bool wroteX = WriteSetting("video", "window_x", std::to_string(x));
const bool wroteY = WriteSetting("video", "window_y", std::to_string(y));
return wroteX && wroteY;
}
inline bool SetFrameInterpolationFps(uint32_t value) {
if (!IsSupportedFrameInterpolationFps(value)) {
return false;
}
Mutable().frameInterpolationFps = value;
return WriteSetting("video", "frame_interpolation_fps", std::to_string(value));
}
inline bool SetDisplayMode(std::string value) {
if (!IsSupportedDisplayMode(value)) {
return false;
}
Mutable().displayMode = value;
return WriteSetting("video", "display_mode", FormatString(value));
}
inline bool SetSkipUnreadyPipelines(bool value) {
Mutable().skipUnreadyPipelines = value;
return WriteSetting("video", "skip_unready_pipelines", value ? "true" : "false");
}
inline bool SetDisableCopyFilter(bool value) {
Mutable().disableCopyFilter = value;
return WriteSetting("video", "disable_copy_filter", value ? "true" : "false");
}
inline bool SetShowFps(bool value) {
Mutable().showFps = value;
return WriteSetting("video", "show_fps", value ? "true" : "false");
}
inline bool SetDisabledPostProcessingPaths(uint32_t value) {
Mutable().disabledPostProcessingPaths = value;
std::ostringstream formatted;
formatted << "0x" << std::hex << std::uppercase << value;
return WriteSetting("video", "disabled_post_processing_paths", formatted.str());
}
inline bool SetVrEnabled(bool value) {
Mutable().vrEnabled = value;
return WriteSetting("vr", "enabled", value ? "true" : "false");
}
inline bool SetVrHudVirtualScreen(bool value) {
Mutable().vrHudVirtualScreen = value;
return WriteSetting("vr", "hud_virtual_screen", value ? "true" : "false");
}
inline bool SetVrStopAtDisplayCopy(bool value) {
Mutable().vrStopAtDisplayCopy = value;
return WriteSetting("vr", "stop_at_display_copy", value ? "true" : "false");
}
inline bool SetVrSkipCopyClears(bool value) {
Mutable().vrSkipCopyClears = value;
return WriteSetting("vr", "skip_copy_clears", value ? "true" : "false");
}
inline bool SetVrFirstPerson(bool value) {
Mutable().vrFirstPerson = value;
return WriteSetting("vr", "first_person", value ? "true" : "false");
}
inline bool SetVrFirstPersonUnitsPerMeter(float value) {
value = std::clamp(value, 1.0f, 10000.0f);
Mutable().vrFirstPersonUnitsPerMeter = value;
std::ostringstream formatted;
formatted << value;
return WriteSetting("vr", "first_person_units_per_meter", formatted.str());
}
inline bool SetVrFirstPersonHeadUpMeters(float value) {
value = std::clamp(value, -kVrFirstPersonHeadOffsetLimit, kVrFirstPersonHeadOffsetLimit);
Mutable().vrFirstPersonHeadUpMeters = value;
std::ostringstream formatted;
formatted << value;
return WriteSetting("vr", "first_person_head_up_meters", formatted.str());
}
inline bool SetVrFirstPersonHeadForwardMeters(float value) {
value = std::clamp(value, -kVrFirstPersonHeadOffsetLimit, kVrFirstPersonHeadOffsetLimit);
Mutable().vrFirstPersonHeadForwardMeters = value;
std::ostringstream formatted;
formatted << value;
return WriteSetting("vr", "first_person_head_forward_meters", formatted.str());
}
inline bool SetVrRecenterKey(std::string value) {
Mutable().vrRecenterKey = value;
return WriteSetting("vr", "recenter_key", FormatString(value));
}
inline bool SetVrLeanBackDegrees(float value) {
value = std::clamp(value, -kVrLeanBackDegreesLimit, kVrLeanBackDegreesLimit);
Mutable().vrLeanBackDegrees = value;
std::ostringstream formatted;
formatted << value;
return WriteSetting("vr", "lean_back_degrees", formatted.str());
}
inline bool SetVrFirstPersonHideDriver(bool value) {
Mutable().vrFirstPersonHideDriver = value;
return WriteSetting("vr", "first_person_hide_driver", value ? "true" : "false");
}
inline bool SetVrMirrorView(std::string value) {
if (!IsSupportedVrMirrorView(value)) {
return false;
}
Mutable().vrMirrorView = value;
return WriteSetting("vr", "mirror_view", FormatString(value));
}
inline bool SetVrControllerMode(std::string value) {
if (!IsSupportedVrControllerMode(value)) {
return false;
}
Mutable().vrControllerMode = value;
return WriteSetting("vr", "controller_mode", FormatString(value));
}
inline bool SetVrFrameInterpolationFps(uint32_t value) {
value = mkw::vr::NormalizeFrameInterpolationFps(value);
Mutable().vrFrameInterpolationFps = value;
return WriteSetting("vr", "frame_interpolation_fps", std::to_string(value));
}
inline bool SetVrFirstPersonRotation(std::string value) {
if (!IsSupportedVrFirstPersonRotation(value)) {
return false;
}
Mutable().vrFirstPersonRotation = value;
return WriteSetting("vr", "first_person_rotation", FormatString(value));
}
inline bool SetVrFirstPersonHiddenModel(int32_t value) {
value = std::clamp(value, -1, 31);
Mutable().vrFirstPersonHiddenModel = value;
std::ostringstream formatted;
formatted << value;
return WriteSetting("vr", "first_person_hidden_model", formatted.str());
}
inline bool SetVrFirstPersonHeadRightMeters(float value) {
value = std::clamp(value, -kVrFirstPersonHeadOffsetLimit, kVrFirstPersonHeadOffsetLimit);
Mutable().vrFirstPersonHeadRightMeters = value;
std::ostringstream formatted;
formatted << value;
return WriteSetting("vr", "first_person_head_right_meters", formatted.str());
}
inline bool SetControllerButton(size_t index, std::string value) {
if (index >= kControllerButtonKeys.size()) {
return false;
}
Mutable().controllerButtons[index] = value;
return WriteSetting("controller", kControllerButtonKeys[index], FormatString(value));
}
inline std::string ControllerExpression(const std::string& key) {
const auto it = Get().controllerExpressions.find(key);
return it == Get().controllerExpressions.end() ? std::string() : it->second;
}
inline bool SetControllerExpression(const std::string& key, const std::string& value) {
Mutable().controllerExpressions[key] = value;
return WriteSetting("controller", key, FormatString(value));
}
inline bool RumbleEnabled(bool fallback = true) {
return Get().rumbleEnabled.value_or(fallback);
}
inline bool SetRumbleEnabled(bool value) {
Mutable().rumbleEnabled = value;
return WriteSetting("controller", "rumble", value ? "true" : "false");
}
inline int32_t MuteHotkey(int32_t fallback) {
return Get().muteHotkey.value_or(fallback);
}
inline bool SetMuteHotkey(int32_t value) {
Mutable().muteHotkey = value;
return WriteSetting("audio", "mute_key", std::to_string(value));
}
inline bool SetAudioVolume(float value) {
value = std::clamp(value, 0.0f, 1.0f);
Mutable().audioVolume = value;
std::ostringstream formatted;
formatted << value;
return WriteSetting("audio", "volume", formatted.str());
}
inline bool SetMusicVolume(float value) {
value = std::clamp(value, 0.0f, 1.0f);
Mutable().audioMusicVolume = value;
std::ostringstream formatted;
formatted << value;
return WriteSetting("audio", "music_volume", formatted.str());
}
inline bool SetSoundEffectsVolume(float value) {
value = std::clamp(value, 0.0f, 1.0f);
Mutable().audioSoundEffectsVolume = value;
std::ostringstream formatted;
formatted << value;
return WriteSetting("audio", "sound_effects_volume", formatted.str());
}
inline bool SetUiVolume(float value) {
value = std::clamp(value, 0.0f, 1.0f);
Mutable().audioUiVolume = value;
std::ostringstream formatted;
formatted << value;
return WriteSetting("audio", "ui_volume", formatted.str());
}
inline bool SetVoicesVolume(float value) {
value = std::clamp(value, 0.0f, 1.0f);
Mutable().audioVoicesVolume = value;
std::ostringstream formatted;
formatted << value;
return WriteSetting("audio", "voices_volume", formatted.str());
}
inline bool SetAudioMuted(bool value) {
Mutable().audioMuted = value;
return WriteSetting("audio", "muted", value ? "true" : "false");
}
inline bool SetAudioMixWorker(bool value) {
Mutable().audioMixWorker = value;
return WriteSetting("audio", "mix_worker", value ? "true" : "false");
}
inline bool SetAttenuateMusicWhenMediaPlays(bool value) {
Mutable().attenuateMusicWhenMediaPlays = value;
return WriteSetting("audio", "attenuate_music_when_media_plays", value ? "true" : "false");
}
inline bool WidescreenEnabled(bool fallback = false) {
return Get().widescreen.value_or(fallback);
}
inline bool WindowPosition(int32_t& x, int32_t& y) {
if (!Get().windowPosX || !Get().windowPosY) {
return false;
}
x = *Get().windowPosX;
y = *Get().windowPosY;
return true;
}
inline uint32_t WindowWidth(uint32_t fallback) {
return Get().windowWidth.value_or(fallback);
}
inline uint32_t WindowHeight(uint32_t fallback) {
return Get().windowHeight.value_or(fallback);
}
inline float ResolutionMultiplier(float fallback = 1.0f) {
return std::max(0.0f, Get().resolutionMultiplier.value_or(fallback));
}
inline float AudioVolume(float fallback = 1.0f) {
return std::clamp(Get().audioVolume.value_or(fallback), 0.0f, 1.0f);
}
inline float MusicVolume(float fallback = 1.0f) {
return std::clamp(Get().audioMusicVolume.value_or(fallback), 0.0f, 1.0f);
}
inline float SoundEffectsVolume(float fallback = 1.0f) {
return std::clamp(Get().audioSoundEffectsVolume.value_or(fallback), 0.0f, 1.0f);
}
inline float UiVolume(float fallback = 1.0f) {
return std::clamp(Get().audioUiVolume.value_or(fallback), 0.0f, 1.0f);
}
inline float VoicesVolume(float fallback = 1.0f) {
return std::clamp(Get().audioVoicesVolume.value_or(fallback), 0.0f, 1.0f);
}
inline bool AudioMuted(bool fallback = false) {
return Get().audioMuted.value_or(fallback);
}
// Off-thread AX/DSP mix. Default on; false restores the fully synchronous mix.
inline bool AudioMixWorkerEnabled(bool fallback = true) {
return Get().audioMixWorker.value_or(fallback);
}
// Whether background music should duck automatically for other media playback.
inline bool AttenuateMusicWhenMediaPlays(bool fallback = false) {
return Get().attenuateMusicWhenMediaPlays.value_or(fallback);
}
// Bluetooth Wii Remotes / Wii U Pro Controllers. Read once before SDL's joystick
// subsystem comes up, so a change only takes effect on the next launch.
inline bool WiiRemotesEnabled(bool fallback = true) {
return Get().wiiRemotes.value_or(fallback);
}
// Persists the Bluetooth Wii Remote driver switch.
inline bool SetWiiRemotesEnabled(bool value) {
Mutable().wiiRemotes = value;
return WriteSetting("controller", "wii_remotes", value ? "true" : "false");
}
// Whether to keep rescanning Bluetooth while no Wii controller is connected.
inline bool WiiContinuousScanEnabled(bool fallback = false) {
return Get().wiiContinuousScan.value_or(fallback);
}
// Persists the continuous scanning switch.
inline bool SetWiiContinuousScanEnabled(bool value) {
Mutable().wiiContinuousScan = value;
return WriteSetting("controller", "wii_continuous_scan", value ? "true" : "false");
}
// Wii Remote accelerometer zero-point correction (g, SDL sensor frame); all zero
// when the remote has not been calibrated.
inline std::array<double, 3> WiiAccelOffset() {
const RuntimeUserConfig& config = Get();
return {config.wiiAccelOffsetX.value_or(0.0), config.wiiAccelOffsetY.value_or(0.0),
config.wiiAccelOffsetZ.value_or(0.0)};
}
// Whether to write the per-frame accelerometer trace (off unless asked for).
inline bool WiiAccelTraceEnabled(bool fallback = false) {
return Get().wiiAccelTrace.value_or(fallback);
}
// True while a non-zero correction is stored ("Clear calibration" writes zeros).
inline bool HasWiiAccelOffset() {
const std::array<double, 3> offset = WiiAccelOffset();
return offset[0] != 0.0 || offset[1] != 0.0 || offset[2] != 0.0;
}
// Persists the accelerometer correction measured by the overlay's calibration.
inline bool SetWiiAccelOffset(const std::array<double, 3>& offset) {
Mutable().wiiAccelOffsetX = offset[0];
Mutable().wiiAccelOffsetY = offset[1];
Mutable().wiiAccelOffsetZ = offset[2];
bool ok = true;
const char* keys[3] = {"wii_accel_offset_x", "wii_accel_offset_y", "wii_accel_offset_z"};
for (size_t i = 0; i < 3; ++i) {
// Always a float literal, so a whole-number offset does not come back as a TOML integer.
std::ostringstream formatted;
formatted << std::fixed << std::setprecision(4) << offset[i];
ok = WriteSetting("controller", keys[i], formatted.str()) && ok;
}
return ok;
}
// Target frame rate for frame interpolation, or 0 to disable it.
inline uint32_t FrameInterpolationFps(uint32_t fallback = 0) {
return Get().frameInterpolationFps.value_or(fallback);
}
// Whether to skip draws whose graphics pipeline has not finished compiling yet.
inline bool SkipUnreadyPipelines(bool fallback = true) {
return Get().skipUnreadyPipelines.value_or(fallback);
}
inline bool DisableCopyFilter(bool fallback = true) {
return Get().disableCopyFilter.value_or(fallback);
}
inline bool ShowFps(bool fallback = true) {
return Get().showFps.value_or(fallback);
}
inline bool TextureReplacements(bool fallback = false) {
return Get().textureReplacements.value_or(fallback);
}
// Dumping only produces the names a replacement would need, so main.cpp
// gates it on TextureReplacements() as well.
inline bool TextureDumps(bool fallback = false) {
return Get().textureDumps.value_or(fallback);
}
// An absent setting means the default mask, not "nothing disabled": a fresh
// install has no [video] section at all and still starts without bloom.
inline uint32_t DisabledPostProcessingPaths(uint32_t fallback = kDisabledPostProcessingPathsDefault) {
return Get().disabledPostProcessingPaths.value_or(fallback) & kPostProcessingBloomPath;
}
inline bool VrEnabled(bool fallback = false) {
return Get().vrEnabled.value_or(fallback);
}
inline bool VrRequired(bool fallback = false) {
return Get().vrRequired.value_or(fallback);
}
inline float VrRenderScale(float fallback = 1.0f) {
return std::clamp(Get().vrRenderScale.value_or(fallback), 0.25f, 2.0f);
}
inline float VrWorldUnitsPerMeter(float fallback = 500.0f) {
return std::clamp(Get().vrWorldUnitsPerMeter.value_or(fallback), 1.0f, 10000.0f);
}
inline float VrHudDistanceMeters(float fallback = 2.0f) {
return std::clamp(Get().vrHudDistanceMeters.value_or(fallback), 0.25f, 10.0f);
}
inline float VrHudWidthMeters(float fallback = 2.4f) {
return std::clamp(Get().vrHudWidthMeters.value_or(fallback), 0.25f, 20.0f);
}
inline bool VrHudVirtualScreen(bool fallback = true) {
return Get().vrHudVirtualScreen.value_or(fallback);
}
inline bool VrStopAtDisplayCopy(bool fallback = true) {
return Get().vrStopAtDisplayCopy.value_or(fallback);
}
inline bool VrSkipCopyClears(bool fallback = true) {
return Get().vrSkipCopyClears.value_or(fallback);
}
inline bool VrFirstPerson(bool fallback = false) {
return Get().vrFirstPerson.value_or(fallback);
}
inline float VrFirstPersonUnitsPerMeter(float fallback = kVrFirstPersonUnitsPerMeterDefault) {
return std::clamp(Get().vrFirstPersonUnitsPerMeter.value_or(fallback), 1.0f, 10000.0f);
}
inline float VrFirstPersonHeadUpMeters(float fallback = kVrFirstPersonHeadUpDefault) {
return std::clamp(Get().vrFirstPersonHeadUpMeters.value_or(fallback),
-kVrFirstPersonHeadOffsetLimit, kVrFirstPersonHeadOffsetLimit);
}
inline float VrFirstPersonHeadForwardMeters(float fallback = kVrFirstPersonHeadForwardDefault) {
return std::clamp(Get().vrFirstPersonHeadForwardMeters.value_or(fallback),
-kVrFirstPersonHeadOffsetLimit, kVrFirstPersonHeadOffsetLimit);
}
inline float VrFirstPersonHeadRightMeters(float fallback = kVrFirstPersonHeadRightDefault) {
return std::clamp(Get().vrFirstPersonHeadRightMeters.value_or(fallback),
-kVrFirstPersonHeadOffsetLimit, kVrFirstPersonHeadOffsetLimit);
}
inline std::string VrRecenterKey(std::string fallback = std::string(kVrRecenterKeyDefault)) {
return Get().vrRecenterKey.value_or(std::move(fallback));
}
inline float VrLeanBackDegrees(float fallback = kVrLeanBackDegreesDefault) {
return std::clamp(Get().vrLeanBackDegrees.value_or(fallback),
-kVrLeanBackDegreesLimit, kVrLeanBackDegreesLimit);
}
inline bool VrFirstPersonHideDriver(bool fallback = kVrFirstPersonHideDriverDefault) {
return Get().vrFirstPersonHideDriver.value_or(fallback);
}
inline std::string VrMirrorView(std::string fallback = kVrMirrorViewDefault) {
const auto& value = Get().vrMirrorView;
return value && IsSupportedVrMirrorView(*value) ? *value : std::move(fallback);
}
inline std::string VrControllerMode(std::string fallback = kVrControllerModeDefault) {
const auto& value = Get().vrControllerMode;
return value && IsSupportedVrControllerMode(*value) ? *value : std::move(fallback);
}
inline uint32_t VrFrameInterpolationFps() {
return mkw::vr::NormalizeFrameInterpolationFps(Get().vrFrameInterpolationFps.value_or(0));
}
inline bool DiagnosticsOpenXRLogging(bool fallback = false) {
return Get().diagnosticsOpenXRLogging.value_or(fallback);
}
inline bool SetDiagnosticsOpenXRLogging(bool value) {
Mutable().diagnosticsOpenXRLogging = value;
return WriteSetting("diagnostics", "openxr_logging", value ? "true" : "false");
}
inline std::string VrFirstPersonRotation(std::string fallback = kVrFirstPersonRotationDefault) {
const auto& value = Get().vrFirstPersonRotation;
return value && IsSupportedVrFirstPersonRotation(*value) ? *value : std::move(fallback);
}
inline int32_t VrFirstPersonHiddenModel(int32_t fallback = kVrFirstPersonHiddenModelDefault) {
return std::clamp(Get().vrFirstPersonHiddenModel.value_or(fallback), -1, 31);
}
inline std::string GraphicsApi(std::string fallback = "auto") {
return Get().graphicsApi.value_or(std::move(fallback));
}
inline std::string DisplayMode(std::string fallback = "windowed") {
return Get().displayMode.value_or(std::move(fallback));
}
inline bool NetworkEnabled(bool fallback = true) {
return Get().networkEnabled.value_or(fallback);
}
inline std::string NandRoot(std::string fallback = "") {
return Get().nandRoot.value_or(std::move(fallback));
}
inline std::string DvdRoot(std::string fallback = "") {
return Get().dvdRoot.value_or(std::move(fallback));
}
// The one resolver for configured paths. A relative value means the same thing
// everywhere it can be configured: relative to the config file that named it,
// never to the process working directory (docs/WHEELWIZARD_CONTRACT.md).
inline std::filesystem::path ResolveRelativeTo(const std::filesystem::path& base,
const std::string& value) {
std::filesystem::path path = PathFromUtf8(value);
if (path.is_relative()) {
path = base / path;
}
return path.lexically_normal();
}
inline std::filesystem::path ResolveRelativeToConfig(const std::string& value) {
return ResolveRelativeTo(ResolveConfigPath().parent_path(), value);
}
// The extracted DATA directory. Empty when nothing is configured.
inline std::filesystem::path ResolvedDvdRoot() {
const std::string configured = DvdRoot();
return configured.empty() ? std::filesystem::path{} : ResolveRelativeToConfig(configured);
}
/// The canonical Retro Rewind installation the frontend owns, or "" when none is recorded.
inline std::string RetroRewindRoot(std::string fallback = "") {
return Get().retroRewindRoot.value_or(std::move(fallback));
}
inline bool DiscordPresenceEnabled(bool fallback = true) {
return Get().discordPresenceEnabled.value_or(fallback);
}
inline std::string DiscordClientId(std::string fallback = "1543984562369990706") {
return Get().discordClientId.value_or(std::move(fallback));
}
inline const std::vector<std::string>& OverlayRoots() {
return Get().overlayRoots;
}
inline void LogLoadedConfig() {
static const bool logged = [] {
const auto& config = Get();
const auto configPath = ResolveConfigPath();
std::cout << "[runtime-config] " << PathToUtf8(configPath);
if (!std::filesystem::exists(configPath)) {
std::cout << " not found; using built-in defaults";
} else {
std::cout << " loaded";
if (config.widescreen) {
std::cout << " widescreen=" << (*config.widescreen ? "true" : "false");
}
if (config.windowWidth || config.windowHeight) {
std::cout << " window=" << config.windowWidth.value_or(0) << "x"
<< config.windowHeight.value_or(0);
}
if (config.resolutionMultiplier) {
std::cout << " resolution_multiplier=" << *config.resolutionMultiplier;
}
if (config.dvdRoot) {
std::cout << " dvd_root=" << *config.dvdRoot;
}
if (config.graphicsApi) {
std::cout << " graphics_api=" << *config.graphicsApi;
}
if (config.frameInterpolationFps) {
std::cout << " frame_interpolation_fps=" << *config.frameInterpolationFps;
}
if (config.skipUnreadyPipelines) {
std::cout << " skip_unready_pipelines=" << (*config.skipUnreadyPipelines ? "true" : "false");
}
if (config.disableCopyFilter) {
std::cout << " disable_copy_filter=" << (*config.disableCopyFilter ? "true" : "false");
}
if (config.showFps) {
std::cout << " show_fps=" << (*config.showFps ? "true" : "false");
}
if (config.textureReplacements) {
std::cout << " texture_replacements=" << (*config.textureReplacements ? "true" : "false");
}
if (config.textureDumps) {
std::cout << " texture_dumps=" << (*config.textureDumps ? "true" : "false");
}
if (config.vrEnabled) {
std::cout << " vr_enabled=" << (*config.vrEnabled ? "true" : "false");
}
if (config.vrRequired) {
std::cout << " vr_required=" << (*config.vrRequired ? "true" : "false");
}
if (config.audioVolume) {
std::cout << " audio_volume=" << *config.audioVolume;
}
if (config.audioMuted) {
std::cout << " audio_muted=" << (*config.audioMuted ? "true" : "false");
}
if (config.networkEnabled) {
std::cout << " network_enabled=" << (*config.networkEnabled ? "true" : "false");
}
if (config.discordPresenceEnabled) {
std::cout << " discord_enabled=" << (*config.discordPresenceEnabled ? "true" : "false");
}
if (config.nandRoot) {
std::cout << " nand_root=" << *config.nandRoot;
}
if (config.retroRewindRoot) {
std::cout << " retro_rewind_root=" << *config.retroRewindRoot;
}
}
std::cout << std::endl;
return true;
}();
(void)logged;
}
} // namespace RuntimeConfigFile