Provide the access to the OpenGL shaders. More...

#include <shader.h>

Public Member Functions
	SHADER ()

virtual	~SHADER ()

template<typename... Args>
bool	LoadShaderFromStrings (SHADER_TYPE aShaderType, Args &&... aArgs)
	Add a shader and compile the shader sources.

bool	LoadShaderFromFile (SHADER_TYPE aShaderType, const std::string &aShaderSourceName)
	Load one of the built-in shaders and compiles it.

bool	Link ()
	Link the shaders.

bool	IsLinked () const
	Return true if shaders are linked correctly.

void	Use ()
	Use the shader.

void	Deactivate ()
	Deactivate the shader and use the default OpenGL program.

bool	IsActive () const
	Return the current state of the shader.

void	ConfigureGeometryShader (GLuint maxVertices, GLuint geometryInputType, GLuint geometryOutputType)
	Configure the geometry shader - has to be done before linking!

int	AddParameter (const std::string &aParameterName)
	Add a parameter to the parameter queue.

void	SetParameter (int aParameterNumber, float aValue) const
	Set a parameter of the shader.

void	SetParameter (int aParameterNumber, int aValue) const

void	SetParameter (int aParameterNumber, const VECTOR2D &aValue) const

void	SetParameter (int aParameterNumber, float f0, float f1, float f2, float f3) const

int	GetAttribute (const std::string &aAttributeName) const
	Get an attribute location.

Static Public Member Functions
static std::string	ReadSource (const std::string &aShaderSourceName)
	Read the shader source file.

Private Member Functions
bool	loadShaderFromStringArray (SHADER_TYPE aShaderType, const char **aArray, size_t aSize)
	Compile vertex of fragment shader source code into the program.

void	programInfo (GLuint aProgram)
	Get the shader program information.

void	shaderInfo (GLuint aShader)
	Get the shader information.

Private Attributes
std::deque< GLuint >	shaderNumbers
	Shader number list.

GLuint	programNumber
	Shader program number.

bool	isProgramCreated
	Flag for program creation.

bool	isShaderLinked
	Is the shader linked?

bool	active
	Is any of shaders used?

GLuint	maximumVertices
	The maximum of vertices to be generated.

GLuint	geomInputType
	Output type [e.g. GL_LINES, GL_TRIANGLES, GL_QUADS etc.].

GLuint	geomOutputType

std::deque< GLint >	parameterLocation
	Location of the parameter.

Detailed Description

Provide the access to the OpenGL shaders.

The purpose of this class is advanced drawing with OpenGL. One example is using the pixel shader for drawing exact circles or for anti-aliasing. This class supports vertex, geometry and fragment shaders.

Make sure that the hardware supports these features. This can be identified with the "GLAD" library.

Definition at line 72 of file shader.h.

Constructor & Destructor Documentation

◆ SHADER()

SHADER::SHADER ( )

Definition at line 37 of file shader.cpp.

References active, geomInputType, geomOutputType, isProgramCreated, isShaderLinked, maximumVertices, and programNumber.

◆ ~SHADER()

SHADER::~SHADER ( )

virtual

Definition at line 51 of file shader.cpp.

References active, Deactivate(), isProgramCreated, programNumber, and shaderNumbers.

Member Function Documentation

◆ AddParameter()

int SHADER::AddParameter ( const std::string & aParameterName )

Add a parameter to the parameter queue.

To communicate with the shader use this function to set up the names for the uniform variables. These are queued in a list and can be assigned with the SetParameter(..) method using the queue position.

Parameters

aParameterName is the name of the parameter.

Returns: the added parameter location.

Definition at line 126 of file shader.cpp.

References location, parameterLocation, and programNumber.

◆ ConfigureGeometryShader()

void SHADER::ConfigureGeometryShader	(	GLuint	maxVertices,
		GLuint	geometryInputType,
		GLuint	geometryOutputType )

Configure the geometry shader - has to be done before linking!

Parameters

maxVertices	is the maximum of vertices to be generated.
geometryInputType	is the input type [e.g. GL_LINES, GL_TRIANGLES, GL_QUADS etc.]
geometryOutputType	is the output type [e.g. GL_LINES, GL_TRIANGLES, GL_QUADS etc.]

Definition at line 88 of file shader.cpp.

References geomInputType, geomOutputType, and maximumVertices.

◆ Deactivate()

void KIGFX::SHADER::Deactivate ( )

inline

Deactivate the shader and use the default OpenGL program.

Definition at line 131 of file shader.h.

References active.

Referenced by ~SHADER().

◆ GetAttribute()

int SHADER::GetAttribute ( const std::string & aAttributeName ) const

Get an attribute location.

Parameters

aAttributeName is the name of the attribute.

Returns: the location.

Definition at line 171 of file shader.cpp.

References programNumber.

◆ IsActive()

bool KIGFX::SHADER::IsActive ( ) const

inline

Return the current state of the shader.

Returns: True if any of shaders is enabled.

Definition at line 142 of file shader.h.

References active.

◆ IsLinked()

bool KIGFX::SHADER::IsLinked ( ) const

inline

Return true if shaders are linked correctly.

Definition at line 114 of file shader.h.

References isShaderLinked.

◆ Link()

bool SHADER::Link ( )

Link the shaders.

Returns: true in case of success, false otherwise.

Definition at line 97 of file shader.cpp.

References isShaderLinked, programInfo(), and programNumber.

◆ LoadShaderFromFile()

bool SHADER::LoadShaderFromFile	(	SHADER_TYPE	aShaderType,
		const std::string &	aShaderSourceName )

Load one of the built-in shaders and compiles it.

Parameters

aShaderSourceName	is the shader source file name.
aShaderType	is the type of the shader.

Returns: True in case of success, false otherwise.

Definition at line 79 of file shader.cpp.

References LoadShaderFromStrings(), and ReadSource().

◆ loadShaderFromStringArray()

bool SHADER::loadShaderFromStringArray	(	SHADER_TYPE	aShaderType,
		const char **	aArray,
		size_t	aSize )

private

Compile vertex of fragment shader source code into the program.

Definition at line 237 of file shader.cpp.

References geomInputType, geomOutputType, isProgramCreated, isShaderLinked, maximumVertices, programInfo(), programNumber, KIGFX::SHADER_TYPE_GEOMETRY, shaderInfo(), and shaderNumbers.

Referenced by LoadShaderFromStrings().

◆ LoadShaderFromStrings()

template<typename... Args>

bool KIGFX::SHADER::LoadShaderFromStrings	(	SHADER_TYPE	aShaderType,
		Args &&...	aArgs )

inline

Add a shader and compile the shader sources.

Parameters

aArgs	is the list of strings (std::string or convertible to const char*) which are concatenated and compiled as a single shader source code.
aShaderType	is the type of the shader.

Returns: True in case of success, false otherwise.

Definition at line 89 of file shader.h.

References loadShaderFromStringArray(), and KIGFX::DETAIL::translateStringArg().

Referenced by LoadShaderFromFile().

◆ programInfo()

void SHADER::programInfo ( GLuint aProgram )

private

Get the shader program information.

Parameters

aProgram is the program number.

Definition at line 177 of file shader.cpp.

Referenced by Link(), and loadShaderFromStringArray().

◆ ReadSource()

std::string SHADER::ReadSource ( const std::string & aShaderSourceName )

static

Read the shader source file.

Parameters

aShaderSourceName is the shader source file name.

Returns: the source as string

Definition at line 215 of file shader.cpp.

Referenced by LoadShaderFromFile().

◆ SetParameter() [1/4]

void SHADER::SetParameter	(	int	aParameterNumber,
		const VECTOR2D &	aValue ) const

Definition at line 163 of file shader.cpp.

References parameterLocation, VECTOR2< T >::x, and VECTOR2< T >::y.

◆ SetParameter() [2/4]

void SHADER::SetParameter	(	int	aParameterNumber,
		float	aValue ) const

Set a parameter of the shader.

Parameters

aParameterNumber	is the number of the parameter.
aValue	is the value of the parameter.

Definition at line 139 of file shader.cpp.

References parameterLocation.

◆ SetParameter() [3/4]

void SHADER::SetParameter	(	int	aParameterNumber,
		float	f0,
		float	f1,
		float	f2,
		float	f3 ) const

Definition at line 155 of file shader.cpp.

References parameterLocation.

◆ SetParameter() [4/4]

void SHADER::SetParameter	(	int	aParameterNumber,
		int	aValue ) const

Definition at line 147 of file shader.cpp.

References parameterLocation.

◆ shaderInfo()

void SHADER::shaderInfo ( GLuint aShader )

private

Get the shader information.

Parameters

aShader is the shader number.

Definition at line 196 of file shader.cpp.

Referenced by loadShaderFromStringArray().

◆ Use()

void KIGFX::SHADER::Use ( )

inline

Use the shader.

Definition at line 122 of file shader.h.

References active, and programNumber.

Member Data Documentation

◆ active

bool KIGFX::SHADER::active

private

Is any of shaders used?

Definition at line 220 of file shader.h.

Referenced by Deactivate(), IsActive(), SHADER(), Use(), and ~SHADER().

◆ geomInputType

GLuint KIGFX::SHADER::geomInputType

private

Output type [e.g. GL_LINES, GL_TRIANGLES, GL_QUADS etc.].

Definition at line 224 of file shader.h.

Referenced by ConfigureGeometryShader(), loadShaderFromStringArray(), and SHADER().

◆ geomOutputType

GLuint KIGFX::SHADER::geomOutputType

private

Definition at line 227 of file shader.h.

Referenced by ConfigureGeometryShader(), loadShaderFromStringArray(), and SHADER().

◆ isProgramCreated

bool KIGFX::SHADER::isProgramCreated

private

Flag for program creation.

Definition at line 218 of file shader.h.

Referenced by loadShaderFromStringArray(), SHADER(), and ~SHADER().

◆ isShaderLinked

bool KIGFX::SHADER::isShaderLinked

private

Is the shader linked?

Definition at line 219 of file shader.h.

Referenced by IsLinked(), Link(), loadShaderFromStringArray(), and SHADER().

◆ maximumVertices

GLuint KIGFX::SHADER::maximumVertices

private

The maximum of vertices to be generated.

Input type [e.g. GL_LINES, GL_TRIANGLES, GL_QUADS etc.]

Definition at line 221 of file shader.h.

Referenced by ConfigureGeometryShader(), loadShaderFromStringArray(), and SHADER().

◆ parameterLocation

std::deque<GLint> KIGFX::SHADER::parameterLocation

private

Location of the parameter.

Definition at line 228 of file shader.h.

Referenced by AddParameter(), SetParameter(), SetParameter(), SetParameter(), and SetParameter().

◆ programNumber

GLuint KIGFX::SHADER::programNumber

private

Shader program number.

Definition at line 217 of file shader.h.

Referenced by AddParameter(), GetAttribute(), Link(), loadShaderFromStringArray(), SHADER(), Use(), and ~SHADER().

◆ shaderNumbers

std::deque<GLuint> KIGFX::SHADER::shaderNumbers

private

Shader number list.

Definition at line 216 of file shader.h.

Referenced by loadShaderFromStringArray(), and ~SHADER().

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

Public Member Functions

Static Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ SHADER()

◆ ~SHADER()

Member Function Documentation

◆ AddParameter()

◆ ConfigureGeometryShader()

◆ Deactivate()

◆ GetAttribute()

◆ IsActive()

◆ IsLinked()

◆ Link()

◆ LoadShaderFromFile()

◆ loadShaderFromStringArray()

◆ LoadShaderFromStrings()

◆ programInfo()

◆ ReadSource()

◆ SetParameter() [1/4]

◆ SetParameter() [2/4]

◆ SetParameter() [3/4]

◆ SetParameter() [4/4]

◆ shaderInfo()

◆ Use()

Member Data Documentation

◆ active

◆ geomInputType

◆ geomOutputType

◆ isProgramCreated

◆ isShaderLinked

◆ maximumVertices

◆ parameterLocation

◆ programNumber

◆ shaderNumbers