EventDisplay/BesVisLib/include/BesVisLib/BesTView.h

Go to the documentation of this file.

// @(#)root/base:$Name: BesVisLib-00-06-02 $:$Id: BesTView.h,v 1.11 2022/03/04 04:44:37 maqm
// Exp $ Author: Rene Brun, Nenad Buncic, Evgueni Tcherniaev, Olivier Couet   18/08/95
 
/*************************************************************************
 * Copyright (C) 1995-2000, Rene Brun and Fons Rademakers.               *
 * All rights reserved.                                                  *
 *                                                                       *
 * For the licensing terms see $ROOTSYS/LICENSE.                         *
 * For the list of contributors see $ROOTSYS/README/CREDITS.             *
 *************************************************************************/
 
#ifndef ROOT_BesTView
#define ROOT_BesTView
 
/////////////////////////////////////////////////////////////////////////
//                                                                     //
// BesTView                                                               //
//                                                                     //
/////////////////////////////////////////////////////////////////////////
 
#ifndef ROOT_TView
#  include "TView.h"
#endif
 
class TSeqCollection;
class TVirtualPad;
 
class BesTView : public TView {
 
protected:
  Double_t        fLatitude;       // View angle latitude
  Double_t        fLongitude;      // View angle longitude
  Double_t        fPsi;            // View angle psi
  Double_t        fDview;          // Distance from COP to COV
  Double_t        fDproj;          // Distance from COP to projection plane
  Double_t        fUpix;           // pad X size in pixels
  Double_t        fVpix;           // pad Y size in pixels
  Double_t        fTN[16];         //
  Double_t        fTB[16];         //
  Double_t        fRmax[3];        // Upper limits of object
  Double_t        fRmin[3];        // Lower limits of object
  Double_t        fUVcoord[4];     // Viewing window limits
  Double_t        fTnorm[16];      // Transformation matrix
  Double_t        fTback[16];      // Back transformation matrix
  Double_t        fX1[3];          // First coordinate of X axis
  Double_t        fX2[3];          // Second coordinate of X axis
  Double_t        fY1[3];          // First coordinate of Y axis
  Double_t        fY2[3];          // Second coordinate of Y axis
  Double_t        fZ1[3];          // First coordinate of Z axis
  Double_t        fZ2[3];          // Second coordinate of Z axis
  Int_t           fSystem;         // Coordinate system
  TSeqCollection* fOutline;        // Collection of outline's objects
  Bool_t          fDefaultOutline; // Set to TRUE if outline is default cube
  Bool_t          fAutoRange;      // Set to TRUE if range computed automatically
  Bool_t          fChanged;        //! Set to TRUE after ExecuteRotateView
 
  BesTView( const BesTView& );            // Not implemented
  BesTView& operator=( const BesTView& ); // Not implemented
 
  void ResetView( Double_t longitude, Double_t latitude, Double_t psi, Int_t& irep );
 
public:
  // BesTView status bits
  enum { kPerspective = BIT( 6 ) };
 
  BesTView();
  BesTView( Int_t system );
  BesTView( const Float_t* rmin, const Float_t* rmax, Int_t system = 1 );
  BesTView( const Double_t* rmin, const Double_t* rmax, Int_t system = 1 );
  virtual ~BesTView();
 
  virtual void    AxisVertex( Double_t ang, Double_t* av, Int_t& ix1, Int_t& ix2, Int_t& iy1,
                              Int_t& iy2, Int_t& iz1, Int_t& iz2 );
  virtual void    DefinePerspectiveView();
  virtual void    DefineViewDirection( const Double_t* s, const Double_t* c, Double_t cosphi,
                                       Double_t sinphi, Double_t costhe, Double_t sinthe,
                                       Double_t cospsi, Double_t sinpsi, Double_t* tnorm,
                                       Double_t* tback );
  virtual void    DrawOutlineCube( TList* outline, Double_t* rmin, Double_t* rmax );
  virtual void    ExecuteEvent( Int_t event, Int_t px, Int_t py );
  virtual void    ExecuteRotateView( Int_t event, Int_t px, Int_t py );
  virtual void    FindScope( Double_t* scale, Double_t* center, Int_t& irep );
  virtual Int_t   GetDistancetoAxis( Int_t axis, Int_t px, Int_t py, Double_t& ratio );
  Double_t        GetDview() const { return fDview; }
  Double_t        GetDproj() const { return fDproj; }
  Double_t        GetExtent() const;
  Bool_t          GetAutoRange() { return fAutoRange; }
  Double_t        GetLatitude() { return fLatitude; }
  Double_t        GetLongitude() { return fLongitude; }
  Double_t        GetPsi() { return fPsi; }
  virtual void    GetRange( Float_t* min, Float_t* max );
  virtual void    GetRange( Double_t* min, Double_t* max );
  Double_t*       GetRmax() { return fRmax; }
  Double_t*       GetRmin() { return fRmin; }
  TSeqCollection* GetOutline() { return fOutline; }
  Double_t*       GetTback() { return fTback; }
  Double_t*       GetTN() { return fTN; }
  Double_t*       GetTnorm() { return fTnorm; }
  Int_t           GetSystem() { return fSystem; }
  void            GetWindow( Double_t& u0, Double_t& v0, Double_t& du, Double_t& dv ) const;
  Double_t        GetWindowWidth() const { return 0.5 * ( fUVcoord[1] - fUVcoord[0] ); }
  Double_t        GetWindowHeight() const { return 0.5 * ( fUVcoord[3] - fUVcoord[2] ); }
  virtual void    FindNormal( Double_t x, Double_t y, Double_t z, Double_t& zn );
  virtual void    FindPhiSectors( Int_t iopt, Int_t& kphi, Double_t* aphi, Int_t& iphi1,
                                  Int_t& iphi2 );
  virtual void    FindThetaSectors( Int_t iopt, Double_t phi, Int_t& kth, Double_t* ath,
                                    Int_t& ith1, Int_t& ith2 );
  Bool_t          IsClippedNDC( Double_t* p ) const;
  Bool_t          IsPerspective() const { return TestBit( kPerspective ); }
  Bool_t          IsViewChanged() const { return fChanged; }
  virtual void    NDCtoWC( const Float_t* pn, Float_t* pw );
  virtual void    NDCtoWC( const Double_t* pn, Double_t* pw );
  virtual void    NormalWCtoNDC( const Float_t* pw, Float_t* pn );
  virtual void    NormalWCtoNDC( const Double_t* pw, Double_t* pn );
  virtual void    PadRange( Int_t rback );
  void            ResizePad();
  virtual void    SetAutoRange( Bool_t autorange = kTRUE ) { fAutoRange = autorange; }
  virtual void    SetAxisNDC( const Double_t* x1, const Double_t* x2, const Double_t* y1,
                              const Double_t* y2, const Double_t* z1, const Double_t* z2 );
  void            SetDefaultWindow();
  void            SetDview( Double_t dview ) { fDview = dview; }
  void            SetDproj( Double_t dproj ) { fDproj = dproj; }
  void            SetLatitude( Double_t latitude ) { fLatitude = latitude; }
  void            SetLongitude( Double_t longitude ) { fLongitude = longitude; }
  void            SetPsi( Double_t psi ) { fPsi = psi; }
  virtual void    SetOutlineToCube();
  virtual void    SetParallel();    // *MENU*
  virtual void    SetPerspective(); // *MENU*
  virtual void    SetRange( const Double_t* min, const Double_t* max );
  virtual void    SetRange( Double_t x0, Double_t y0, Double_t z0, Double_t x1, Double_t y1,
                            Double_t z1, Int_t flag = 0 );
  virtual void    SetSystem( Int_t system ) { fSystem = system; }
  virtual void    SetView( Double_t longitude, Double_t latitude, Double_t psi, Int_t& irep );
  void            SetViewChanged( Bool_t flag = kTRUE ) { fChanged = flag; }
  void            SetWindow( Double_t u0, Double_t v0, Double_t du, Double_t dv );
  virtual void    WCtoNDC( const Float_t* pw, Float_t* pn );
  virtual void    WCtoNDC( const Double_t* pw, Double_t* pn );
 
  //--
  void MoveFocus( Double_t* center, Double_t dx, Double_t dy, Double_t dz, Int_t nsteps = 10,
                  Double_t dlong = 0, Double_t dlat = 0, Double_t dpsi = 0 );
  virtual void MoveViewCommand( Char_t chCode, Int_t count = 1 );
  void         MoveWindow( Char_t option );
 
  static void  AdjustPad( TVirtualPad* pad = 0 );
  virtual void AdjustScales( TVirtualPad* pad = 0 ); // *MENU*
  virtual void Centered3DImages( TVirtualPad* pad = 0 );
  virtual void Centered(); // *MENU*
  virtual void FrontView( TVirtualPad* pad = 0 );
  virtual void Front(); // *MENU*
 
  virtual void ZoomIn();  // *MENU*
  virtual void ZoomOut(); // *MENU*
  virtual void ZoomView( TVirtualPad* pad = 0, Double_t zoomFactor = 1.25 );
  virtual void UnzoomView( TVirtualPad* pad = 0, Double_t unZoomFactor = 1.25 );
 
  virtual void RotateView( Double_t phi, Double_t theta, TVirtualPad* pad = 0 );
  virtual void SideView( TVirtualPad* pad = 0 );
  virtual void Side(); // *MENU*
  virtual void TopView( TVirtualPad* pad = 0 );
  virtual void Top(); // *MENU*
 
  virtual void ToggleRulers( TVirtualPad* pad = 0 );
  virtual void ShowAxis(); // *MENU*
  virtual void ToggleZoom( TVirtualPad* pad = 0 );
  virtual void ZoomMove(); // *MENU*
  virtual void Zoom();     // *MENU*
  virtual void UnZoom();   // *MENU*
 
  ClassDef( BesTView, 2 ); // 3-D View
};
 
//      Shortcuts for menus
inline void BesTView::Centered() { Centered3DImages(); }
inline void BesTView::Front() { FrontView(); }
inline void BesTView::ShowAxis() { ToggleRulers(); }
inline void BesTView::Side() { SideView(); }
inline void BesTView::Top() { TopView(); }
inline void BesTView::ZoomMove() { ToggleZoom(); }
inline void BesTView::Zoom() { ZoomView(); }
inline void BesTView::UnZoom() { UnzoomView(); }
 
#endif