Logo ROOT  
Reference Guide
Go to the documentation of this file.
1// @(#)root/gl:$Id$
2// Author: Matevz Tadel, Feb 2007
5 * Copyright (C) 1995-2004, Rene Brun and Fons Rademakers. *
6 * All rights reserved. *
7 * *
8 * For the licensing terms see $ROOTSYS/LICENSE. *
9 * For the list of contributors see $ROOTSYS/README/CREDITS. *
10 *************************************************************************/
12#ifndef ROOT_TGLSceneBase_H
13#define ROOT_TGLSceneBase_H
15#include "TGLLockable.h"
16#include "TGLBoundingBox.h"
18#include <TString.h>
20#include <list>
22class TGLViewerBase;
23class TGLSceneInfo;
24class TGLClip;
25class TGLRnrCtx;
26class TGLLogicalShape;
27class TGLSelectRecord;
29// Avoid TObject inheritance due to clash with TObject::Draw as well
30// as possible inheritance of TGLPadScene from VierualViewer3D.
32class TGLSceneBase : public TGLLockable // : public TObject / TNamed
35 TGLSceneBase(const TGLSceneBase&); // Not implemented
36 TGLSceneBase& operator=(const TGLSceneBase&); // Not implemented
41 UInt_t fSceneID; // Unique scene id.
42 TString fName; // Object identifier.
43 TString fTitle; // Object title.
45 UInt_t fTimeStamp; // Counter increased on every update.
46 UInt_t fMinorStamp; // Counter increased on minimal update.
47 Short_t fLOD; // Scene-lod.
48 Short_t fStyle; // Scene-style.
49 Float_t fWFLineW; // Scene wire-frame line-width.
50 Float_t fOLLineW; // Scene outline line-width.
51 TGLClip * fClip; // Scene clipping-plane.
52 Bool_t fSelectable; // Objects in the scene are selectable.
54 // BoundingBox
55 mutable TGLBoundingBox fBoundingBox; // bounding box for scene (axis aligned) - lazy update - use BoundingBox() to access
56 mutable Bool_t fBoundingBoxValid; // bounding box valid?
58 Bool_t fDoFrustumCheck; // Perform global frustum-check in UpdateSceneInfo()
59 Bool_t fDoClipCheck; // Perform global clip-plane-check in UpdateSceneInfo()
61 // Interface to other components
62 typedef std::list<TGLViewerBase*> ViewerList_t;
63 typedef std::list<TGLViewerBase*>::iterator ViewerList_i;
68 // Possible future extensions
69 // TGLMatrix fGlobalTrans;
73 virtual ~TGLSceneBase();
75 void AddViewer(TGLViewerBase* viewer);
76 void RemoveViewer(TGLViewerBase* viewer);
77 void TagViewersChanged();
79 virtual const char* LockIdStr() const;
81 virtual const char *GetName() const { return fName; }
82 virtual const char *GetTitle() const { return fTitle; }
83 virtual void SetName (const char *name) { fName = name; }
84 virtual void SetTitle(const char *title) { fTitle = title; }
85 virtual void SetNameTitle(const char *name, const char *title) { SetName(name); SetTitle(title); }
88 virtual void RebuildSceneInfo(TGLRnrCtx& ctx);
89 virtual void UpdateSceneInfo(TGLRnrCtx& ctx);
90 virtual void LodifySceneInfo(TGLRnrCtx& ctx);
92 // Rendering
93 virtual void PreDraw (TGLRnrCtx& rnrCtx);
94 virtual void PreRender (TGLRnrCtx& rnrCtx);
95 virtual void Render (TGLRnrCtx& rnrCtx);
96 virtual void RenderOpaque (TGLRnrCtx& rnrCtx);
97 virtual void RenderTransp (TGLRnrCtx& rnrCtx);
98 virtual void RenderSelOpaque(TGLRnrCtx& rnrCtx);
99 virtual void RenderSelTransp(TGLRnrCtx& rnrCtx);
100 virtual void RenderSelOpaqueForHighlight(TGLRnrCtx& rnrCtx);
101 virtual void RenderSelTranspForHighlight(TGLRnrCtx& rnrCtx);
102 virtual void PostRender(TGLRnrCtx& rnrCtx);
103 virtual void PostDraw (TGLRnrCtx& rnrCtx);
105 virtual TGLLogicalShape* FindLogical(TObject*) const { return 0; }
107 // Selection interface
108 virtual Bool_t ResolveSelectRecord(TGLSelectRecord& rec, Int_t curIdx);
111 // Getters & setters
113 UInt_t GetTimeStamp() const { return fTimeStamp; }
116 UInt_t GetMinorStamp() const { return fMinorStamp; }
119 Short_t LOD() const { return fLOD; }
120 void SetLOD(Short_t lod) { fLOD = lod; }
122 Short_t Style() const { return fStyle; }
123 void SetStyle(Short_t st) { fStyle = st; }
125 TGLClip* Clip() const { return fClip; }
126 void SetClip(TGLClip *p) { fClip = p; }
128 Bool_t GetSelectable() const { return fSelectable; }
134 // BoundingBox
136 virtual void CalcBoundingBox() const = 0;
142 ClassDef(TGLSceneBase, 0) // Base-class for OpenGL scenes.
143}; // endclass TGLSceneBase
int Int_t
Definition: RtypesCore.h:45
unsigned int UInt_t
Definition: RtypesCore.h:46
const Bool_t kFALSE
Definition: RtypesCore.h:101
bool Bool_t
Definition: RtypesCore.h:63
short Short_t
Definition: RtypesCore.h:39
float Float_t
Definition: RtypesCore.h:57
#define ClassDef(name, id)
Definition: Rtypes.h:325
char name[80]
Definition: TGX11.cxx:110
Concrete class describing an orientated (free) or axis aligned box of 8 vertices.
Abstract clipping shape - derives from TGLPhysicalShape Adds clip mode (inside/outside) and pure virt...
Definition: TGLClip.h:32
Simple locking interface used by viewer and scene.
Definition: TGLLockable.h:18
Abstract logical shape - a GL 'drawable' - base for all shapes - faceset sphere etc.
The TGLRnrCtx class aggregates data for a given redering context as needed by various parts of the RO...
Definition: TGLRnrCtx.h:41
Scene base-class – provides basic interface expected by the TGLViewer or its sub-classes:
Definition: TGLSceneBase.h:33
virtual const char * GetName() const
Definition: TGLSceneBase.h:81
Bool_t fAutoDestruct
Definition: TGLSceneBase.h:66
void SetAutoDestruct(Bool_t a)
Definition: TGLSceneBase.h:132
virtual void PostDraw(TGLRnrCtx &rnrCtx)
Finalize drawing.
const TGLBoundingBox & BoundingBox() const
Definition: TGLSceneBase.h:138
virtual void RenderSelOpaque(TGLRnrCtx &rnrCtx)
Render selected opaque elements.
TGLClip * fClip
Definition: TGLSceneBase.h:51
Bool_t fSelectable
Definition: TGLSceneBase.h:52
TString fName
Definition: TGLSceneBase.h:42
virtual void PostRender(TGLRnrCtx &rnrCtx)
Perform post-render clean-up.
UInt_t fMinorStamp
Definition: TGLSceneBase.h:46
static UInt_t fgSceneIDSrc
Definition: TGLSceneBase.h:38
virtual void SetTitle(const char *title)
Definition: TGLSceneBase.h:84
virtual TGLLogicalShape * FindLogical(TObject *) const
Definition: TGLSceneBase.h:105
virtual void SetName(const char *name)
Definition: TGLSceneBase.h:83
TGLBoundingBox fBoundingBox
Definition: TGLSceneBase.h:55
virtual TGLSceneInfo * CreateSceneInfo(TGLViewerBase *view)
Create a scene-info instance appropriate for this scene class.
UInt_t fTimeStamp
Definition: TGLSceneBase.h:45
ViewerList_t fViewers
Definition: TGLSceneBase.h:65
void RemoveViewer(TGLViewerBase *viewer)
Remove viewer from the list.
TGLSceneBase(const TGLSceneBase &)
virtual void LodifySceneInfo(TGLRnrCtx &ctx)
Setup LOD-dependant values in scene-info.
Bool_t fBoundingBoxValid
Definition: TGLSceneBase.h:56
Short_t fStyle
Definition: TGLSceneBase.h:48
virtual ~TGLSceneBase()
virtual void RenderSelTransp(TGLRnrCtx &rnrCtx)
Render selected transparent elements for highlight.
TString fTitle
Definition: TGLSceneBase.h:43
void IncTimeStamp()
Definition: TGLSceneBase.h:114
virtual void PreRender(TGLRnrCtx &rnrCtx)
Perform pre-render initialization - fill rnrCtx with values stored during PreDraw().
virtual const char * LockIdStr() const
Name printed on locking info messages.
void SetLOD(Short_t lod)
Definition: TGLSceneBase.h:120
virtual Bool_t ResolveSelectRecord(TGLSelectRecord &rec, Int_t curIdx)
Process selection record rec.
UInt_t fSceneID
Definition: TGLSceneBase.h:41
virtual void RenderTransp(TGLRnrCtx &rnrCtx)
Render transparent elements.
UInt_t GetMinorStamp() const
Definition: TGLSceneBase.h:116
virtual void RenderSelTranspForHighlight(TGLRnrCtx &rnrCtx)
Render selected transparent elements.
void InvalidateBoundingBox()
Definition: TGLSceneBase.h:137
Bool_t fDoClipCheck
Definition: TGLSceneBase.h:59
UInt_t GetTimeStamp() const
Definition: TGLSceneBase.h:113
std::list< TGLViewerBase * >::iterator ViewerList_i
Definition: TGLSceneBase.h:63
std::list< TGLViewerBase * > ViewerList_t
Definition: TGLSceneBase.h:62
void SetSelectable(Bool_t a)
Definition: TGLSceneBase.h:129
virtual void PreDraw(TGLRnrCtx &rnrCtx)
Perform basic pre-render initialization:
TGLSceneBase & operator=(const TGLSceneBase &)
virtual void RebuildSceneInfo(TGLRnrCtx &ctx)
Fill scene-info with very basic information that is practically view independent.
void AddViewer(TGLViewerBase *viewer)
Add viewer to the list.
virtual void CalcBoundingBox() const =0
void SetStyle(Short_t st)
Definition: TGLSceneBase.h:123
TGLClip * Clip() const
Definition: TGLSceneBase.h:125
Bool_t fDoFrustumCheck
Definition: TGLSceneBase.h:58
Bool_t GetAutoDestruct() const
Definition: TGLSceneBase.h:131
virtual void SetNameTitle(const char *name, const char *title)
Definition: TGLSceneBase.h:85
virtual void RenderOpaque(TGLRnrCtx &rnrCtx)
Render opaque elements.
virtual void RenderSelOpaqueForHighlight(TGLRnrCtx &rnrCtx)
Render selected opaque elements for highlight.
Float_t fWFLineW
Definition: TGLSceneBase.h:49
virtual void UpdateSceneInfo(TGLRnrCtx &ctx)
Fill scene-info with information needed for rendering, take into account the render-context (viewer s...
Short_t LOD() const
Definition: TGLSceneBase.h:119
void TagViewersChanged()
Tag all viewers as changed.
void IncMinorStamp()
Definition: TGLSceneBase.h:117
Float_t fOLLineW
Definition: TGLSceneBase.h:50
virtual const char * GetTitle() const
Definition: TGLSceneBase.h:82
void SetClip(TGLClip *p)
Definition: TGLSceneBase.h:126
virtual void Render(TGLRnrCtx &rnrCtx)
This function does rendering of all stages, the shapes are rendered in the following order: opaque,...
Short_t fLOD
Definition: TGLSceneBase.h:47
Short_t Style() const
Definition: TGLSceneBase.h:122
Bool_t GetSelectable() const
Definition: TGLSceneBase.h:128
Base class for extended scene context.
Definition: TGLSceneInfo.h:28
Standard selection record including information about containing scene and details ob out selected ob...
Base class for GL viewers.
Definition: TGLViewerBase.h:37
Mother of all ROOT objects.
Definition: TObject.h:37
Basic string class.
Definition: TString.h:136
auto * a
Definition: textangle.C:12