vtkInteractorStyleUnicam.h

Go to the documentation of this file.

/*=========================================================================
 
  Program:   Visualization Toolkit
  Module:    vtkInteractorStyleUnicam.h
 
  Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
  All rights reserved.
  See Copyright.txt or http://www.kitware.com/Copyright.htm 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.
 
=========================================================================*/
 
/*
 * This work (vtkInteractorStyleUnicam.h) was produced under a grant from
 * the Department of Energy to Brown University.  Neither Brown University
 * nor the authors assert any copyright with respect to this work and it may
 * be used, reproduced, and distributed without permission.
 */
 
#ifndef vtkInteractorStyleUnicam_h
#define vtkInteractorStyleUnicam_h
 
#include "vtkInteractionStyleModule.h" // For export macro
#include "vtkInteractorStyle.h"
 
class vtkCamera;
class vtkWorldPointPicker;
 
#ifndef VTK_LEGACY_REMOVE
// Replaced with the enum types in the `vtkInteractorStyleUnicam` class.
 
// buttons pressed
#define VTK_UNICAM_NONE 0
#define VTK_UNICAM_BUTTON_LEFT 1
#define VTK_UNICAM_BUTTON_MIDDLE 2
#define VTK_UNICAM_BUTTON_RIGHT 3
//
// camera modes
#define VTK_UNICAM_CAM_INT_ROT 0
#define VTK_UNICAM_CAM_INT_CHOOSE 1
#define VTK_UNICAM_CAM_INT_PAN 2
#define VTK_UNICAM_CAM_INT_DOLLY 3
#endif
 
class VTKINTERACTIONSTYLE_EXPORT vtkInteractorStyleUnicam : public vtkInteractorStyle
{
public:
  enum
  {
    NONE = 0,
    BUTTON_LEFT = 1,
    BUTTON_MIDDLE = 2,
    BUTTON_RIGHT = 3
  };
  enum
  {
    CAM_INT_ROT = 0,
    CAM_INT_CHOOSE = 1,
    CAM_INT_PAN = 2,
    CAM_INT_DOLLY = 3
  };
 
  static vtkInteractorStyleUnicam* New();
  vtkTypeMacro(vtkInteractorStyleUnicam, vtkInteractorStyle);
  void PrintSelf(ostream& os, vtkIndent indent) override;
 
  void SetWorldUpVector(double a[3]) { this->SetWorldUpVector(a[0], a[1], a[2]); }
  void SetWorldUpVector(double x, double y, double z);
  vtkGetVectorMacro(WorldUpVector, double, 3);
 
 
  void OnMouseMove() override;
  void OnLeftButtonDown() override;
  void OnLeftButtonUp() override;
  virtual void OnLeftButtonMove();
 
  void OnTimer() override;
 
protected:
  vtkInteractorStyleUnicam();
  ~vtkInteractorStyleUnicam() override;
 
  vtkWorldPointPicker* InteractionPicker;
 
  int ButtonDown;     // which button is down
  double DTime;       // time mouse button was pressed
  double Dist;        // distance the mouse has moved since button press
  double StartPix[2]; // pixel mouse movement started at
  double LastPos[2];  // normalized position of mouse last frame
  double LastPix[2];  // pixel position of mouse last frame
  double DownPt[3];   // 3D point under cursor when mouse button pressed
  double Center[3];   // center of camera rotation
 
  double WorldUpVector[3]; // what the world thinks the 'up' vector is
 
  vtkActor* FocusSphere;            // geometry for indicating center of rotation
  int IsDot;                        // flag-- is the FocusSphere being displayed?
  vtkRenderer* FocusSphereRenderer; // renderer for 'FocusSphere'
 
  int state; // which navigation mode was selected?
 
  void ChooseXY(int X, int Y); // method for choosing type of navigation
  void RotateXY(int X, int Y); // method for rotating
  void DollyXY(int X, int Y);  // method for dollying
  void PanXY(int X, int Y);    // method for panning
 
  // conveinence methods for translating & rotating the camera
  void MyTranslateCamera(double v[3]);
  void MyRotateCamera(
    double cx, double cy, double cz, double ax, double ay, double az, double angle);
 
  // Given a 3D point & a vtkCamera, compute the vectors that extend
  // from the projection of the center of projection to the center of
  // the right-edge and the center of the top-edge onto the plane
  // containing the 3D point & with normal parallel to the camera's
  // projection plane.
  void GetRightVandUpV(double* p, vtkCamera* cam, double* rightV, double* upV);
 
  // takes in pixels, returns normalized window coordinates
  void NormalizeMouseXY(int X, int Y, double* NX, double* NY);
 
  // return the aspect ratio of the current window
  double WindowAspect();
 
private:
  vtkInteractorStyleUnicam(const vtkInteractorStyleUnicam&) = delete;
  void operator=(const vtkInteractorStyleUnicam&) = delete;
};
 
#endif // vtkInteractorStyleUnicam_h