qgspainteffectregistry.h

Go to the documentation of this file.

/***************************************************************************
                             qgspainteffectregistry.h
                             ------------------------
    begin                : January 2015
    copyright            : (C) 2015 Nyall Dawson
    email                : nyall dot dawson at gmail dot com
 ***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/
 
#ifndef QGSPAINTEFFECTREGISTRY_H
#define QGSPAINTEFFECTREGISTRY_H
 
#include "qgis_core.h"
#include "qgis_sip.h"
 
#include <QDomDocument>
#include <QDomElement>
#include <QMap>
#include <QVariantMap>
 
class QgsPaintEffect;
class QgsPaintEffectWidget SIP_EXTERNAL;

class CORE_EXPORT QgsPaintEffectAbstractMetadata
{
  public:

    QgsPaintEffectAbstractMetadata( const QString &name, const QString &visibleName );
 
    virtual ~QgsPaintEffectAbstractMetadata() = default;

    QString name() const { return mName; }

    QString visibleName() const { return mVisibleName; }

    virtual QgsPaintEffect *createPaintEffect( const QVariantMap &map ) = 0 SIP_FACTORY;

    virtual QgsPaintEffectWidget *createWidget() SIP_FACTORY { return nullptr; }
 
  protected:
    QString mName;
    QString mVisibleName;
 
};
 
typedef QgsPaintEffect *( *QgsPaintEffectCreateFunc )( const QVariantMap & ) SIP_SKIP;
typedef QgsPaintEffectWidget *( *QgsPaintEffectWidgetFunc )() SIP_SKIP;

class CORE_EXPORT QgsPaintEffectMetadata : public QgsPaintEffectAbstractMetadata SIP_SKIP
{
 
  public:

    QgsPaintEffectMetadata( const QString &name, const QString &visibleName,
                            QgsPaintEffectCreateFunc pfCreate,
                            QgsPaintEffectWidgetFunc pfWidget = nullptr ) SIP_SKIP
  : QgsPaintEffectAbstractMetadata( name, visibleName )
    , mCreateFunc( pfCreate )
    , mWidgetFunc( pfWidget )
    {}

    QgsPaintEffectCreateFunc createFunction() const SIP_SKIP { return mCreateFunc; }

    QgsPaintEffectWidgetFunc widgetFunction() const SIP_SKIP { return mWidgetFunc; }

    void setWidgetFunction( QgsPaintEffectWidgetFunc f ) SIP_SKIP { mWidgetFunc = f; }

    QgsPaintEffect *createPaintEffect( const QVariantMap &map ) override SIP_SKIP { return mCreateFunc ? mCreateFunc( map ) : nullptr; }

    QgsPaintEffectWidget *createWidget() override SIP_FACTORY SIP_SKIP { return mWidgetFunc ? mWidgetFunc() : nullptr; }
 
  protected:
    QgsPaintEffectCreateFunc mCreateFunc;
    QgsPaintEffectWidgetFunc mWidgetFunc;
};
 

class CORE_EXPORT QgsPaintEffectRegistry
{
  public:
 
    QgsPaintEffectRegistry();
    ~QgsPaintEffectRegistry();
 
    QgsPaintEffectRegistry( const QgsPaintEffectRegistry &rh ) = delete;
    QgsPaintEffectRegistry &operator=( const QgsPaintEffectRegistry &rh ) = delete;

    QgsPaintEffectAbstractMetadata *effectMetadata( const QString &name ) const;

    bool addEffectType( QgsPaintEffectAbstractMetadata *metadata SIP_TRANSFER );

    QgsPaintEffect *createEffect( const QString &name, const QVariantMap &properties = QVariantMap() ) const SIP_FACTORY;

    QgsPaintEffect *createEffect( const QDomElement &element ) const SIP_FACTORY;

    QStringList effects() const;

    static QgsPaintEffect *defaultStack() SIP_FACTORY;

    static bool isDefaultStack( QgsPaintEffect *effect );
 
  private:
#ifdef SIP_RUN
    QgsPaintEffectRegistry( const QgsPaintEffectRegistry &rh );
#endif
 
    QMap<QString, QgsPaintEffectAbstractMetadata *> mMetadata;
};
 
#endif //QGSPAINTEFFECTREGISTRY_H