vtkSMRemoteObject.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: Copyright (c) Kitware Inc.
// SPDX-License-Identifier: BSD-3-Clause
#ifndef vtkSMRemoteObject_h
#define vtkSMRemoteObject_h
 
#include "vtkRemotingServerManagerModule.h" //needed for exports
#include "vtkSMMessageMinimal.h"            // needed for vtkSMMessage
#include "vtkSMSessionObject.h"
#include "vtkWeakPointer.h" // needed for vtkWeakPointer
 
class vtkClientServerStream;
class vtkSMSession;
class vtkSMProxyLocator;
class vtkSMLoadStateContext;
 
class VTKREMOTINGSERVERMANAGER_EXPORT vtkSMRemoteObject : public vtkSMSessionObject
{
  // My friends are...
  friend class vtkSMStateHelper; // To pull state
  friend class vtkSMStateLoader; // To set GlobalId as the originals
 
public:
  vtkTypeMacro(vtkSMRemoteObject, vtkSMSessionObject);
  void PrintSelf(ostream& os, vtkIndent indent) override;
 
 
  vtkSetMacro(Location, vtkTypeUInt32);
  vtkGetMacro(Location, vtkTypeUInt32);
 
  void SetSession(vtkSMSession*) override;
 
 
  virtual vtkTypeUInt32 GetGlobalID();
  const char* GetGlobalIDAsString();
 
  bool HasGlobalID();
 
 
  vtkBooleanMacro(Prototype, bool);
  bool IsPrototype() { return this->Prototype; }
  vtkSetMacro(Prototype, bool);
 
  virtual const vtkSMMessage* GetFullState() { return nullptr; }
 
 
  virtual void LoadState(const vtkSMMessage* msg, vtkSMProxyLocator* locator)
  {
    (void)msg;
    (void)locator;
  }
 
  virtual void EnableLocalPushOnly();
 
  virtual void DisableLocalPushOnly();
 
  virtual bool IsLocalPushOnly() { return this->ClientOnlyLocationFlag; }
 
protected:
  vtkSMRemoteObject();
 
  ~vtkSMRemoteObject() override;
 
  void PushState(vtkSMMessage* msg);
 
  bool PullState(vtkSMMessage* msg);
 
  void SetGlobalID(vtkTypeUInt32 guid);
 
  // Global-ID for this vtkSMRemoteObject. This is assigned when needed.
  // Assigned at :
  // - First push
  // - or when the RemoteObject is created by the ProcessModule remotely.
  // - or when state is loaded from protobuf messages
  vtkTypeUInt32 GlobalID;
 
  // Location flag identify the processes on which the vtkSIObject
  // corresponding to this vtkSMRemoteObject exist.
  vtkTypeUInt32 Location;
 
  // Allow remote object to be discard for any state management such as
  // Undo/Redo, Register/UnRegister (in ProxyManager) and so on...
  bool Prototype;
 
  // Field that store the Disable/EnableLocalPushOnly() state information
  bool ClientOnlyLocationFlag;
 
  // Convenient method used to return either the local Location or a filtered
  // version of it based on the ClientOnlyLocationFlag
  vtkTypeUInt32 GetFilteredLocation();
 
private:
  vtkSMRemoteObject(const vtkSMRemoteObject&) = delete;
  void operator=(const vtkSMRemoteObject&) = delete;
 
  char* GlobalIDString;
};
 
class VTKREMOTINGSERVERMANAGER_EXPORT SIOBJECT
{
  vtkSMRemoteObject* Reference;
  friend VTKREMOTINGSERVERMANAGER_EXPORT vtkClientServerStream& operator<<(
    vtkClientServerStream& stream, const SIOBJECT& manipulator);
 
public:
  SIOBJECT(vtkSMRemoteObject* rmobject)
    : Reference(rmobject)
  {
  }
};
 
VTKREMOTINGSERVERMANAGER_EXPORT vtkClientServerStream& operator<<(
  vtkClientServerStream& stream, const SIOBJECT& manipulator);
 
#endif // #ifndef vtkSMRemoteObject_h