Logo ROOT   6.30.04
Reference Guide
 All Namespaces Files Pages
TGLLogicalShape.h
Go to the documentation of this file.
1 // @(#)root/gl:$Id$
2 // Author: Richard Maunder 25/05/2005
3 
4 /*************************************************************************
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  *************************************************************************/
11 
12 #ifndef ROOT_TGLLogicalShape
13 #define ROOT_TGLLogicalShape
14 
15 #include "TGLBoundingBox.h"
16 
17 class TBuffer3D;
18 class TObject;
19 class TContextMenu;
20 
21 class TGLPhysicalShape;
22 class TGLRnrCtx;
23 class TGLSelectRecord;
24 class TGLViewer;
25 class TGLSceneBase;
26 class TGLScene;
27 
28 
29 class TGLLogicalShape
30 {
31  friend class TGLScene;
32 
33 private:
34  TGLLogicalShape(const TGLLogicalShape&); // Not implemented.
35  TGLLogicalShape& operator=(const TGLLogicalShape&); // Not implemented.
36 
37 public:
38  enum ELODAxes { kLODAxesNone = 0, // LOD will be set to high or pixel.
39  kLODAxesX = 1 << 0,
40  kLODAxesY = 1 << 1,
41  kLODAxesZ = 1 << 2,
42  kLODAxesAll = kLODAxesX | kLODAxesY | kLODAxesZ
43  };
44 
45 protected:
46  mutable UInt_t fRef; //! physical instance ref counting
47  mutable TGLPhysicalShape *fFirstPhysical; //! first replica
48 
49  TObject *fExternalObj; //! Also plays the role of ID.
50  TGLBoundingBox fBoundingBox; //! Shape's bounding box.
51  mutable TGLScene *fScene; //! scene where object is stored (can be zero!)
52  mutable UInt_t fDLBase; //! display-list id base
53  mutable Int_t fDLSize; //! display-list size for different LODs
54  mutable UShort_t fDLValid; //! display-list validity bit-field
55  mutable Bool_t fDLCache; //! use display list caching
56  mutable Bool_t fRefStrong; //! Strong ref (delete on 0 ref); not in scene
57  mutable Bool_t fOwnExtObj; //! External object is a fake
58 
59  void PurgeDLRange(UInt_t base, Int_t size) const;
60 
61  static Bool_t fgIgnoreSizeForCameraInterest;
62 
63  static Bool_t fgUseDLs; //! global flag for usage of display-lists
64  static Bool_t fgUseDLsForVertArrs; //! global flag for usage of display-lists in shapes that use vertex arrays
65 
66 public:
67  TGLLogicalShape();
68  TGLLogicalShape(TObject* obj);
69  TGLLogicalShape(const TBuffer3D & buffer);
70  virtual ~TGLLogicalShape();
71 
72  // Physical shape reference-counting, replica management
73  UInt_t Ref() const { return fRef; }
74  void AddRef(TGLPhysicalShape* phys) const;
75  void SubRef(TGLPhysicalShape* phys) const;
76  void StrongRef(Bool_t strong) const { fRefStrong = strong; }
77  void DestroyPhysicals();
78  UInt_t UnrefFirstPhysical();
79 
80  const TGLPhysicalShape* GetFirstPhysical() const { return fFirstPhysical; }
81 
82  TObject* ID() const { return fExternalObj; }
83  TObject* GetExternal() const { return fExternalObj; }
84  TGLScene* GetScene() const { return fScene; }
85 
86  const TGLBoundingBox& BoundingBox() const { return fBoundingBox; }
87  virtual void UpdateBoundingBox() {}
88  void UpdateBoundingBoxesOfPhysicals();
89 
90  // Display List Caching
91  Bool_t SetDLCache(Bool_t cached);
92  virtual Bool_t ShouldDLCache(const TGLRnrCtx & rnrCtx) const;
93  virtual UInt_t DLOffset(Short_t /*lod*/) const { return 0; }
94  virtual void DLCacheClear();
95  virtual void DLCacheDrop();
96  virtual void DLCachePurge();
97 
98  virtual ELODAxes SupportedLODAxes() const { return kLODAxesNone; }
99  virtual Short_t QuantizeShapeLOD(Short_t shapeLOD, Short_t combiLOD) const;
100  virtual void Draw(TGLRnrCtx& rnrCtx) const;
101  virtual void DirectDraw(TGLRnrCtx& rnrCtx) const = 0; // Actual draw method (non DL cached)
102 
103  virtual void DrawHighlight(TGLRnrCtx& rnrCtx, const TGLPhysicalShape* pshp, Int_t lvl=-1) const;
104 
105  virtual Bool_t IgnoreSizeForOfInterest() const;
106 
107  // Override in sub-classes that do direct object rendering (e.g. TGLObject).
108  virtual Bool_t KeepDuringSmartRefresh() const { return kFALSE; }
109  // Override in sub-classes that support secondary selection (e.g. TPointSet3DGL).
110  virtual Bool_t SupportsSecondarySelect() const { return kFALSE; }
111  virtual Bool_t AlwaysSecondarySelect() const { return kFALSE; }
112  virtual void ProcessSelection(TGLRnrCtx& rnrCtx, TGLSelectRecord& rec);
113 
114  void InvokeContextMenu(TContextMenu & menu, UInt_t x, UInt_t y) const;
115 
116  static Bool_t GetIgnoreSizeForCameraInterest();
117  static void SetIgnoreSizeForCameraInterest(Bool_t isfci);
118 
119  static void SetEnvDefaults();
120 
121  ClassDef(TGLLogicalShape,0) // a logical (non-placed, local frame) drawable object
122 };
123 
124 
125 #endif // ROOT_TGLLogicalShape