vtkPVPluginTracker.h

Go to the documentation of this file.

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

  Program:   ParaView
  Module:    vtkPVPluginTracker.h

  Copyright (c) Kitware, Inc.
  All rights reserved.
  See Copyright.txt or http://www.paraview.org/HTML/Copyright.html for details.

     This software is distributed WITHOUT ANY WARRANTY; without even
     the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
     PURPOSE.  See the above copyright notice for more information.

=========================================================================*/
#ifndef vtkPVPluginTracker_h
#define vtkPVPluginTracker_h

#include "vtkCommand.h" // needed for vtkCommand
#include "vtkObject.h"
#include "vtkRemotingCoreModule.h" // needed for exports
#include "vtkSmartPointer.h"       // needed for vtkSmartPointer

#include <vector> // for std::vector

class vtkPVPlugin;
class vtkPVXMLElement;

typedef bool (*vtkPluginSearchFunction)(const char*);
typedef void (*vtkPluginListFunction)(const char* appname, std::vector<std::string>& names);

class VTKREMOTINGCORE_EXPORT vtkPVPluginTracker : public vtkObject
{
public:
  static vtkPVPluginTracker* New();
  vtkTypeMacro(vtkPVPluginTracker, vtkObject);
  void PrintSelf(ostream& os, vtkIndent indent) override;

  static vtkPVPluginTracker* GetInstance();

  void RegisterPlugin(vtkPVPlugin*);

  unsigned int RegisterAvailablePlugin(const char* filename);


  void LoadPluginConfigurationXMLs(const char* appname);
  void LoadPluginConfigurationXML(const char* filename, bool forceLoad = false);
  void LoadPluginConfigurationXML(vtkPVXMLElement*, bool forceLoad = false);
  void LoadPluginConfigurationXMLFromString(const char* xmlcontents, bool forceLoad = false);

  unsigned int GetNumberOfPlugins();

  vtkPVPlugin* GetPlugin(unsigned int index);


  const char* GetPluginName(unsigned int index);
  const char* GetPluginFileName(unsigned int index);
  bool GetPluginLoaded(unsigned int index);
  bool GetPluginAutoLoad(unsigned int index);


  static void RegisterStaticPluginSearchFunction(vtkPluginSearchFunction function);
  static void RegisterStaticPluginListFunction(vtkPluginListFunction function);
#ifndef VTK_LEGACY_REMOVE
  static VTK_LEGACY(void SetStaticPluginSearchFunction(vtkPluginSearchFunction function));
#endif


  enum
  {
    RegisterAvailablePluginEvent = vtkCommand::UserEvent + 91
  };

protected:
  vtkPVPluginTracker();
  ~vtkPVPluginTracker() override;

private:
  vtkPVPluginTracker(const vtkPVPluginTracker&) = delete;
  void operator=(const vtkPVPluginTracker&) = delete;

  class vtkPluginsList;
  vtkPluginsList* PluginsList;

  void LoadPluginConfigurationXMLConf(std::string const& exe_dir, std::string const& conf);
  void LoadPluginConfigurationXMLHinted(vtkPVXMLElement*, const char* hint, bool forceLoad);
};

#endif

// VTK-HeaderTest-Exclude: vtkPVPluginTracker.h