OpenGl_LayerList Class Reference

Class defining the list of layers. More...

#include <OpenGl_LayerList.hxx>

Data Structures
class	OpenGl_LayerStack
	Stack of references to existing layers of predefined maximum size. More...

Public Member Functions
	OpenGl_LayerList ()
	Constructor.
virtual	~OpenGl_LayerList ()
	Destructor.
Standard_Integer	NbPriorities () const
	Method returns the number of available priorities.
Standard_Integer	NbStructures () const
	Number of displayed structures.
Standard_Integer	NbImmediateStructures () const
	Return number of structures within immediate layers.
void	InsertLayerBefore (const Graphic3d_ZLayerId theNewLayerId, const Graphic3d_ZLayerSettings &theSettings, const Graphic3d_ZLayerId theLayerAfter)
	Insert a new layer with id.
void	InsertLayerAfter (const Graphic3d_ZLayerId theNewLayerId, const Graphic3d_ZLayerSettings &theSettings, const Graphic3d_ZLayerId theLayerBefore)
	Insert a new layer with id.
void	RemoveLayer (const Graphic3d_ZLayerId theLayerId)
	Remove layer by its id.
void	AddStructure (const OpenGl_Structure *theStruct, const Graphic3d_ZLayerId theLayerId, const Graphic3d_DisplayPriority thePriority, Standard_Boolean isForChangePriority=Standard_False)
	Add structure to list with given priority. The structure will be inserted to specified layer. If the layer isn't found, the structure will be put to default bottom-level layer.
void	RemoveStructure (const OpenGl_Structure *theStructure)
	Remove structure from structure list and return its previous priority.
void	ChangeLayer (const OpenGl_Structure *theStructure, const Graphic3d_ZLayerId theOldLayerId, const Graphic3d_ZLayerId theNewLayerId)
	Change structure z layer If the new layer is not presented, the structure will be displayed in default z layer.
void	ChangePriority (const OpenGl_Structure *theStructure, const Graphic3d_ZLayerId theLayerId, const Graphic3d_DisplayPriority theNewPriority)
	Changes structure priority within its ZLayer.
OpenGl_Layer &	Layer (const Graphic3d_ZLayerId theLayerId)
	Returns reference to the layer with given ID.
const OpenGl_Layer &	Layer (const Graphic3d_ZLayerId theLayerId) const
	Returns reference to the layer with given ID.
void	SetLayerSettings (const Graphic3d_ZLayerId theLayerId, const Graphic3d_ZLayerSettings &theSettings)
	Assign new settings to the layer.
void	UpdateCulling (const Handle< OpenGl_Workspace > &theWorkspace, const Standard_Boolean theToDrawImmediate)
	Update culling state - should be called before rendering.
void	Render (const Handle< OpenGl_Workspace > &theWorkspace, const Standard_Boolean theToDrawImmediate, const OpenGl_LayerFilter theLayersToProcess, OpenGl_FrameBuffer *theReadDrawFbo, OpenGl_FrameBuffer *theOitAccumFbo) const
	Render this element.
const NCollection_List< Handle< Graphic3d_Layer > > &	Layers () const
	Returns the set of OpenGL Z-layers.
const NCollection_DataMap< Graphic3d_ZLayerId, Handle< Graphic3d_Layer > > &	LayerIDs () const
	Returns the map of Z-layer IDs to indexes.
void	InvalidateBVHData (const Graphic3d_ZLayerId theLayerId)
	Marks BVH tree for given priority list as dirty and marks primitive set for rebuild.
Standard_Size	ModificationStateOfRaytracable () const
	Returns structure modification state (for ray-tracing).
const Handle< Select3D_BVHBuilder3d > &	FrustumCullingBVHBuilder () const
	Returns BVH tree builder for frustum culling.
void	SetFrustumCullingBVHBuilder (const Handle< Select3D_BVHBuilder3d > &theBuilder)
	Assigns BVH tree builder for frustum culling.
void	DumpJson (Standard_OStream &theOStream, Standard_Integer theDepth=-1) const
	Dumps the content of me into the stream.

Protected Member Functions
void	renderTransparent (const Handle< OpenGl_Workspace > &theWorkspace, OpenGl_LayerStack::iterator &theLayerIter, const OpenGl_GlobalLayerSettings &theGlobalSettings, OpenGl_FrameBuffer *theReadDrawFbo, OpenGl_FrameBuffer *theOitAccumFbo) const
	Render transparent objects using blending operator. Additional accumulation framebuffer is used for blended order-independent transparency algorithm. It should support floating-point color components and share depth with main reading/drawing framebuffer.
void	renderLayer (const Handle< OpenGl_Workspace > &theWorkspace, const OpenGl_GlobalLayerSettings &theDefaultSettings, const Graphic3d_Layer &theLayer) const

Protected Attributes
NCollection_List< Handle< Graphic3d_Layer > >	myLayers
NCollection_DataMap< Graphic3d_ZLayerId, Handle< Graphic3d_Layer > >	myLayerIds
Handle< Select3D_BVHBuilder3d >	myBVHBuilder
	BVH tree builder for frustum culling.
Standard_Integer	myNbStructures
Standard_Integer	myImmediateNbStructures
	number of structures within immediate layers
Standard_Size	myModifStateOfRaytraceable
OpenGl_LayerStack	myTransparentToProcess
	Collection of references to layers with transparency gathered during rendering pass.

Detailed Description

Class defining the list of layers.

Constructor & Destructor Documentation

OpenGl_LayerList()

OpenGl_LayerList::OpenGl_LayerList

(

)

Constructor.

~OpenGl_LayerList()

virtual OpenGl_LayerList::~OpenGl_LayerList ( )

virtual

Destructor.

Member Function Documentation

AddStructure()

void OpenGl_LayerList::AddStructure	(	const OpenGl_Structure *	theStruct,
		const Graphic3d_ZLayerId	theLayerId,
		const Graphic3d_DisplayPriority	thePriority,
		Standard_Boolean	isForChangePriority = Standard_False
	)

Add structure to list with given priority. The structure will be inserted to specified layer. If the layer isn't found, the structure will be put to default bottom-level layer.

ChangeLayer()

void OpenGl_LayerList::ChangeLayer	(	const OpenGl_Structure *	theStructure,
		const Graphic3d_ZLayerId	theOldLayerId,
		const Graphic3d_ZLayerId	theNewLayerId
	)

Change structure z layer If the new layer is not presented, the structure will be displayed in default z layer.

ChangePriority()

void OpenGl_LayerList::ChangePriority	(	const OpenGl_Structure *	theStructure,
		const Graphic3d_ZLayerId	theLayerId,
		const Graphic3d_DisplayPriority	theNewPriority
	)

Changes structure priority within its ZLayer.

DumpJson()

void OpenGl_LayerList::DumpJson	(	Standard_OStream &	theOStream,
		Standard_Integer	theDepth = -1
	)		const

Dumps the content of me into the stream.

FrustumCullingBVHBuilder()

const Handle< Select3D_BVHBuilder3d > & OpenGl_LayerList::FrustumCullingBVHBuilder ( ) const

inline

Returns BVH tree builder for frustum culling.

InsertLayerAfter()

void OpenGl_LayerList::InsertLayerAfter	(	const Graphic3d_ZLayerId	theNewLayerId,
		const Graphic3d_ZLayerSettings &	theSettings,
		const Graphic3d_ZLayerId	theLayerBefore
	)

Insert a new layer with id.

InsertLayerBefore()

void OpenGl_LayerList::InsertLayerBefore	(	const Graphic3d_ZLayerId	theNewLayerId,
		const Graphic3d_ZLayerSettings &	theSettings,
		const Graphic3d_ZLayerId	theLayerAfter
	)

Insert a new layer with id.

InvalidateBVHData()

void OpenGl_LayerList::InvalidateBVHData

(

const Graphic3d_ZLayerId

theLayerId

)

Marks BVH tree for given priority list as dirty and marks primitive set for rebuild.

Layer() [1/2]

OpenGl_Layer & OpenGl_LayerList::Layer ( const Graphic3d_ZLayerId  theLayerId )

inline

Returns reference to the layer with given ID.

Layer() [2/2]

const OpenGl_Layer & OpenGl_LayerList::Layer ( const Graphic3d_ZLayerId  theLayerId ) const

inline

Returns reference to the layer with given ID.

LayerIDs()

const NCollection_DataMap< Graphic3d_ZLayerId, Handle< Graphic3d_Layer > > & OpenGl_LayerList::LayerIDs ( ) const

inline

Returns the map of Z-layer IDs to indexes.

Layers()

const NCollection_List< Handle< Graphic3d_Layer > > & OpenGl_LayerList::Layers ( ) const

inline

Returns the set of OpenGL Z-layers.

ModificationStateOfRaytracable()

Standard_Size OpenGl_LayerList::ModificationStateOfRaytracable ( ) const

inline

Returns structure modification state (for ray-tracing).

NbImmediateStructures()

Standard_Integer OpenGl_LayerList::NbImmediateStructures ( ) const

inline

Return number of structures within immediate layers.

NbPriorities()

Standard_Integer OpenGl_LayerList::NbPriorities ( ) const

inline

Method returns the number of available priorities.

NbStructures()

Standard_Integer OpenGl_LayerList::NbStructures ( ) const

inline

Number of displayed structures.

RemoveLayer()

void OpenGl_LayerList::RemoveLayer

(

const Graphic3d_ZLayerId

theLayerId

)

Remove layer by its id.

RemoveStructure()

void OpenGl_LayerList::RemoveStructure

(

const OpenGl_Structure *

theStructure

)

Remove structure from structure list and return its previous priority.

Render()

void OpenGl_LayerList::Render	(	const Handle< OpenGl_Workspace > &	theWorkspace,
		const Standard_Boolean	theToDrawImmediate,
		const OpenGl_LayerFilter	theLayersToProcess,
		OpenGl_FrameBuffer *	theReadDrawFbo,
		OpenGl_FrameBuffer *	theOitAccumFbo
	)		const

Render this element.

renderLayer()

void OpenGl_LayerList::renderLayer ( const Handle< OpenGl_Workspace > &  theWorkspace, const OpenGl_GlobalLayerSettings &  theDefaultSettings, const Graphic3d_Layer &  theLayer  ) const

protected

renderTransparent()

void OpenGl_LayerList::renderTransparent ( const Handle< OpenGl_Workspace > &  theWorkspace, OpenGl_LayerStack::iterator &  theLayerIter, const OpenGl_GlobalLayerSettings &  theGlobalSettings, OpenGl_FrameBuffer *  theReadDrawFbo, OpenGl_FrameBuffer *  theOitAccumFbo  ) const

protected

Render transparent objects using blending operator. Additional accumulation framebuffer is used for blended order-independent transparency algorithm. It should support floating-point color components and share depth with main reading/drawing framebuffer.

Parameters

theWorkspace	[in] the currently used workspace for rendering.
theLayerIter	[in/out] the current iterator of transparent layers to process.
theGlobalSettings	[in] the set of global settings used for rendering.
theReadDrawFbo	[in] the framebuffer for reading depth and writing final color.
theOitAccumFbo	[in] the framebuffer for accumulating color and coverage for OIT process.

SetFrustumCullingBVHBuilder()

void OpenGl_LayerList::SetFrustumCullingBVHBuilder

(

const Handle< Select3D_BVHBuilder3d > &

theBuilder

)

Assigns BVH tree builder for frustum culling.

SetLayerSettings()

void OpenGl_LayerList::SetLayerSettings	(	const Graphic3d_ZLayerId	theLayerId,
		const Graphic3d_ZLayerSettings &	theSettings
	)

Assign new settings to the layer.

UpdateCulling()

void OpenGl_LayerList::UpdateCulling	(	const Handle< OpenGl_Workspace > &	theWorkspace,
		const Standard_Boolean	theToDrawImmediate
	)

Update culling state - should be called before rendering.

Field Documentation

myBVHBuilder

Handle< Select3D_BVHBuilder3d > OpenGl_LayerList::myBVHBuilder

protected

BVH tree builder for frustum culling.

myImmediateNbStructures

Standard_Integer OpenGl_LayerList::myImmediateNbStructures

protected

number of structures within immediate layers

myLayerIds

NCollection_DataMap<Graphic3d_ZLayerId, Handle< Graphic3d_Layer > > OpenGl_LayerList::myLayerIds

protected

myLayers

NCollection_List<Handle< Graphic3d_Layer > > OpenGl_LayerList::myLayers

protected

myModifStateOfRaytraceable

Standard_Size OpenGl_LayerList::myModifStateOfRaytraceable

mutableprotected

myNbStructures

Standard_Integer OpenGl_LayerList::myNbStructures

protected

myTransparentToProcess

OpenGl_LayerStack OpenGl_LayerList::myTransparentToProcess

mutableprotected

Collection of references to layers with transparency gathered during rendering pass.

---

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

• OpenGl_LayerList.hxx