Specialisation of GLSLProgram to provide support for separable programs via the OpenGL program pipeline. More...

#include <OgreGLSLSeparableProgram.h>

Inheritance diagram for Ogre::GLSLSeparableProgram:

Public Member Functions
	GLSLSeparableProgram (GLSLShader vertexShader, GLSLShader hullShader, GLSLShader domainShader, GLSLShader geometryShader, GLSLShader fragmentShader, GLSLShader computeShader)
	Constructor should only be used by GLSLSeparableProgramManager. More...

	~GLSLSeparableProgram ()

void	activate (void)
	Makes a program pipeline object active by making sure it is linked and then putting it in use. More...

void	bindFixedAttributes (GLuint program)

void	extractLayoutQualifiers (void)

GLSLShader *	getComputeShader () const

GLSLShader *	getDomainShader () const

GLSLShader *	getFragmentShader () const

GLSLShader *	getGeometryShader () const

uint	getGLProgramHandle (void) const
	Get the GL Handle for the program object. More...

GLuint	getGLProgramPipelineHandle () const
	GL Program Pipeline Handle. More...

GLSLShader *	getHullShader () const

GLSLShader *	getVertexShader () const

bool	isSkeletalAnimationIncluded (void) const
	Returns whether the linked program includes the required instructions to perform skeletal animation. More...

bool	isUsingShader (GLSLShaderCommon *shader) const
	query if the program is using the given shader More...

void	setSkeletalAnimationIncluded (bool included)
	Sets whether the linked program includes the required instructions to perform skeletal animation. More...

void	setTransformFeedbackVaryings (const std::vector< String > &nameStrings)

void	updateAtomicCounters (GpuProgramParametersSharedPtr params, uint16 mask, GpuProgramType fromProgType)
	Updates program object atomic counter buffers using data from GpuProgramParameters. More...

void	updatePassIterationUniforms (GpuProgramParametersSharedPtr params)
	Updates program pipeline object uniforms using data from pass iteration GpuProgramParameters. More...

void	updateUniformBlocks (GpuProgramParametersSharedPtr params, uint16 mask, GpuProgramType fromProgType)
	Updates program object uniform blocks using shared parameter data from GpuProgramParameters. More...

void	updateUniforms (GpuProgramParametersSharedPtr params, uint16 mask, GpuProgramType fromProgType)
	Updates program pipeline object uniforms using named and indexed parameter data from GpuProgramParameters. More...

Static Public Member Functions
static int32	getFixedAttributeIndex (VertexElementSemantic semantic, uint index)
	Get the fixed attribute bindings normally used by GL for a semantic. More...

static void	useTightAttributeLayout ()
	use alternate vertex attribute layout using only 8 vertex attributes More...

Detailed Description

Specialisation of GLSLProgram to provide support for separable programs via the OpenGL program pipeline.

Separable programs consist of shader objects which have been individually linked. This allows for invidual shaders in a program pipeline to be swapped without recompiling the program object, as would be necessary with monolithic programs. This is especially useful in the common case of only entities which change only a few of the shaders in the pipeline while leaving the rest the same.

Remarks: GLSL has no target assembler or entry point specification like DirectX 9 HLSL. Vertex and Fragment shaders only have one entry point called "main". When a shader is compiled, microcode is generated but can not be accessed by the application.

GLSL also does not provide assembler low level output after compiling. The GL Render system assumes that the Gpu program is a GL Gpu program so GLSLSeparableProgram will create a GL3PlusShader for the low level implementation. The GLProgram class will create a shader and program object and compile the source but will not create a pipeline object. It's up to GLGpuProgram class to request a program pipeline object to link the program object to.

Note: GLSL supportsn multiple modular shader objects that can be attached to one program object to form a single shader. This is supported through the "attach" material script command. All the modules to be attached are listed on the same line as the attach command separated by white space.

Constructor & Destructor Documentation

◆ GLSLSeparableProgram()

Ogre::GLSLSeparableProgram::GLSLSeparableProgram	(	GLSLShader *	vertexShader,
		GLSLShader *	hullShader,
		GLSLShader *	domainShader,
		GLSLShader *	geometryShader,
		GLSLShader *	fragmentShader,
		GLSLShader *	computeShader
	)

Constructor should only be used by GLSLSeparableProgramManager.

◆ ~GLSLSeparableProgram()

Ogre::GLSLSeparableProgram::~GLSLSeparableProgram ( )

Member Function Documentation

◆ getGLProgramPipelineHandle()

GLuint Ogre::GLSLSeparableProgram::getGLProgramPipelineHandle ( ) const

inline

GL Program Pipeline Handle.

◆ updateUniforms()

void Ogre::GLSLSeparableProgram::updateUniforms	(	GpuProgramParametersSharedPtr	params,
		uint16	mask,
		GpuProgramType	fromProgType
	)

virtual

Updates program pipeline object uniforms using named and indexed parameter data from GpuProgramParameters.

normally called by GLSLShader::bindProgramParameters() just before rendering occurs.

Implements Ogre::GLSLProgramCommon.

◆ updateAtomicCounters()

void Ogre::GLSLSeparableProgram::updateAtomicCounters	(	GpuProgramParametersSharedPtr	params,
		uint16	mask,
		GpuProgramType	fromProgType
	)

virtual

Updates program object atomic counter buffers using data from GpuProgramParameters.

Normally called by GLSLShader::bindProgramAtomicCounterParameters() just before rendering occurs.

Implements Ogre::GLSLProgram.

◆ updateUniformBlocks()

void Ogre::GLSLSeparableProgram::updateUniformBlocks	(	GpuProgramParametersSharedPtr	params,
		uint16	mask,
		GpuProgramType	fromProgType
	)

virtual

Updates program object uniform blocks using shared parameter data from GpuProgramParameters.

Normally called by GLSLShader::bindProgramSharedParameters() just before rendering occurs.

Implements Ogre::GLSLProgramCommon.

◆ updatePassIterationUniforms()

void Ogre::GLSLSeparableProgram::updatePassIterationUniforms ( GpuProgramParametersSharedPtr params )

virtual

Updates program pipeline object uniforms using data from pass iteration GpuProgramParameters.

Normally called by GLSLShader::bindProgramPassIterationParameters() just before multi pass rendering occurs.

Implements Ogre::GLSLProgramCommon.

◆ activate()

void Ogre::GLSLSeparableProgram::activate ( void )

virtual

Makes a program pipeline object active by making sure it is linked and then putting it in use.

Implements Ogre::GLSLProgramCommon.

◆ bindFixedAttributes()

void Ogre::GLSLProgram::bindFixedAttributes ( GLuint program )

inherited

◆ getVertexShader()

GLSLShader* Ogre::GLSLProgram::getVertexShader ( ) const

inlineinherited

◆ getHullShader()

GLSLShader* Ogre::GLSLProgram::getHullShader ( ) const

inlineinherited

◆ getDomainShader()

GLSLShader* Ogre::GLSLProgram::getDomainShader ( ) const

inlineinherited

◆ getGeometryShader()

GLSLShader* Ogre::GLSLProgram::getGeometryShader ( ) const

inlineinherited

◆ getFragmentShader()

GLSLShader* Ogre::GLSLProgram::getFragmentShader ( ) const

inlineinherited

◆ getComputeShader()

GLSLShader* Ogre::GLSLProgram::getComputeShader ( ) const

inlineinherited

◆ isUsingShader()

bool Ogre::GLSLProgram::isUsingShader ( GLSLShaderCommon * shader ) const

inlinevirtualinherited

query if the program is using the given shader

Implements Ogre::GLSLProgramCommon.

◆ setTransformFeedbackVaryings()

void Ogre::GLSLProgram::setTransformFeedbackVaryings ( const std::vector< String > & nameStrings )

inherited

◆ extractLayoutQualifiers()

void Ogre::GLSLProgramCommon::extractLayoutQualifiers ( void )

inherited

◆ setSkeletalAnimationIncluded()

void Ogre::GLSLProgramCommon::setSkeletalAnimationIncluded ( bool included )

inlineinherited

Sets whether the linked program includes the required instructions to perform skeletal animation.

Remarks: If this is set to true, OGRE will not blend the geometry according to skeletal animation, it will expect the vertex program to do it.

◆ isSkeletalAnimationIncluded()

bool Ogre::GLSLProgramCommon::isSkeletalAnimationIncluded ( void ) const

inlineinherited

Returns whether the linked program includes the required instructions to perform skeletal animation.

Remarks: If this returns true, OGRE will not blend the geometry according to skeletal animation, it will expect the vertex program to do it.

◆ getGLProgramHandle()

uint Ogre::GLSLProgramCommon::getGLProgramHandle ( void ) const

inlineinherited

Get the GL Handle for the program object.

References OGRE_MAX_TEXTURE_COORD_SETS, and Ogre::VES_COUNT.

◆ getFixedAttributeIndex()

static int32 Ogre::GLSLProgramCommon::getFixedAttributeIndex	(	VertexElementSemantic	semantic,
		uint	index
	)

staticinherited

Get the fixed attribute bindings normally used by GL for a semantic.

◆ useTightAttributeLayout()

static void Ogre::GLSLProgramCommon::useTightAttributeLayout ( )

staticinherited

use alternate vertex attribute layout using only 8 vertex attributes

For "Vivante GC1000" and "VideoCore IV" (notably in Raspberry Pi) on GLES2

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

OgreGLSLSeparableProgram.h

Public Member Functions

Static Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ GLSLSeparableProgram()

◆ ~GLSLSeparableProgram()

Member Function Documentation

◆ getGLProgramPipelineHandle()

◆ updateUniforms()

◆ updateAtomicCounters()

◆ updateUniformBlocks()

◆ updatePassIterationUniforms()

◆ activate()

◆ bindFixedAttributes()

◆ getVertexShader()

◆ getHullShader()

◆ getDomainShader()

◆ getGeometryShader()

◆ getFragmentShader()

◆ getComputeShader()

◆ isUsingShader()

◆ setTransformFeedbackVaryings()

◆ extractLayoutQualifiers()

◆ setSkeletalAnimationIncluded()

◆ isSkeletalAnimationIncluded()

◆ getGLProgramHandle()

◆ getFixedAttributeIndex()

◆ useTightAttributeLayout()