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 ()
	Constructor. More...

	TGLLogicalShape (TObject *obj)
	Constructor with external object. More...

	TGLLogicalShape (const TBuffer3D &buffer)
	Constructor from TBuffer3D. 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 TGLBoundingBox &	BoundingBox () 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...

TObject *	GetExternal () const

const TGLPhysicalShape *	GetFirstPhysical () const

TGLScene *	GetScene () const

TObject *	ID () 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 TClass *	GetGLRenderer (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	SetIgnoreSizeForCameraInterest (Bool_t isfci)
	Set state of static fgIgnoreSizeForCameraInterest flag. More...

Protected Member Functions
template<class TT >
TT *	DynCast (TObject *obj)

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...

void	SetAxisAlignedBBox (const Float_t *p)
	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...

TObject *	fExternalObj
	first replica More...

TGLPhysicalShape *	fFirstPhysical
	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...

TGLScene *	fScene
	Shape's bounding box. More...

Static Private Member Functions
static TClass *	SearchGLRenderer (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

#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, TF2GL, TGLParametricEquationGL, 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	(	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.

◆ SetAxisAlignedBBox() [2/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.

◆ SetBBox()

virtual void TGLObject::SetBBox ( )

pure virtual

◆ SetModel()

virtual Bool_t TGLObject::SetModel	(	TObject *	obj,
		const Option_t *	opt = `0`
	)

pure virtual

◆ 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 TEveCalo3DGL, TEveStraightLineSetGL, TEveBoxSetGL, and TPointSet3DGL.

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.

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

graf3d/gl/inc/TGLObject.h
graf3d/gl/src/TGLObject.cxx

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Static Private Member Functions

Static Private Attributes

Additional Inherited Members

Constructor & Destructor Documentation

◆ TGLObject()

◆ ~TGLObject()

Member Function Documentation

◆ DynCast()

◆ GetGLRenderer()

◆ KeepDuringSmartRefresh()

◆ SearchGLRenderer()

◆ SetAxisAlignedBBox() [1/2]

◆ SetAxisAlignedBBox() [2/2]

◆ SetBBox()

◆ SetModel()

◆ SetModelCheckClass()

◆ SetModelDynCast()

◆ ShouldDLCache()

◆ UpdateBoundingBox()

Member Data Documentation

◆ fgGLClassMap

◆ fMultiColor