This class allows the definition of a graphic driver for 3d interface (currently only OpenGl driver is used). More...

#include <Graphic3d_GraphicDriver.hxx>

Inheritance diagram for Graphic3d_GraphicDriver:

[legend]

Public Member Functions
virtual int	InquireLimit (const Graphic3d_TypeOfLimit theType) const =0
	Request limit of graphic resource of specific type.

int	InquireLightLimit () const
	Request maximum number of active light sources supported by driver and hardware.

int	InquirePlaneLimit () const
	Request maximum number of active clipping planes supported by driver and hardware.

int	InquireViewLimit () const
	Request maximum number of views supported by driver.

virtual occ::handle< Graphic3d_CStructure >	CreateStructure (const occ::handle< Graphic3d_StructureManager > &theManager)=0
	Creates new empty graphic structure.

virtual void	RemoveStructure (occ::handle< Graphic3d_CStructure > &theCStructure)=0
	Removes structure from graphic driver and releases its resources.

virtual occ::handle< Graphic3d_CView >	CreateView (const occ::handle< Graphic3d_StructureManager > &theMgr)=0
	Creates new view for this graphic driver.

virtual void	RemoveView (const occ::handle< Graphic3d_CView > &theView)=0
	Removes view from graphic driver and releases its resources.

virtual void	EnableVBO (const bool status)=0
	enables/disables usage of OpenGL vertex buffer arrays while drawing primitive arrays

virtual bool	IsVerticalSync () const =0
	Returns TRUE if vertical synchronization with display refresh rate (VSync) should be used; TRUE by default.

virtual void	SetVerticalSync (bool theToEnable)=0
	Set if vertical synchronization with display refresh rate (VSync) should be used.

virtual bool	MemoryInfo (size_t &theFreeBytes, TCollection_AsciiString &theInfo) const =0
	Returns information about GPU memory usage.

virtual float	DefaultTextHeight () const =0

virtual void	TextSize (const occ::handle< Graphic3d_CView > &theView, const char *const theText, const float theHeight, float &theWidth, float &theAscent, float &theDescent) const =0
	Computes text width.

virtual void	InsertLayerBefore (const Graphic3d_ZLayerId theNewLayerId, const Graphic3d_ZLayerSettings &theSettings, const Graphic3d_ZLayerId theLayerAfter)=0
	Adds a layer to all views. To add a structure to desired layer on display it is necessary to set the layer ID for the structure.

virtual void	InsertLayerAfter (const Graphic3d_ZLayerId theNewLayerId, const Graphic3d_ZLayerSettings &theSettings, const Graphic3d_ZLayerId theLayerBefore)=0
	Adds a layer to all views.

virtual void	RemoveZLayer (const Graphic3d_ZLayerId theLayerId)=0
	Removes Z layer. All structures displayed at the moment in layer will be displayed in default layer (the bottom-level z layer). By default, there are always default bottom-level layer that can't be removed. The passed theLayerId should be not less than 0 (reserved for default layers that can not be removed).

virtual void	ZLayers (NCollection_Sequence< int > &theLayerSeq) const
	Returns list of Z layers defined for the graphical driver.

virtual void	SetZLayerSettings (const Graphic3d_ZLayerId theLayerId, const Graphic3d_ZLayerSettings &theSettings)=0
	Sets the settings for a single Z layer.

virtual const Graphic3d_ZLayerSettings &	ZLayerSettings (const Graphic3d_ZLayerId theLayerId) const
	Returns the settings of a single Z layer.

virtual bool	ViewExists (const occ::handle< Aspect_Window > &theWindow, occ::handle< Graphic3d_CView > &theView)=0
	Returns view associated with the window if it is exists and is activated. Returns true if the view associated to the window exists.

const occ::handle< Aspect_DisplayConnection > &	GetDisplayConnection () const
	returns Handle to display connection

int	NewIdentification ()
	Returns a new identification number for a new structure.

void	RemoveIdentification (const int theId)
	Frees the identifier of a structure.

void	DumpJson (Standard_OStream &theOStream, int theDepth=-1) const
	Dumps the content of me into the stream.

Public Member Functions inherited from Standard_Transient
	Standard_Transient ()
	Empty constructor.

	Standard_Transient (const Standard_Transient &)
	Copy constructor – does nothing.

Standard_Transient &	operator= (const Standard_Transient &)
	Assignment operator, needed to avoid copying reference counter.

virtual	~Standard_Transient ()=default
	Destructor must be virtual.

virtual const opencascade::handle< Standard_Type > &	DynamicType () const
	Returns a type descriptor about this object.

bool	IsInstance (const opencascade::handle< Standard_Type > &theType) const
	Returns a true value if this is an instance of Type.

bool	IsInstance (const char *const theTypeName) const
	Returns a true value if this is an instance of TypeName.

bool	IsKind (const opencascade::handle< Standard_Type > &theType) const
	Returns true if this is an instance of Type or an instance of any class that inherits from Type. Note that multiple inheritance is not supported by OCCT RTTI mechanism.

bool	IsKind (const char *const theTypeName) const
	Returns true if this is an instance of TypeName or an instance of any class that inherits from TypeName. Note that multiple inheritance is not supported by OCCT RTTI mechanism.

Standard_Transient *	This () const
	Returns non-const pointer to this object (like const_cast). For protection against creating handle to objects allocated in stack or call from constructor, it will raise exception Standard_ProgramError if reference counter is zero.

int	GetRefCount () const noexcept
	Get the reference counter of this object.

void	IncrementRefCounter () noexcept
	Increments the reference counter of this object. Uses relaxed memory ordering since incrementing only requires atomicity, not synchronization with other memory operations.

int	DecrementRefCounter () noexcept
	Decrements the reference counter of this object; returns the decremented value. Uses release ordering for the decrement to ensure all writes to the object are visible before the count reaches zero. An acquire fence is added only when the count reaches zero, ensuring proper synchronization before deletion. This is more efficient than using acq_rel for every decrement.

virtual void	Delete () const
	Memory deallocator for transient classes.

Protected Member Functions
	Graphic3d_GraphicDriver (const occ::handle< Aspect_DisplayConnection > &theDisp)
	Initializes the Driver.

Protected Attributes
occ::handle< Aspect_DisplayConnection >	myDisplayConnection

Aspect_GenId	myStructGenId

NCollection_List< occ::handle< Graphic3d_Layer > >	myLayers

NCollection_DataMap< Graphic3d_ZLayerId, occ::handle< Graphic3d_Layer > >	myLayerIds

Additional Inherited Members
Public Types inherited from Standard_Transient
typedef void	base_type
	Returns a type descriptor about this object.

Static Public Member Functions inherited from Standard_Transient
static constexpr const char *	get_type_name ()
	Returns a type descriptor about this object.

static const opencascade::handle< Standard_Type > &	get_type_descriptor ()
	Returns type descriptor of Standard_Transient class.

Detailed Description

This class allows the definition of a graphic driver for 3d interface (currently only OpenGl driver is used).

Constructor & Destructor Documentation

◆ Graphic3d_GraphicDriver()

Graphic3d_GraphicDriver::Graphic3d_GraphicDriver ( const occ::handle< Aspect_DisplayConnection > & theDisp )

protected

Initializes the Driver.

Member Function Documentation

◆ CreateStructure()

virtual occ::handle< Graphic3d_CStructure > Graphic3d_GraphicDriver::CreateStructure ( const occ::handle< Graphic3d_StructureManager > & theManager )

pure virtual

Creates new empty graphic structure.

Implemented in OpenGl_GraphicDriver.

◆ CreateView()

virtual occ::handle< Graphic3d_CView > Graphic3d_GraphicDriver::CreateView ( const occ::handle< Graphic3d_StructureManager > & theMgr )

pure virtual

Creates new view for this graphic driver.

Implemented in D3DHost_GraphicDriver, and OpenGl_GraphicDriver.

◆ DefaultTextHeight()

virtual float Graphic3d_GraphicDriver::DefaultTextHeight ( ) const

pure virtual

Implemented in OpenGl_GraphicDriver.

◆ DumpJson()

void Graphic3d_GraphicDriver::DumpJson	(	Standard_OStream &	theOStream,
		int	theDepth = -1 ) const

Dumps the content of me into the stream.

◆ EnableVBO()

virtual void Graphic3d_GraphicDriver::EnableVBO ( const bool status )

pure virtual

enables/disables usage of OpenGL vertex buffer arrays while drawing primitive arrays

Implemented in OpenGl_GraphicDriver.

◆ GetDisplayConnection()

const occ::handle< Aspect_DisplayConnection > & Graphic3d_GraphicDriver::GetDisplayConnection ( ) const

returns Handle to display connection

◆ InquireLightLimit()

int Graphic3d_GraphicDriver::InquireLightLimit ( ) const

inline

Request maximum number of active light sources supported by driver and hardware.

◆ InquireLimit()

virtual int Graphic3d_GraphicDriver::InquireLimit ( const Graphic3d_TypeOfLimit theType ) const

pure virtual

Request limit of graphic resource of specific type.

Implemented in OpenGl_GraphicDriver.

◆ InquirePlaneLimit()

int Graphic3d_GraphicDriver::InquirePlaneLimit ( ) const

inline

Request maximum number of active clipping planes supported by driver and hardware.

◆ InquireViewLimit()

int Graphic3d_GraphicDriver::InquireViewLimit ( ) const

inline

Request maximum number of views supported by driver.

◆ InsertLayerAfter()

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

pure virtual

Adds a layer to all views.

Parameters

[in]	theNewLayerId	id of new layer, should be > 0 (negative values are reserved for default layers).
[in]	theSettings	new layer settings
[in]	theLayerBefore	id of layer to append new layer after

Implemented in OpenGl_GraphicDriver.

◆ InsertLayerBefore()

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

pure virtual

Adds a layer to all views. To add a structure to desired layer on display it is necessary to set the layer ID for the structure.

Parameters

[in]	theNewLayerId	id of new layer, should be > 0 (negative values are reserved for default layers).
[in]	theSettings	new layer settings
[in]	theLayerAfter	id of layer to append new layer before

Implemented in OpenGl_GraphicDriver.

◆ IsVerticalSync()

virtual bool Graphic3d_GraphicDriver::IsVerticalSync ( ) const

pure virtual

Returns TRUE if vertical synchronization with display refresh rate (VSync) should be used; TRUE by default.

Implemented in OpenGl_GraphicDriver.

◆ MemoryInfo()

virtual bool Graphic3d_GraphicDriver::MemoryInfo	(	size_t &	theFreeBytes,
		TCollection_AsciiString &	theInfo ) const

pure virtual

Returns information about GPU memory usage.

Implemented in OpenGl_GraphicDriver.

◆ NewIdentification()

int Graphic3d_GraphicDriver::NewIdentification ( )

Returns a new identification number for a new structure.

◆ RemoveIdentification()

void Graphic3d_GraphicDriver::RemoveIdentification ( const int theId )

Frees the identifier of a structure.

◆ RemoveStructure()

virtual void Graphic3d_GraphicDriver::RemoveStructure ( occ::handle< Graphic3d_CStructure > & theCStructure )

pure virtual

Removes structure from graphic driver and releases its resources.

Implemented in OpenGl_GraphicDriver.

◆ RemoveView()

virtual void Graphic3d_GraphicDriver::RemoveView ( const occ::handle< Graphic3d_CView > & theView )

pure virtual

Removes view from graphic driver and releases its resources.

Implemented in OpenGl_GraphicDriver.

◆ RemoveZLayer()

virtual void Graphic3d_GraphicDriver::RemoveZLayer ( const Graphic3d_ZLayerId theLayerId )

pure virtual

Removes Z layer. All structures displayed at the moment in layer will be displayed in default layer (the bottom-level z layer). By default, there are always default bottom-level layer that can't be removed. The passed theLayerId should be not less than 0 (reserved for default layers that can not be removed).

Implemented in OpenGl_GraphicDriver.

◆ SetVerticalSync()

virtual void Graphic3d_GraphicDriver::SetVerticalSync ( bool theToEnable )

pure virtual

Set if vertical synchronization with display refresh rate (VSync) should be used.

Implemented in OpenGl_GraphicDriver.

◆ SetZLayerSettings()

virtual void Graphic3d_GraphicDriver::SetZLayerSettings	(	const Graphic3d_ZLayerId	theLayerId,
		const Graphic3d_ZLayerSettings &	theSettings )

pure virtual

Sets the settings for a single Z layer.

Implemented in OpenGl_GraphicDriver.

◆ TextSize()

virtual void Graphic3d_GraphicDriver::TextSize	(	const occ::handle< Graphic3d_CView > &	theView,
		const char *const	theText,
		const float	theHeight,
		float &	theWidth,
		float &	theAscent,
		float &	theDescent ) const

pure virtual

Computes text width.

Implemented in OpenGl_GraphicDriver.

◆ ViewExists()

virtual bool Graphic3d_GraphicDriver::ViewExists	(	const occ::handle< Aspect_Window > &	theWindow,
		occ::handle< Graphic3d_CView > &	theView )

pure virtual

Returns view associated with the window if it is exists and is activated. Returns true if the view associated to the window exists.

Implemented in OpenGl_GraphicDriver.

◆ ZLayers()

virtual void Graphic3d_GraphicDriver::ZLayers ( NCollection_Sequence< int > & theLayerSeq ) const

virtual

Returns list of Z layers defined for the graphical driver.

◆ ZLayerSettings()

virtual const Graphic3d_ZLayerSettings & Graphic3d_GraphicDriver::ZLayerSettings ( const Graphic3d_ZLayerId theLayerId ) const

virtual

Returns the settings of a single Z layer.

Field Documentation

◆ myDisplayConnection

occ::handle<Aspect_DisplayConnection> Graphic3d_GraphicDriver::myDisplayConnection

protected

◆ myLayerIds

NCollection_DataMap<Graphic3d_ZLayerId, occ::handle<Graphic3d_Layer> > Graphic3d_GraphicDriver::myLayerIds

protected

◆ myLayers

NCollection_List<occ::handle<Graphic3d_Layer> > Graphic3d_GraphicDriver::myLayers

protected

◆ myStructGenId

Aspect_GenId Graphic3d_GraphicDriver::myStructGenId

protected

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

Graphic3d_GraphicDriver.hxx

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ Graphic3d_GraphicDriver()

Member Function Documentation

◆ CreateStructure()

◆ CreateView()

◆ DefaultTextHeight()

◆ DumpJson()

◆ EnableVBO()

◆ GetDisplayConnection()

◆ InquireLightLimit()

◆ InquireLimit()

◆ InquirePlaneLimit()

◆ InquireViewLimit()

◆ InsertLayerAfter()

◆ InsertLayerBefore()

◆ IsVerticalSync()

◆ MemoryInfo()

◆ NewIdentification()

◆ RemoveIdentification()

◆ RemoveStructure()

◆ RemoveView()

◆ RemoveZLayer()

◆ SetVerticalSync()

◆ SetZLayerSettings()

◆ TextSize()

◆ ViewExists()

◆ ZLayers()

◆ ZLayerSettings()

Field Documentation

◆ myDisplayConnection

◆ myLayerIds

◆ myLayers

◆ myStructGenId