add audio toolbar and AudioVolumeSlider widget

Author: nschimme

src/CMakeLists.txt

@@ -242,6 +242,8 @@ set(mmapper_SRCS
     group/mmapper2group.h
     logger/autologger.cpp
     logger/autologger.h
+    mainwindow/AudioVolumeSlider.cpp
+    mainwindow/AudioVolumeSlider.h
     mainwindow/MapZoomSlider.cpp
     mainwindow/MapZoomSlider.h
     mainwindow/UpdateDialog.cpp

src/group/mmapper2group.cpp

@@ -30,7 +30,7 @@ Mmapper2Group::Mmapper2Group(QObject *const parent)
     , m_groupManagerApi{std::make_unique<GroupManagerApi>(*this)}
 {}
 
-Mmapper2Group::~Mmapper2Group() {}
+Mmapper2Group::~Mmapper2Group() = default;
 
 SharedGroupChar Mmapper2Group::getSelf()
 {

src/mainwindow/AudioVolumeSlider.cpp

@@ -0,0 +1,98 @@
+// SPDX-License-Identifier: GPL-2.0-or-later
+// Copyright (C) 2026 The MMapper Authors
+
+#include "AudioVolumeSlider.h"
+
+#include "../configuration/configuration.h"
+#include "../global/SignalBlocker.h"
+
+#include <QWheelEvent>
+
+AudioVolumeSlider::AudioVolumeSlider(QWidget *const parent)
+    : QSlider(Qt::Orientation::Horizontal, parent)
+{
+    init();
+}
+
+AudioVolumeSlider::AudioVolumeSlider(AudioType type, QWidget *const parent)
+    : QSlider(Qt::Orientation::Horizontal, parent)
+    , m_type(type)
+{
+    init();
+}
+
+AudioVolumeSlider::~AudioVolumeSlider() = default;
+
+void AudioVolumeSlider::init()
+{
+    setRange(0, 100);
+    connect(this, &QSlider::valueChanged, this, [this](int value) { updateToConfig(value); });
+
+    setConfig().audio.registerChangeCallback(m_lifetime, [this]() { updateFromConfig(); });
+
+    if constexpr (NO_AUDIO) {
+        setEnabled(false);
+    }
+    setAudioType(m_type);
+}
+
+void AudioVolumeSlider::setAudioType(AudioType type)
+{
+    if (m_type == type && toolTip().length() > 0) {
+        return;
+    }
+
+    m_type = type;
+    updateFromConfig();
+
+    switch (m_type) {
+    case AudioType::Music:
+        setToolTip(tr("Music Volume"));
+        break;
+    case AudioType::Sound:
+        setToolTip(tr("Sound Volume"));
+        break;
+    }
+}
+
+void AudioVolumeSlider::updateFromConfig()
+{
+    int actualVolume = 0;
+    switch (m_type) {
+    case AudioType::Music:
+        actualVolume = getConfig().audio.getMusicVolume();
+        break;
+    case AudioType::Sound:
+        actualVolume = getConfig().audio.getSoundVolume();
+        break;
+    }
+
+    if (value() != actualVolume) {
+        const SignalBlocker block{*this};
+        setValue(actualVolume);
+    }
+}
+
+void AudioVolumeSlider::updateToConfig(int value)
+{
+    auto &audioSettings = setConfig().audio;
+    switch (m_type) {
+    case AudioType::Music:
+        if (audioSettings.getMusicVolume() != value) {
+            audioSettings.setMusicVolume(value);
+            audioSettings.setUnlocked();
+        }
+        break;
+    case AudioType::Sound:
+        if (audioSettings.getSoundVolume() != value) {
+            audioSettings.setSoundVolume(value);
+            audioSettings.setUnlocked();
+        }
+        break;
+    }
+}
+
+void AudioVolumeSlider::wheelEvent(QWheelEvent *event)
+{
+    event->ignore();
+}

src/mainwindow/AudioVolumeSlider.h

@@ -0,0 +1,42 @@
+#pragma once
+// SPDX-License-Identifier: GPL-2.0-or-later
+// Copyright (C) 2026 The MMapper Authors
+
+#include "../global/RuleOf5.h"
+#include "../global/Signal2.h"
+#include "../global/macros.h"
+
+#include <QSlider>
+
+class NODISCARD_QOBJECT AudioVolumeSlider final : public QSlider
+{
+    Q_OBJECT
+    Q_PROPERTY(AudioType audioType READ audioType WRITE setAudioType)
+
+public:
+    enum class NODISCARD AudioType : uint8_t { Music, Sound };
+    Q_ENUM(AudioType)
+
+private:
+    Signal2Lifetime m_lifetime;
+    AudioType m_type = AudioType::Music;
+
+public:
+    explicit AudioVolumeSlider(QWidget *parent = nullptr);
+    explicit AudioVolumeSlider(AudioType type, QWidget *parent = nullptr);
+    ~AudioVolumeSlider() final;
+    DELETE_CTORS_AND_ASSIGN_OPS(AudioVolumeSlider);
+
+public:
+    NODISCARD AudioType audioType() const { return m_type; }
+    void setAudioType(AudioType type);
+
+    void updateFromConfig();
+
+protected:
+    void wheelEvent(QWheelEvent *event) override;
+
+private:
+    void init();
+    void updateToConfig(int value);
+};

src/mainwindow/MapZoomSlider.cpp

@@ -6,6 +6,8 @@
 #include "../display/mapwindow.h"
 #include "../global/SignalBlocker.h"
 
+#include <QWheelEvent>
+
 MapZoomSlider::~MapZoomSlider() = default;
 
 int MapZoomSlider::calcPos(const float zoom) noexcept
@@ -49,3 +51,8 @@ void MapZoomSlider::setFromActual()
         setValue(clamp(rounded));
     }
 }
+
+void MapZoomSlider::wheelEvent(QWheelEvent *event)
+{
+    event->ignore();
+}

src/mainwindow/MapZoomSlider.h

@@ -31,6 +31,9 @@ class NODISCARD_QOBJECT MapZoomSlider final : public QSlider
 
     void setFromActual();
 
+protected:
+    void wheelEvent(QWheelEvent *event) override;
+
 private:
     static int clamp(int val) { return std::clamp(val, min, max); }
 };

src/mainwindow/mainwindow.cpp

@@ -33,6 +33,7 @@
 #include "../roompanel/RoomManager.h"
 #include "../roompanel/RoomWidget.h"
 #include "../viewers/TopLevelWindows.h"
+#include "AudioVolumeSlider.h"
 #include "MapZoomSlider.h"
 #include "UpdateDialog.h"
 #include "aboutdialog.h"
@@ -1185,6 +1186,7 @@ void MainWindow::setupMenuBar()
     toolbars->addAction(roomToolBar->toggleViewAction());
     toolbars->addAction(connectionToolBar->toggleViewAction());
     toolbars->addAction(settingsToolBar->toggleViewAction());
+    toolbars->addAction(audioToolBar->toggleViewAction());
     QMenu *sidepanels = viewMenu->addMenu(tr("&Side Panels"));
     sidepanels->addAction(m_dockDialogLog->toggleViewAction());
     sidepanels->addAction(m_dockDialogClient->toggleViewAction());
@@ -1428,6 +1430,15 @@ void MainWindow::setupToolBars()
     settingsToolBar->setObjectName("PreferencesToolBar");
     settingsToolBar->addAction(preferencesAct);
     settingsToolBar->hide();
+
+    audioToolBar = addToolBar(tr("Audio"));
+    audioToolBar->setObjectName("AudioToolBar");
+    audioToolBar->addWidget(
+        new AudioVolumeSlider(AudioVolumeSlider::AudioType::Music, audioToolBar));
+    audioToolBar->addSeparator();
+    audioToolBar->addWidget(
+        new AudioVolumeSlider(AudioVolumeSlider::AudioType::Sound, audioToolBar));
+    audioToolBar->hide();
 }
 
 void MainWindow::setupStatusBar()

src/mainwindow/mainwindow.h

@@ -135,6 +135,7 @@ class NODISCARD_QOBJECT MainWindow final : public QMainWindow
     QToolBar *roomToolBar = nullptr;
     QToolBar *connectionToolBar = nullptr;
     QToolBar *settingsToolBar = nullptr;
+    QToolBar *audioToolBar = nullptr;
 
     QMenu *fileMenu = nullptr;
     QMenu *editMenu = nullptr;

src/media/DescriptionWidget.h

@@ -19,8 +19,8 @@ class NODISCARD_QOBJECT DescriptionWidget final : public QWidget
 private:
     MediaLibrary &m_library;
 
-    QLabel *m_label;
-    QTextEdit *m_textEdit;
+    QLabel *m_label = nullptr;
+    QTextEdit *m_textEdit = nullptr;
 
 private:
     QCache<QString, QImage> m_imageCache;

src/media/MediaLibrary.h

@@ -33,8 +33,8 @@ class NODISCARD_QOBJECT MediaLibrary final : public QObject
 public:
     explicit MediaLibrary(QObject *parent = nullptr);
 
-    QString findAudio(const QString &subDir, const QString &name) const;
-    QString findImage(const QString &subDir, const QString &name) const;
+    NODISCARD QString findAudio(const QString &subDir, const QString &name) const;
+    NODISCARD QString findImage(const QString &subDir, const QString &name) const;
 
     void fetchAsync(const QString &path, std::function<void(const QByteArray &)> callback);