File indexing completed on 2024-12-01 09:52:16

 /*
     This file is part of the KDE libraries
     SPDX-FileCopyrightText: 2006 Hamish Rodda <rodda@kde.org>
 
     SPDX-License-Identifier: LGPL-2.0-only
 */
 
 #ifndef KICONENGINE_H
 #define KICONENGINE_H
 
 #include "kiconthemes_export.h"
 #include <QIconEngine>
 #include <QPointer>
 
 class KIconColors;
 class KIconLoader;
 class KIconEnginePrivate;
 
 /**
  * @class KIconEngine kiconengine.h KIconEngine
  *
  * \short A class to provide rendering of KDE icons.
  *
  * Currently, this class is not much more than a wrapper around QIconEngine.
  * However, it should not be difficult to extend with features such as SVG
  * rendered icons.
  *
  * Icon themes specifying a KDE-Extensions string list setting, will limit
  * themselves to checking these extensions exclusively, in the order specified
  * in the setting.
  *
  * @author Hamish Rodda <rodda@kde.org>
  */
 class KICONTHEMES_EXPORT KIconEngine : public QIconEngine // exported for kdelibs4support's KIcon and plasma integration
 {
 public:
     /**
      * Constructs an icon engine for a KDE named icon.
      *
      * @param iconName the name of the icon to load
      * @param iconLoader The KDE icon loader that this engine is to use.
      * @param overlays Add one or more overlays to the icon. See KIconLoader::Overlays.
      *
      * @sa KIconLoader
      */
     KIconEngine(const QString &iconName, KIconLoader *iconLoader, const QStringList &overlays);
 
     /**
      * \overload
      */
     KIconEngine(const QString &iconName, KIconLoader *iconLoader);
 
     /**
      * Constructs an icon engine for a KDE named icon with a specific palette.
      *
      * @param iconName the name of the icon to load
      * @param colors defines the colors we want to be applied on this icon
      * @param iconLoader The KDE icon loader that this engine is to use.
      */
     KIconEngine(const QString &iconName, const KIconColors &colors, KIconLoader *iconLoader);
 
     /**
      * Destructor.
      */
     ~KIconEngine() override;
 
     /// Reimplementation
     QSize actualSize(const QSize &size, QIcon::Mode mode, QIcon::State state) override;
     /// Reimplementation
     void paint(QPainter *painter, const QRect &rect, QIcon::Mode mode, QIcon::State state) override;
     /// Reimplementation
     QPixmap pixmap(const QSize &size, QIcon::Mode mode, QIcon::State state) override;
 
     /// Reimplementation
     QString iconName() const override;
     /// Reimplementation
     QList<QSize> availableSizes(QIcon::Mode mode, QIcon::State state) const override;
 
     QString key() const override;
     QIconEngine *clone() const override;
     bool read(QDataStream &in) override;
     bool write(QDataStream &out) const override;
 
     void virtual_hook(int id, void *data) override;
 
 private:
     // TODO KF6: move those into the d-pointer
     QPixmap createPixmap(const QSize &size, qreal scale, QIcon::Mode mode, QIcon::State state);
     QString mIconName;
     QStringList mOverlays;
     KIconEnginePrivate *const d;
 };
 
 #endif