Concrete class describing an orientated (free) or axis aligned box of 8 vertices.

Supports methods for setting aligned or orientated boxes, find volume, axes, extents, centers, face planes etc. Also tests for overlap testing of planes and other bounding boxes, with fast sphere approximation.

Definition at line 32 of file TGLBoundingBox.h.

Public Types
enum	EFace { kFaceLowX , kFaceHighX , kFaceLowY , kFaceHighY , kFaceLowZ , kFaceHighZ , kFaceCount }

Public Member Functions
	TGLBoundingBox ()
	Construct an empty bounding box.

	TGLBoundingBox (const Double_t vertex[8][3])
	Construct a bounding box from provided 8 vertices.

	TGLBoundingBox (const TGLBoundingBox &other)
	Construct a bounding box as copy of existing one.

	TGLBoundingBox (const TGLVertex3 &lowVertex, const TGLVertex3 &highVertex)
	Construct an global axis ALIGNED bounding box from provided low/high vertex pair.

	TGLBoundingBox (const TGLVertex3 vertex[8])
	Construct a bounding box from provided 8 vertices.

virtual	~TGLBoundingBox ()
	Destroy bounding box.

const TGLVector3 &	Axis (UInt_t i, Bool_t normalised=kTRUE) const

TGLVertex3	Center () const

Double_t	Diagonal () const

void	Draw (Bool_t solid=kFALSE) const
	Draw the bounding box as either wireframe (default) of solid using current GL color.

void	Dump () const
	Output to std::cout the vertices, center and volume of box.

void	ExpandAligned (const TGLVertex3 &point)
	Expand current bbox so that it includes the point.

TGLVector3	Extents () const

const std::vector< UInt_t > &	FaceVertices (EFace face) const
	return a vector of face vertices y \| \| \|________x / 3----—2 / /\| /\| z 7----—6 \| \| 0--—\|-1 \|/ \|/ 4----—5

TGLPlane	GetNearPlane () const
	Return the near-plane.

virtual TClass *	IsA () const

Bool_t	IsEmpty () const

TGLVertex3	MaxAAVertex () const
	Find maximum vertex values.

void	MergeAligned (const TGLBoundingBox &other)
	Expand current bbox so that it includes other's bbox.

TGLVertex3	MinAAVertex () const
	Find minimum vertex values.

Int_t	NumVertices () const

TGLBoundingBox &	operator= (const TGLBoundingBox &other)

const TGLVertex3 &	operator[] (UInt_t index) const

Rgl::EOverlap	Overlap (const TGLBoundingBox &box) const
	Find overlap (Inside, Outside, Partial) of other bounding box c.f. us.

Rgl::EOverlap	Overlap (const TGLPlane &plane) const
	Find overlap (Inside, Outside, Partial) of plane c.f. bounding box.

void	PlaneSet (TGLPlaneSet_t &planeSet) const
	Fill out supplied plane set vector with TGLPlane objects representing six faces of box.

void	Scale (Double_t factor)
	Isotropically scale bounding box along it's LOCAL axes, preserving center.

void	Scale (Double_t xFactor, Double_t yFactor, Double_t zFactor)
	Asymmetrically scale box along it's LOCAL x,y,z axes, preserving center.

void	Set (const Double_t vertex[8][3])
	Set a bounding box from provided 8 vertices.

void	Set (const TGLBoundingBox &other)
	Set a bounding box from vertices of other.

void	Set (const TGLVertex3 vertex[8])
	Set a bounding box from provided 8 vertices.

void	SetAligned (const TGLVertex3 &lowVertex, const TGLVertex3 &highVertex)
	Set ALIGNED box from two low/high vertices.

void	SetAligned (UInt_t nbPnts, const Double_t *pnts)
	Set ALIGNED box from one or more points.

void	SetEmpty ()
	Set bounding box empty - all vertices at (0,0,0)

virtual void	Streamer (TBuffer &)

void	StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)

void	Transform (const TGLMatrix &matrix)
	Transform all vertices with matrix.

void	Translate (const TGLVector3 &offset)
	Translate all vertices by offset.

const TGLVertex3 &	Vertex (UInt_t index) const

const TGLVertex3 *	Vertices () const

Double_t	Volume () const

Double_t	XMax () const

Double_t	XMin () const

Double_t	YMax () const

Double_t	YMin () const

Double_t	ZMax () const

Double_t	ZMin () const

Static Public Member Functions
static TClass *	Class ()

static const char *	Class_Name ()

static constexpr Version_t	Class_Version ()

static const char *	DeclFileName ()

Private Member Functions
Double_t	Max (UInt_t index) const
	Find maximum vertex value for axis of index X(0), Y(1), Z(2)

Double_t	Min (UInt_t index) const
	Find minimum vertex value for axis of index X(0), Y(1), Z(2)

void	UpdateCache ()
	normalised box axes in global frame - cached for speed

Bool_t	ValidIndex (UInt_t index) const

Private Attributes
TGLVector3	fAxes [3]
	max box diagonal - cached for speed

TGLVector3	fAxesNorm [3]
	box axes in global frame - cached for speed

Double_t	fDiagonal
	box volume - cached for speed

TGLVertex3	fVertex [8]

Double_t	fVolume
	the 8 bounding box vertices

#include <TGLBoundingBox.h>

Member Enumeration Documentation

◆ EFace

enum TGLBoundingBox::EFace

Enumerator
kFaceLowX
kFaceHighX
kFaceLowY
kFaceHighY
kFaceLowZ
kFaceHighZ
kFaceCount

Definition at line 113 of file TGLBoundingBox.h.

Constructor & Destructor Documentation

◆ TGLBoundingBox() [1/5]

TGLBoundingBox::TGLBoundingBox ( )

Construct an empty bounding box.

Definition at line 31 of file TGLBoundingBox.cxx.

◆ TGLBoundingBox() [2/5]

TGLBoundingBox::TGLBoundingBox ( const TGLVertex3 vertex[8] )

Construct a bounding box from provided 8 vertices.

Definition at line 39 of file TGLBoundingBox.cxx.

◆ TGLBoundingBox() [3/5]

TGLBoundingBox::TGLBoundingBox ( const Double_t vertex[8][3] )

Construct a bounding box from provided 8 vertices.

Definition at line 47 of file TGLBoundingBox.cxx.

◆ TGLBoundingBox() [4/5]

TGLBoundingBox::TGLBoundingBox	(	const TGLVertex3 &	lowVertex,
		const TGLVertex3 &	highVertex
	)

Construct an global axis ALIGNED bounding box from provided low/high vertex pair.

Definition at line 55 of file TGLBoundingBox.cxx.

◆ TGLBoundingBox() [5/5]

TGLBoundingBox::TGLBoundingBox ( const TGLBoundingBox & other )

Construct a bounding box as copy of existing one.

Definition at line 63 of file TGLBoundingBox.cxx.

◆ ~TGLBoundingBox()

TGLBoundingBox::~TGLBoundingBox ( )

virtual

Destroy bounding box.

Definition at line 71 of file TGLBoundingBox.cxx.

Member Function Documentation

◆ Axis()

const TGLVector3 & TGLBoundingBox::Axis	(	UInt_t	i,
		Bool_t	normalised = `kTRUE`
	)		const

inline

Definition at line 183 of file TGLBoundingBox.h.

◆ Center()

TGLVertex3 TGLBoundingBox::Center ( ) const

inline

Definition at line 174 of file TGLBoundingBox.h.

◆ Class()

static TClass * TGLBoundingBox::Class ( )

static

Returns: TClass describing this class

◆ Class_Name()

static const char * TGLBoundingBox::Class_Name ( )

static

Returns: Name of this class

◆ Class_Version()

static constexpr Version_t TGLBoundingBox::Class_Version ( )

inlinestaticconstexpr

Returns: Version of this class

Definition at line 133 of file TGLBoundingBox.h.

◆ DeclFileName()

static const char * TGLBoundingBox::DeclFileName ( )

inlinestatic

Returns: Name of the file containing the class declaration

Definition at line 133 of file TGLBoundingBox.h.

◆ Diagonal()

Double_t TGLBoundingBox::Diagonal ( ) const

inline

Definition at line 122 of file TGLBoundingBox.h.

◆ Draw()

void TGLBoundingBox::Draw ( Bool_t solid = kFALSE ) const

Draw the bounding box as either wireframe (default) of solid using current GL color.

Definition at line 650 of file TGLBoundingBox.cxx.

◆ Dump()

void TGLBoundingBox::Dump ( ) const

Output to std::cout the vertices, center and volume of box.

Definition at line 775 of file TGLBoundingBox.cxx.

◆ ExpandAligned()

void TGLBoundingBox::ExpandAligned ( const TGLVertex3 & point )

Expand current bbox so that it includes the point.

This make the bbox axis-aligned.

Definition at line 271 of file TGLBoundingBox.cxx.

◆ Extents()

TGLVector3 TGLBoundingBox::Extents ( ) const

inline

Definition at line 165 of file TGLBoundingBox.h.

◆ FaceVertices()

const std::vector< UInt_t > & TGLBoundingBox::FaceVertices ( EFace face ) const

return a vector of face vertices y | | |________x / 3----—2 / /| /| z 7----—6 | | 0--—|-1 |/ |/ 4----—5

Definition at line 367 of file TGLBoundingBox.cxx.

◆ GetNearPlane()

TGLPlane TGLBoundingBox::GetNearPlane ( ) const

Return the near-plane.

Definition at line 438 of file TGLBoundingBox.cxx.

◆ IsA()

virtual TClass * TGLBoundingBox::IsA ( ) const

inlinevirtual

Returns: TClass describing current object

Definition at line 133 of file TGLBoundingBox.h.

◆ IsEmpty()

Bool_t TGLBoundingBox::IsEmpty ( ) const

inline

Definition at line 207 of file TGLBoundingBox.h.

◆ Max()

Double_t TGLBoundingBox::Max ( UInt_t index ) const

private

Find maximum vertex value for axis of index X(0), Y(1), Z(2)

Definition at line 745 of file TGLBoundingBox.cxx.

◆ MaxAAVertex()

TGLVertex3 TGLBoundingBox::MaxAAVertex ( ) const

Find maximum vertex values.

Definition at line 767 of file TGLBoundingBox.cxx.

◆ MergeAligned()

void TGLBoundingBox::MergeAligned ( const TGLBoundingBox & other )

Expand current bbox so that it includes other's bbox.

This make the bbox axis-aligned.

Definition at line 249 of file TGLBoundingBox.cxx.

◆ Min()

Double_t TGLBoundingBox::Min ( UInt_t index ) const

private

Find minimum vertex value for axis of index X(0), Y(1), Z(2)

Definition at line 731 of file TGLBoundingBox.cxx.

◆ MinAAVertex()

TGLVertex3 TGLBoundingBox::MinAAVertex ( ) const

Find minimum vertex values.

Definition at line 759 of file TGLBoundingBox.cxx.

◆ NumVertices()

Int_t TGLBoundingBox::NumVertices ( ) const

inline

Definition at line 111 of file TGLBoundingBox.h.

◆ operator=()

TGLBoundingBox & TGLBoundingBox::operator= ( const TGLBoundingBox & other )

inline

Definition at line 137 of file TGLBoundingBox.h.

◆ operator[]()

const TGLVertex3 & TGLBoundingBox::operator[] ( UInt_t index ) const

inline

Definition at line 147 of file TGLBoundingBox.h.

◆ Overlap() [1/2]

Rgl::EOverlap TGLBoundingBox::Overlap ( const TGLBoundingBox & box ) const

Find overlap (Inside, Outside, Partial) of other bounding box c.f. us.

Definition at line 476 of file TGLBoundingBox.cxx.

◆ Overlap() [2/2]

Rgl::EOverlap TGLBoundingBox::Overlap ( const TGLPlane & plane ) const

Find overlap (Inside, Outside, Partial) of plane c.f. bounding box.

Definition at line 446 of file TGLBoundingBox.cxx.

◆ PlaneSet()

void TGLBoundingBox::PlaneSet ( TGLPlaneSet_t & planeSet ) const

Fill out supplied plane set vector with TGLPlane objects representing six faces of box.

Definition at line 411 of file TGLBoundingBox.cxx.

◆ Scale() [1/2]

void TGLBoundingBox::Scale ( Double_t factor )

Isotropically scale bounding box along it's LOCAL axes, preserving center.

Definition at line 285 of file TGLBoundingBox.cxx.

◆ Scale() [2/2]

void TGLBoundingBox::Scale	(	Double_t	xFactor,
		Double_t	yFactor,
		Double_t	zFactor
	)

Asymmetrically scale box along it's LOCAL x,y,z axes, preserving center.

Definition at line 295 of file TGLBoundingBox.cxx.

◆ Set() [1/3]

void TGLBoundingBox::Set ( const Double_t vertex[8][3] )

Set a bounding box from provided 8 vertices.

Definition at line 144 of file TGLBoundingBox.cxx.

◆ Set() [2/3]

void TGLBoundingBox::Set ( const TGLBoundingBox & other )

Set a bounding box from vertices of other.

Definition at line 158 of file TGLBoundingBox.cxx.

◆ Set() [3/3]

void TGLBoundingBox::Set ( const TGLVertex3 vertex[8] )

Set a bounding box from provided 8 vertices.

Definition at line 132 of file TGLBoundingBox.cxx.

◆ SetAligned() [1/2]

void TGLBoundingBox::SetAligned	(	const TGLVertex3 &	lowVertex,
		const TGLVertex3 &	highVertex
	)

Set ALIGNED box from two low/high vertices.

Box axes are aligned with global frame axes that vertices are specified in.

Definition at line 183 of file TGLBoundingBox.cxx.

◆ SetAligned() [2/2]

void TGLBoundingBox::SetAligned	(	UInt_t	nbPnts,
		const Double_t *	pnts
	)

Set ALIGNED box from one or more points.

Box axes are aligned with global frame axes that points are specified in.

Definition at line 220 of file TGLBoundingBox.cxx.

◆ SetEmpty()

void TGLBoundingBox::SetEmpty ( )

Set bounding box empty - all vertices at (0,0,0)

Definition at line 170 of file TGLBoundingBox.cxx.

◆ Streamer()

virtual void TGLBoundingBox::Streamer ( TBuffer & )

virtual

◆ StreamerNVirtual()

void TGLBoundingBox::StreamerNVirtual ( TBuffer & ClassDef_StreamerNVirtual_b )

inline

Definition at line 133 of file TGLBoundingBox.h.

◆ Transform()

void TGLBoundingBox::Transform ( const TGLMatrix & matrix )

Transform all vertices with matrix.

Definition at line 343 of file TGLBoundingBox.cxx.

◆ Translate()

void TGLBoundingBox::Translate ( const TGLVector3 & offset )

Translate all vertices by offset.

Definition at line 331 of file TGLBoundingBox.cxx.

◆ UpdateCache()

void TGLBoundingBox::UpdateCache ( )

private

normalised box axes in global frame - cached for speed

Update the internally cached volume and axes vectors - these are retained for efficiency - many more reads than modifications.

Definition at line 79 of file TGLBoundingBox.cxx.

◆ ValidIndex()

Bool_t TGLBoundingBox::ValidIndex ( UInt_t index ) const

inlineprivate

Definition at line 66 of file TGLBoundingBox.h.

◆ Vertex()

const TGLVertex3 & TGLBoundingBox::Vertex ( UInt_t index ) const

inline

Definition at line 153 of file TGLBoundingBox.h.

◆ Vertices()

const TGLVertex3 * TGLBoundingBox::Vertices ( ) const

inline

Definition at line 159 of file TGLBoundingBox.h.

◆ Volume()

Double_t TGLBoundingBox::Volume ( ) const

inline

Definition at line 121 of file TGLBoundingBox.h.

◆ XMax()

Double_t TGLBoundingBox::XMax ( ) const

inline

Definition at line 101 of file TGLBoundingBox.h.

◆ XMin()

Double_t TGLBoundingBox::XMin ( ) const

inline

Definition at line 100 of file TGLBoundingBox.h.

◆ YMax()

Double_t TGLBoundingBox::YMax ( ) const

inline

Definition at line 103 of file TGLBoundingBox.h.

◆ YMin()

Double_t TGLBoundingBox::YMin ( ) const

inline

Definition at line 102 of file TGLBoundingBox.h.

◆ ZMax()

Double_t TGLBoundingBox::ZMax ( ) const

inline

Definition at line 105 of file TGLBoundingBox.h.

◆ ZMin()

Double_t TGLBoundingBox::ZMin ( ) const

inline

Definition at line 104 of file TGLBoundingBox.h.

Member Data Documentation

◆ fAxes

TGLVector3 TGLBoundingBox::fAxes[3]

private

max box diagonal - cached for speed

Definition at line 61 of file TGLBoundingBox.h.

◆ fAxesNorm

TGLVector3 TGLBoundingBox::fAxesNorm[3]

private

box axes in global frame - cached for speed

Definition at line 62 of file TGLBoundingBox.h.

◆ fDiagonal

Double_t TGLBoundingBox::fDiagonal

private

box volume - cached for speed

Definition at line 60 of file TGLBoundingBox.h.

◆ fVertex

TGLVertex3 TGLBoundingBox::fVertex[8]

private

Definition at line 58 of file TGLBoundingBox.h.

◆ fVolume

Double_t TGLBoundingBox::fVolume

private

the 8 bounding box vertices

Definition at line 59 of file TGLBoundingBox.h.

Libraries for TGLBoundingBox:

[legend]

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

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

Public Types

Public Member Functions

Static Public Member Functions

Private Member Functions

Private Attributes

Member Enumeration Documentation

◆ EFace

Constructor & Destructor Documentation

◆ TGLBoundingBox() [1/5]

◆ TGLBoundingBox() [2/5]

◆ TGLBoundingBox() [3/5]

◆ TGLBoundingBox() [4/5]

◆ TGLBoundingBox() [5/5]

◆ ~TGLBoundingBox()

Member Function Documentation

◆ Axis()

◆ Center()

◆ Class()

◆ Class_Name()

◆ Class_Version()

◆ DeclFileName()

◆ Diagonal()

◆ Draw()

◆ Dump()

◆ ExpandAligned()

◆ Extents()

◆ FaceVertices()

◆ GetNearPlane()

◆ IsA()

◆ IsEmpty()

◆ Max()

◆ MaxAAVertex()

◆ MergeAligned()

◆ Min()

◆ MinAAVertex()

◆ NumVertices()

◆ operator=()

◆ operator[]()

◆ Overlap() [1/2]

◆ Overlap() [2/2]

◆ PlaneSet()

◆ Scale() [1/2]

◆ Scale() [2/2]

◆ Set() [1/3]

◆ Set() [2/3]

◆ Set() [3/3]

◆ SetAligned() [1/2]

◆ SetAligned() [2/2]

◆ SetEmpty()

◆ Streamer()

◆ StreamerNVirtual()

◆ Transform()

◆ Translate()

◆ UpdateCache()

◆ ValidIndex()

◆ Vertex()

◆ Vertices()

◆ Volume()

◆ XMax()

◆ XMin()

◆ YMax()

◆ YMin()

◆ ZMax()

◆ ZMin()

Member Data Documentation

◆ fAxes

◆ fAxesNorm

◆ fDiagonal

◆ fVertex

◆ fVolume