Wrapper for OpenGL shader object. More...

#include <OpenGl_ShaderObject.hxx>

Inheritance diagram for OpenGl_ShaderObject:

[legend]

Public Member Functions
	OpenGl_ShaderObject (GLenum theType)
	Creates uninitialized shader object.

virtual	~OpenGl_ShaderObject ()
	Releases resources of shader object.

Standard_Boolean	LoadSource (const Handle< OpenGl_Context > &theCtx, const TCollection_AsciiString &theSource)
	Loads shader source code.

Standard_Boolean	Compile (const Handle< OpenGl_Context > &theCtx)
	Compiles the shader object.

Standard_Boolean	LoadAndCompile (const Handle< OpenGl_Context > &theCtx, const TCollection_AsciiString &theId, const TCollection_AsciiString &theSource, bool theIsVerbose=true, bool theToPrintSource=true)
	Wrapper for compiling shader object with verbose printing on error.

void	DumpSourceCode (const Handle< OpenGl_Context > &theCtx, const TCollection_AsciiString &theId, const TCollection_AsciiString &theSource) const
	Print source code of this shader object to messenger.

Standard_Boolean	FetchInfoLog (const Handle< OpenGl_Context > &theCtx, TCollection_AsciiString &theLog)
	Fetches information log of the last compile operation.

Standard_Boolean	Create (const Handle< OpenGl_Context > &theCtx)
	Creates new empty shader object of specified type.

virtual void	Release (OpenGl_Context *theCtx) override
	Destroys shader object.

virtual Standard_Size	EstimatedDataSize () const override
	Returns estimated GPU memory usage - not implemented.

GLenum	Type () const
	Returns type of shader object.

Standard_Boolean	updateDebugDump (const Handle< OpenGl_Context > &theCtx, const TCollection_AsciiString &theId, const TCollection_AsciiString &theFolder, Standard_Boolean theToBeautify, Standard_Boolean theToReset)
	Update the shader object from external file in the following way: 1) If external file does not exist, then it will be created (current source code will be dumped, no recompilation) and FALSE will be returned. 2) If external file exists and it has the same timestamp as myDumpDate, nothing will be done and FALSE will be returned. 3) If external file exists and it has newer timestamp than myDumpDate, shader will be recompiled and TRUE will be returned.

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

virtual	~OpenGl_Resource ()
	Destructor. Inheritors should call Clean (NULL) within it.

virtual void	DumpJson (Standard_OStream &theOStream, Standard_Integer 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 ()
	Destructor must be virtual.

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

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

Standard_Boolean	IsInstance (const Standard_CString theTypeName) const
	Returns a true value if this is an instance of TypeName.

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

Standard_Boolean	IsKind (const Standard_CString 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.

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

void	IncrementRefCounter () noexcept
	Increments the reference counter of this object.

Standard_Integer	DecrementRefCounter () noexcept
	Decrements the reference counter of this object; returns the decremented value.

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

Static Public Attributes
static const GLuint	NO_SHADER = 0
	Non-valid shader name.

Protected Attributes
Quantity_Date	myDumpDate
	The recent date of the shader dump.

GLenum	myType
	Type of OpenGL shader object.

GLuint	myShaderID
	Handle of OpenGL shader object.

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

Wrapper for OpenGL shader object.

Constructor & Destructor Documentation

◆ OpenGl_ShaderObject()

OpenGl_ShaderObject::OpenGl_ShaderObject ( GLenum theType )

Creates uninitialized shader object.

◆ ~OpenGl_ShaderObject()

virtual OpenGl_ShaderObject::~OpenGl_ShaderObject ( )

virtual

Releases resources of shader object.

Member Function Documentation

◆ Compile()

Standard_Boolean OpenGl_ShaderObject::Compile ( const Handle< OpenGl_Context > & theCtx )

Compiles the shader object.

◆ Create()

Standard_Boolean OpenGl_ShaderObject::Create ( const Handle< OpenGl_Context > & theCtx )

Creates new empty shader object of specified type.

◆ DumpSourceCode()

void OpenGl_ShaderObject::DumpSourceCode	(	const Handle< OpenGl_Context > &	theCtx,
		const TCollection_AsciiString &	theId,
		const TCollection_AsciiString &	theSource
	)		const

Print source code of this shader object to messenger.

◆ EstimatedDataSize()

virtual Standard_Size OpenGl_ShaderObject::EstimatedDataSize ( ) const

inlineoverridevirtual

Returns estimated GPU memory usage - not implemented.

Implements OpenGl_Resource.

◆ FetchInfoLog()

Standard_Boolean OpenGl_ShaderObject::FetchInfoLog	(	const Handle< OpenGl_Context > &	theCtx,
		TCollection_AsciiString &	theLog
	)

Fetches information log of the last compile operation.

◆ LoadAndCompile()

Standard_Boolean OpenGl_ShaderObject::LoadAndCompile	(	const Handle< OpenGl_Context > &	theCtx,
		const TCollection_AsciiString &	theId,
		const TCollection_AsciiString &	theSource,
		bool	theIsVerbose = `true`,
		bool	theToPrintSource = `true`
	)

Wrapper for compiling shader object with verbose printing on error.

Parameters

theCtx	bound OpenGL context
theId	GLSL program id to define file name
theSource	source code to load
theIsVerbose	flag to print log on error
theToPrintSource	flag to print source code on error

◆ LoadSource()

Standard_Boolean OpenGl_ShaderObject::LoadSource	(	const Handle< OpenGl_Context > &	theCtx,
		const TCollection_AsciiString &	theSource
	)

Loads shader source code.

◆ Release()

virtual void OpenGl_ShaderObject::Release ( OpenGl_Context * theCtx )

overridevirtual

Destroys shader object.

Implements OpenGl_Resource.

◆ Type()

GLenum OpenGl_ShaderObject::Type ( ) const

inline

Returns type of shader object.

◆ updateDebugDump()

Standard_Boolean OpenGl_ShaderObject::updateDebugDump	(	const Handle< OpenGl_Context > &	theCtx,
		const TCollection_AsciiString &	theId,
		const TCollection_AsciiString &	theFolder,
		Standard_Boolean	theToBeautify,
		Standard_Boolean	theToReset
	)

Update the shader object from external file in the following way: 1) If external file does not exist, then it will be created (current source code will be dumped, no recompilation) and FALSE will be returned. 2) If external file exists and it has the same timestamp as myDumpDate, nothing will be done and FALSE will be returned. 3) If external file exists and it has newer timestamp than myDumpDate, shader will be recompiled and TRUE will be returned.

Parameters

theCtx	OpenGL context bound to this working thread
theId	GLSL program id to define file name
theFolder	folder to store files
theToBeautify	flag improving formatting (add extra newlines)
theToReset	when TRUE, existing dumps will be overridden

Field Documentation

◆ myDumpDate

Quantity_Date OpenGl_ShaderObject::myDumpDate

protected

The recent date of the shader dump.

◆ myShaderID

GLuint OpenGl_ShaderObject::myShaderID

protected

Handle of OpenGL shader object.

◆ myType

GLenum OpenGl_ShaderObject::myType

protected

Type of OpenGL shader object.

◆ NO_SHADER

const GLuint OpenGl_ShaderObject::NO_SHADER = 0

static

Non-valid shader name.

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

OpenGl_ShaderObject.hxx

Public Member Functions

Static Public Attributes

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ OpenGl_ShaderObject()

◆ ~OpenGl_ShaderObject()

Member Function Documentation

◆ Compile()

◆ Create()

◆ DumpSourceCode()

◆ EstimatedDataSize()

◆ FetchInfoLog()

◆ LoadAndCompile()

◆ LoadSource()

◆ Release()

◆ Type()

◆ updateDebugDump()

Field Documentation

◆ myDumpDate

◆ myShaderID

◆ myType

◆ NO_SHADER