File indexing completed on 2024-05-12 15:59:51

 /*
  *  SPDX-FileCopyrightText: 2020 Dmitry Kazakov <dimula73@gmail.com>
  *
  *  SPDX-License-Identifier: GPL-2.0-or-later
  */
 #ifndef KISRESOURCESINTERFACE_H
 #define KISRESOURCESINTERFACE_H
 
 #include "kritaresources_export.h"
 
 #include <QScopedPointer>
 #include <KoResource.h>
 #include <QHash>
 #include <KoResourceLoadResult.h>
 
 class QString;
 class QByteArray;
 class KisResourcesInterfacePrivate;
 
 /**
  * @brief a provider-like interface class for accessing resource sources in Krita.
  *
  * Main differences to KoResourceServer and KisResourceModel:
  *
  *  1) It is a polymorphic class. Therefore, we are not obliged to pass
        a pointer to the global gui-only resource storage everywhere. Instead,
        we can create temporary storages and pass them to the strokes, when needed.
 
     2) The class doesn't depend on any specific resource types. Its baseline
        implementation of resourceInterface->source(type) returns a source
        working with KoResourceSP only. But when needed, the caller may request
        a typed version via resourcesInterface->source<KisBrush>(type). It
        will instantiate a templated wrapper **in the caller's** object file,
        not in kritaresources library. It solves linking problem:
        we have a source for KisBrush objects in kritaresources library,
        even though this library doesn't link kritabrush.
 
     3) Since strokes may have local storages for the resources, we operate
        with resources sources using shared pointers, not raw pointers.
  */
 class KRITARESOURCES_EXPORT KisResourcesInterface
 {
 public:
     class KRITARESOURCES_EXPORT ResourceSourceAdapter
     {
     public:
         ResourceSourceAdapter(const QString &type);
         virtual ~ResourceSourceAdapter();
 //protected:
         friend class KisResourcesInterface;
         virtual QVector<KoResourceSP> resourcesForFilename(const QString& filename) const = 0;
         virtual QVector<KoResourceSP> resourcesForName(const QString& name) const = 0;
         virtual QVector<KoResourceSP> resourcesForMD5(const QString& md5) const = 0;
 public:
         /**
          * @brief bestMatch retrieves a resource, prefarably by md5, but with filename and name
          * as fallback for older files that do not store the md5sum. If the resource is
          * not found by md5 and the md5 isn't empty, then it will try to fallback to searching
          * by filename, but will show a warning in case sanity checks are enabled.
          *
          * If multiple resources with the same md5 exist, then it prefers the one
          * with the same filename and name.
          *
          * @return a resource, or 0 of the resource doesn't exist.
          */
 
         KoResourceSP bestMatch(const QString md5, const QString filename, const QString name);
 
         /**
          * Same as bestMatch(), but returns KoResourceLoadResult. In case the
          * resource is not found in the backend storage, the load-result
          * will be set in FailedLink state
          *
          */
         KoResourceLoadResult bestMatchLoadResult(const QString md5, const QString filename, const QString name);
 
         virtual KoResourceSP fallbackResource() const = 0;
 
     private:
         Q_DISABLE_COPY(ResourceSourceAdapter);
         const QString m_type;
     };
 
     template <typename T>
     class TypedResourceSourceAdapter
     {
     public:
         TypedResourceSourceAdapter(ResourceSourceAdapter *adapter)
             : m_source(adapter)
         {
         }
 private:
         QVector<QSharedPointer<T>> resourcesForFilename(const QString& filename) const
         {
             QVector<QSharedPointer<T>> r;
             Q_FOREACH(KoResourceSP resource, m_source->resourcesForFilename(filename)) {
                 r << resource.dynamicCast<T>();
             }
             return r;
         }
 
         QVector<QSharedPointer<T>> resourcesForName(const QString& name) const
         {
             QVector<QSharedPointer<T>> r;
             Q_FOREACH(KoResourceSP resource, m_source->resourcesForName(name)) {
                 r << resource.dynamicCast<T>();
             }
             return r;
         }
 
         QVector<QSharedPointer<T>> resourcesForMD5(const QString& md5) const
         {
             QVector<QSharedPointer<T>> r;
             Q_FOREACH(KoResourceSP resource, m_source->resourcesForMD5(md5)) {
                 r << resource.dynamicCast<T>();
             }
             return r;
         }
 public:
         /**
          * @brief resource retrieves a resource, prefarably by md5, but with filename and name
          * as fallback for older files that do not store the md5sum. Note that if the resource is
          * not found by md5 if the md5 isn't empty, we do NOT then look by filename.
          *
          * If multiple resources with the same md5 exist, then it prefers the one
          * with the same filename and name.
          *
          * @return a resource, or 0 of the resource doesn't exist.
          */
 
         QSharedPointer<T>  bestMatch(const QString md5, const QString filename, const QString name) {
             return m_source->bestMatch(md5, filename, name).dynamicCast<T>();
         }
 
         /**
          * Same as bestMatch(), but returns KoResourceLoadResult. In case the
          * resource is not found in the backend storage, the load-result
          * will be set in FailedLink state
          *
          */
         KoResourceLoadResult bestMatchLoadResult(const QString md5, const QString filename, const QString name) {
             return m_source->bestMatchLoadResult(md5, filename, name);
         }
 
         QSharedPointer<T> fallbackResource() const
         {
             return m_source->fallbackResource().dynamicCast<T>();
         }
 
     protected:
         ResourceSourceAdapter *m_source;
     };
 
 public:
     KisResourcesInterface();
     virtual ~KisResourcesInterface();
 
     /**
      * A basic implementation that returns a source for a specific type
      * of the resource. Please take into account that this source object will
      * return un-casted resources of type KoResourceSP. If you want to have a
      * proper resource (in most of the cases), use a `server<T>(type)` instead.
      */
     ResourceSourceAdapter& source(const QString &type) const;
 
     /**
      * The main fetcher of resource source for resources of a specific type.
      *
      * Usage:
      *
      * \code{.cpp}
      *
      * auto source = resourceInterface->source<KisBrush>(ResourceType::Brushes);
      * KisBrushSP brush = source.resourceByMd5(md5)
      *
      * \endcode
      *
      */
     template<typename T>
     TypedResourceSourceAdapter<T> source(const QString &type) const {
         return TypedResourceSourceAdapter<T>(&this->source(type));
     }
 
 protected:
     KisResourcesInterface(KisResourcesInterfacePrivate *dd);
     virtual ResourceSourceAdapter* createSourceImpl(const QString &type) const = 0;
 
 protected:
     QScopedPointer<KisResourcesInterfacePrivate> d_ptr;
 
 private:
     Q_DECLARE_PRIVATE(KisResourcesInterface)
 };
 
 using KisResourcesInterfaceSP = QSharedPointer<KisResourcesInterface>;
 
 #endif // KISRESOURCESINTERFACE_H