vtkSIProxyDefinitionManager.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: Copyright (c) Kitware Inc.
// SPDX-License-Identifier: BSD-3-Clause
#ifndef vtkSIProxyDefinitionManager_h
#define vtkSIProxyDefinitionManager_h
 
#include "vtkRemotingServerManagerModule.h" //needed for exports
#include "vtkSIObject.h"
 
class vtkPVPlugin;
class vtkPVProxyDefinitionIterator;
class vtkPVXMLElement;
 
class VTKREMOTINGSERVERMANAGER_EXPORT vtkSIProxyDefinitionManager : public vtkSIObject
{
public:
  static vtkSIProxyDefinitionManager* New();
  vtkTypeMacro(vtkSIProxyDefinitionManager, vtkSIObject);
  void PrintSelf(ostream& os, vtkIndent indent) override;
 
  static vtkTypeUInt32 GetReservedGlobalID();
 
  static void PatchXMLProperty(vtkPVXMLElement* propElement);
 
 
  vtkPVXMLElement* GetProxyDefinition(const char* group, const char* name, bool throwError);
  vtkPVXMLElement* GetProxyDefinition(const char* group, const char* name)
  {
    // We do throw an error by default
    return this->GetProxyDefinition(group, name, true);
  }
 
  bool HasDefinition(const char* groupName, const char* proxyName);
 
 
  vtkPVXMLElement* GetCollapsedProxyDefinition(
    const char* group, const char* name, const char* subProxyName, bool throwError);
  vtkPVXMLElement* GetCollapsedProxyDefinition(
    const char* group, const char* name, const char* subProxyName)
  {
    return this->GetCollapsedProxyDefinition(group, name, subProxyName, true);
  }
 
 
  void AddCustomProxyDefinition(const char* group, const char* name, vtkPVXMLElement* top);
  void AddCustomProxyDefinition(
    const char* groupName, const char* proxyName, const char* xmlcontents);
 
  void RemoveCustomProxyDefinition(const char* group, const char* name);
 
  void ClearCustomProxyDefinitions();
 
 
  void LoadCustomProxyDefinitions(vtkPVXMLElement* root);
  void LoadCustomProxyDefinitionsFromString(const char* xmlContent);
 
  void SaveCustomProxyDefinitions(vtkPVXMLElement* root);
 
 
  bool LoadConfigurationXML(vtkPVXMLElement* root);
  bool LoadConfigurationXMLFromString(const char* xmlContent);
 
  enum Events
  {
    ProxyDefinitionsUpdated = 2000,
    CompoundProxyDefinitionsUpdated = 2001
  };
 
  enum
  {
    ALL_DEFINITIONS = 0,
    CORE_DEFINITIONS = 1,
    CUSTOM_DEFINITIONS = 2
  };
 
  VTK_NEWINSTANCE
  vtkPVProxyDefinitionIterator* NewIterator(int scope = ALL_DEFINITIONS);
 
  vtkPVProxyDefinitionIterator* NewSingleGroupIterator(
    const char* groupName, int scope = ALL_DEFINITIONS);
 
  void EnableXMLProxyDefnitionUpdate(bool);
 
  void Push(vtkSMMessage* msg) override;
 
  void Pull(vtkSMMessage* msg) override;
 
 
  struct RegisteredDefinitionInformation
  {
    const char* GroupName;
    const char* ProxyName;
    bool CustomDefinition;
    RegisteredDefinitionInformation(
      const char* groupName, const char* proxyName, bool isCustom = false)
    {
      this->GroupName = groupName;
      this->ProxyName = proxyName;
      this->CustomDefinition = isCustom;
    }
  };
 
protected:
  vtkSIProxyDefinitionManager();
  ~vtkSIProxyDefinitionManager() override;
 
  void AttachShowInMenuHintsToProxy(vtkPVXMLElement* proxy);
 
  void AttachShowInMenuHintsToProxyFromProxyGroups(vtkPVXMLElement* root);
 
 
  bool LoadConfigurationXML(vtkPVXMLElement* root, bool attachShowInMenuHints);
  bool LoadConfigurationXMLFromString(const char* xmlContent, bool attachShowInMenuHints);
 
 
  void OnPluginLoaded(vtkObject* caller, unsigned long event, void* calldata);
  void HandlePlugin(vtkPVPlugin*);
 
  void AddElement(const char* groupName, const char* proxyName, vtkPVXMLElement* element);
 
  bool AddCustomProxyDefinitionInternal(const char* group, const char* name, vtkPVXMLElement* top);
 
  void MergeProxyDefinition(vtkPVXMLElement* element, vtkPVXMLElement* elementToFill);
 
  void InvalidateCollapsedDefinition();
 
  vtkPVXMLElement* GetProxyElement(const char* groupName, const char* proxyName);
 
  vtkPVXMLElement* ExtractSubProxy(vtkPVXMLElement* proxyDefinition, const char* subProxyName);
 
  void InvokeCustomDefitionsUpdated();
 
private:
  vtkSIProxyDefinitionManager(const vtkSIProxyDefinitionManager&) = delete;
  void operator=(const vtkSIProxyDefinitionManager&) = delete;
 
  class vtkInternals;
  vtkInternals* Internals;
  vtkInternals* InternalsFlatten;
};
 
#endif