/usr/include/paraview/pqPluginManager.h

/*=========================================================================

   Program: ParaView
   Module:    pqPluginManager.h

   Copyright (c) 2005-2008 Sandia Corporation, Kitware Inc.
   All rights reserved.

   ParaView is a free software; you can redistribute it and/or modify it
   under the terms of the ParaView license version 1.2. 

   See License_v1.2.txt for the full ParaView license.
   A copy of this license can be obtained by contacting
   Kitware Inc.
   28 Corporate Drive
   Clifton Park, NY 12065
   USA

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

=========================================================================*/

#ifndef _pqPluginManager_h
#define _pqPluginManager_h

#include <QObject>
#include <QStringList>
#include "pqCoreModule.h"

class pqServer;
class vtkSMPluginManager;
class vtkPVPluginsInformation;

/// pqPluginManager works with vtkSMPluginManager to keep track for plugins
/// loaded/available. It also ensures that when a new session is created, the
/// default plugin-configuration-xmls are parsed on all processes involved to
/// ensure that auto-load plugins are loaded. It preserves the information about
/// plugins loaded across ParaView sessions in settings so that users can easily
/// load previously loaded plugins.
///
/// pqPluginManager can work with multiple sessions. It maintains internal
/// data-structures for different sessions.
class PQCORE_EXPORT pqPluginManager : public QObject
{
  Q_OBJECT
  typedef QObject Superclass;
public:
  pqPluginManager(QObject* p = 0);
  ~pqPluginManager();

  /// Called during application initialization to load plugins from settings.
  /// This only loads "local" plugins. pqApplicationCore calls this method
  /// explicitly after the essential components of the core have been
  /// initialized. This ensures that any plugins  being loaded during startup of
  /// application have the environment setup correctly.
  void loadPluginsFromSettings();

  enum LoadStatus { LOADED, NOTLOADED, ALREADYLOADED };

  /// attempt to load an extension on a server
  /// if server is NULL, extension will be loaded on client side
  /// return status on success, if NOTLOADED was returned, the error is reported
  /// If errorMsg is non-null, then errors are not reported, but the error
  /// message is put in the errorMsg string
  LoadStatus loadExtension(pqServer* session, const QString& lib, 
    QString* errorMsg=0, bool remote=true);

  /// attempt to load all available plugins on a server, 
  /// or client plugins if NULL
  void loadExtensions(pqServer*);

  /// return all the plugins loaded on a session. This will either returns the
  /// plugins information for local processes or server-process (for remote
  /// sessions) based on the state of \c remote.
  vtkPVPluginsInformation* loadedExtensions(pqServer* session, bool remote);

  /// Return all the paths that plugins will be searched for.
  QStringList pluginPaths(pqServer* session, bool remote);

  /// simply adds the plugin to the ignore list, so when this class tries to
  /// serialize the plugin information, it skips the indicated plugin.
  void hidePlugin(const QString& lib, bool remote);
  bool isHidden(const QString& lib, bool remote);

  /// ensures that plugins required on client and server are present on both.
  /// Fires requiredPluginsNotLoaded() signal if any mismatch is found.
  /// Returns true is all plugin requirements are satisfied, else returns false.
  bool verifyPlugins(pqServer* session);

signals:
  /// notification when plugin has been loaded.
  void pluginsUpdated();

  /// notification that the plugins on the client and
  /// server are mismatched.
  void requiredPluginsNotLoaded(pqServer*);

protected:
  void initialize(vtkSMPluginManager*);

protected slots:
  /// attempts to load the configuration for plugins for the particular server.
  void loadPluginsFromSettings(pqServer*);

  void onServerConnected(pqServer*);
  void onServerDisconnected(pqServer*);
  void updatePluginLists();

private:
  class pqInternals;
  pqInternals* Internals;
};

#endif
paraview-dev 5.0.1+dfsg1-4 / usr / include / paraview / pqPluginManager.h
