ruby-ogre 0.0.5-x86-linux → 0.1.0-x86-linux

data/deps/include/OGRE/OgreMaterialManager.h

@@ -1,304 +0,0 @@
-/*
------------------------------------------------------------------------------
-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 __MATERIALMANAGER_H__
-#define __MATERIALMANAGER_H__
-
-#include "OgrePrerequisites.h"
-
-#include "OgreSingleton.h"
-#include "OgreResourceManager.h"
-#include "OgreMaterial.h"
-#include "OgreStringVector.h"
-#include "OgreMaterialSerializer.h"
-
-namespace Ogre {
-
-
-	/** \addtogroup Core
-	*  @{
-	*/
-	/** \addtogroup Materials
-	*  @{
-	*/
-	/** Class for managing Material settings for Ogre.
-        @remarks
-            Materials control the eventual surface rendering properties of geometry. This class
-            manages the library of materials, dealing with programmatic registrations and lookups,
-            as well as loading predefined Material settings from scripts.
-        @par
-            When loaded from a script, a Material is in an 'unloaded' state and only stores the settings
-            required. It does not at that stage load any textures. This is because the material settings may be
-            loaded 'en masse' from bulk material script files, but only a subset will actually be required.
-        @par
-            Because this is a subclass of ResourceManager, any files loaded will be searched for in any path or
-            archive added to the resource paths/archives. See ResourceManager for details.
-        @par
-            For a definition of the material script format, see the Tutorials/MaterialScript.html file.
-    */
-    class _OgreExport MaterialManager : public ResourceManager, public Singleton<MaterialManager>
-    {
-	public:
-		/** Listener on any general material events.
-		@see MaterialManager::addListener
-		*/
-		class Listener
-		{
-		public:
-            /** Virtual destructor needed as class has virtual methods. */
-            virtual ~Listener() { }
-			/** Called if a technique for a given scheme is not found within a material,
-				allows the application to specify a Technique instance manually.
-			@remarks
-				Material schemes allow you to switch wholesale between families of 
-				techniques on a material. However they require you to define those
-				schemes on the materials up-front, which might not be possible or
-				desirable for all materials, particular if, for example, you wanted
-				a simple way to replace all materials with another using a scheme.
-			@par
-				This callback allows you to handle the case where a scheme is requested
-				but the material doesn't have an entry for it. You can return a
-				Technique pointer from this method to specify the material technique
-				you'd like to be applied instead, which can be from another material
-				entirely (and probably will be). Note that it is critical that you
-				only return a Technique that is supported on this hardware; there are
-				utility methods like Material::getBestTechnique to help you with this.
-			@param schemeIndex The index of the scheme that was requested - all 
-				schemes have a unique index when created that does not alter. 
-			@param schemeName The friendly name of the scheme being requested
-			@param originalMaterial The material that is being processed, that 
-				didn't have a specific technique for this scheme
-			@param lodIndex The material level-of-detail that was being asked for, 
-				in case you need to use it to determine a technique.
-			@param rend Pointer to the Renderable that is requesting this technique
-				to be used, so this may influence your choice of Technique. May be
-				null if the technique isn't being requested in that context.
-			@return A pointer to the technique to be used, or NULL if you wish to
-				use the default technique for this material
-			*/
-			virtual Technique* handleSchemeNotFound(unsigned short schemeIndex, 
-				const String& schemeName, Material* originalMaterial, unsigned short lodIndex, 
-				const Renderable* rend) = 0;
-
-		};
-
-    protected:
-
-        /// Default Texture filtering - minification
-        FilterOptions mDefaultMinFilter;
-        /// Default Texture filtering - magnification
-        FilterOptions mDefaultMagFilter;
-        /// Default Texture filtering - mipmapping
-        FilterOptions mDefaultMipFilter;
-        /// Default Texture anisotropy
-        unsigned int mDefaultMaxAniso;
-        /// Serializer - Hold instance per thread if necessary
-        OGRE_THREAD_POINTER(MaterialSerializer, mSerializer);
-		/// Default settings
-		MaterialPtr mDefaultSettings;
-		/// Overridden from ResourceManager
-		Resource* createImpl(const String& name, ResourceHandle handle, 
-			const String& group, bool isManual, ManualResourceLoader* loader,
-            const NameValuePairList* params);
-
-		/// Scheme name -> index. Never shrinks! Should be pretty static anyway
-		typedef map<String, unsigned short>::type SchemeMap;
-		/// List of material schemes
-		SchemeMap mSchemes;
-		/// Current material scheme
-		String mActiveSchemeName;
-		/// Current material scheme
-		unsigned short mActiveSchemeIndex;
-
-		/// The list of per-scheme (and general) material listeners
-		typedef list<Listener*>::type ListenerList;
-		typedef std::map<String, ListenerList> ListenerMap;
-		ListenerMap mListenerMap;
-
-    public:
-		/// Default material scheme
-		static String DEFAULT_SCHEME_NAME;
-		
-        /** Default constructor.
-        */
-        MaterialManager();
-
-        /** Default destructor.
-        */
-        virtual ~MaterialManager();
-
-		/** Initialises the material manager, which also triggers it to 
-		 * parse all available .program and .material scripts. */
-		void initialise(void);
-        
-		/** @see ScriptLoader::parseScript
-        */
-        void parseScript(DataStreamPtr& stream, const String& groupName);
-
-
-        /** Sets the default texture filtering to be used for loaded textures, for when textures are
-            loaded automatically (e.g. by Material class) or when 'load' is called with the default
-            parameters by the application.
-            @note
-                The default value is TFO_BILINEAR.
-        */
-        virtual void setDefaultTextureFiltering(TextureFilterOptions fo);
-        /** Sets the default texture filtering to be used for loaded textures, for when textures are
-            loaded automatically (e.g. by Material class) or when 'load' is called with the default
-            parameters by the application.
-        */
-        virtual void setDefaultTextureFiltering(FilterType ftype, FilterOptions opts);
-        /** Sets the default texture filtering to be used for loaded textures, for when textures are
-            loaded automatically (e.g. by Material class) or when 'load' is called with the default
-            parameters by the application.
-        */
-        virtual void setDefaultTextureFiltering(FilterOptions minFilter, FilterOptions magFilter, FilterOptions mipFilter);
-
-		/// Get the default texture filtering
-        virtual FilterOptions getDefaultTextureFiltering(FilterType ftype) const;
-
-        /** Sets the default anisotropy level to be used for loaded textures, for when textures are
-            loaded automatically (e.g. by Material class) or when 'load' is called with the default
-            parameters by the application.
-            @note
-                The default value is 1 (no anisotropy).
-        */
-		void setDefaultAnisotropy(unsigned int maxAniso);
-		/// Get the default maxAnisotropy
-		unsigned int getDefaultAnisotropy() const;
-
-        /** Returns a pointer to the default Material settings.
-            @remarks
-                Ogre comes configured with a set of defaults for newly created
-                materials. If you wish to have a different set of defaults,
-                simply call this method and change the returned Material's
-                settings. All materials created from then on will be configured
-                with the new defaults you have specified.
-            @par
-                The default settings begin as a single Technique with a single, non-programmable Pass:
-                <ul>
-                <li>ambient = ColourValue::White</li>
-                <li>diffuse = ColourValue::White</li>
-                <li>specular = ColourValue::Black</li>
-                <li>emmissive = ColourValue::Black</li>
-                <li>shininess = 0</li>
-                <li>No texture unit settings (& hence no textures)</li>
-                <li>SourceBlendFactor = SBF_ONE</li>
-                <li>DestBlendFactor = SBF_ZERO (no blend, replace with new
-                  colour)</li>
-                <li>Depth buffer checking on</li>
-                <li>Depth buffer writing on</li>
-                <li>Depth buffer comparison function = CMPF_LESS_EQUAL</li>
-                <li>Colour buffer writing on for all channels</li>
-                <li>Culling mode = CULL_CLOCKWISE</li>
-                <li>Ambient lighting = ColourValue(0.5, 0.5, 0.5) (mid-grey)</li>
-                <li>Dynamic lighting enabled</li>
-                <li>Gourad shading mode</li>
-                <li>Bilinear texture filtering</li>
-                </ul>
-        */
-		virtual MaterialPtr getDefaultSettings(void) const { return mDefaultSettings; }
-
-		/** Internal method - returns index for a given material scheme name.
-		@see Technique::setSchemeName
-		*/
-		virtual unsigned short _getSchemeIndex(const String& name);
-		/** Internal method - returns name for a given material scheme index.
-		@see Technique::setSchemeName
-		*/
-		virtual const String& _getSchemeName(unsigned short index);
-		/** Internal method - returns the active scheme index.
-		@see Technique::setSchemeName
-		*/
-		virtual unsigned short _getActiveSchemeIndex(void) const;
-
-		/** Returns the name of the active material scheme. 
-		@see Technique::setSchemeName
-		*/
-		virtual const String& getActiveScheme(void) const;
-		
-		/** Sets the name of the active material scheme. 
-		@see Technique::setSchemeName
-		*/
-		virtual void setActiveScheme(const String& schemeName);
-
-		/** 
-		Add a listener to handle material events. 
-		If schemeName is supplied, the listener will only receive events for that certain scheme.
-		*/
-		virtual void addListener(Listener* l, const Ogre::String& schemeName = StringUtil::BLANK);
-
-		/** 
-		Remove a listener handling material events. 
-		If the listener was added with a custom scheme name, it needs to be supplied here as well.
-		*/
-		virtual void removeListener(Listener* l, const Ogre::String& schemeName = StringUtil::BLANK);
-
-		/// Internal method for sorting out missing technique for a scheme
-		virtual Technique* _arbitrateMissingTechniqueForActiveScheme(
-			Material* mat, unsigned short lodIndex, const Renderable* rend);
-
-        /** Override standard Singleton retrieval.
-        @remarks
-        Why do we do this? Well, it's because the Singleton
-        implementation is in a .h file, which means it gets compiled
-        into anybody who includes it. This is needed for the
-        Singleton template to work, but we actually only want it
-        compiled into the implementation of the class based on the
-        Singleton, not all of them. If we don't change this, we get
-        link errors when trying to use the Singleton-based class from
-        an outside dll.
-        @par
-        This method just delegates to the template version anyway,
-        but the implementation stays in this single compilation unit,
-        preventing link errors.
-        */
-        static MaterialManager& getSingleton(void);
-        /** Override standard Singleton retrieval.
-        @remarks
-        Why do we do this? Well, it's because the Singleton
-        implementation is in a .h file, which means it gets compiled
-        into anybody who includes it. This is needed for the
-        Singleton template to work, but we actually only want it
-        compiled into the implementation of the class based on the
-        Singleton, not all of them. If we don't change this, we get
-        link errors when trying to use the Singleton-based class from
-        an outside dll.
-        @par
-        This method just delegates to the template version anyway,
-        but the implementation stays in this single compilation unit,
-        preventing link errors.
-        */
-        static MaterialManager* getSingletonPtr(void);
-
-    };
-	/** @} */
-	/** @} */
-
-}
-
-#endif

data/deps/include/OGRE/OgreMaterialSerializer.h

@@ -1,447 +0,0 @@
-/*
------------------------------------------------------------------------------
-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 __MaterialSerializer_H__
-#define __MaterialSerializer_H__
-
-#include "OgrePrerequisites.h"
-#include "OgreMaterial.h"
-#include "OgreBlendMode.h"
-#include "OgreTextureUnitState.h"
-#include "OgreGpuProgram.h"
-#include "OgreStringVector.h"
-
-namespace Ogre {
-
-	/** \addtogroup Core
-	*  @{
-	*/
-	/** \addtogroup Materials
-	*  @{
-	*/
-	/** Enum to identify material sections. */
-    enum MaterialScriptSection
-    {
-        MSS_NONE,
-        MSS_MATERIAL,
-        MSS_TECHNIQUE,
-        MSS_PASS,
-        MSS_TEXTUREUNIT,
-        MSS_PROGRAM_REF,
-		MSS_PROGRAM,
-        MSS_DEFAULT_PARAMETERS,
-		MSS_TEXTURESOURCE
-    };
-	/** Struct for holding a program definition which is in progress. */
-	struct MaterialScriptProgramDefinition
-	{
-		String name;
-		GpuProgramType progType;
-        String language;
-		String source;
-		String syntax;
-        bool supportsSkeletalAnimation;
-		bool supportsMorphAnimation;
-		ushort supportsPoseAnimation; // number of simultaneous poses supported
-		bool usesVertexTextureFetch;
-		vector<std::pair<String, String> >::type customParameters;
-	};
-    /** Struct for holding the script context while parsing. */
-    struct MaterialScriptContext 
-    {
-        MaterialScriptSection section;
-		String groupName;
-        MaterialPtr material;
-        Technique* technique;
-        Pass* pass;
-        TextureUnitState* textureUnit;
-        GpuProgramPtr program; // used when referencing a program, not when defining it
-        bool isVertexProgramShadowCaster; // when referencing, are we in context of shadow caster
-        bool isFragmentProgramShadowCaster; // when referencing, are we in context of shadow caster
-        bool isVertexProgramShadowReceiver; // when referencing, are we in context of shadow caster
-		bool isFragmentProgramShadowReceiver; // when referencing, are we in context of shadow caster
-        GpuProgramParametersSharedPtr programParams;
-		ushort numAnimationParametrics;
-		MaterialScriptProgramDefinition* programDef; // this is used while defining a program
-
-		int techLev,	//Keep track of what tech, pass, and state level we are in
-			passLev,
-			stateLev;
-        StringVector defaultParamLines;
-
-		// Error reporting state
-        size_t lineNo;
-        String filename;
-        AliasTextureNamePairList textureAliases;
-    };
-    /// Function def for material attribute parser; return value determines if the next line should be {
-    typedef bool (*ATTRIBUTE_PARSER)(String& params, MaterialScriptContext& context);
-
-    /** Class for serializing Materials to / from a .material script.*/
-	class _OgreExport MaterialSerializer : public SerializerAlloc
-    {	
-	public:
-
-		// Material serizliae event.
-		enum SerializeEvent
-		{
-			MSE_PRE_WRITE,
-			MSE_WRITE_BEGIN,
-			MSE_WRITE_END,
-			MSE_POST_WRITE
-		};
-
-		/** Class that allows listening in on the various stages of material serialization process.
-		Sub-classing it enable extending the attribute set of any part in the material.
-		*/
-		class Listener
-		{
-		public:
-			virtual ~Listener() {}
-			
-			/** Called when material section event raised.					
-			@param ser The MaterialSerializer instance that writes the given material.
-			@param stage The current section writing stage.
-			@param skip May set to true by sub-class instances in order to skip the following section write.
-			This parameter relevant only when stage equals MSE_PRE_WRITE. 
-			@param mat The material that is being written.			
-			*/
-			virtual void materialEventRaised(MaterialSerializer* ser, 
-				SerializeEvent event, bool& skip, const Material* mat)
-                        { (void)ser; (void)event; (void)skip; (void)mat; }
-			
-			/** Called when technique section event raised.				
-			@param ser The MaterialSerializer instance that writes the given material.
-			@param stage The current section writing stage.
-			@param skip May set to true by sub-class instances in order to skip the following section write.
-			This parameter relevant only when stage equals MSE_PRE_WRITE. 
-			@param tech The technique that is being written.		
-			*/
-			virtual void techniqueEventRaised(MaterialSerializer* ser, 
-				SerializeEvent event, bool& skip, const Technique* tech)
-                        { (void)ser; (void)event; (void)skip; (void)tech; }
-		
-			/** Called when pass section event raised.					
-			@param ser The MaterialSerializer instance that writes the given material.
-			@param stage The current section writing stage.
-			@param skip May set to true by sub-class instances in order to skip the following section write.
-			This parameter relevant only when stage equals MSE_PRE_WRITE. 
-			@param pass The pass that is being written.		
-			*/
-			virtual void passEventRaised(MaterialSerializer* ser, 
-				SerializeEvent event, bool& skip, const Pass* pass)
-                        { (void)ser; (void)event; (void)skip; (void)pass; }
-
-			/** Called when GPU program reference section event raised.				
-			@param ser The MaterialSerializer instance that writes the given material.
-			@param stage The current section writing stage.
-			@param skip May set to true by sub-class instances in order to skip the following section write.
-			This parameter relevant only when stage equals MSE_PRE_WRITE. 
-			@param attrib The GPU program reference description (vertex_program_ref, fragment_program_ref, etc).		
-			@param program The program being written.
-			@param params The program parameters.
-			@param defaultParams The default program parameters.
-			*/
-			void gpuProgramRefEventRaised(MaterialSerializer* ser, 
-				SerializeEvent event, bool& skip,
-				const String& attrib, 
-				const GpuProgramPtr& program, 
-				const GpuProgramParametersSharedPtr& params,
-				GpuProgramParameters* defaultParams)
-                        {
-                            (void)ser;
-                            (void)event;
-                            (void)skip;
-                            (void)attrib;
-                            (void)program;
-                            (void)params;
-                            (void)defaultParams;
-                        }
-
-			/** Called when texture unit state section event raised.					
-			@param ser The MaterialSerializer instance that writes the given material.
-			@param stage The current section writing stage.
-			@param skip May set to true by sub-class instances in order to skip the following section write.
-			This parameter relevant only when stage equals MSE_PRE_WRITE. 
-			@param textureUnit The texture unit state that is being written.		
-			*/
-			virtual void textureUnitStateEventRaised(MaterialSerializer* ser, 
-				SerializeEvent event, bool& skip, const TextureUnitState* textureUnit)
-                        {
-                            (void)ser;
-                            (void)event;
-                            (void)skip;
-                            (void)textureUnit;
-                        }			
-		};
-
-    protected:
-        /// Keyword-mapped attribute parsers.
-        typedef map<String, ATTRIBUTE_PARSER>::type AttribParserList;
-
-        MaterialScriptContext mScriptContext;
-
-        /** internal method for parsing a material
-        @return true if it expects the next line to be a {
-        */
-        bool parseScriptLine(String& line);
-        /** internal method for finding & invoking an attribute parser. */
-        bool invokeParser(String& line, AttribParserList& parsers);
-		/** Internal method for saving a program definition which has been
-		    built up.
-		*/
-		void finishProgramDefinition(void);
-        /// Parsers for the root of the material script
-        AttribParserList mRootAttribParsers;
-        /// Parsers for the material section of a script
-        AttribParserList mMaterialAttribParsers;
-        /// Parsers for the technique section of a script
-        AttribParserList mTechniqueAttribParsers;
-        /// Parsers for the pass section of a script
-        AttribParserList mPassAttribParsers;
-        /// Parsers for the texture unit section of a script
-        AttribParserList mTextureUnitAttribParsers;
-        /// Parsers for the program reference section of a script
-        AttribParserList mProgramRefAttribParsers;
-        /// Parsers for the program definition section of a script
-        AttribParserList mProgramAttribParsers;
-        /// Parsers for the program definition section of a script
-        AttribParserList mProgramDefaultParamAttribParsers;
-
-		/// Listeners list of this Serializer.
-		typedef vector<Listener*>::type			ListenerList;
-		typedef ListenerList::iterator			ListenerListIterator;
-		typedef ListenerList::const_iterator	ListenerListConstIterator;
-		ListenerList mListeners;
-
-
-        void writeMaterial(const MaterialPtr& pMat, const String& materialName = "");
-        void writeTechnique(const Technique* pTech);
-        void writePass(const Pass* pPass);
-        void writeVertexProgramRef(const Pass* pPass);
-        void writeShadowCasterVertexProgramRef(const Pass* pPass);
-        void writeShadowCasterFragmentProgramRef(const Pass* pPass);
-        void writeShadowReceiverVertexProgramRef(const Pass* pPass);
-        void writeShadowReceiverFragmentProgramRef(const Pass* pPass);
-        void writeFragmentProgramRef(const Pass* pPass);
-        void writeGpuProgramRef(const String& attrib, const GpuProgramPtr& program, const GpuProgramParametersSharedPtr& params);
-        void writeGpuPrograms(void);
-        void writeGPUProgramParameters(const GpuProgramParametersSharedPtr& params, GpuProgramParameters* defaultParams,
-            const unsigned short level = 4, const bool useMainBuffer = true);
-		void writeNamedGpuProgramParameters(const GpuProgramParametersSharedPtr& params, GpuProgramParameters* defaultParams,
-			const unsigned short level = 4, const bool useMainBuffer = true);
-		void writeLowLevelGpuProgramParameters(const GpuProgramParametersSharedPtr& params, GpuProgramParameters* defaultParams,
-			const unsigned short level = 4, const bool useMainBuffer = true);
-		void writeGpuProgramParameter(
-			const String& commandName, const String& identifier, 
-			const GpuProgramParameters::AutoConstantEntry* autoEntry, 
-			const GpuProgramParameters::AutoConstantEntry* defaultAutoEntry, 
-			bool isFloat, size_t physicalIndex, size_t physicalSize,
-			const GpuProgramParametersSharedPtr& params, GpuProgramParameters* defaultParams,
-			const unsigned short level, const bool useMainBuffer);
-		void writeTextureUnit(const TextureUnitState *pTex);
-		void writeSceneBlendFactor(const SceneBlendFactor c_src, const SceneBlendFactor c_dest, 
-			const SceneBlendFactor a_src, const SceneBlendFactor a_dest);
-		void writeSceneBlendFactor(const SceneBlendFactor sbf_src, const SceneBlendFactor sbf_dest);
-		void writeSceneBlendFactor(const SceneBlendFactor sbf);
-		void writeCompareFunction(const CompareFunction cf);
-		void writeColourValue(const ColourValue &colour, bool writeAlpha = false);
-		void writeLayerBlendOperationEx(const LayerBlendOperationEx op);
-		void writeLayerBlendSource(const LayerBlendSource lbs);
-		
-		typedef multimap<TextureUnitState::TextureEffectType, TextureUnitState::TextureEffect>::type EffectMap;
-
-		void writeRotationEffect(const TextureUnitState::TextureEffect& effect, const TextureUnitState *pTex);
-		void writeTransformEffect(const TextureUnitState::TextureEffect& effect, const TextureUnitState *pTex);
-		void writeScrollEffect(const TextureUnitState::TextureEffect& effect, const TextureUnitState *pTex);
-		void writeEnvironmentMapEffect(const TextureUnitState::TextureEffect& effect, const TextureUnitState *pTex);
-
-        String convertFiltering(FilterOptions fo);
-
-		
-		/** Internal methods that invokes registered listeners callback.
-		@see Listener::materialEventRaised.
-		*/
-		void fireMaterialEvent(SerializeEvent event, bool& skip, const Material* mat);
-
-		/** Internal methods that invokes registered listeners callback.
-		@see Listener::techniqueEventRaised.
-		*/
-		void fireTechniqueEvent(SerializeEvent event, bool& skip, const Technique* tech);
-		
-		/** Internal methods that invokes registered listeners callback.
-		@see Listener::passEventRaised.
-		*/
-		void firePassEvent(SerializeEvent event, bool& skip, const Pass* pass);
-		
-		/** Internal methods that invokes registered listeners callback.
-		@see Listener::gpuProgramRefEventRaised.
-		*/
-		void fireGpuProgramRefEvent(SerializeEvent event, bool& skip,
-			const String& attrib, 
-			const GpuProgramPtr& program, 
-			const GpuProgramParametersSharedPtr& params,
-			GpuProgramParameters* defaultParams);
-	
-
-		/** Internal methods that invokes registered listeners callback.
-		@see Listener::textureUnitStateEventRaised.
-		*/
-		void fireTextureUnitStateEvent(SerializeEvent event, bool& skip, const TextureUnitState* textureUnit);
-		
-   public:		
-		/** default constructor*/
-		MaterialSerializer();
-		/** default destructor*/
-		virtual ~MaterialSerializer() {}
-
-		/** Queue an in-memory Material to the internal buffer for export.
-		@param pMat Material pointer
-		@param clearQueued If true, any materials already queued will be removed
-		@param exportDefaults If true, attributes which are defaulted will be
-			included in the script exported, otherwise they will be omitted
-		@param materialName Allow exporting the given material under a different name.
-			In case of empty string the original material name will be used.
-		*/
-        void queueForExport(const MaterialPtr& pMat, bool clearQueued = false, 
-			bool exportDefaults = false, const String& materialName = "");
-        /** Exports queued material(s) to a named material script file.
-        @param filename the file name of the material script to be exported
-		@param includeProgDef If true, vertex program and fragment program 
-			definitions will be written at the top of the material script
-        @param programFilename the file name of the vertex / fragment program 
-			script to be exported. This is only used if there are program definitions
-            to be exported and includeProgDef is false 
-			when calling queueForExport.
-        */
-		void exportQueued(const String& filename, const bool includeProgDef = false, const String& programFilename = "");
-        /** Exports a single in-memory Material to the named material script file.
-        @param exportDefaults if true then exports all values including defaults
-        @param includeProgDef if true includes Gpu shader program definitions in the
-            export material script otherwise if false then program definitions will
-            be exported to a separate file with name programFilename if
-            programFilename is not empty
-        @param programFilename the file name of the vertex / fragment program 
-			script to be exported. This is only used if includeProgDef is false.
-		@param materialName Allow exporting the given material under a different name.
-			In case of empty string the original material name will be used.
-        */
-        void exportMaterial(const MaterialPtr& pMat, const String& filename, bool exportDefaults = false,
-            const bool includeProgDef = false, const String& programFilename = "", 
-			const String& materialName = "");
-		/** Returns a string representing the parsed material(s) */
-		const String &getQueuedAsString() const;
-		/** Clears the internal buffer */
-		void clearQueue();
-
-        /** Parses a Material script file passed as a stream.
-        */
-        void parseScript(DataStreamPtr& stream, const String& groupName);
-
-		/** Register a listener to this Serializer.
-		@see MaterialSerializer::Listener
-		*/
-		void addListener(Listener* listener);
-
-		/** Remove a listener from this Serializer.
-		@see MaterialSerializer::Listener
-		*/
-		void removeListener(Listener* listener);
-
-	private:
-		String mBuffer;
-        String mGpuProgramBuffer;
-        typedef set<String>::type GpuProgramDefinitionContainer;
-        typedef GpuProgramDefinitionContainer::iterator GpuProgramDefIterator;
-        GpuProgramDefinitionContainer mGpuProgramDefinitionContainer;
-		bool mDefaults;
-		
-	public:
-        void beginSection(unsigned short level, const bool useMainBuffer = true)
-		{
-            String& buffer = (useMainBuffer ? mBuffer : mGpuProgramBuffer);
-			buffer += "\n";
-            for (unsigned short i = 0; i < level; ++i)
-            {
-                buffer += "\t";
-            }
-            buffer += "{";
-		}
-		void endSection(unsigned short level, const bool useMainBuffer = true)
-		{
-            String& buffer = (useMainBuffer ? mBuffer : mGpuProgramBuffer);
-			buffer += "\n";
-            for (unsigned short i = 0; i < level; ++i)
-            {
-                buffer += "\t";
-            }
-            buffer += "}";
-		}
-
-		void writeAttribute(unsigned short level, const String& att, const bool useMainBuffer = true)
-		{
-            String& buffer = (useMainBuffer ? mBuffer : mGpuProgramBuffer);
-			buffer += "\n";
-            for (unsigned short i = 0; i < level; ++i)
-            {
-                buffer += "\t";
-            }
-            buffer += att;
-		}
-
-		void writeValue(const String& val, const bool useMainBuffer = true)
-		{
-            String& buffer = (useMainBuffer ? mBuffer : mGpuProgramBuffer);
-			buffer += (" " + val);
-		}
-
-		String quoteWord(const String& val)
-		{
-			if (val.find_first_of(" \t") != String::npos)
-				return ("\"" + val + "\"");
-			else return val;
-		}
-
-
-		void writeComment(unsigned short level, const String& comment, const bool useMainBuffer = true)
-		{
-            String& buffer = (useMainBuffer ? mBuffer : mGpuProgramBuffer);
-			buffer += "\n";
-            for (unsigned short i = 0; i < level; ++i)
-            {
-                buffer += "\t";
-            }
-            buffer += "// " + comment;
-		}
-
-
-
-    };
-	/** @} */
-	/** @} */
-}
-#endif