// SPDX-FileCopyrightText: 2002-2024 PCSX2 Dev Team // SPDX-License-Identifier: LGPL-3.0+ #include "MainWindow.h" #include "QtHost.h" #include "QtUtils.h" #include "Settings/AchievementSettingsWidget.h" #include "Settings/AdvancedSettingsWidget.h" #include "Settings/AudioSettingsWidget.h" #include "Settings/BIOSSettingsWidget.h" #include "Settings/DEV9SettingsWidget.h" #include "Settings/DebugSettingsWidget.h" #include "Settings/EmulationSettingsWidget.h" #include "Settings/FolderSettingsWidget.h" #include "Settings/GameCheatSettingsWidget.h" #include "Settings/GameFixSettingsWidget.h" #include "Settings/GameListSettingsWidget.h" #include "Settings/GamePatchSettingsWidget.h" #include "Settings/GameSummaryWidget.h" #include "Settings/GraphicsSettingsWidget.h" #include "Settings/HotkeySettingsWidget.h" #include "Settings/InterfaceSettingsWidget.h" #include "Settings/MemoryCardSettingsWidget.h" #include "SettingsWindow.h" #include "pcsx2/Achievements.h" #include "pcsx2/GameList.h" #include "pcsx2/Host.h" #include "pcsx2/INISettingsInterface.h" #include "common/FileSystem.h" #include "common/Path.h" #include "common/StringUtil.h" #include #include #include #include static QList s_open_game_properties_dialogs; SettingsWindow::SettingsWindow() : QWidget(nullptr) , m_disc_crc(0) { setupUi(nullptr); } SettingsWindow::SettingsWindow(std::unique_ptr sif, const GameList::Entry* game, std::string serial, u32 disc_crc, QString filename) : QWidget(nullptr) , m_sif(std::move(sif)) , m_filename(std::move(filename)) , m_game_list_filename(game ? game->path : std::string()) , m_serial(std::move(serial)) , m_disc_crc(disc_crc) { setupUi(game); s_open_game_properties_dialogs.push_back(this); } SettingsInterface* SettingsWindow::getSettingsInterface() const { return m_sif.get(); } void SettingsWindow::setupUi(const GameList::Entry* game) { const bool show_advanced_settings = QtHost::ShouldShowAdvancedSettings(); m_ui.setupUi(this); setWindowFlags(windowFlags() & ~Qt::WindowContextHelpButtonHint); if (isPerGameSettings()) { QString summary = tr("Summary
This page shows details about the selected game. Changing the Input " "Profile will set the controller binding scheme for this game to whichever profile is chosen, instead " "of the default (Shared) configuration. The track list and dump verification can be used to determine " "if your disc image matches a known good dump. If it does not match, the game may be broken."); if (game) { addWidget(new GameSummaryWidget(game, this, m_ui.settingsContainer), tr("Summary"), QStringLiteral("file-list-line"), std::move(summary)); } else { QLabel* placeholder_label = new QLabel(tr("Summary is unavailable for files not present in game list."), m_ui.settingsContainer); placeholder_label->setAlignment(Qt::AlignLeft | Qt::AlignTop); addWidget(placeholder_label, tr("Summary"), QStringLiteral("file-list-line"), std::move(summary)); } m_ui.restoreDefaultsButton->setVisible(false); m_ui.footerLayout->removeWidget(m_ui.restoreDefaultsButton); m_ui.restoreDefaultsButton->deleteLater(); m_ui.restoreDefaultsButton = nullptr; } else { m_ui.copyGlobalSettingsButton->setVisible(false); m_ui.footerLayout->removeWidget(m_ui.copyGlobalSettingsButton); m_ui.copyGlobalSettingsButton->deleteLater(); m_ui.copyGlobalSettingsButton = nullptr; m_ui.clearGameSettingsButton->setVisible(false); m_ui.footerLayout->removeWidget(m_ui.clearGameSettingsButton); m_ui.clearGameSettingsButton->deleteLater(); m_ui.clearGameSettingsButton = nullptr; } addWidget(m_interface_settings = new InterfaceSettingsWidget(this, m_ui.settingsContainer), tr("Interface"), QStringLiteral("interface-line"), tr("Interface Settings
These options control how the software looks and behaves.

Mouse over an option " "for additional information, and Shift+Wheel to scroll this panel.")); // We don't include game list/bios settings in per-game settings. if (!isPerGameSettings()) { addWidget(m_game_list_settings = new GameListSettingsWidget(this, m_ui.settingsContainer), tr("Game List"), QStringLiteral("folder-open-line"), tr("Game List Settings
The list above shows the directories which will be searched by PCSX2 to populate " "the game list. Search directories can be added, removed, and switched to recursive/non-recursive.")); addWidget(m_bios_settings = new BIOSSettingsWidget(this, m_ui.settingsContainer), tr("BIOS"), QStringLiteral("chip-line"), tr("BIOS Settings
Configure your BIOS here.

Mouse over an option for additional information, " "and Shift+Wheel to scroll this panel.")); } // Common to both per-game and global settings. addWidget(m_emulation_settings = new EmulationSettingsWidget(this, m_ui.settingsContainer), tr("Emulation"), QStringLiteral("emulation-line"), tr("Emulation Settings
These options determine the configuration of frame pacing and game " "settings.

Mouse over an option for additional information, and Shift+Wheel to scroll this panel.")); if (isPerGameSettings()) { addWidget(m_game_patch_settings_widget = new GamePatchSettingsWidget(this, m_ui.settingsContainer), tr("Patches"), QStringLiteral("band-aid-line"), tr("Patches
This section allows you to select optional patches to apply to the game, " "which may provide performance, visual, or gameplay improvements.")); addWidget(m_game_cheat_settings_widget = new GameCheatSettingsWidget(this, m_ui.settingsContainer), tr("Cheats"), QStringLiteral("cheats-line"), tr("Cheats
This section allows you to select which cheats you wish to enable. You " "cannot enable/disable cheats without labels for old-format pnach files, those will automatically " "activate if the main cheat enable option is checked.")); } // Only show the game fixes for per-game settings, there's really no reason to be setting them globally. if (show_advanced_settings && isPerGameSettings()) { addWidget(m_game_fix_settings_widget = new GameFixSettingsWidget(this, m_ui.settingsContainer), tr("Game Fixes"), QStringLiteral("tools-line"), tr("Game Fixes Settings
Game Fixes can work around incorrect emulation in some titles.
However, they can " "also cause problems in games if used incorrectly.
It is best to leave them all disabled unless advised otherwise.")); } addWidget(m_graphics_settings = new GraphicsSettingsWidget(this, m_ui.settingsContainer), tr("Graphics"), QStringLiteral("image-fill"), tr("Graphics Settings
These options determine the configuration of the graphical output.

Mouse over an " "option for additional information, and Shift+Wheel to scroll this panel.")); addWidget(m_audio_settings = new AudioSettingsWidget(this, m_ui.settingsContainer), tr("Audio"), QStringLiteral("volume-up-line"), tr("Audio Settings
These options control the audio output of the console.

Mouse over an option for " "additional information, and Shift+Wheel to scroll this panel.")); addWidget(m_memory_card_settings = new MemoryCardSettingsWidget(this, m_ui.settingsContainer), tr("Memory Cards"), QStringLiteral("memcard-line"), tr("Memory Card Settings
Create and configure Memory Cards here.

Mouse over an option for " "additional information, and Shift+Wheel to scroll this panel.")); addWidget(m_dev9_settings = new DEV9SettingsWidget(this, m_ui.settingsContainer), tr("Network & HDD"), QStringLiteral("global-line"), tr("Network & HDD Settings
These options control the network connectivity and internal HDD storage of the " "console.

Mouse over an option for additional information, and Shift+Wheel to scroll this panel.")); if (!isPerGameSettings()) { addWidget(m_folder_settings = new FolderSettingsWidget(this, m_ui.settingsContainer), tr("Folders"), QStringLiteral("folder-settings-line"), tr("Folder Settings
These options control where PCSX2 will save runtime data files.")); } { QString title = tr("Achievements"); QString icon_text(QStringLiteral("trophy-line")); QString help_text = tr("Achievements Settings
" "These options control the RetroAchievements implementation in PCSX2, allowing you to earn achievements in your games."); if (Achievements::IsUsingRAIntegration()) { QLabel* placeholder_label = new QLabel(tr("RAIntegration is being used, built-in RetroAchievements support is disabled."), m_ui.settingsContainer); placeholder_label->setAlignment(Qt::AlignLeft | Qt::AlignTop); addWidget(placeholder_label, std::move(title), std::move(icon_text), std::move(help_text)); } else { addWidget((m_achievement_settings = new AchievementSettingsWidget(this, m_ui.settingsContainer)), std::move(title), std::move(icon_text), std::move(help_text)); } } if (show_advanced_settings) { addWidget(m_advanced_settings = new AdvancedSettingsWidget(this, m_ui.settingsContainer), tr("Advanced"), QStringLiteral("warning-line"), tr("Advanced Settings
These are advanced options to determine the configuration of the simulated " "console.

Mouse over an option for additional information, and Shift+Wheel to scroll this panel.")); addWidget(m_debug_settings = new DebugSettingsWidget(this, m_ui.settingsContainer), tr("Debug"), QStringLiteral("debugger-line"), tr("Debug Settings
These are options which can be used to log internal information about the application. " "Do not modify unless you know what you are doing, it will cause significant slowdown, and can waste large " "amounts of disk space.")); } m_ui.settingsCategory->setSizePolicy(QSizePolicy::Minimum, QSizePolicy::Minimum); m_ui.settingsCategory->setCurrentRow(0); m_ui.settingsContainer->setCurrentIndex(0); m_ui.helpText->setText(m_category_help_text[0]); connect(m_ui.settingsCategory, &QListWidget::currentRowChanged, this, &SettingsWindow::onCategoryCurrentRowChanged); connect(m_ui.closeButton, &QPushButton::clicked, this, &SettingsWindow::close); if (m_ui.restoreDefaultsButton) connect(m_ui.restoreDefaultsButton, &QPushButton::clicked, this, &SettingsWindow::onRestoreDefaultsClicked); if (m_ui.copyGlobalSettingsButton) connect(m_ui.copyGlobalSettingsButton, &QPushButton::clicked, this, &SettingsWindow::onCopyGlobalSettingsClicked); if (m_ui.clearGameSettingsButton) connect(m_ui.clearGameSettingsButton, &QPushButton::clicked, this, &SettingsWindow::onClearSettingsClicked); } SettingsWindow::~SettingsWindow() { if (isPerGameSettings()) s_open_game_properties_dialogs.removeOne(this); } void SettingsWindow::closeEvent(QCloseEvent*) { // we need to clean up ourselves, since we're not modal if (isPerGameSettings()) deleteLater(); } QString SettingsWindow::getCategory() const { return m_ui.settingsCategory->item(m_ui.settingsCategory->currentRow())->text(); } void SettingsWindow::setCategory(const char* category) { // the titles in the category list will be translated. const QString translated_category(tr(category)); for (int i = 0; i < m_ui.settingsCategory->count(); i++) { if (translated_category == m_ui.settingsCategory->item(i)->text()) { // will also update the visible widget m_ui.settingsCategory->setCurrentRow(i); break; } } } void SettingsWindow::onCategoryCurrentRowChanged(int row) { m_ui.settingsContainer->setCurrentIndex(row); m_ui.helpText->setText(m_category_help_text[row]); } void SettingsWindow::onRestoreDefaultsClicked() { QMessageBox msgbox(this); msgbox.setWindowIcon(QtHost::GetAppIcon()); msgbox.setIcon(QMessageBox::Question); msgbox.setWindowTitle(tr("Confirm Restore Defaults")); msgbox.setText(tr("Are you sure you want to restore the default settings? Any existing preferences will be lost.")); QCheckBox* ui_cb = new QCheckBox(tr("Reset UI Settings"), &msgbox); msgbox.setCheckBox(ui_cb); msgbox.addButton(QMessageBox::Yes); msgbox.addButton(QMessageBox::No); msgbox.setDefaultButton(QMessageBox::Yes); if (msgbox.exec() != QMessageBox::Yes) return; g_main_window->resetSettings(ui_cb->isChecked()); } void SettingsWindow::onCopyGlobalSettingsClicked() { if (!isPerGameSettings()) return; if (QMessageBox::question(this, tr("PCSX2 Settings"), tr("The configuration for this game will be replaced by the current global settings.\n\nAny current setting values will be " "overwritten.\n\nDo you want to continue?"), QMessageBox::Yes, QMessageBox::No) != QMessageBox::Yes) { return; } { auto lock = Host::GetSettingsLock(); Pcsx2Config::CopyConfiguration(m_sif.get(), *Host::Internal::GetBaseSettingsLayer()); Pcsx2Config::ClearInvalidPerGameConfiguration(m_sif.get()); } saveAndReloadGameSettings(); reopen(tr("Per-game configuration copied from global settings.")); } void SettingsWindow::onClearSettingsClicked() { if (!isPerGameSettings()) return; if (QMessageBox::question(this, tr("PCSX2 Settings"), tr("The configuration for this game will be cleared.\n\nAny current setting values will be lost.\n\nDo you want to continue?"), QMessageBox::Yes, QMessageBox::No) != QMessageBox::Yes) { return; } m_game_cheat_settings_widget->disableAllCheats(); m_game_patch_settings_widget->disableAllPatches(); Pcsx2Config::ClearConfiguration(m_sif.get()); saveAndReloadGameSettings(); reopen(tr("Per-game configuration cleared.")); } void SettingsWindow::reopen(const QString& message) { // This doesn't work for global settings, because MainWindow maintains a pointer. if (!m_sif) return; // After closing, this pointer is freed. So we need to grab everything early. std::unique_ptr new_sif = std::make_unique(m_sif->GetFileName()); if (FileSystem::FileExists(new_sif->GetFileName().c_str())) new_sif->Load(); auto lock = GameList::GetLock(); const GameList::Entry* game = m_game_list_filename.empty() ? nullptr : GameList::GetEntryForPath(m_game_list_filename.c_str()); SettingsWindow* dlg = new SettingsWindow(std::move(new_sif), game, m_serial, m_disc_crc, m_filename); dlg->QWidget::setWindowTitle(windowTitle()); // See note above. QtHost::RunOnUIThread([this, dlg, message]() { close(); dlg->show(); if (!message.isEmpty()) QMessageBox::information(dlg, tr("PCSX2 Settings"), message); }); } void SettingsWindow::addWidget(QWidget* widget, QString title, QString icon, QString help_text) { const int index = m_ui.settingsCategory->count(); QListWidgetItem* item = new QListWidgetItem(m_ui.settingsCategory); item->setText(title); if (!icon.isEmpty()) item->setIcon(QIcon::fromTheme(icon)); m_ui.settingsContainer->addWidget(widget); m_category_help_text[index] = std::move(help_text); } void SettingsWindow::registerWidgetHelp(QObject* object, QString title, QString recommended_value, QString text) { if (!object) return; // construct rich text with formatted description QString full_text; full_text += "
"; full_text += title; full_text += ""; full_text += tr("Recommended Value"); full_text += ": "; full_text += recommended_value; full_text += "

"; full_text += text; m_widget_help_text_map[object] = std::move(full_text); object->installEventFilter(this); } bool SettingsWindow::eventFilter(QObject* object, QEvent* event) { if (event->type() == QEvent::Enter) { auto iter = m_widget_help_text_map.constFind(object); if (iter != m_widget_help_text_map.end()) { m_current_help_widget = object; m_ui.helpText->setText(iter.value()); } } else if (event->type() == QEvent::Leave) { if (m_current_help_widget) { m_current_help_widget = nullptr; m_ui.helpText->setText(m_category_help_text[m_ui.settingsCategory->currentRow()]); } } else if (event->type() == QEvent::Wheel) { if (handleWheelEvent(static_cast(event))) return true; } return QWidget::eventFilter(object, event); } bool SettingsWindow::handleWheelEvent(QWheelEvent* event) { if (!(event->modifiers() & Qt::ShiftModifier)) return false; const int amount = event->hasPixelDelta() ? event->pixelDelta().y() : (event->angleDelta().y() / 20); QScrollBar* sb = m_ui.helpText->verticalScrollBar(); if (!sb) return false; sb->setSliderPosition(std::max(sb->sliderPosition() - amount, 0)); return true; } void SettingsWindow::wheelEvent(QWheelEvent* event) { if (handleWheelEvent(event)) return; QWidget::wheelEvent(event); } void SettingsWindow::setWindowTitle(const QString& title) { if (m_filename.isEmpty()) QWidget::setWindowTitle(title); else QWidget::setWindowTitle(QStringLiteral("%1 [%2]").arg(title, m_filename)); } bool SettingsWindow::getEffectiveBoolValue(const char* section, const char* key, bool default_value) const { bool value; if (m_sif && m_sif->GetBoolValue(section, key, &value)) return value; else return Host::GetBaseBoolSettingValue(section, key, default_value); } int SettingsWindow::getEffectiveIntValue(const char* section, const char* key, int default_value) const { int value; if (m_sif && m_sif->GetIntValue(section, key, &value)) return value; else return Host::GetBaseIntSettingValue(section, key, default_value); } float SettingsWindow::getEffectiveFloatValue(const char* section, const char* key, float default_value) const { float value; if (m_sif && m_sif->GetFloatValue(section, key, &value)) return value; else return Host::GetBaseFloatSettingValue(section, key, default_value); } std::string SettingsWindow::getEffectiveStringValue(const char* section, const char* key, const char* default_value) const { std::string value; if (!m_sif || !m_sif->GetStringValue(section, key, &value)) value = Host::GetBaseStringSettingValue(section, key, default_value); return value; } std::optional SettingsWindow::getBoolValue(const char* section, const char* key, std::optional default_value) const { std::optional value; if (m_sif) { bool bvalue; if (m_sif->GetBoolValue(section, key, &bvalue)) value = bvalue; else value = default_value; } else { value = Host::GetBaseBoolSettingValue(section, key, default_value.value_or(false)); } return value; } std::optional SettingsWindow::getIntValue(const char* section, const char* key, std::optional default_value) const { std::optional value; if (m_sif) { int ivalue; if (m_sif->GetIntValue(section, key, &ivalue)) value = ivalue; else value = default_value; } else { value = Host::GetBaseIntSettingValue(section, key, default_value.value_or(0)); } return value; } std::optional SettingsWindow::getFloatValue(const char* section, const char* key, std::optional default_value) const { std::optional value; if (m_sif) { float fvalue; if (m_sif->GetFloatValue(section, key, &fvalue)) value = fvalue; else value = default_value; } else { value = Host::GetBaseFloatSettingValue(section, key, default_value.value_or(0.0f)); } return value; } std::optional SettingsWindow::getStringValue( const char* section, const char* key, std::optional default_value) const { std::optional value; if (m_sif) { std::string svalue; if (m_sif->GetStringValue(section, key, &svalue)) value = std::move(svalue); else if (default_value.has_value()) value = default_value.value(); } else { value = Host::GetBaseStringSettingValue(section, key, default_value.value_or("")); } return value; } void SettingsWindow::setBoolSettingValue(const char* section, const char* key, std::optional value) { if (m_sif) { value.has_value() ? m_sif->SetBoolValue(section, key, value.value()) : m_sif->DeleteValue(section, key); saveAndReloadGameSettings(); } else { value.has_value() ? Host::SetBaseBoolSettingValue(section, key, value.value()) : Host::RemoveBaseSettingValue(section, key); Host::CommitBaseSettingChanges(); g_emu_thread->applySettings(); } } void SettingsWindow::setIntSettingValue(const char* section, const char* key, std::optional value) { if (m_sif) { value.has_value() ? m_sif->SetIntValue(section, key, value.value()) : m_sif->DeleteValue(section, key); saveAndReloadGameSettings(); } else { value.has_value() ? Host::SetBaseIntSettingValue(section, key, value.value()) : Host::RemoveBaseSettingValue(section, key); Host::CommitBaseSettingChanges(); g_emu_thread->applySettings(); } } void SettingsWindow::setFloatSettingValue(const char* section, const char* key, std::optional value) { if (m_sif) { value.has_value() ? m_sif->SetFloatValue(section, key, value.value()) : m_sif->DeleteValue(section, key); saveAndReloadGameSettings(); } else { value.has_value() ? Host::SetBaseFloatSettingValue(section, key, value.value()) : Host::RemoveBaseSettingValue(section, key); Host::CommitBaseSettingChanges(); g_emu_thread->applySettings(); } } void SettingsWindow::setStringSettingValue(const char* section, const char* key, std::optional value) { if (m_sif) { value.has_value() ? m_sif->SetStringValue(section, key, value.value()) : m_sif->DeleteValue(section, key); saveAndReloadGameSettings(); } else { value.has_value() ? Host::SetBaseStringSettingValue(section, key, value.value()) : Host::RemoveBaseSettingValue(section, key); Host::CommitBaseSettingChanges(); g_emu_thread->applySettings(); } } bool SettingsWindow::containsSettingValue(const char* section, const char* key) const { if (m_sif) return m_sif->ContainsValue(section, key); else return Host::ContainsBaseSettingValue(section, key); } void SettingsWindow::removeSettingValue(const char* section, const char* key) { if (m_sif) { m_sif->DeleteValue(section, key); saveAndReloadGameSettings(); } else { Host::RemoveBaseSettingValue(section, key); Host::CommitBaseSettingChanges(); g_emu_thread->applySettings(); } } void SettingsWindow::saveAndReloadGameSettings() { pxAssert(m_sif); QtHost::SaveGameSettings(m_sif.get(), true); g_emu_thread->reloadGameSettings(); } void SettingsWindow::openGamePropertiesDialog(const GameList::Entry* game, const std::string_view title, std::string serial, u32 disc_crc) { std::string filename = VMManager::GetGameSettingsPath(serial, disc_crc); // check for an existing dialog with this filename for (SettingsWindow* dialog : s_open_game_properties_dialogs) { if (dialog->isPerGameSettings() && static_cast(dialog->m_sif.get())->GetFileName() == filename) { dialog->show(); dialog->raise(); dialog->activateWindow(); dialog->setFocus(); return; } } std::unique_ptr sif = std::make_unique(filename); if (FileSystem::FileExists(sif->GetFileName().c_str())) sif->Load(); SettingsWindow* dialog = new SettingsWindow(std::move(sif), game, std::move(serial), disc_crc, QtUtils::StringViewToQString(Path::GetFileName(filename))); dialog->setWindowTitle(QtUtils::StringViewToQString(title)); dialog->show(); } void SettingsWindow::closeGamePropertiesDialogs() { for (SettingsWindow* dialog : s_open_game_properties_dialogs) { dialog->close(); dialog->deleteLater(); } }