Cockatrice/cockatrice/src/interface/pixel_map_generator.h

/**
 * @file pixel_map_generator.h
 * @ingroup UI
 */
//! \todo Document this file.

#ifndef PIXMAPGENERATOR_H
#define PIXMAPGENERATOR_H

#include "libcockatrice/protocol/pb/serverinfo_user.pb.h"

#include <QHash>
#include <QIcon>
#include <QLoggingCategory>
#include <QMap>
#include <QPixmap>
#include <QString>
#include <QStringView>
#include <libcockatrice/network/server/remote/user_level.h>
#include <optional>

class QSize;

inline Q_LOGGING_CATEGORY(PixelMapGeneratorLog, "pixel_map_generator");

class PhasePixmapGenerator
{
private:
    static QMap<QString, QPixmap> pmCache;

public:
    static QPixmap generatePixmap(int size, QString name);
    static void clear()
    {
        pmCache.clear();
    }
};

class CounterPixmapGenerator
{
private:
    static QMap<QString, QPixmap> pmCache;

public:
    static QPixmap generatePixmap(int size, QString name, bool highlight);
    static void clear()
    {
        pmCache.clear();
    }
};

class PingPixmapGenerator
{
private:
    static QMap<int, QPixmap> pmCache;

public:
    static QPixmap generatePixmap(int size, int value, int max);
    static void clear()
    {
        pmCache.clear();
    }
};

class CountryPixmapGenerator
{
private:
    static QMap<QString, QPixmap> pmCache;

public:
    static QPixmap generatePixmap(int height, const QString &countryCode);
    static void clear()
    {
        pmCache.clear();
    }
};

class UserLevelPixmapGenerator
{
private:
    static QMap<QString, QIcon> iconCache;

    static QIcon generateIconDefault(int height, UserLevelFlags userLevel, bool isBuddy, const QString &privLevel);
    static QIcon generateIconWithColorOverride(int height,
                                               bool isBuddy,
                                               const UserLevelFlags &userLevelFlags,
                                               const QString &privLevel,
                                               const std::optional<QString> &colorLeft,
                                               const std::optional<QString> &colorRight);

public:
    static QPixmap generatePixmap(int height,
                                  UserLevelFlags userLevel,
                                  ServerInfo_User::PawnColorsOverride pawnColors,
                                  bool isBuddy,
                                  const QString &privLevel);

    static QIcon generateIcon(int minHeight,
                              UserLevelFlags userLevel,
                              ServerInfo_User::PawnColorsOverride pawnColors,
                              bool isBuddy,
                              const QString &privLevel);
    static void clear()
    {
        iconCache.clear();
    }
};

class DropdownIconPixmapGenerator
{
private:
    static QMap<QString, QPixmap> pmCache;

public:
    static QPixmap generatePixmap(int height, bool expanded);
    static void clear()
    {
        pmCache.clear();
    }
};

class ManaSymbolPixmapGenerator
{
private:
    static QHash<QString, QPixmap> masterCache;
    static QHash<QString, QPixmap> scaledCache;

    /**
     * @brief Renders \a symbol once at a fixed moderate size, so repeated scalings never
     * re-rasterize the source file (SVG sources can be very expensive to rasterize).
     */
    static const QPixmap &masterIcon(const QString &symbol);

public:
    /**
     * @brief Returns a smooth-scaled rendering of the given mana symbol icon.
     *
     * Results are shared between all callers via a process-wide cache keyed by symbol
     * and size, so scaling work is done once per distinct combination instead of once
     * per widget creation or resize.
     */
    static QPixmap generatePixmap(const QString &symbol, const QSize &size);
    static void clear()
    {
        masterCache.clear();
        scaledCache.clear();
    }
};

// Returns a "theme:" asset (with no file extension in prefix), preferring the
// scheme-qualified variant (prefix-dark / prefix-light, resolved via
// ThemeManager::assetPath) and falling back to the plain asset. Token-driven
// SVGs resolve their `currentColor` sentinel from the palette. Use for
// scheme-sensitive pixmaps like backgrounds, the card back, and the app logo.
QPixmap themePixmap(QStringView prefix);

// Clears every PixmapGenerator's static cache so scheme variants are
// re-resolved when the active theme or color scheme changes.
void clearPixmapGeneratorCaches();

#endif