libavogadro/src/plugin.h

/**********************************************************************
  Plugin - Avogadro Plugin Interface Base Class

  Copyright (C) 2008 Tim Vandermeersch
  Copyright (C) 2008 Donald Ephraim Curtis

  This file is part of the Avogadro molecular editor project.
  For more information, see <http://avogadro.openmolecules.net/>

  Avogadro 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.

  Avogadro is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
  02110-1301, USA.
 **********************************************************************/

#ifndef PLUGIN_H
#define PLUGIN_H

#include <avogadro/global.h>

#include <QObject>
#include <QSettings> // do not remove!!

namespace Avogadro {

  /*class A_EXPORT PluginMeta*/
  /*{*/
    /*public:*/
      /*QString className();*/
      /*QString type();*/
  /*}*/

  //class PluginPrivate;
  class A_EXPORT Plugin : public QObject
  {
    Q_OBJECT

    public:
      enum Type
      {
        EngineType = 0,
        ToolType,
        ExtensionType,
        ColorType,
        OtherType,
        TypeCount // this needs to be last always
      };

    public:
      Plugin(QObject *parent = NULL);

      virtual ~Plugin();

      virtual Plugin::Type type() const = 0;

      virtual QString identifier() const = 0;

      virtual QString name() const = 0;

      virtual QString description() const;

      virtual QString license() const;

      virtual QWidget *settingsWidget();

      virtual void writeSettings(QSettings &settings) const;

      virtual void readSettings(QSettings &settings);

    protected:
      //PluginPrivate *const d;
  };

  class A_EXPORT PluginFactory
  {
    public:
      virtual ~PluginFactory() {}

      virtual Plugin *createInstance(QObject *parent=0) = 0;

      virtual Plugin::Type type() const = 0;

      virtual QString identifier() const = 0;

      virtual QString name() const = 0;

      virtual QString description() const = 0;
  };

} // end namespace Avogadro

Q_DECLARE_METATYPE(Avogadro::Plugin*)
Q_DECLARE_INTERFACE(Avogadro::PluginFactory,
                    "net.sourceforge.avogadro.pluginfactory/1.4")

#endif

---