ruby-ogre 0.0.1-x86-linux

data/deps/include/OGRE/RTShaderSystem/OgreShaderExNormalMapLighting.h

@@ -0,0 +1,391 @@
+/*
+-----------------------------------------------------------------------------
+This source file is part of OGRE
+(Object-oriented Graphics Rendering Engine)
+For the latest info, see http://www.ogre3d.org
+
+Copyright (c) 2000-2012 Torus Knot Software Ltd
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+-----------------------------------------------------------------------------
+*/
+#ifndef _ShaderExNormalMapLighting_
+#define _ShaderExNormalMapLighting_
+
+#include "OgreShaderPrerequisites.h"
+#ifdef RTSHADER_SYSTEM_BUILD_EXT_SHADERS
+#include "OgreShaderParameter.h"
+#include "OgreShaderSubRenderState.h"
+#include "OgreVector4.h"
+#include "OgreLight.h"
+#include "OgreCommon.h"
+
+namespace Ogre {
+namespace RTShader {
+
+/** \addtogroup Core
+*  @{
+*/
+/** \addtogroup RTShader
+*  @{
+*/
+
+#define SGX_LIB_NORMALMAPLIGHTING					"SGXLib_NormalMapLighting"
+#define SGX_FUNC_CONSTRUCT_TBNMATRIX				"SGX_ConstructTBNMatrix"
+#define SGX_FUNC_TRANSFORMNORMAL					"SGX_TransformNormal"
+#define SGX_FUNC_TRANSFORMPOSITION					"SGX_TransformPosition"
+#define SGX_FUNC_FETCHNORMAL						"SGX_FetchNormal"
+#define SGX_FUNC_LIGHT_DIRECTIONAL_DIFFUSE			"SGX_Light_Directional_Diffuse"
+#define SGX_FUNC_LIGHT_DIRECTIONAL_DIFFUSESPECULAR	"SGX_Light_Directional_DiffuseSpecular"
+#define SGX_FUNC_LIGHT_POINT_DIFFUSE				"SGX_Light_Point_Diffuse"
+#define SGX_FUNC_LIGHT_POINT_DIFFUSESPECULAR		"SGX_Light_Point_DiffuseSpecular"
+#define SGX_FUNC_LIGHT_SPOT_DIFFUSE					"SGX_Light_Spot_Diffuse"
+#define SGX_FUNC_LIGHT_SPOT_DIFFUSESPECULAR			"SGX_Light_Spot_DiffuseSpecular"
+
+/** Normal Map Lighting extension sub render state implementation.
+Derives from SubRenderState class.
+*/
+class _OgreRTSSExport NormalMapLighting : public SubRenderState
+{
+
+// Interface.
+public:
+	/** Class default constructor */	
+	NormalMapLighting();
+
+	/** 
+	@see SubRenderState::getType.
+	*/
+	virtual const String&	getType					() const;
+
+	/** 
+	@see SubRenderState::getType.
+	*/
+	virtual int				getExecutionOrder		() const;
+
+	/** 
+	@see SubRenderState::updateGpuProgramsParams.
+	*/
+	virtual void			updateGpuProgramsParams	(Renderable* rend, Pass* pass, const AutoParamDataSource* source, const LightList* pLightList);
+
+	/** 
+	@see SubRenderState::copyFrom.
+	*/
+	virtual void			copyFrom				(const SubRenderState& rhs);
+
+
+	/** 
+	@see SubRenderState::preAddToRenderState.
+	*/
+	virtual bool			preAddToRenderState		(const RenderState* renderState, Pass* srcPass, Pass* dstPass);
+
+	/** 
+	Set the index of the input vertex shader texture coordinate set 
+	*/
+	void					setTexCoordIndex		(unsigned int index) { mVSTexCoordSetIndex = index;}
+
+	/** 
+	Return the index of the input vertex shader texture coordinate set.
+	*/
+	unsigned int			getTexCoordIndex		() const { return mVSTexCoordSetIndex; }
+
+	// Type of this render state.
+	static String Type;
+
+	// Normal map space definition.
+	enum NormalMapSpace
+	{
+		NMS_TANGENT,		// Normal map contains normal data in tangent space.
+							// This is the default normal mapping behavior and it requires that the
+							// target mesh will have valid tangents within its vertex data.
+		
+		NMS_OBJECT			// Normal map contains normal data in object local space.
+							// This normal mapping technique has the advantages of better visualization results,
+							// lack of artifacts that comes from texture mirroring usage, it doesn't requires tangent
+							// and it also saves some instruction in the vertex shader stage.
+							// The main drawback of using this kind of normal map is that the target object must be static
+							// in terms of local space rotations and translations.
+	};
+
+	/** 
+	Set the normal map space.
+	@param normalMapSpace The normal map space.
+	*/
+	void					setNormalMapSpace			(NormalMapSpace normalMapSpace) { mNormalMapSpace = normalMapSpace; }
+
+	/** Return the normal map space. */
+	NormalMapSpace			getNormalMapSpace			() const { return mNormalMapSpace; }
+
+	/** 
+	Set the normal map texture name.
+	*/
+	void					setNormalMapTextureName		(const String& textureName) { mNormalMapTextureName = textureName; }
+
+	/** 
+	Return the normal map texture name.
+	*/
+	const String&			getNormalMapTextureName		() const { return mNormalMapTextureName; }
+
+	/** 
+	Set the normal map filtering attributes.
+	@param minFilter The desired min filter.
+	@param magFilter The desired mag filter.
+	@param mipFilter The desired mip filter.
+	*/
+	void					setNormalMapFiltering			(const FilterOptions minFilter, const FilterOptions magFilter, const FilterOptions mipFilter) 
+	{ mNormalMapMinFilter = minFilter; mNormalMapMagFilter = magFilter; mNormalMapMipFilter = mipFilter; }
+
+	/** 
+	Return the normal map filtering attributes.
+	@param minFilter The desired min filter.
+	@param magFilter The desired mag filter.
+	@param mipFilter The desired mip filter.
+	*/
+	void					getNormalMapFiltering			(FilterOptions& minFilter, FilterOptions& magFilter, FilterOptions& mipFilter) const
+	{ minFilter = mNormalMapMinFilter; magFilter = mNormalMapMagFilter ; mipFilter = mNormalMapMipFilter; }
+
+	/** Setup the normal map anisotropy value. 
+	@param anisotropy The anisotropy value.
+	*/
+	void			setNormalMapAnisotropy		(unsigned int anisotropy) { mNormalMapAnisotropy = anisotropy; }
+
+
+	/** Return the normal map anisotropy value. */
+	unsigned int	getNormalMapAnisotropy		() const { return mNormalMapAnisotropy; }
+
+	
+	/** Setup the normal map anisotropy value. 
+	@param anisotropy The anisotropy value.
+	*/
+	void			setNormalMapMipBias		(Real mipBias) { mNormalMapMipBias = mipBias; }
+
+
+	/** Return the normal map mip bias value. */
+	Real			getNormalMapMipBias		() const { return mNormalMapMipBias; }
+
+
+
+// Protected types:
+protected:
+	
+	// Per light parameters.
+	struct _OgreRTSSExport LightParams
+	{
+		Light::LightTypes		mType;				// Light type.		
+		UniformParameterPtr		mPosition;			// Light position.
+		ParameterPtr			mVSOutToLightDir;	// Vertex shader output vertex position to light position direction (texture space).
+		ParameterPtr			mPSInToLightDir;	// Pixel shader input vertex position to light position direction (texture space).
+		UniformParameterPtr		mDirection;			// Light direction.
+		ParameterPtr			mVSOutDirection;	// Vertex shader output light direction (texture space).
+		ParameterPtr			mPSInDirection;		// Pixel shader input light direction (texture space).		
+		UniformParameterPtr		mAttenuatParams;	// Attenuation parameters.
+		UniformParameterPtr		mSpotParams;		// Spot light parameters.
+		UniformParameterPtr		mDiffuseColour;		// Diffuse colour.
+		UniformParameterPtr		mSpecularColour;	// Specular colour.
+
+	};
+
+	typedef vector<LightParams>::type				LightParamsList;
+	typedef LightParamsList::iterator				LightParamsIterator;
+	typedef LightParamsList::const_iterator			LightParamsConstIterator;
+
+// Protected methods
+protected:
+
+	/** 
+	Set the track per vertex colour type. Ambient, Diffuse, Specular and Emissive lighting components source
+	can be the vertex colour component. To establish such a link one should provide the matching flags to this
+	sub render state.
+	*/
+	void					setTrackVertexColourType(TrackVertexColourType type) { mTrackVertexColourType = type; }
+
+	/** 
+	Return the current track per vertex type.
+	*/
+	TrackVertexColourType	getTrackVertexColourType() const { return mTrackVertexColourType; }
+
+
+	/** 
+	Set the light count per light type that this sub render state will generate.
+	@see ShaderGenerator::setLightCount.
+	*/
+	void					setLightCount			(const int lightCount[3]);
+
+	/** 
+	Get the light count per light type that this sub render state will generate.
+	@see ShaderGenerator::getLightCount.
+	*/
+	void					getLightCount			(int lightCount[3]) const;
+	/** 
+	Set the specular component state. If set to true this sub render state will compute a specular
+	lighting component in addition to the diffuse component.
+	@param enable Pass true to enable specular component computation.
+	*/
+	void					setSpecularEnable		(bool enable) { mSpecularEnable = enable; }
+
+	/** 
+	Get the specular component state. 
+	*/
+	bool					getSpecularEnable		() const	  { return mSpecularEnable; }
+
+
+	/** 
+	@see SubRenderState::resolveParameters.
+	*/
+	virtual bool			resolveParameters			(ProgramSet* programSet);
+
+	/** Resolve global lighting parameters */
+	bool					resolveGlobalParameters		(ProgramSet* programSet);
+
+	/** Resolve per light parameters */
+	bool					resolvePerLightParameters	(ProgramSet* programSet);
+
+	/** 
+	@see SubRenderState::resolveDependencies.
+	*/
+	virtual bool			resolveDependencies		(ProgramSet* programSet);
+
+	/** 
+	@see SubRenderState::addFunctionInvocations.
+	*/
+	virtual bool			addFunctionInvocations	(ProgramSet* programSet);
+	
+
+	/** 
+	Internal method that adds related vertex shader functions invocations.
+	*/
+	bool			addVSInvocation						(Function* vsMain, const int groupOrder, int& internalCounter);
+
+	/** 
+	Internal method that adds per light illumination component functions invocations.
+	*/
+	bool			addVSIlluminationInvocation			(LightParams* curLightParams, Function* vsMain, const int groupOrder, int& internalCounter);
+
+	/** 
+	Internal method that perform normal fetch invocation.
+	*/
+	bool			addPSNormalFetchInvocation		(Function* psMain, const int groupOrder, int& internalCounter);
+
+
+	/** 
+	Internal method that adds global illumination component functions invocations.
+	*/
+	bool			addPSGlobalIlluminationInvocation	(Function* psMain, const int groupOrder, int& internalCounter);
+
+	/** 
+	Internal method that adds per light illumination component functions invocations.
+	*/
+	bool			addPSIlluminationInvocation		(LightParams* curLightParams, Function* psMain, const int groupOrder, int& internalCounter);
+
+	/** 
+	Internal method that adds the final colour assignments.
+	*/
+	bool			addPSFinalAssignmentInvocation	(Function* psMain, const int groupOrder, int& internalCounter);
+
+
+// Attributes.
+protected:	
+	String					mNormalMapTextureName;			// The normal map texture name.
+	TrackVertexColourType	mTrackVertexColourType;			// Track per vertex colour type.
+	bool					mSpecularEnable;				// Specular component enabled/disabled.
+	LightParamsList			mLightParamsList;				// Light list.
+	unsigned short			mNormalMapSamplerIndex;			// Normal map texture sampler index.
+	unsigned int			mVSTexCoordSetIndex;			// Vertex shader input texture coordinate set index.
+	FilterOptions			mNormalMapMinFilter;			// The normal map min filter.
+	FilterOptions			mNormalMapMagFilter;			// The normal map mag filter.
+	FilterOptions			mNormalMapMipFilter;			// The normal map mip filter.
+	unsigned int			mNormalMapAnisotropy;			// The normal map max anisotropy value.
+	Real					mNormalMapMipBias;				// The normal map mip map bias.
+	NormalMapSpace			mNormalMapSpace;				// The normal map space.
+	UniformParameterPtr		mWorldMatrix;					// World matrix parameter.
+	UniformParameterPtr		mWorldInvRotMatrix;				// World matrix inverse rotation matrix parameter.
+	UniformParameterPtr		mCamPosWorldSpace;				// Camera position in world space parameter.	
+	ParameterPtr			mVSInPosition;					// Vertex shader input position parameter.
+	ParameterPtr			mVSWorldPosition;				// Vertex shader world position parameter.
+	ParameterPtr			mVSOutView;						// Vertex shader output view vector (position in camera space) parameter.
+	ParameterPtr			mPSInView;						// Pixel shader input view position (position in camera space) parameter.
+	ParameterPtr			mVSInNormal;					// Vertex shader input normal.
+	ParameterPtr			mVSInTangent;					// Vertex shader input tangent.
+	ParameterPtr			mVSTBNMatrix;					// Vertex shader local TNB matrix.
+	ParameterPtr			mVSLocalDir;					// Vertex shader local light direction.
+	UniformParameterPtr		mNormalMapSampler;				// Normal map texture sampler parameter.
+	ParameterPtr			mPSNormal;						// Pixel shader normal parameter.
+	ParameterPtr			mVSInTexcoord;					// Vertex shader input texture coordinates.
+	ParameterPtr			mVSOutTexcoord;					// Vertex shader output texture coordinates.
+	ParameterPtr			mPSInTexcoord;					// Pixel shader input texture coordinates.
+	ParameterPtr			mPSTempDiffuseColour;			// Pixel shader temporary diffuse calculation parameter.
+	ParameterPtr			mPSTempSpecularColour;			// Pixel shader temporary specular calculation parameter.
+	ParameterPtr			mPSDiffuse;						// Pixel shader input/local diffuse parameter.	
+	ParameterPtr			mPSSpecular;					// Pixel shader input/local specular parameter.	
+	ParameterPtr			mPSOutDiffuse;					// Pixel shader output diffuse parameter.	
+	ParameterPtr			mPSOutSpecular;					// Pixel shader output specular parameter.	
+	UniformParameterPtr		mDerivedSceneColour;			// Derived scene colour parameter.
+	UniformParameterPtr		mLightAmbientColour;			// Ambient light colour parameter.
+	UniformParameterPtr		mDerivedAmbientLightColour;		// Derived ambient light colour parameter.
+	UniformParameterPtr		mSurfaceAmbientColour;			// Surface ambient colour parameter.
+	UniformParameterPtr		mSurfaceDiffuseColour;			// Surface diffuse colour parameter.
+	UniformParameterPtr		mSurfaceSpecularColour;			// Surface specular colour parameter.
+	UniformParameterPtr		mSurfaceEmissiveColour;			// Surface emissive colour parameter.
+	UniformParameterPtr		mSurfaceShininess;				// Surface shininess parameter.
+	static Light			msBlankLight;					// Shared blank light.
+};
+
+
+/** 
+A factory that enables creation of NormalMapLighting instances.
+@remarks Sub class of SubRenderStateFactory
+*/
+class _OgreRTSSExport NormalMapLightingFactory : public SubRenderStateFactory
+{
+public:
+
+	/** 
+	@see SubRenderStateFactory::getType.
+	*/
+	virtual const String&	getType				() const;
+
+	/** 
+	@see SubRenderStateFactory::createInstance.
+	*/
+	virtual SubRenderState*	createInstance		(ScriptCompiler* compiler, PropertyAbstractNode* prop, Pass* pass, SGScriptTranslator* translator);
+
+	/** 
+	@see SubRenderStateFactory::writeInstance.
+	*/
+	virtual void			writeInstance		(MaterialSerializer* ser, SubRenderState* subRenderState, Pass* srcPass, Pass* dstPass);
+
+	
+protected:
+
+	/** 
+	@see SubRenderStateFactory::createInstanceImpl.
+	*/
+	virtual SubRenderState*	createInstanceImpl	();
+
+
+};
+
+/** @} */
+/** @} */
+
+}
+}
+
+#endif
+#endif
+

data/deps/include/OGRE/RTShaderSystem/OgreShaderExPerPixelLighting.h

@@ -0,0 +1,276 @@
+/*
+-----------------------------------------------------------------------------
+This source file is part of OGRE
+(Object-oriented Graphics Rendering Engine)
+For the latest info, see http://www.ogre3d.org
+
+Copyright (c) 2000-2012 Torus Knot Software Ltd
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+-----------------------------------------------------------------------------
+*/
+#ifndef _ShaderExPerPixelLighting_
+#define _ShaderExPerPixelLighting_
+
+#include "OgreShaderPrerequisites.h"
+#ifdef RTSHADER_SYSTEM_BUILD_EXT_SHADERS
+#include "OgreShaderParameter.h"
+#include "OgreShaderSubRenderState.h"
+#include "OgreVector4.h"
+#include "OgreLight.h"
+#include "OgreCommon.h"
+
+namespace Ogre {
+namespace RTShader {
+
+/** \addtogroup Core
+*  @{
+*/
+/** \addtogroup RTShader
+*  @{
+*/
+
+#define SGX_LIB_PERPIXELLIGHTING					"SGXLib_PerPixelLighting"
+#define SGX_FUNC_TRANSFORMNORMAL					"SGX_TransformNormal"
+#define SGX_FUNC_TRANSFORMPOSITION					"SGX_TransformPosition"
+#define SGX_FUNC_LIGHT_DIRECTIONAL_DIFFUSE			"SGX_Light_Directional_Diffuse"
+#define SGX_FUNC_LIGHT_DIRECTIONAL_DIFFUSESPECULAR	"SGX_Light_Directional_DiffuseSpecular"
+#define SGX_FUNC_LIGHT_POINT_DIFFUSE				"SGX_Light_Point_Diffuse"
+#define SGX_FUNC_LIGHT_POINT_DIFFUSESPECULAR		"SGX_Light_Point_DiffuseSpecular"
+#define SGX_FUNC_LIGHT_SPOT_DIFFUSE					"SGX_Light_Spot_Diffuse"
+#define SGX_FUNC_LIGHT_SPOT_DIFFUSESPECULAR			"SGX_Light_Spot_DiffuseSpecular"	
+
+/** Per pixel Lighting extension sub render state implementation.
+Derives from SubRenderState class.
+*/
+class _OgreRTSSExport PerPixelLighting : public SubRenderState
+{
+
+// Interface.
+public:
+	/** Class default constructor */	
+	PerPixelLighting();
+
+	/** 
+	@see SubRenderState::getType.
+	*/
+	virtual const String&	getType					() const;
+
+	/** 
+	@see SubRenderState::getType.
+	*/
+	virtual int				getExecutionOrder		() const;
+
+	/** 
+	@see SubRenderState::updateGpuProgramsParams.
+	*/
+	virtual void			updateGpuProgramsParams	(Renderable* rend, Pass* pass, const AutoParamDataSource* source, const LightList* pLightList);
+
+	/** 
+	@see SubRenderState::copyFrom.
+	*/
+	virtual void			copyFrom				(const SubRenderState& rhs);
+
+
+	/** 
+	@see SubRenderState::preAddToRenderState.
+	*/
+	virtual bool			preAddToRenderState		(const RenderState* renderState, Pass* srcPass, Pass* dstPass);
+
+
+	
+	static String Type;
+
+// Protected types:
+protected:
+	
+	// Per light parameters.
+	struct _OgreRTSSExport LightParams
+	{
+		Light::LightTypes		mType;				// Light type.		
+		UniformParameterPtr		mPosition;			// Light position.
+		UniformParameterPtr		mDirection;			// Light direction.
+		UniformParameterPtr		mAttenuatParams;	// Attenuation parameters.
+		UniformParameterPtr		mSpotParams;		// Spot light parameters.
+		UniformParameterPtr		mDiffuseColour;		// Diffuse colour.
+		UniformParameterPtr		mSpecularColour;	// Specular colour.
+
+	};
+
+	typedef vector<LightParams>::type				LightParamsList;
+	typedef LightParamsList::iterator				LightParamsIterator;
+	typedef LightParamsList::const_iterator			LightParamsConstIterator;
+
+// Protected methods
+protected:
+
+	/** 
+	Set the track per vertex colour type. Ambient, Diffuse, Specular and Emissive lighting components source
+	can be the vertex colour component. To establish such a link one should provide the matching flags to this
+	sub render state.
+	*/
+	void					setTrackVertexColourType(TrackVertexColourType type) { mTrackVertexColourType = type; }
+
+	/** 
+	Return the current track per vertex type.
+	*/
+	TrackVertexColourType	getTrackVertexColourType() const { return mTrackVertexColourType; }
+
+
+	/** 
+	Set the light count per light type that this sub render state will generate.
+	@see ShaderGenerator::setLightCount.
+	*/
+	void					setLightCount			(const int lightCount[3]);
+
+	/** 
+	Get the light count per light type that this sub render state will generate.
+	@see ShaderGenerator::getLightCount.
+	*/
+	void					getLightCount			(int lightCount[3]) const;
+	/** 
+	Set the specular component state. If set to true this sub render state will compute a specular
+	lighting component in addition to the diffuse component.
+	@param enable Pass true to enable specular component computation.
+	*/
+	void					setSpecularEnable		(bool enable) { mSpecularEnable = enable; }
+
+	/** 
+	Get the specular component state. 
+	*/
+	bool					getSpecularEnable		() const	  { return mSpecularEnable; }
+
+
+	/** 
+	@see SubRenderState::resolveParameters.
+	*/
+	virtual bool			resolveParameters			(ProgramSet* programSet);
+
+	/** Resolve global lighting parameters */
+	bool					resolveGlobalParameters		(ProgramSet* programSet);
+
+	/** Resolve per light parameters */
+	bool					resolvePerLightParameters	(ProgramSet* programSet);
+
+	/** 
+	@see SubRenderState::resolveDependencies.
+	*/
+	virtual bool			resolveDependencies		(ProgramSet* programSet);
+
+	/** 
+	@see SubRenderState::addFunctionInvocations.
+	*/
+	virtual bool			addFunctionInvocations	(ProgramSet* programSet);
+	
+
+	/** 
+	Internal method that adds related vertex shader functions invocations.
+	*/
+	bool			addVSInvocation						(Function* vsMain, const int groupOrder, int& internalCounter);
+
+	
+	/** 
+	Internal method that adds global illumination component functions invocations.
+	*/
+	bool			addPSGlobalIlluminationInvocation	(Function* psMain, const int groupOrder, int& internalCounter);
+
+	/** 
+	Internal method that adds per light illumination component functions invocations.
+	*/
+	bool			addPSIlluminationInvocation		(LightParams* curLightParams, Function* psMain, const int groupOrder, int& internalCounter);
+
+	/** 
+	Internal method that adds the final colour assignments.
+	*/
+	bool			addPSFinalAssignmentInvocation	(Function* psMain, const int groupOrder, int& internalCounter);
+
+
+// Attributes.
+protected:	
+	TrackVertexColourType	mTrackVertexColourType;			// Track per vertex colour type.
+	bool					mSpecularEnable;				// Specular component enabled/disabled.
+	LightParamsList			mLightParamsList;				// Light list.
+	UniformParameterPtr		mWorldViewMatrix;				// World view matrix parameter.
+	UniformParameterPtr		mWorldViewITMatrix;				// World view matrix inverse transpose parameter.
+	ParameterPtr			mVSInPosition;					// Vertex shader input position parameter.
+	ParameterPtr			mVSOutViewPos;					// Vertex shader output view position (position in camera space) parameter.
+	ParameterPtr			mPSInViewPos;					// Pixel shader input view position (position in camera space) parameter.
+	ParameterPtr			mVSInNormal;					// Vertex shader input normal.
+	ParameterPtr			mVSOutNormal;					// Vertex shader output normal.
+	ParameterPtr			mPSInNormal;					// Pixel shader input normal.
+	ParameterPtr			mPSTempDiffuseColour;			// Pixel shader temporary diffuse calculation parameter.
+	ParameterPtr			mPSTempSpecularColour;			// Pixel shader temporary specular calculation parameter.
+	ParameterPtr			mPSDiffuse;						// Pixel shader input/local diffuse parameter.	
+	ParameterPtr			mPSSpecular;					// Pixel shader input/local specular parameter.	
+	ParameterPtr			mPSOutDiffuse;					// Pixel shader output diffuse parameter.	
+	ParameterPtr			mPSOutSpecular;					// Pixel shader output specular parameter.	
+	UniformParameterPtr		mDerivedSceneColour;			// Derived scene colour parameter.
+	UniformParameterPtr		mLightAmbientColour;			// Ambient light colour parameter.
+	UniformParameterPtr		mDerivedAmbientLightColour;		// Derived ambient light colour parameter.
+	UniformParameterPtr		mSurfaceAmbientColour;			// Surface ambient colour parameter.
+	UniformParameterPtr		mSurfaceDiffuseColour;			// Surface diffuse colour parameter.
+	UniformParameterPtr		mSurfaceSpecularColour;			// Surface specular colour parameter.
+	UniformParameterPtr		mSurfaceEmissiveColour;			// Surface emissive colour parameter.
+	UniformParameterPtr		mSurfaceShininess;				// Surface shininess parameter.
+	static Light			msBlankLight;					// Shared blank light.
+};
+
+
+/** 
+A factory that enables creation of PerPixelLighting instances.
+@remarks Sub class of SubRenderStateFactory
+*/
+class _OgreRTSSExport PerPixelLightingFactory : public SubRenderStateFactory
+{
+public:
+
+	/** 
+	@see SubRenderStateFactory::getType.
+	*/
+	virtual const String&	getType				() const;
+
+	/** 
+	@see SubRenderStateFactory::createInstance.
+	*/
+	virtual SubRenderState*	createInstance		(ScriptCompiler* compiler, PropertyAbstractNode* prop, Pass* pass, SGScriptTranslator* translator);
+
+	/** 
+	@see SubRenderStateFactory::writeInstance.
+	*/
+	virtual void			writeInstance		(MaterialSerializer* ser, SubRenderState* subRenderState, Pass* srcPass, Pass* dstPass);
+
+	
+protected:
+
+	/** 
+	@see SubRenderStateFactory::createInstanceImpl.
+	*/
+	virtual SubRenderState*	createInstanceImpl	();
+
+
+};
+
+/** @} */
+/** @} */
+
+}
+}
+
+#endif
+#endif
+