TGLViewer.h

Go to the documentation of this file.

// @(#)root/gl:$Id$
// Author:  Richard Maunder  25/05/2005
 
/*************************************************************************
 * Copyright (C) 1995-2004, 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_TGLViewer
#define ROOT_TGLViewer
 
#include "TGLViewerBase.h"
#include "TGLRnrCtx.h"
#include "TGLSelectRecord.h"
 
#include "TVirtualViewer3D.h"
#include "TBuffer3D.h"
 
#include "TGLPerspectiveCamera.h"
#include "TGLOrthoCamera.h"
#include "TGLClip.h"
 
#include "TTimer.h"
#include "TPoint.h"
 
#include "TGEventHandler.h"
 
#include "GuiTypes.h"
#include "TQObject.h"
 
class TGLSceneBase;
class TGLRedrawTimer;
class TGLViewerEditor;
class TGLWidget;
class TGLLightSet;
class TGLClipSet;
class TGLManipSet;
class TGLCameraOverlay;
class TGLContextIdentity;
class TGLAutoRotator;
class TTimer;
class TImage;
 
class TContextMenu;
class TGedEditor;
class TGLPShapeObj;
 
class TGLViewer : public TVirtualViewer3D,
                  public TGLViewerBase,
                  public TQObject
 
{
   friend class TGLOutput;
   friend class TGLEventHandler;
   friend class TGLAutoRotator;
public:
 
   enum ECameraType { kCameraPerspXOZ,  kCameraPerspYOZ,  kCameraPerspXOY,
                      kCameraOrthoXOY,  kCameraOrthoXOZ,  kCameraOrthoZOY, kCameraOrthoZOX,
                      kCameraOrthoXnOY, kCameraOrthoXnOZ, kCameraOrthoZnOY, kCameraOrthoZnOX };
 
   enum ESecSelType { // When to do secondary-selection:
      kOnRequest,     // - on request - when Mod1 is pressed or logical-shape requests it;
      kOnKeyMod1      // - only when Mod1 is pressed.
   };
 
private:
   TGLViewer(const TGLViewer &) = delete;
   TGLViewer & operator=(const TGLViewer &) = delete;
 
   void InitSecondaryObjects();
 
protected:
   // External handles
   TVirtualPad   *fPad;         ///<! external pad - remove replace with signal
 
   // GUI Handles
   TContextMenu  *fContextMenu; ///<!
 
   // Cameras
   // TODO: Put in vector and allow external creation
   TGLPerspectiveCamera fPerspectiveCameraXOZ; ///<!
   TGLPerspectiveCamera fPerspectiveCameraYOZ; ///<!
   TGLPerspectiveCamera fPerspectiveCameraXOY; ///<!
   TGLOrthoCamera       fOrthoXOYCamera;       ///<!
   TGLOrthoCamera       fOrthoXOZCamera;       ///<!
   TGLOrthoCamera       fOrthoZOYCamera;       ///<!
   TGLOrthoCamera       fOrthoZOXCamera;       ///<!
   TGLOrthoCamera       fOrthoXnOYCamera;      ///<!
   TGLOrthoCamera       fOrthoXnOZCamera;      ///<!
   TGLOrthoCamera       fOrthoZnOYCamera;      ///<!
   TGLOrthoCamera       fOrthoZnOXCamera;      ///<!
   TGLCamera           *fCurrentCamera;        ///<!
   TGLAutoRotator      *fAutoRotator;          ///<!
 
   // Stereo
   Bool_t               fStereo;               ///<! use stereo rendering
   Bool_t               fStereoQuadBuf;        ///<! draw quad buffer or left/right stereo in left/right half of window
   Float_t              fStereoZeroParallax;   ///<! position of zero-parallax plane: 0 - near clipping plane, 1 - far clipping plane
   Float_t              fStereoEyeOffsetFac;   ///<!
   Float_t              fStereoFrustumAsymFac; ///<!
 
   // Lights
   TGLLightSet         *fLightSet;             ///<!
   // Clipping
   TGLClipSet          *fClipSet;              ///<!
   // Selected physical
   TGLSelectRecord      fCurrentSelRec;        ///<! select record in use as selected
   TGLSelectRecord      fSelRec;               ///<! select record from last select (should go to context)
   TGLSelectRecord      fSecSelRec;            ///<! select record from last secondary select (should go to context)
   TGLManipSet         *fSelectedPShapeRef;    ///<!
   // Overlay
   TGLOverlayElement   *fCurrentOvlElm;        ///<! current overlay element
   TGLOvlSelectRecord   fOvlSelRec;            ///<! select record from last overlay select
 
   TGEventHandler      *fEventHandler;         ///<! event handler
   TGedEditor          *fGedEditor;            ///<! GED editor
   TGLPShapeObj        *fPShapeWrap;
 
   // Mouse ineraction
public:
   enum EPushAction   { kPushStd,
                        kPushCamCenter, kPushAnnotate };
   enum EDragAction   { kDragNone,
                        kDragCameraRotate, kDragCameraTruck, kDragCameraDolly,
                        kDragOverlay };
protected:
   EPushAction          fPushAction;
   EDragAction          fDragAction;
 
   // Redraw timer
   TGLRedrawTimer      *fRedrawTimer;        ///<! timer for triggering redraws
   Float_t              fMaxSceneDrawTimeHQ; ///<! max time for scene rendering at high LOD (in ms)
   Float_t              fMaxSceneDrawTimeLQ; ///<! max time for scene rendering at high LOD (in ms)
 
   TGLRect        fViewport;       ///<! viewport - drawn area
   TGLColorSet    fDarkColorSet;   ///<! color-set with dark background
   TGLColorSet    fLightColorSet;  ///<! color-set with light background
   Float_t        fPointScale;     ///<! size scale for points
   Float_t        fLineScale;      ///<! width scale for lines
   Bool_t         fSmoothPoints;   ///<! smooth point edge rendering
   Bool_t         fSmoothLines;    ///<! smooth line edge rendering
   Int_t          fAxesType;       ///<! axes type
   Bool_t         fAxesDepthTest;  ///<! remove guides hidden-lines
   Bool_t         fReferenceOn;    ///<! reference marker on?
   TGLVertex3     fReferencePos;   ///<! reference position
   Bool_t         fDrawCameraCenter; ///<! reference marker on?
   TGLCameraOverlay  *fCameraOverlay; ///<! markup size of viewport in scene units
 
   Bool_t         fSmartRefresh;   ///<! cache logicals during scene rebuilds
 
   // Debug tracing (for scene rebuilds)
   Bool_t         fDebugMode;            ///<! debug mode (forced rebuild + draw scene/frustum/interest boxes)
   Bool_t         fIsPrinting;           ///<!
   TString        fPictureFileName;      ///<! default file-name for SavePicture()
   Float_t        fFader;                ///<! fade the view (0 - no fade/default, 1 - full fade/no rendering done)
 
   static TGLColorSet fgDefaultColorSet;                 ///<! a shared, default color-set
   static Bool_t      fgUseDefaultColorSetForNewViewers; ///<! name says it all
   static Float_t     fgAxisLabelScale; ///<! allow simple guide axes labels to be scaled relative to scene units
 
   ///////////////////////////////////////////////////////////////////////
   // Methods
   ///////////////////////////////////////////////////////////////////////
 
   void SetupClipObject() override;
 
   // Drawing - can tidy up/remove lots when TGLManager added
   void InitGL();
   void PreDraw();
   void PostDraw();
   void FadeView(Float_t alpha);
   void MakeCurrent() const;
   void SwapBuffers() const;
 
   // Cameras
   void        SetViewport(Int_t x, Int_t y, Int_t width, Int_t height);
   void        SetViewport(const TGLRect& vp);
   void        SetupCameras(Bool_t reset);
 
protected:
   TGLWidget          *fGLWidget;
   Int_t               fGLDevice; ///<!for embedded gl viewer
   TGLContextIdentity *fGLCtxId;  ///<!for embedded gl viewer
 
   // Updata/camera-reset behaviour
   Bool_t           fIgnoreSizesOnUpdate;      // ignore sizes of bounding-boxes on update
   Bool_t           fResetCamerasOnUpdate;     // reposition camera on each update
   Bool_t           fResetCamerasOnNextUpdate; // reposition camera on next update
 
public:
   TGLViewer(TVirtualPad* pad, Int_t x, Int_t y, Int_t width, Int_t height);
   TGLViewer(TVirtualPad* pad);
   ~TGLViewer() override;
 
   // TVirtualViewer3D interface ... mostly a facade
 
   // Forward to TGLScenePad
   Bool_t CanLoopOnPrimitives() const override { return kTRUE; }
   void   PadPaint(TVirtualPad* pad) override;
   // Actually used by GL-in-pad
   Int_t  DistancetoPrimitive(Int_t px, Int_t py) override;
   void   ExecuteEvent(Int_t event, Int_t px, Int_t py) override;
   // Only implemented because they're abstract ... should throw an
   // exception or assert they are not called.
   Bool_t PreferLocalFrame() const override { return kTRUE; }
   void   BeginScene() override {}
   Bool_t BuildingScene() const override { return kFALSE; }
   void   EndScene() override {}
   Int_t  AddObject(const TBuffer3D&, Bool_t* = nullptr) override { return TBuffer3D::kNone; }
   Int_t  AddObject(UInt_t, const TBuffer3D&, Bool_t* = nullptr) override { return TBuffer3D::kNone; }
   Bool_t OpenComposite(const TBuffer3D&, Bool_t* = nullptr) override { return kFALSE; }
   void   CloseComposite() override {}
   void   AddCompositeOp(UInt_t) override {}
 
   void   PrintObjects() override;
   void   ResetCameras() override                { SetupCameras(kTRUE); }
   void   ResetCamerasAfterNextUpdate() override { fResetCamerasOnNextUpdate = kTRUE; }
 
   TGLWidget* GetGLWidget() { return fGLWidget; }
 
   virtual void  CreateGLWidget()  {}
   virtual void  DestroyGLWidget() {}
 
   Int_t   GetDev()          const           { return fGLDevice; }
   Bool_t  GetSmartRefresh() const           { return fSmartRefresh; }
   void    SetSmartRefresh(Bool_t smart_ref) { fSmartRefresh = smart_ref; }
 
   TGLColorSet& RefDarkColorSet()  { return fDarkColorSet;  }
   TGLColorSet& RefLightColorSet() { return fLightColorSet; }
   TGLColorSet& ColorSet()         { return * fRnrCtx->GetBaseColorSet(); }
   void         UseDarkColorSet();
   void         UseLightColorSet();
   void         SwitchColorSet();
 
   void         UseDefaultColorSet(Bool_t x);
   Bool_t       IsUsingDefaultColorSet() const;
   Bool_t       IsColorSetDark() const;
 
   void         SetClearColor(Color_t col);
 
   static TGLColorSet& GetDefaultColorSet();
   static void         UseDefaultColorSetForNewViewers(Bool_t x);
   static Bool_t       IsUsingDefaultColorSetForNewViewers();
   static void         SetAxisLabelScale(Float_t als);
 
   const TGLRect& RefViewport()      const { return fViewport; }
   Int_t          ViewportDiagonal() const { return fViewport.Diagonal(); }
 
   Float_t GetPointScale()    const { return fPointScale; }
   Float_t GetLineScale()     const { return fLineScale; }
   void    SetPointScale(Float_t s) { fPointScale = s; }
   void    SetLineScale (Float_t s) { fLineScale  = s; }
   Bool_t  GetSmoothPoints()  const { return fSmoothPoints; }
   Bool_t  GetSmoothLines()   const { return fSmoothLines; }
   void    SetSmoothPoints(Bool_t s){ fSmoothPoints = s; }
   void    SetSmoothLines(Bool_t s) { fSmoothLines  = s; }
 
   TGLLightSet* GetLightSet() const { return fLightSet; }
   TGLClipSet * GetClipSet()  const { return fClipSet; }
   Bool_t GetClipAutoUpdate() const   { return fClipSet->GetAutoUpdate(); }
   void   SetClipAutoUpdate(Bool_t x) { fClipSet->SetAutoUpdate(x); }
 
   // External GUI component interface
   TGLCamera & CurrentCamera() const { return *fCurrentCamera; }
   TGLCamera & RefCamera(ECameraType camera);
   void SetCurrentCamera(ECameraType camera);
   void SetOrthoCamera(ECameraType camera, Double_t zoom, Double_t dolly,
                             Double_t center[3], Double_t hRotate, Double_t vRotate);
   void SetPerspectiveCamera(ECameraType camera, Double_t fov, Double_t dolly,
                             Double_t center[3], Double_t hRotate, Double_t vRotate);
   void ReinitializeCurrentCamera(const TGLVector3& hAxis, const TGLVector3& vAxis, Bool_t redraw=kTRUE);
   void GetGuideState(Int_t & axesType, Bool_t & axesDepthTest, Bool_t & referenceOn, Double_t* referencePos) const;
   void SetGuideState(Int_t axesType, Bool_t axesDepthTest, Bool_t referenceOn, const Double_t* referencePos);
   void SetDrawCameraCenter(Bool_t x);
   Bool_t GetDrawCameraCenter() { return fDrawCameraCenter; }
   void   PickCameraCenter()    { fPushAction = kPushCamCenter; RefreshPadEditor(this); }
   void   PickAnnotate()        { fPushAction = kPushAnnotate;  RefreshPadEditor(this); }
   TGLCameraOverlay* GetCameraOverlay() const { return fCameraOverlay; }
   void SetCameraOverlay(TGLCameraOverlay* m) { fCameraOverlay = m; }
   TGLAutoRotator* GetAutoRotator();
   void SetAutoRotator(TGLAutoRotator* ar);
 
   // Stereo
   Bool_t  GetStereo()               const { return fStereo; }
   Float_t GetStereoZeroParallax()   const { return fStereoZeroParallax;   }
   Float_t GetStereoEyeOffsetFac()   const { return fStereoEyeOffsetFac;   }
   Float_t GetStereoFrustumAsymFac() const { return fStereoFrustumAsymFac; }
 
   void SetStereo(Bool_t stereo, Bool_t quad_buf=kTRUE);
   void SetStereoZeroParallax(Float_t f)   { fStereoZeroParallax   = f; }
   void SetStereoEyeOffsetFac(Float_t f)   { fStereoEyeOffsetFac   = f; }
   void SetStereoFrustumAsymFac(Float_t f) { fStereoFrustumAsymFac = f; }
 
   // Push / drag action
   EPushAction GetPushAction() const { return fPushAction; }
   EDragAction GetDragAction() const { return fDragAction; }
 
   const TGLPhysicalShape * GetSelected() const;
 
 
   // Draw and selection
 
   // Scene rendering timeouts
   Float_t GetMaxSceneDrawTimeHQ() const    { return fMaxSceneDrawTimeHQ; }
   Float_t GetMaxSceneDrawTimeLQ() const    { return fMaxSceneDrawTimeLQ; }
   void    SetMaxSceneDrawTimeHQ(Float_t t) { fMaxSceneDrawTimeHQ = t; }
   void    SetMaxSceneDrawTimeLQ(Float_t t) { fMaxSceneDrawTimeLQ = t; }
 
   // Request methods post cross thread request via TROOT::ProcessLineFast().
   void RequestDraw(Short_t LOD = TGLRnrCtx::kLODMed); // Cross thread draw request
   void PreRender() override;
   void Render() override;
   void PostRender() override;
   void DoDraw(Bool_t swap_buffers=kTRUE);
   void DoDrawMono(Bool_t swap_buffers);
   void DoDrawStereo(Bool_t swap_buffers);
 
   void DrawGuides();
   void DrawDebugInfo();
 
   Bool_t RequestSelect(Int_t x, Int_t y);          // Cross thread select request
   Bool_t DoSelect(Int_t x, Int_t y);               // First level selecton (shapes/objects).
   Bool_t RequestSecondarySelect(Int_t x, Int_t y); // Cross thread secondary select request
   Bool_t DoSecondarySelect(Int_t x, Int_t y);      // Second level selecton (inner structure).
   void   ApplySelection();
 
   Bool_t RequestOverlaySelect(Int_t x, Int_t y); // Cross thread select request
   Bool_t DoOverlaySelect(Int_t x, Int_t y);      // Window coords origin top left
 
   // Saving of screen image
   Bool_t SavePicture();
   Bool_t SavePicture(const TString &fileName);
   Bool_t SavePictureUsingBB (const TString &fileName);
   Bool_t SavePictureUsingFBO(const TString &fileName, Int_t w, Int_t h, Float_t pixel_object_scale=0);
   Bool_t SavePictureWidth (const TString &fileName, Int_t width, Bool_t pixel_object_scale=kTRUE);
   Bool_t SavePictureHeight(const TString &fileName, Int_t height, Bool_t pixel_object_scale=kTRUE);
   Bool_t SavePictureScale (const TString &fileName, Float_t scale, Bool_t pixel_object_scale=kTRUE);
 
   // Methods returning screen image
   TImage* GetPictureUsingBB();
   TImage* GetPictureUsingFBO(Int_t w, Int_t h,Float_t pixel_object_scale=0);
 
   const char*  GetPictureFileName() const { return fPictureFileName.Data(); }
   void         SetPictureFileName(const TString& f) { fPictureFileName = f; }
   Float_t      GetFader() const { return fFader; }
   void         SetFader(Float_t x) { fFader = x; }
   void         AutoFade(Float_t fade, Float_t time=1, Int_t steps=10);
 
   // Update/camera-reset
   void   UpdateScene(Bool_t redraw=kTRUE);
   Bool_t GetIgnoreSizesOnUpdate() const        { return fIgnoreSizesOnUpdate; }
   void   SetIgnoreSizesOnUpdate(Bool_t v)      { fIgnoreSizesOnUpdate = v; }
   void   ResetCurrentCamera();
   Bool_t GetResetCamerasOnUpdate() const       { return fResetCamerasOnUpdate; }
   void   SetResetCamerasOnUpdate(Bool_t v)     { fResetCamerasOnUpdate = v; }
 
   virtual void PostSceneBuildSetup(Bool_t resetCameras);
 
   virtual void Activated() { Emit("Activated()"); } // *SIGNAL*
 
   virtual void MouseIdle(TGLPhysicalShape*,UInt_t,UInt_t); // *SIGNAL*
   virtual void MouseOver(TGLPhysicalShape*); // *SIGNAL*
   virtual void MouseOver(TGLPhysicalShape*, UInt_t state); // *SIGNAL*
   virtual void MouseOver(TObject *obj, UInt_t state); // *SIGNAL*
   virtual void ReMouseOver(TObject *obj, UInt_t state); // *SIGNAL*
   virtual void UnMouseOver(TObject *obj, UInt_t state); // *SIGNAL*
 
   virtual void Clicked(TObject *obj); //*SIGNAL*
   virtual void Clicked(TObject *obj, UInt_t button, UInt_t state); //*SIGNAL*
   virtual void ReClicked(TObject *obj, UInt_t button, UInt_t state); //*SIGNAL*
   virtual void UnClicked(TObject *obj, UInt_t button, UInt_t state); //*SIGNAL*
   virtual void DoubleClicked() { Emit("DoubleClicked()"); } // *SIGNAL*
 
   TGEventHandler *GetEventHandler() const { return fEventHandler; }
   virtual void    SetEventHandler(TGEventHandler *handler);
 
   TGedEditor*  GetGedEditor() const { return fGedEditor; }
   virtual void SetGedEditor(TGedEditor* ed) { fGedEditor = ed; }
 
   virtual void SelectionChanged();
   virtual void OverlayDragFinished();
   virtual void RefreshPadEditor(TObject* obj=nullptr);
 
   void RemoveOverlayElement(TGLOverlayElement* el) override;
 
   TGLSelectRecord&    GetSelRec()    { return fSelRec; }
   TGLOvlSelectRecord& GetOvlSelRec() { return fOvlSelRec; }
   TGLOverlayElement*  GetCurrentOvlElm() const { return fCurrentOvlElm; }
   void                ClearCurrentOvlElm();
 
   ClassDefOverride(TGLViewer,0) // Standard ROOT GL viewer.
};
 
 
 
// TODO: Find a better place/way to do this
class TGLRedrawTimer : public TTimer
{
private:
   TGLViewer & fViewer;
   Short_t     fRedrawLOD;
   Bool_t      fPending;
public:
   TGLRedrawTimer(TGLViewer & viewer) :
      fViewer(viewer), fRedrawLOD(TGLRnrCtx::kLODHigh), fPending(kFALSE) {}
   ~TGLRedrawTimer() override {}
   void RequestDraw(Int_t milliSec, Short_t redrawLOD)
   {
      if (fPending) TurnOff(); else fPending = kTRUE;
      if (redrawLOD < fRedrawLOD) fRedrawLOD = redrawLOD;
      TTimer::Start(milliSec, kTRUE);
   }
   Bool_t IsPending() const { return fPending; }
   void Stop() override
   {
      if (fPending) { TurnOff(); fPending = kFALSE; }
   }
   Bool_t Notify() override
   {
      TurnOff();
      fPending = kFALSE;
      fViewer.RequestDraw(fRedrawLOD);
      fRedrawLOD = TGLRnrCtx::kLODHigh;
      return kTRUE;
   }
};
 
class TGLFaderHelper {
private:
   TGLFaderHelper(const TGLFaderHelper&) = delete;
   TGLFaderHelper& operator=(const TGLFaderHelper&) = delete;
 
public:
   TGLViewer *fViewer;
   Float_t    fFadeTarget;
   Float_t    fTime;
   Int_t      fNSteps;
 
   TGLFaderHelper() :
      fViewer(nullptr), fFadeTarget(0), fTime(0), fNSteps(0) {}
   TGLFaderHelper(TGLViewer* v, Float_t fade, Float_t time, Int_t steps) :
      fViewer(v), fFadeTarget(fade), fTime(time), fNSteps(steps) {}
   virtual ~TGLFaderHelper() {}
 
   void MakeFadeStep();
 
   ClassDef(TGLFaderHelper, 0);
};
 
#endif // ROOT_TGLViewer