vtkVRCamera.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 vtkVRCamera_h
#define vtkVRCamera_h
 
#include "vtkDeprecation.h" // for VTK_DEPRECATED_IN_9_2_0
#include "vtkNew.h"         // for iavr
#include "vtkOpenGLCamera.h"
#include "vtkRenderingVRModule.h" // For export macro
 
VTK_ABI_NAMESPACE_BEGIN
class vtkMatrix4x4;
class vtkVRRenderWindow;
 
class VTKRENDERINGVR_EXPORT vtkVRCamera : public vtkOpenGLCamera
{
public:
  vtkTypeMacro(vtkVRCamera, vtkOpenGLCamera);
 
  VTK_DEPRECATED_IN_9_2_0("use GetPhysicalToProjectionMatrix instead")
  virtual void GetTrackingToDCMatrix(vtkMatrix4x4*& physicalToProjectionMatrix)
  {
    this->GetPhysicalToProjectionMatrix(physicalToProjectionMatrix);
  };
  virtual void GetPhysicalToProjectionMatrix(vtkMatrix4x4*& physicalToProjectionMatrix) = 0;
 
  // A pose in VR includes more than just the basic camera values.
  // It includes all the properties needed to reproduce a view
  // in physical space when requested from a different physical space
  // This class stores those properties
  // As the VR code is still being rearchitected this signature
  // may change slightly through the end of 2021.
  class Pose
  {
  public:
    double Position[3];
    double PhysicalViewUp[3];
    double PhysicalViewDirection[3];
    double ViewDirection[3];
    double Translation[3];
    double Distance;
    double MotionFactor = 1.0;
  };
 
  // Fill in a Pose object based on the current camera and physical space
  // settings. As the VR code is still being rearchitected this signature
  // may change slightly through the end of 2021.
  void SetPoseFromCamera(Pose* pose, vtkVRRenderWindow* win);
 
  // Reproduce a pose using the current camera and render window. That is, try
  // to make the viewer's current view look like the original saved pose.
  // This is complicated by the fact that the viewer may now occupy a very
  // different position and orientation in the physical space than when the
  // pose was saved. This method accounts for this and adjusts the phjsical
  // space to best fit the requested pose.
  // As the VR code is still being rearchitected this signature
  // may change slightly through the end of 2021.
  void ApplyPoseToCamera(Pose* pose, vtkVRRenderWindow* win);
 
  // Set the camera's ivars based on a user provided matrix. The goal here
  // is to make it so that the camera is consistent with the provided matrix
  // and when the world to pose/view matrix is requested would return the
  // same matrix as provided.
  void SetCameraFromWorldToDeviceMatrix(vtkMatrix4x4* mat, double distance);
  void SetCameraFromDeviceToWorldMatrix(vtkMatrix4x4* mat, double distance);
 
protected:
  vtkVRCamera();
  ~vtkVRCamera() override;
 
  vtkNew<vtkMatrix4x4> TempMatrix4x4;
 
private:
  vtkVRCamera(const vtkVRCamera&) = delete;
  void operator=(const vtkVRCamera&) = delete;
};
 
VTK_ABI_NAMESPACE_END
#endif
/* VTK-HeaderTest-Exclude: vtkVRCamera.h */