Specialisation of HighLevelGpuProgram to provide support for OpenGL Shader Language (GLSL) for OpenGL. More...

#include <OgreGLSLProgramPipeline.h>

Inheritance diagram for Ogre::GLSLProgramPipeline:

Public Member Functions
	GLSLProgramPipeline (GLSLGpuProgram vertexProgram, GLSLGpuProgram geometryProgram, GLSLGpuProgram fragmentProgram, GLSLGpuProgram hullProgram, GLSLGpuProgram domainProgram, GLSLGpuProgram computeProgram)
	Constructor should only be used by GLSLProgramPipelineManager.
virtual	~GLSLProgramPipeline ()
void	activate (void)
	Makes a program pipeline object active by making sure it is linked and then putting it in use.
virtual void	extractLayoutQualifiers (void)
	Finds layout qualifiers in the shader source and sets attribute indices appropriately.
virtual GLint	getAttributeIndex (VertexElementSemantic semantic, uint index)
	Get the index of a non-standard attribute bound in the linked code.
GLSLGpuProgram *	getComputeProgram () const
GLSLGpuProgram *	getDomainProgram () const
GLSLGpuProgram *	getFragmentProgram () const
GLSLGpuProgram *	getGeometryProgram () const
GLuint	getGLProgramHandle (void) const
	Get the GL Handle for the program object.
GLuint	getGLProgramPipelineHandle () const
	GL Program Pipeline Handle.
GLSLGpuProgram *	getHullProgram () const
GL3PlusVertexArrayObject *	getVertexArrayObject ()
GLSLGpuProgram *	getVertexProgram () const
bool	isAttributeValid (VertexElementSemantic semantic, uint index)
	Is a non-standard attribute bound in the linked code?
bool	isSkeletalAnimationIncluded (void) const
	Returns whether the linked program includes the required instructions to perform skeletal animation.
void	setSkeletalAnimationIncluded (bool included)
	Sets whether the linked program includes the required instructions to perform skeletal animation.
virtual void	updatePassIterationUniforms (GpuProgramParametersSharedPtr params)
	Updates program pipeline object uniforms using data from pass iteration GpuProgramParameters.
virtual void	updateUniformBlocks (GpuProgramParametersSharedPtr params, uint16 mask, GpuProgramType fromProgType)
	Updates program object uniform blocks using data from GpuProgramParameters.
virtual void	updateUniforms (GpuProgramParametersSharedPtr params, uint16 mask, GpuProgramType fromProgType)
	Updates program pipeline object uniforms using data from GpuProgramParameters.
Protected Types
typedef set< GLuint >::type	AttributeSet
typedef map< String, VertexElementSemantic >::type	SemanticToStringMap
Protected Member Functions
virtual void	_useProgram (void)
	Put a program pipeline in use.
virtual void	buildGLUniformReferences (void)
	Build uniform references from active named uniforms.
virtual void	compileAndLink (void)
	Compiles and links the separate programs.
void	compileIndividualProgram (GLSLGpuProgram *program)
VertexElementSemantic	getAttributeSemanticEnum (String type)
const char *	getAttributeSemanticString (VertexElementSemantic semantic)
Ogre::String	getCombinedName (void)
void	getMicrocodeFromCache (void)
	Get the the binary data of a program from the microcode cache.
Protected Attributes
GLSLGpuProgram *	mComputeProgram
	Linked compute program.
GLint	mCustomAttributesIndexes [VES_COUNT][OGRE_MAX_TEXTURE_COORD_SETS]
	An array to hold the attributes indexes.
GLSLGpuProgram *	mDomainProgram
	Linked domain(evaluation) program.
GLSLGpuProgram *	mFragmentProgram
	Linked fragment program.
GLSLGpuProgram *	mGeometryProgram
	Linked geometry program.
GLuint	mGLProgramHandle
	GL handle for the program object.
GLuint	mGLProgramPipelineHandle
	GL handle for pipeline object.
GLUniformBufferList	mGLUniformBufferReferences
	Container of uniform buffer references that are active in the program object.
GLUniformReferenceList	mGLUniformReferences
	Container of uniform references that are active in the program object.
GLSLGpuProgram *	mHullProgram
	Linked hull(control) program.
GLint	mLinked
	Flag indicating that the program or pipeline object has been successfully linked.
SemanticToStringMap	mSemanticTypeMap
bool	mSkeletalAnimation
	Flag indicating skeletal animation is being performed.
bool	mTriedToLinkAndFailed
	Flag indicating that the program or pipeline object has tried to link and failed.
bool	mUniformRefsBuilt
	Flag to indicate that uniform references have already been built.
GL3PlusVertexArrayObject *	mVertexArrayObject
	GL handle for the vertex array object.
GLSLGpuProgram *	mVertexProgram
	Linked vertex program.

Detailed Description

Specialisation of HighLevelGpuProgram to provide support for OpenGL Shader Language (GLSL) for OpenGL.

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 GLSLProgramPipeline will create a GLSLGpuProgram that is subclassed from GLGpuProgram 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 supports 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.

Definition at line 56 of file OgreGLSLProgramPipeline.h.

Member Typedef Documentation

typedef set<GLuint>::type Ogre::GLSLProgramCommon::AttributeSet [protected, inherited]

Definition at line 98 of file OgreGLSLProgramCommon.h.

typedef map<String, VertexElementSemantic>::type Ogre::GLSLProgramCommon::SemanticToStringMap [protected, inherited]

Definition at line 115 of file OgreGLSLProgramCommon.h.

Constructor & Destructor Documentation

Ogre::GLSLProgramPipeline::GLSLProgramPipeline	(	GLSLGpuProgram *	vertexProgram,
		GLSLGpuProgram *	geometryProgram,
		GLSLGpuProgram *	fragmentProgram,
		GLSLGpuProgram *	hullProgram,
		GLSLGpuProgram *	domainProgram,
		GLSLGpuProgram *	computeProgram
	)

Constructor should only be used by GLSLProgramPipelineManager.

virtual Ogre::GLSLProgramPipeline::~GLSLProgramPipeline ( ) [virtual]

Member Function Documentation

virtual void Ogre::GLSLProgramPipeline::_useProgram ( void ) [protected, virtual]

Put a program pipeline in use.

Implements Ogre::GLSLProgramCommon.

void Ogre::GLSLProgramPipeline::activate ( void ) [virtual]

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

Implements Ogre::GLSLProgramCommon.

virtual void Ogre::GLSLProgramPipeline::buildGLUniformReferences ( void ) [protected, virtual]

Build uniform references from active named uniforms.

Reimplemented from Ogre::GLSLProgramCommon.

virtual void Ogre::GLSLProgramPipeline::compileAndLink ( void ) [protected, virtual]

Compiles and links the separate programs.

Implements Ogre::GLSLProgramCommon.

void Ogre::GLSLProgramPipeline::compileIndividualProgram ( GLSLGpuProgram * program ) [protected]

virtual void Ogre::GLSLProgramCommon::extractLayoutQualifiers ( void ) [virtual, inherited]

Finds layout qualifiers in the shader source and sets attribute indices appropriately.

virtual GLint Ogre::GLSLProgramPipeline::getAttributeIndex	(	VertexElementSemantic	semantic,
		uint	index
	)		`[virtual]`

Get the index of a non-standard attribute bound in the linked code.

Reimplemented from Ogre::GLSLProgramCommon.

VertexElementSemantic Ogre::GLSLProgramCommon::getAttributeSemanticEnum ( String type ) [protected, inherited]

const char* Ogre::GLSLProgramCommon::getAttributeSemanticString ( VertexElementSemantic semantic ) [protected, inherited]

Ogre::String Ogre::GLSLProgramCommon::getCombinedName ( void ) [protected, inherited]

GLSLGpuProgram* Ogre::GLSLProgramCommon::getComputeProgram ( ) const [inherited]

Definition at line 172 of file OgreGLSLProgramCommon.h.

GLSLGpuProgram* Ogre::GLSLProgramCommon::getDomainProgram ( ) const [inherited]

Definition at line 171 of file OgreGLSLProgramCommon.h.

GLSLGpuProgram* Ogre::GLSLProgramCommon::getFragmentProgram ( ) const [inherited]

Definition at line 168 of file OgreGLSLProgramCommon.h.

GLSLGpuProgram* Ogre::GLSLProgramCommon::getGeometryProgram ( ) const [inherited]

Definition at line 169 of file OgreGLSLProgramCommon.h.

GLuint Ogre::GLSLProgramCommon::getGLProgramHandle ( void ) const [inherited]

Get the GL Handle for the program object.

Definition at line 145 of file OgreGLSLProgramCommon.h.

GLuint Ogre::GLSLProgramPipeline::getGLProgramPipelineHandle ( ) const

GL Program Pipeline Handle.

Definition at line 64 of file OgreGLSLProgramPipeline.h.

GLSLGpuProgram* Ogre::GLSLProgramCommon::getHullProgram ( ) const [inherited]

Definition at line 170 of file OgreGLSLProgramCommon.h.

void Ogre::GLSLProgramCommon::getMicrocodeFromCache ( void ) [protected, inherited]

Get the the binary data of a program from the microcode cache.

GL3PlusVertexArrayObject* Ogre::GLSLProgramCommon::getVertexArrayObject ( ) [inherited]

Definition at line 173 of file OgreGLSLProgramCommon.h.

GLSLGpuProgram* Ogre::GLSLProgramCommon::getVertexProgram ( ) const [inherited]

Definition at line 167 of file OgreGLSLProgramCommon.h.

bool Ogre::GLSLProgramCommon::isAttributeValid	(	VertexElementSemantic	semantic,
		uint	index
	)		`[inherited]`

Is a non-standard attribute bound in the linked code?

bool Ogre::GLSLProgramCommon::isSkeletalAnimationIncluded ( void ) const [inherited]

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.

Definition at line 160 of file OgreGLSLProgramCommon.h.

void Ogre::GLSLProgramCommon::setSkeletalAnimationIncluded ( bool included ) [inherited]

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.

Definition at line 152 of file OgreGLSLProgramCommon.h.

virtual void Ogre::GLSLProgramPipeline::updatePassIterationUniforms ( GpuProgramParametersSharedPtr params ) [virtual]

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

normally called by GLSLGpuProgram::bindMultiPassParameters() just before multi pass rendering occurs.

Implements Ogre::GLSLProgramCommon.

virtual void Ogre::GLSLProgramPipeline::updateUniformBlocks	(	GpuProgramParametersSharedPtr	params,
		uint16	mask,
		GpuProgramType	fromProgType
	)		`[virtual]`