theme_manager.h

Go to the documentation of this file.

 
#ifndef THEMEMANAGER_H
#define THEMEMANAGER_H
 
#include "theme_config.h"
 
#include <QBrush>
#include <QColor>
#include <QLoggingCategory>
#include <QMap>
#include <QObject>
#include <QPalette>
#include <QString>
#include <QStringView>
#include <array>
#include <qtmetamacros.h>
 
inline Q_LOGGING_CATEGORY(ThemeManagerLog, "theme_manager");
 
typedef QMap<QString, QString> QStringMap;
typedef QMap<int, QBrush> QBrushMap;
 
class ThemeManager : public QObject
{
    Q_OBJECT
public:
    ThemeManager(QObject *parent = nullptr);
 
    enum Role
    {
        MinRole = 0,
        Hand = MinRole,
        Stack,
        Table,
        Player,
        MaxRole = Player,
    };
 
private:
    QString defaultStyleName;
    // Pristine application palette captured at startup, before any custom theme
    // palette is applied. Used as the base when a theme supplies no palette, so
    // switching away from a custom palette restores the original colours.
    QPalette defaultPalette;
    QString currentThemePath;
    std::array<QBrush, Role::MaxRole + 1> brushes;
    QStringMap availableThemes;
    QMap<AppColor::Role, QColor> currentAppColors;
    /*
      Internal cache for multiple backgrounds
    */
    std::array<QBrushMap, Role::MaxRole + 1> brushesCache;
 
protected:
    void ensureThemeDirectoryExists();
    QBrush loadBrush(QString fileName, QColor fallbackColor);
    QBrush loadExtraBrush(QString fileName, QBrush &fallbackBrush);
    void applyStyleAndPalette(const QString &themeName,
                              const ThemeConfig &themeCfg,
                              const PaletteConfig &palCfg,
                              const QString &activeScheme);
 
public:
    // Resolves the directory to write theme changes to for the given theme
    // name. The resolved theme dir (user or system) is used when writable;
    // read-only system themes fall back to the user themes directory, creating
    // it if needed, so customisations never get lost on upgrade.
    static QString writableThemeDir(const QString &themeName);
    // Carries a user profile's customised "Default" theme directory over to the
    // "System" directory the theme was renamed to, so zone graphics,
    // stylesheets, palettes and theme.cfg survive the rename. Renames the
    // directory when "System" does not exist yet, otherwise merges file by
    // file without overwriting what "System" already has. No-op unless the
    // active theme is one of the two names, so a hand-made "Default" folder of
    // a user on another theme is left alone.
    static void migrateLegacyThemeDir(const QString &themesPath, const QString &currentThemeName);
    // Probe whether a directory is truly writable by trying to create and remove
    // a temporary file. QFileInfo::isWritable() on a directory is unreliable
    // (notably on Windows where UAC VirtualStore can make a system dir appear
    // writable).
    static bool isDirReallyWritable(const QString &dirPath);
    // Explicit color scheme of the theme: theme.cfg's ColorScheme setting
    // (Dark/Light), falling back to the OS color scheme when it is "System".
    bool isDarkMode(const QString &themeDirPath) const;
    // The resolved scheme of the currently active theme.
    bool isDarkModeActive() const
    {
        return isDarkMode(currentThemePath);
    }
    QStringMap &getAvailableThemes();
    // Returns the path to the currently active theme directory (empty = default)
    QString getCurrentThemePath() const
    {
        return currentThemePath;
    }
    // Load the global theme settings (style + color scheme preference)
    static ThemeConfig loadGlobalConfig(const QString &themeDirPath);
    static bool saveGlobalConfig(const QString &themeDirPath, const ThemeConfig &cfg);
 
    // Load/save per-scheme palette colors
    static PaletteConfig loadPaletteConfig(const QString &themeDirPath, const QString &colorScheme);
    static bool savePaletteConfig(const QString &themeDirPath, const QString &colorScheme, const PaletteConfig &cfg);
    // Resolve prefix to a scheme-qualified "theme:" path. Existence is probed
    // internally across the formats themes may ship (.png/.jpg/.svg), so
    // callers load the returned path directly. Prefers "<prefix>-<dark|light>"
    // when a file exists at that stem, otherwise the plain "<prefix>" as the
    // super fallback. The resolved scheme covers explicit light/dark as well
    // as OS-resolved "system". Returns the path with its file extension when a
    // match is found; unqualified assets keep working unchanged.
    QString assetPath(QStringView prefix) const;
    // Like assetPath, but resolves only the scheme-qualified variant
    // ("<prefix>-<dark|light>.<ext>") and returns an empty string when no
    // variant exists — it never falls back to the plain "<prefix>" asset.
    // Callers that must distinguish "no authored variant" (e.g. to keep a
    // legacy runtime fallback alive) should use this instead of assetPath.
    QString schemeVariantPath(QStringView prefix) const;
    // Load the theme's shipped default palette, falling back to the system
    // theme directory when it is absent from the resolved (user) directory.
    static PaletteConfig
    loadDefaultPaletteConfig(const QString &themeDirPath, const QString &themeName, const QString &colorScheme);
    static bool commitPalette(const QString &themeDirPath, const QString &colorScheme, const PaletteConfig &cfg);
    void setColorScheme(const QString &scheme);
    void setStyleName(const QString &styleName);
 
    void reloadCurrentTheme();
    void previewPalette(const PaletteConfig &cfg, const QString &scheme);
 
    // Resolves an application color role: the theme's stored [AppColors] value
    // when present, otherwise a palette-accent-derived fallback.
    QColor appColor(AppColor::Role role) const;
 
    QBrush &getBgBrush(Role zone);
    QBrush getExtraBgBrush(Role zone, int zoneId = 0);
protected slots:
    void themeChangedSlot();
signals:
    void themeChanged();
    void paletteChanged();
};
 
extern ThemeManager *themeManager;
 
#endif