Logo ROOT  
Reference Guide
TGLObject Class Referenceabstract

Base-class for direct OpenGL renderers.

This allows classes to circumvent passing of TBuffer3D and use user-provided OpenGL code. By convention, if you want class TFoo : public TObject to have direct rendering you should also provide TFooGL : public TGLObject and implement abstract functions SetModel() and SetBBox(). TAttBBox can be used to facilitate calculation of bounding-boxes. See TPointSet3D and TPointSet3DGL.

Definition at line 21 of file TGLObject.h.

Public Member Functions

 TGLObject ()
 
virtual ~TGLObject ()
 
virtual Bool_t KeepDuringSmartRefresh () const
 
virtual void SetBBox ()=0
 
virtual Bool_t SetModel (TObject *obj, const Option_t *opt=0)=0
 
virtual Bool_t ShouldDLCache (const TGLRnrCtx &rnrCtx) const
 Decide if display-list should be used for this pass rendering, as determined by rnrCtx. More...
 
virtual void UpdateBoundingBox ()
 Update bounding box from external source. More...
 
- Public Member Functions inherited from TGLLogicalShape
 TGLLogicalShape ()
 global flag for usage of display-lists in shapes that use vertex arrays More...
 
 TGLLogicalShape (const TBuffer3D &buffer)
 Constructor from TBuffer3D. More...
 
 TGLLogicalShape (TObject *obj)
 Constructor with external object. More...
 
virtual ~TGLLogicalShape ()
 Destroy logical shape. More...
 
void AddRef (TGLPhysicalShape *phys) const
 Add reference to given physical shape. More...
 
virtual Bool_t AlwaysSecondarySelect () const
 
const TGLBoundingBoxBoundingBox () const
 
void DestroyPhysicals ()
 Destroy all physicals attached to this logical. More...
 
virtual void DirectDraw (TGLRnrCtx &rnrCtx) const =0
 
virtual void DLCacheClear ()
 Clear all entries for all LODs for this drawable from the display list cache but keeping the reserved ids from GL context. More...
 
virtual void DLCacheDrop ()
 Drop all entries for all LODs for this drawable from the display list cache, WITHOUT returning the reserved ids to GL context. More...
 
virtual void DLCachePurge ()
 Purge all entries for all LODs for this drawable from the display list cache, returning the reserved ids to GL context. More...
 
virtual UInt_t DLOffset (Short_t) const
 
virtual void Draw (TGLRnrCtx &rnrCtx) const
 Draw the GL drawable, using draw flags. More...
 
virtual void DrawHighlight (TGLRnrCtx &rnrCtx, const TGLPhysicalShape *pshp, Int_t lvl=-1) const
 Draw the logical shape in highlight mode. More...
 
TObjectGetExternal () const
 
const TGLPhysicalShapeGetFirstPhysical () const
 
TGLSceneGetScene () const
 
TObjectID () const
 
virtual Bool_t IgnoreSizeForOfInterest () const
 Return true if size of this shape should be ignored when determining if the object should be drawn. More...
 
void InvokeContextMenu (TContextMenu &menu, UInt_t x, UInt_t y) const
 Invoke popup menu or our bound external TObject (if any), using passed 'menu' object, at location 'x' 'y'. More...
 
virtual void ProcessSelection (TGLRnrCtx &rnrCtx, TGLSelectRecord &rec)
 Virtual method called-back after a secondary selection hit is recorded (see TGLViewer::HandleButton(), Ctrl-Button1). More...
 
virtual Short_t QuantizeShapeLOD (Short_t shapeLOD, Short_t combiLOD) const
 Logical shapes usually support only discreet LOD values, especially in view of display-list caching. More...
 
UInt_t Ref () const
 
Bool_t SetDLCache (Bool_t cached)
 Modify capture of draws into display list cache kTRUE - capture, kFALSE direct draw. More...
 
void StrongRef (Bool_t strong) const
 
void SubRef (TGLPhysicalShape *phys) const
 Remove reference to given physical shape, potentially deleting this object when hitting zero ref-count (if fRefStrong is true). More...
 
virtual ELODAxes SupportedLODAxes () const
 
virtual Bool_t SupportsSecondarySelect () const
 
UInt_t UnrefFirstPhysical ()
 Unreferenced first physical in the list, returning its id and making it fit for destruction somewhere else. More...
 
void UpdateBoundingBoxesOfPhysicals ()
 Update bounding-boxed of all dependent physicals. More...
 

Static Public Member Functions

static TClassGetGLRenderer (TClass *isa)
 Return direct-rendering GL class for class isa. More...
 
- Static Public Member Functions inherited from TGLLogicalShape
static Bool_t GetIgnoreSizeForCameraInterest ()
 Get state of static fgIgnoreSizeForCameraInterest flag. More...
 
static void SetEnvDefaults ()
 
static void SetIgnoreSizeForCameraInterest (Bool_t isfci)
 Set state of static fgIgnoreSizeForCameraInterest flag. More...
 

Protected Member Functions

template<class TT >
TT * DynCast (TObject *obj)
 
void SetAxisAlignedBBox (const Float_t *p)
 Set axis-aligned bounding-box. More...
 
void SetAxisAlignedBBox (Float_t xmin, Float_t xmax, Float_t ymin, Float_t ymax, Float_t zmin, Float_t zmax)
 Set axis-aligned bounding-box. More...
 
Bool_t SetModelCheckClass (TObject *obj, TClass *cls)
 Checks if obj is of proper class and sets the model. More...
 
template<class TT >
TT * SetModelDynCast (TObject *obj)
 
- Protected Member Functions inherited from TGLLogicalShape
void PurgeDLRange (UInt_t base, Int_t size) const
 External object is a fake. More...
 

Protected Attributes

Bool_t fMultiColor
 
- Protected Attributes inherited from TGLLogicalShape
TGLBoundingBox fBoundingBox
 Also plays the role of ID. More...
 
UInt_t fDLBase
 scene where object is stored (can be zero!) More...
 
Bool_t fDLCache
 display-list validity bit-field More...
 
Int_t fDLSize
 display-list id base More...
 
UShort_t fDLValid
 display-list size for different LODs More...
 
TObjectfExternalObj
 first replica More...
 
TGLPhysicalShapefFirstPhysical
 physical instance ref counting More...
 
Bool_t fOwnExtObj
 Strong ref (delete on 0 ref); not in scene. More...
 
UInt_t fRef
 
Bool_t fRefStrong
 use display list caching More...
 
TGLScenefScene
 Shape's bounding box. More...
 

Static Private Member Functions

static TClassSearchGLRenderer (TClass *cls)
 Recursively search cls and its base classes for a GL-renderer class. More...
 

Static Private Attributes

static TMap fgGLClassMap
 

Additional Inherited Members

- Public Types inherited from TGLLogicalShape
enum  ELODAxes {
  kLODAxesNone = 0, kLODAxesX = 1 << 0, kLODAxesY = 1 << 1, kLODAxesZ = 1 << 2,
  kLODAxesAll = kLODAxesX | kLODAxesY | kLODAxesZ
}
 
- Static Protected Attributes inherited from TGLLogicalShape
static Bool_t fgIgnoreSizeForCameraInterest = kFALSE
 
static Bool_t fgUseDLs = kTRUE
 
static Bool_t fgUseDLsForVertArrs = kTRUE
 global flag for usage of display-lists More...
 

#include <TGLObject.h>

Inheritance diagram for TGLObject:
[legend]

Constructor & Destructor Documentation

◆ TGLObject()

TGLObject::TGLObject ( )
inline

Definition at line 53 of file TGLObject.h.

◆ ~TGLObject()

virtual TGLObject::~TGLObject ( )
inlinevirtual

Definition at line 54 of file TGLObject.h.

Member Function Documentation

◆ DynCast()

template<class TT >
TT* TGLObject::DynCast ( TObject obj)
inlineprotected

Definition at line 45 of file TGLObject.h.

◆ GetGLRenderer()

TClass * TGLObject::GetGLRenderer ( TClass isa)
static

Return direct-rendering GL class for class isa.

Zero is a valid response.

Definition at line 135 of file TGLObject.cxx.

◆ KeepDuringSmartRefresh()

virtual Bool_t TGLObject::KeepDuringSmartRefresh ( ) const
inlinevirtual

Reimplemented from TGLLogicalShape.

Reimplemented in TGLPlot3D, TGLParametricEquationGL, TF2GL, and TEvePlot3DGL.

Definition at line 62 of file TGLObject.h.

◆ SearchGLRenderer()

TClass * TGLObject::SearchGLRenderer ( TClass cls)
staticprivate

Recursively search cls and its base classes for a GL-renderer class.

Definition at line 108 of file TGLObject.cxx.

◆ SetAxisAlignedBBox() [1/2]

void TGLObject::SetAxisAlignedBBox ( const Float_t p)
protected

Set axis-aligned bounding-box.

Protected helper for subclasses.

Definition at line 98 of file TGLObject.cxx.

◆ SetAxisAlignedBBox() [2/2]

void TGLObject::SetAxisAlignedBBox ( Float_t  xmin,
Float_t  xmax,
Float_t  ymin,
Float_t  ymax,
Float_t  zmin,
Float_t  zmax 
)
protected

Set axis-aligned bounding-box.

Protected helper for subclasses.

Definition at line 86 of file TGLObject.cxx.

◆ SetBBox()

◆ SetModel()

◆ SetModelCheckClass()

Bool_t TGLObject::SetModelCheckClass ( TObject obj,
TClass cls 
)
protected

Checks if obj is of proper class and sets the model.

Protected helper for subclasses. Most sub-classes use exception-throwing SetModelDynCast() instead.

Definition at line 71 of file TGLObject.cxx.

◆ SetModelDynCast()

template<class TT >
TT* TGLObject::SetModelDynCast ( TObject obj)
inlineprotected

Definition at line 37 of file TGLObject.h.

◆ ShouldDLCache()

Bool_t TGLObject::ShouldDLCache ( const TGLRnrCtx rnrCtx) const
virtual

Decide if display-list should be used for this pass rendering, as determined by rnrCtx.

Reimplemented from TGLLogicalShape.

Reimplemented in TPointSet3DGL, TEveStraightLineSetGL, TEveCalo3DGL, and TEveBoxSetGL.

Definition at line 41 of file TGLObject.cxx.

◆ UpdateBoundingBox()

void TGLObject::UpdateBoundingBox ( )
virtual

Update bounding box from external source.

We call abstract SetBBox() and propagate the change to all attached physicals.

Reimplemented from TGLLogicalShape.

Definition at line 60 of file TGLObject.cxx.

Member Data Documentation

◆ fgGLClassMap

TMap TGLObject::fgGLClassMap
staticprivate

Definition at line 24 of file TGLObject.h.

◆ fMultiColor

Bool_t TGLObject::fMultiColor
mutableprotected

Definition at line 28 of file TGLObject.h.

Libraries for TGLObject:
[legend]

The documentation for this class was generated from the following files: