vtkSynchronizedRenderers.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
// SPDX-License-Identifier: BSD-3-Clause
 
#ifndef vtkSynchronizedRenderers_h
#define vtkSynchronizedRenderers_h
 
#include "vtkIndependentViewerCollection.h" // needed for vtkIndependentViewerCollection
#include "vtkObject.h"
#include "vtkRenderingParallelModule.h" // For export macro
#include "vtkSmartPointer.h"            // needed for vtkSmartPointer.
#include "vtkUnsignedCharArray.h"       // needed for vtkUnsignedCharArray.
 
#include <memory> // for std::unique_ptr
 
VTK_ABI_NAMESPACE_BEGIN
class vtkFXAAOptions;
class vtkRenderer;
class vtkMultiProcessController;
class vtkMultiProcessStream;
class vtkOpenGLFXAAFilter;
class vtkOpenGLRenderer;
 
class VTKRENDERINGPARALLEL_EXPORT vtkSynchronizedRenderers : public vtkObject
{
public:
  static vtkSynchronizedRenderers* New();
  vtkTypeMacro(vtkSynchronizedRenderers, vtkObject);
  void PrintSelf(ostream& os, vtkIndent indent) override;


  virtual void SetRenderer(vtkRenderer*);
  virtual vtkRenderer* GetRenderer();


  vtkSetObjectMacro(IndependentViewers, vtkIndependentViewerCollection);
  vtkGetObjectMacro(IndependentViewers, vtkIndependentViewerCollection);


  virtual void SetParallelController(vtkMultiProcessController*);
  vtkGetObjectMacro(ParallelController, vtkMultiProcessController);


  vtkSetMacro(ParallelRendering, bool);
  vtkGetMacro(ParallelRendering, bool);
  vtkBooleanMacro(ParallelRendering, bool);


  vtkSetClampMacro(ImageReductionFactor, int, 1, 50);
  vtkGetMacro(ImageReductionFactor, int);


  vtkSetMacro(WriteBackImages, bool);
  vtkGetMacro(WriteBackImages, bool);
  vtkBooleanMacro(WriteBackImages, bool);


  vtkSetMacro(RootProcessId, int);
  vtkGetMacro(RootProcessId, int);

  void CollectiveExpandForVisiblePropBounds(double bounds[6]);


  virtual void SetCaptureDelegate(vtkSynchronizedRenderers*);
  vtkGetObjectMacro(CaptureDelegate, vtkSynchronizedRenderers);


  void EnableSynchronizableActors(bool);


  vtkSetMacro(AutomaticEventHandling, bool);
  vtkGetMacro(AutomaticEventHandling, bool);
  vtkBooleanMacro(AutomaticEventHandling, bool);


  vtkSetMacro(FixBackground, bool);
  vtkGetMacro(FixBackground, bool);
  vtkBooleanMacro(FixBackground, bool);
 
  enum
  {
    SYNC_RENDERER_TAG = 15101,
    RESET_CAMERA_TAG = 15102,
    COMPUTE_BOUNDS_TAG = 15103
  };

  struct VTKRENDERINGPARALLEL_EXPORT vtkRawImage
  {
  public:
    vtkRawImage()
    {
      this->Valid = false;
      this->Size[0] = this->Size[1] = 0;
      this->Data = vtkSmartPointer<vtkUnsignedCharArray>::New();
    }
 
    void Resize(int dx, int dy, int numcomps)
    {
      this->Valid = false;
      this->Allocate(dx, dy, numcomps);
    }

    void Initialize(int dx, int dy, vtkUnsignedCharArray* data);
 
    void MarkValid() { this->Valid = true; }
    void MarkInValid() { this->Valid = false; }
 
    bool IsValid() { return this->Valid; }
    int GetWidth() { return this->Size[0]; }
    int GetHeight() { return this->Size[1]; }
    vtkUnsignedCharArray* GetRawPtr() { return this->Data; }

    bool PushToViewport(vtkRenderer* renderer, bool blend = true);

    bool PushToFrameBuffer(vtkRenderer* ren, bool blend = true);
 
    // Captures the image from the viewport.
    // This doesn't trigger a render, just captures what's currently there in
    // the active buffer.
    bool Capture(vtkRenderer*);
 
    // Save the image as a png. Useful for debugging.
    void SaveAsPNG(VTK_FILEPATH const char* filename);
 
  private:
    bool Valid;
    int Size[2];
    vtkSmartPointer<vtkUnsignedCharArray> Data;
 
    void Allocate(int dx, int dy, int numcomps);
  };
 
protected:
  vtkSynchronizedRenderers();
  ~vtkSynchronizedRenderers() override;
 
  struct RendererInfo
  {
    int ImageReductionFactor;
    int Draw;
    int CameraParallelProjection;
    double Viewport[4];
    double CameraPosition[3];
    double CameraFocalPoint[3];
    double CameraViewUp[3];
    double CameraWindowCenter[2];
    double CameraClippingRange[2];
    double CameraViewAngle;
    double CameraParallelScale;
    double CameraEyeSeparation;
    double EyeTransformMatrix[16];
    double ModelTransformMatrix[16];
 
    // Save/restore the struct to/from a stream.
    void Save(vtkMultiProcessStream& stream);
    bool Restore(vtkMultiProcessStream& stream);
 
    void CopyFrom(vtkRenderer*);
    void CopyTo(vtkRenderer*);
  };
 
  // These methods are called on all processes as a consequence of corresponding
  // events being called on the renderer.
  virtual void HandleStartRender();
  virtual void HandleEndRender();
  virtual void HandleAbortRender() {}
 
  virtual void MasterStartRender();
  virtual void SlaveStartRender();
 
  virtual void MasterEndRender();
  virtual void SlaveEndRender();
 
  vtkMultiProcessController* ParallelController;
  vtkOpenGLRenderer* Renderer;
  vtkIndependentViewerCollection* IndependentViewers = nullptr;

  virtual vtkRawImage& CaptureRenderedImage();

  virtual void PushImageToScreen();
 
  vtkSynchronizedRenderers* CaptureDelegate;
  vtkRawImage Image;
 
  bool ParallelRendering;
  int ImageReductionFactor;
  bool WriteBackImages;
  int RootProcessId;
  bool AutomaticEventHandling;
 
private:
  vtkSynchronizedRenderers(const vtkSynchronizedRenderers&) = delete;
  void operator=(const vtkSynchronizedRenderers&) = delete;
 
  class vtkObserver;
  vtkObserver* Observer;
  friend class vtkObserver;
 
  bool UseFXAA;
  vtkOpenGLFXAAFilter* FXAAFilter;
 
  double LastViewport[4];
 
  double LastBackground[3];
  double LastBackgroundAlpha;
  bool LastTexturedBackground;
  bool LastGradientBackground;
  bool FixBackground;
 
  class vtkInternals;
  std::unique_ptr<vtkInternals> Internal;
};
 
VTK_ABI_NAMESPACE_END
#endif