Logo ROOT  
Reference Guide
Loading...
Searching...
No Matches
TGLScene::TSceneInfo Class Reference

Definition at line 78 of file TGLScene.h.

Public Types

enum  EClipTest { kClipNone , kClipOutside , kClipInside }

Public Member Functions

 TSceneInfo (TGLViewerBase *view=nullptr, TGLScene *scene=nullptr)
 Constructor.
 ~TSceneInfo () override
 Destructor.
UInt_t CameraStamp () const
void ClearAfterRebuild ()
 Clear DrawElementVector fVisibleElement and optionally resize it so that it doesn't take more space then required by all the elements in the scene's draw-list.
void ClearAfterUpdate ()
 Clear DrawElementPtrVectors and optionally resize them so that they don't take more space then required by all the elements in the scene's draw-list.
TGLClipClip () const
Char_t ClipMode () const
void ClipMode (Char_t m)
std::vector< TGLPlane > & ClipPlanes ()
UInt_t ClipStamp () const
void DumpDrawStats ()
 Output draw stats to Info stream.
std::vector< TGLPlane > & FrustumPlanes ()
Bool_t GetActive () const
TGLSceneBaseGetScene () const
const TGLBoundingBoxGetTransformedBBox ()
TGLViewerBaseGetViewer () const
Bool_t HasUpdateTimeouted () const
void InClip (Bool_t c)
void InFrustum (Bool_t f)
virtual TClassIsA () const
Bool_t IsInClip () const
Bool_t IsInFrustum () const
Bool_t IsVisible () const
TGLCameraLastCamera () const
TGLClipLastClip () const
Short_t LastLOD () const
Float_t LastOLLineW () const
Short_t LastStyle () const
Float_t LastWFLineW () const
Short_t LOD () const
void Lodify (TGLRnrCtx &ctx)
 Quantize LODs for given render-context.
Float_t OLLineW () const
void PostDraw ()
 Clean-up after drawing, nothing to be done here.
void PreDraw ()
 Prepare for drawing - fill DrawElementPtrVectors from the contents of fVisibleElements if there was some change.
TGLSceneBaseRefScene () const
TGLViewerBaseRefViewer () const
void ResetCameraStamp ()
void ResetClipStamp ()
void ResetDrawStats ()
 Reset draw statistics.
void ResetSceneStamp ()
void ResetUpdateTimeouted ()
UInt_t SceneStamp () const
void SetActive (Bool_t a)
 Set active state of the scene, mark viewer as changed.
void SetCameraStamp (UInt_t ts)
void SetClip (TGLClip *p)
void SetClipStamp (UInt_t ts)
void SetLastCamera (TGLCamera *p)
void SetLastClip (TGLClip *p)
void SetLastLOD (Short_t ld)
void SetLastOLLineW (Float_t w)
void SetLastStyle (Short_t st)
void SetLastWFLineW (Float_t w)
void SetLOD (Short_t lod)
void SetOLLineW (Float_t w)
void SetSceneStamp (UInt_t ts)
virtual void SetSceneTrans (TGLMatrix &)
void SetStyle (Short_t st)
void SetupTransformsAndBBox ()
 Combine information from scene, scene-info and camera (should be optional) into transformation matrices.
void SetWFLineW (Float_t w)
Bool_t ShouldClip () const
virtual void Streamer (TBuffer &)
void StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)
Short_t Style () const
void UpdateDrawStats (const TGLPhysicalShape &shape, Short_t lod)
 Update draw stats, for newly drawn 'shape'.
void UpdateTimeouted ()
Bool_t ViewCheck () const
void ViewCheck (Bool_t c)
Float_t WFLineW () const

Static Public Member Functions

static TClassClass ()
static const char * Class_Name ()
static constexpr Version_t Class_Version ()
static const char * DeclFileName ()

Public Attributes

Int_t fAsPixelCnt
std::map< TClass *, UInt_tfByShapeCnt
UInt_t fMinorStamp
Int_t fOpaqueCnt
DrawElementPtrVec_t fOpaqueElements
DrawElementPtrVec_t fSelOpaqueElements
DrawElementPtrVec_t fSelTranspElements
ShapeVec_t fShapesOfInterest
Int_t fTranspCnt
DrawElementPtrVec_t fTranspElements
DrawElementVec_t fVisibleElements

Protected Member Functions

void ClearDrawElementPtrVec (DrawElementPtrVec_t &vec, Int_t maxSize)
 Clear given vec and if it grew too large compared to the size of shape-of-interest also resize it.
void ClearDrawElementVec (DrawElementVec_t &vec, Int_t maxSize)
 Clear given vec and if it grew too large compared to the size of shape-of-interest also resize it.

Protected Attributes

Bool_t fActive
UInt_t fCameraStamp
TGLClipfClip
Char_t fClipMode
TGLPlaneSet_t fClipPlanes
UInt_t fClipStamp
TGLPlaneSet_t fFrustumPlanes
Bool_t fInClip
Bool_t fInFrustum
TGLCamerafLastCamera
TGLClipfLastClip
Short_t fLastLOD
Float_t fLastOLLineW
Short_t fLastStyle
Float_t fLastWFLineW
Short_t fLOD
Float_t fOLLineW
TGLSceneBasefScene
UInt_t fSceneStamp
Short_t fStyle
TGLBoundingBox fTransformedBBox
Bool_t fUpdateTimeouted
Bool_t fViewCheck
TGLViewerBasefViewer
Float_t fWFLineW

Private Member Functions

Bool_t CmpDrawElements (const DrawElement_t &de1, const DrawElement_t &de2)

#include <TGLScene.h>

Inheritance diagram for TGLScene::TSceneInfo:
TGLSceneInfo

Member Enumeration Documentation

◆ EClipTest

enum TGLSceneInfo::EClipTest
inherited
Enumerator
kClipNone 
kClipOutside 
kClipInside 

Definition at line 32 of file TGLSceneInfo.h.

Constructor & Destructor Documentation

◆ TSceneInfo()

TGLScene::TSceneInfo::TSceneInfo ( TGLViewerBase * view = nullptr,
TGLScene * scene = nullptr )

Constructor.

Definition at line 48 of file TGLScene.cxx.

◆ ~TSceneInfo()

TGLScene::TSceneInfo::~TSceneInfo ( )
override

Destructor.

Definition at line 60 of file TGLScene.cxx.

Member Function Documentation

◆ CameraStamp()

UInt_t TGLSceneInfo::CameraStamp ( ) const
inlineinherited

Definition at line 150 of file TGLSceneInfo.h.

◆ Class()

TClass * TGLSceneInfo::Class ( )
staticinherited
Returns
TClass describing this class

◆ Class_Name()

const char * TGLSceneInfo::Class_Name ( )
staticinherited
Returns
Name of this class

◆ Class_Version()

constexpr Version_t TGLSceneInfo::Class_Version ( )
inlinestaticconstexprinherited
Returns
Version of this class

Definition at line 158 of file TGLSceneInfo.h.

◆ ClearAfterRebuild()

void TGLScene::TSceneInfo::ClearAfterRebuild ( )

Clear DrawElementVector fVisibleElement and optionally resize it so that it doesn't take more space then required by all the elements in the scene's draw-list.

Definition at line 101 of file TGLScene.cxx.

◆ ClearAfterUpdate()

void TGLScene::TSceneInfo::ClearAfterUpdate ( )

Clear DrawElementPtrVectors and optionally resize them so that they don't take more space then required by all the elements in the scene's draw-list.

Definition at line 113 of file TGLScene.cxx.

◆ ClearDrawElementPtrVec()

void TGLScene::TSceneInfo::ClearDrawElementPtrVec ( DrawElementPtrVec_t & vec,
Int_t maxSize )
protected

Clear given vec and if it grew too large compared to the size of shape-of-interest also resize it.

Definition at line 84 of file TGLScene.cxx.

◆ ClearDrawElementVec()

void TGLScene::TSceneInfo::ClearDrawElementVec ( DrawElementVec_t & vec,
Int_t maxSize )
protected

Clear given vec and if it grew too large compared to the size of shape-of-interest also resize it.

Definition at line 68 of file TGLScene.cxx.

◆ Clip()

TGLClip * TGLSceneInfo::Clip ( ) const
inlineinherited

Definition at line 122 of file TGLSceneInfo.h.

◆ ClipMode() [1/2]

Char_t TGLSceneInfo::ClipMode ( ) const
inlineinherited

Definition at line 102 of file TGLSceneInfo.h.

◆ ClipMode() [2/2]

void TGLSceneInfo::ClipMode ( Char_t m)
inlineinherited

Definition at line 103 of file TGLSceneInfo.h.

◆ ClipPlanes()

std::vector< TGLPlane > & TGLSceneInfo::ClipPlanes ( )
inlineinherited

Definition at line 109 of file TGLSceneInfo.h.

◆ ClipStamp()

UInt_t TGLSceneInfo::ClipStamp ( ) const
inlineinherited

Definition at line 146 of file TGLSceneInfo.h.

◆ CmpDrawElements()

Bool_t TGLScene::TSceneInfo::CmpDrawElements ( const DrawElement_t & de1,
const DrawElement_t & de2 )
private

◆ DeclFileName()

const char * TGLSceneInfo::DeclFileName ( )
inlinestaticinherited
Returns
Name of the file containing the class declaration

Definition at line 158 of file TGLSceneInfo.h.

◆ DumpDrawStats()

void TGLScene::TSceneInfo::DumpDrawStats ( )

Output draw stats to Info stream.

Definition at line 218 of file TGLScene.cxx.

◆ FrustumPlanes()

std::vector< TGLPlane > & TGLSceneInfo::FrustumPlanes ( )
inlineinherited

Definition at line 108 of file TGLSceneInfo.h.

◆ GetActive()

Bool_t TGLSceneInfo::GetActive ( ) const
inlineinherited

Definition at line 87 of file TGLSceneInfo.h.

◆ GetScene()

TGLSceneBase * TGLSceneInfo::GetScene ( ) const
inlineinherited

Definition at line 84 of file TGLSceneInfo.h.

◆ GetTransformedBBox()

const TGLBoundingBox & TGLSceneInfo::GetTransformedBBox ( )
inlineinherited

Definition at line 92 of file TGLSceneInfo.h.

◆ GetViewer()

TGLViewerBase * TGLSceneInfo::GetViewer ( ) const
inlineinherited

Definition at line 82 of file TGLSceneInfo.h.

◆ HasUpdateTimeouted()

Bool_t TGLSceneInfo::HasUpdateTimeouted ( ) const
inlineinherited

Definition at line 154 of file TGLSceneInfo.h.

◆ InClip()

void TGLSceneInfo::InClip ( Bool_t c)
inlineinherited

Definition at line 101 of file TGLSceneInfo.h.

◆ InFrustum()

void TGLSceneInfo::InFrustum ( Bool_t f)
inlineinherited

Definition at line 99 of file TGLSceneInfo.h.

◆ IsA()

virtual TClass * TGLSceneInfo::IsA ( ) const
inlinevirtualinherited
Returns
TClass describing current object

Definition at line 158 of file TGLSceneInfo.h.

◆ IsInClip()

Bool_t TGLSceneInfo::IsInClip ( ) const
inlineinherited

Definition at line 100 of file TGLSceneInfo.h.

◆ IsInFrustum()

Bool_t TGLSceneInfo::IsInFrustum ( ) const
inlineinherited

Definition at line 98 of file TGLSceneInfo.h.

◆ IsVisible()

Bool_t TGLSceneInfo::IsVisible ( ) const
inlineinherited

Definition at line 106 of file TGLSceneInfo.h.

◆ LastCamera()

TGLCamera * TGLSceneInfo::LastCamera ( ) const
inlineinherited

Definition at line 139 of file TGLSceneInfo.h.

◆ LastClip()

TGLClip * TGLSceneInfo::LastClip ( ) const
inlineinherited

Definition at line 136 of file TGLSceneInfo.h.

◆ LastLOD()

Short_t TGLSceneInfo::LastLOD ( ) const
inlineinherited

Definition at line 125 of file TGLSceneInfo.h.

◆ LastOLLineW()

Float_t TGLSceneInfo::LastOLLineW ( ) const
inlineinherited

Definition at line 133 of file TGLSceneInfo.h.

◆ LastStyle()

Short_t TGLSceneInfo::LastStyle ( ) const
inlineinherited

Definition at line 128 of file TGLSceneInfo.h.

◆ LastWFLineW()

Float_t TGLSceneInfo::LastWFLineW ( ) const
inlineinherited

Definition at line 131 of file TGLSceneInfo.h.

◆ LOD()

Short_t TGLSceneInfo::LOD ( ) const
inlineinherited

Definition at line 111 of file TGLSceneInfo.h.

◆ Lodify()

void TGLScene::TSceneInfo::Lodify ( TGLRnrCtx & ctx)

Quantize LODs for given render-context.

Definition at line 128 of file TGLScene.cxx.

◆ OLLineW()

Float_t TGLSceneInfo::OLLineW ( ) const
inlineinherited

Definition at line 119 of file TGLSceneInfo.h.

◆ PostDraw()

void TGLScene::TSceneInfo::PostDraw ( )

Clean-up after drawing, nothing to be done here.

Definition at line 169 of file TGLScene.cxx.

◆ PreDraw()

void TGLScene::TSceneInfo::PreDraw ( )

Prepare for drawing - fill DrawElementPtrVectors from the contents of fVisibleElements if there was some change.

Definition at line 138 of file TGLScene.cxx.

◆ RefScene()

TGLSceneBase & TGLSceneInfo::RefScene ( ) const
inlineinherited

Definition at line 85 of file TGLSceneInfo.h.

◆ RefViewer()

TGLViewerBase & TGLSceneInfo::RefViewer ( ) const
inlineinherited

Definition at line 83 of file TGLSceneInfo.h.

◆ ResetCameraStamp()

void TGLSceneInfo::ResetCameraStamp ( )
inlineinherited

Definition at line 152 of file TGLSceneInfo.h.

◆ ResetClipStamp()

void TGLSceneInfo::ResetClipStamp ( )
inlineinherited

Definition at line 148 of file TGLSceneInfo.h.

◆ ResetDrawStats()

void TGLScene::TSceneInfo::ResetDrawStats ( )

Reset draw statistics.

Definition at line 176 of file TGLScene.cxx.

◆ ResetSceneStamp()

void TGLSceneInfo::ResetSceneStamp ( )
inlineinherited

Definition at line 144 of file TGLSceneInfo.h.

◆ ResetUpdateTimeouted()

void TGLSceneInfo::ResetUpdateTimeouted ( )
inlineinherited

Definition at line 156 of file TGLSceneInfo.h.

◆ SceneStamp()

UInt_t TGLSceneInfo::SceneStamp ( ) const
inlineinherited

Definition at line 142 of file TGLSceneInfo.h.

◆ SetActive()

void TGLSceneInfo::SetActive ( Bool_t a)
inherited

Set active state of the scene, mark viewer as changed.

Definition at line 69 of file TGLSceneInfo.cxx.

◆ SetCameraStamp()

void TGLSceneInfo::SetCameraStamp ( UInt_t ts)
inlineinherited

Definition at line 151 of file TGLSceneInfo.h.

◆ SetClip()

void TGLSceneInfo::SetClip ( TGLClip * p)
inlineinherited

Definition at line 123 of file TGLSceneInfo.h.

◆ SetClipStamp()

void TGLSceneInfo::SetClipStamp ( UInt_t ts)
inlineinherited

Definition at line 147 of file TGLSceneInfo.h.

◆ SetLastCamera()

void TGLSceneInfo::SetLastCamera ( TGLCamera * p)
inlineinherited

Definition at line 140 of file TGLSceneInfo.h.

◆ SetLastClip()

void TGLSceneInfo::SetLastClip ( TGLClip * p)
inlineinherited

Definition at line 137 of file TGLSceneInfo.h.

◆ SetLastLOD()

void TGLSceneInfo::SetLastLOD ( Short_t ld)
inlineinherited

Definition at line 126 of file TGLSceneInfo.h.

◆ SetLastOLLineW()

void TGLSceneInfo::SetLastOLLineW ( Float_t w)
inlineinherited

Definition at line 134 of file TGLSceneInfo.h.

◆ SetLastStyle()

void TGLSceneInfo::SetLastStyle ( Short_t st)
inlineinherited

Definition at line 129 of file TGLSceneInfo.h.

◆ SetLastWFLineW()

void TGLSceneInfo::SetLastWFLineW ( Float_t w)
inlineinherited

Definition at line 132 of file TGLSceneInfo.h.

◆ SetLOD()

void TGLSceneInfo::SetLOD ( Short_t lod)
inlineinherited

Definition at line 112 of file TGLSceneInfo.h.

◆ SetOLLineW()

void TGLSceneInfo::SetOLLineW ( Float_t w)
inlineinherited

Definition at line 120 of file TGLSceneInfo.h.

◆ SetSceneStamp()

void TGLSceneInfo::SetSceneStamp ( UInt_t ts)
inlineinherited

Definition at line 143 of file TGLSceneInfo.h.

◆ SetSceneTrans()

virtual void TGLSceneInfo::SetSceneTrans ( TGLMatrix & )
inlinevirtualinherited

Definition at line 94 of file TGLSceneInfo.h.

◆ SetStyle()

void TGLSceneInfo::SetStyle ( Short_t st)
inlineinherited

Definition at line 115 of file TGLSceneInfo.h.

◆ SetupTransformsAndBBox()

void TGLSceneInfo::SetupTransformsAndBBox ( )
inherited

Combine information from scene, scene-info and camera (should be optional) into transformation matrices.

Transform scene bounding box using this transformation.

Definition at line 84 of file TGLSceneInfo.cxx.

◆ SetWFLineW()

void TGLSceneInfo::SetWFLineW ( Float_t w)
inlineinherited

Definition at line 118 of file TGLSceneInfo.h.

◆ ShouldClip()

Bool_t TGLSceneInfo::ShouldClip ( ) const
inlineinherited

Definition at line 105 of file TGLSceneInfo.h.

◆ Streamer()

virtual void TGLSceneInfo::Streamer ( TBuffer & )
virtualinherited

◆ StreamerNVirtual()

void TGLSceneInfo::StreamerNVirtual ( TBuffer & ClassDef_StreamerNVirtual_b)
inlineinherited

Definition at line 158 of file TGLSceneInfo.h.

◆ Style()

Short_t TGLSceneInfo::Style ( ) const
inlineinherited

Definition at line 114 of file TGLSceneInfo.h.

◆ UpdateDrawStats()

void TGLScene::TSceneInfo::UpdateDrawStats ( const TGLPhysicalShape & shape,
Short_t lod )

Update draw stats, for newly drawn 'shape'.

Definition at line 187 of file TGLScene.cxx.

◆ UpdateTimeouted()

void TGLSceneInfo::UpdateTimeouted ( )
inlineinherited

Definition at line 155 of file TGLSceneInfo.h.

◆ ViewCheck() [1/2]

Bool_t TGLSceneInfo::ViewCheck ( ) const
inlineinherited

Definition at line 96 of file TGLSceneInfo.h.

◆ ViewCheck() [2/2]

void TGLSceneInfo::ViewCheck ( Bool_t c)
inlineinherited

Definition at line 97 of file TGLSceneInfo.h.

◆ WFLineW()

Float_t TGLSceneInfo::WFLineW ( ) const
inlineinherited

Definition at line 117 of file TGLSceneInfo.h.

Member Data Documentation

◆ fActive

Bool_t TGLSceneInfo::fActive
protectedinherited

Definition at line 41 of file TGLSceneInfo.h.

◆ fAsPixelCnt

Int_t TGLScene::TSceneInfo::fAsPixelCnt

Definition at line 114 of file TGLScene.h.

◆ fByShapeCnt

std::map<TClass*, UInt_t> TGLScene::TSceneInfo::fByShapeCnt

Definition at line 115 of file TGLScene.h.

◆ fCameraStamp

UInt_t TGLSceneInfo::fCameraStamp
protectedinherited

Definition at line 58 of file TGLSceneInfo.h.

◆ fClip

TGLClip* TGLSceneInfo::fClip
protectedinherited

Definition at line 47 of file TGLSceneInfo.h.

◆ fClipMode

Char_t TGLSceneInfo::fClipMode
protectedinherited

Definition at line 71 of file TGLSceneInfo.h.

◆ fClipPlanes

TGLPlaneSet_t TGLSceneInfo::fClipPlanes
protectedinherited

Definition at line 73 of file TGLSceneInfo.h.

◆ fClipStamp

UInt_t TGLSceneInfo::fClipStamp
protectedinherited

Definition at line 57 of file TGLSceneInfo.h.

◆ fFrustumPlanes

TGLPlaneSet_t TGLSceneInfo::fFrustumPlanes
protectedinherited

Definition at line 72 of file TGLSceneInfo.h.

◆ fInClip

Bool_t TGLSceneInfo::fInClip
protectedinherited

Definition at line 70 of file TGLSceneInfo.h.

◆ fInFrustum

Bool_t TGLSceneInfo::fInFrustum
protectedinherited

Definition at line 69 of file TGLSceneInfo.h.

◆ fLastCamera

TGLCamera* TGLSceneInfo::fLastCamera
protectedinherited

Definition at line 54 of file TGLSceneInfo.h.

◆ fLastClip

TGLClip* TGLSceneInfo::fLastClip
protectedinherited

Definition at line 53 of file TGLSceneInfo.h.

◆ fLastLOD

Short_t TGLSceneInfo::fLastLOD
protectedinherited

Definition at line 49 of file TGLSceneInfo.h.

◆ fLastOLLineW

Float_t TGLSceneInfo::fLastOLLineW
protectedinherited

Definition at line 52 of file TGLSceneInfo.h.

◆ fLastStyle

Short_t TGLSceneInfo::fLastStyle
protectedinherited

Definition at line 50 of file TGLSceneInfo.h.

◆ fLastWFLineW

Float_t TGLSceneInfo::fLastWFLineW
protectedinherited

Definition at line 51 of file TGLSceneInfo.h.

◆ fLOD

Short_t TGLSceneInfo::fLOD
protectedinherited

Definition at line 43 of file TGLSceneInfo.h.

◆ fMinorStamp

UInt_t TGLScene::TSceneInfo::fMinorStamp

Definition at line 92 of file TGLScene.h.

◆ fOLLineW

Float_t TGLSceneInfo::fOLLineW
protectedinherited

Definition at line 46 of file TGLSceneInfo.h.

◆ fOpaqueCnt

Int_t TGLScene::TSceneInfo::fOpaqueCnt

Definition at line 112 of file TGLScene.h.

◆ fOpaqueElements

DrawElementPtrVec_t TGLScene::TSceneInfo::fOpaqueElements

Definition at line 93 of file TGLScene.h.

◆ fScene

TGLSceneBase* TGLSceneInfo::fScene
protectedinherited

Definition at line 40 of file TGLSceneInfo.h.

◆ fSceneStamp

UInt_t TGLSceneInfo::fSceneStamp
protectedinherited

Definition at line 56 of file TGLSceneInfo.h.

◆ fSelOpaqueElements

DrawElementPtrVec_t TGLScene::TSceneInfo::fSelOpaqueElements

Definition at line 95 of file TGLScene.h.

◆ fSelTranspElements

DrawElementPtrVec_t TGLScene::TSceneInfo::fSelTranspElements

Definition at line 96 of file TGLScene.h.

◆ fShapesOfInterest

ShapeVec_t TGLScene::TSceneInfo::fShapesOfInterest

Definition at line 88 of file TGLScene.h.

◆ fStyle

Short_t TGLSceneInfo::fStyle
protectedinherited

Definition at line 44 of file TGLSceneInfo.h.

◆ fTransformedBBox

TGLBoundingBox TGLSceneInfo::fTransformedBBox
protectedinherited

Definition at line 66 of file TGLSceneInfo.h.

◆ fTranspCnt

Int_t TGLScene::TSceneInfo::fTranspCnt

Definition at line 113 of file TGLScene.h.

◆ fTranspElements

DrawElementPtrVec_t TGLScene::TSceneInfo::fTranspElements

Definition at line 94 of file TGLScene.h.

◆ fUpdateTimeouted

Bool_t TGLSceneInfo::fUpdateTimeouted
protectedinherited

Definition at line 59 of file TGLSceneInfo.h.

◆ fViewCheck

Bool_t TGLSceneInfo::fViewCheck
protectedinherited

Definition at line 68 of file TGLSceneInfo.h.

◆ fViewer

TGLViewerBase* TGLSceneInfo::fViewer
protectedinherited

Definition at line 39 of file TGLSceneInfo.h.

◆ fVisibleElements

DrawElementVec_t TGLScene::TSceneInfo::fVisibleElements

Definition at line 90 of file TGLScene.h.

◆ fWFLineW

Float_t TGLSceneInfo::fWFLineW
protectedinherited

Definition at line 45 of file TGLSceneInfo.h.


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