ruby-ogre 0.0.1-x86-linux

data/deps/include/OGRE/OgreCompositorManager.h

@@ -0,0 +1,291 @@
+/*
+-----------------------------------------------------------------------------
+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 __CompositorManager_H__
+#define __CompositorManager_H__
+
+#include "OgrePrerequisites.h"
+#include "OgreResourceManager.h"
+#include "OgreCompositor.h"
+#include "OgreRectangle2D.h"
+#include "OgreRenderSystem.h"
+#include "OgreCompositionTechnique.h"
+
+namespace Ogre {
+	/** \addtogroup Core
+	*  @{
+	*/
+	/** \addtogroup Effects
+	*  @{
+	*/
+	/** Class for managing Compositor settings for Ogre. Compositors provide the means
+        to flexibly "composite" the final rendering result from multiple scene renders
+        and intermediate operations like rendering fullscreen quads. This makes
+        it possible to apply postfilter effects, HDRI postprocessing, and shadow
+        effects to a Viewport.
+        @par
+            When loaded from a script, a Compositor 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.
+    */
+    class _OgreExport CompositorManager : public ResourceManager, public Singleton<CompositorManager>
+    {
+    public:
+        CompositorManager();
+        virtual ~CompositorManager();
+
+        /// Overridden from ResourceManager
+        Resource* createImpl(const String& name, ResourceHandle handle,
+            const String& group, bool isManual, ManualResourceLoader* loader,
+            const NameValuePairList* params);
+
+        /** Initialises the Compositor manager, which also triggers it to
+            parse all available .compositor scripts. */
+        void initialise(void);
+
+        /** @see ScriptLoader::parseScript
+        */
+        void parseScript(DataStreamPtr& stream, const String& groupName);
+
+        /** Get the compositor chain for a Viewport. If there is none yet, a new
+			compositor chain is registered.
+			XXX We need a _notifyViewportRemoved to find out when this viewport disappears,
+			so we can destroy its chain as well.
+        */
+        CompositorChain *getCompositorChain(Viewport *vp);
+
+		/** Returns whether exists compositor chain for a viewport.
+        */
+		bool hasCompositorChain(Viewport *vp) const;
+
+		/** Remove the compositor chain from a viewport if exists.
+		*/
+        void removeCompositorChain(Viewport *vp);
+
+		/** Add a compositor to a viewport. By default, it is added to end of the chain,
+			after the other compositors.
+			@param vp			Viewport to modify
+			@param compositor	The name of the compositor to apply
+			@param addPosition	At which position to add, defaults to the end (-1).
+			@return pointer to instance, or 0 if it failed.
+		*/
+		CompositorInstance *addCompositor(Viewport *vp, const String &compositor, int addPosition=-1);
+
+		/** Remove a compositor from a viewport
+		*/
+		void removeCompositor(Viewport *vp, const String &compositor);
+
+		/** Set the state of a compositor on a viewport to enabled or disabled.
+			Disabling a compositor stops it from rendering but does not free any resources.
+			This can be more efficient than using removeCompositor and addCompositor in cases
+			the filter is switched on and off a lot.
+		*/
+		void setCompositorEnabled(Viewport *vp, const String &compositor, bool value);
+
+		/** Get a textured fullscreen 2D rectangle, for internal use.
+		*/
+		Renderable *_getTexturedRectangle2D();
+
+		/** Overridden from ResourceManager since we have to clean up chains too. */
+		void removeAll(void);
+
+		/** Internal method for forcing all active compositors to recreate their resources. */
+		void _reconstructAllCompositorResources();
+
+		typedef set<Texture*>::type UniqueTextureSet;
+
+		/** Utility function to get an existing pooled texture matching a given
+			definition, or creating one if one doesn't exist. It also takes into
+			account whether a pooled texture has already been supplied to this
+			same requester already, in which case it won't give the same texture
+			twice (this is important for example if you request 2 ping-pong textures, 
+			you don't want to get the same texture for both requests!
+		*/
+		TexturePtr getPooledTexture(const String& name, const String& localName, 
+			size_t w, size_t h, 
+			PixelFormat f, uint aa, const String& aaHint, bool srgb, UniqueTextureSet& texturesAlreadyAssigned, 
+			CompositorInstance* inst, CompositionTechnique::TextureScope scope);
+
+		/** Free pooled textures from the shared pool (compositor instances still 
+			using them will keep them in memory though). 
+		*/
+		void freePooledTextures(bool onlyIfUnreferenced = true);
+
+		/** Register a compositor logic for listening in to expecting composition
+			techniques.
+		*/
+		void registerCompositorLogic(const String& name, CompositorLogic* logic);
+
+		/** Removes a listener for compositor logic registered with registerCompositorLogic
+		*/
+		void unregisterCompositorLogic(const String& name);
+		
+		/** Get a compositor logic by its name
+		*/
+		CompositorLogic* getCompositorLogic(const String& name);
+
+		/** Register a custom composition pass.
+		*/
+		void registerCustomCompositionPass(const String& name, CustomCompositionPass* customPass);
+		
+		/** Get a custom composition pass by its name 
+		*/
+		CustomCompositionPass* getCustomCompositionPass(const String& name);
+
+		/** 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 CompositorManager& 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 CompositorManager* getSingletonPtr(void);
+
+	
+	private:
+        typedef map<Viewport*, CompositorChain*>::type Chains;
+        Chains mChains;
+
+        /** Clear composition chains for all viewports
+         */
+        void freeChains();
+
+		Rectangle2D *mRectangle;
+
+		/// List of instances
+		typedef vector<CompositorInstance *>::type Instances;
+		Instances mInstances;
+
+		/// Map of registered compositor logics
+		typedef map<String, CompositorLogic*>::type CompositorLogicMap;
+		CompositorLogicMap mCompositorLogics;
+
+		/// Map of registered custom composition passes
+		typedef map<String, CustomCompositionPass*>::type CustomCompositionPassMap;
+		CustomCompositionPassMap mCustomCompositionPasses;
+
+		typedef vector<TexturePtr>::type TextureList;
+		typedef VectorIterator<TextureList> TextureIterator;
+
+		struct TextureDef
+		{
+			size_t width, height;
+			PixelFormat format;
+			uint fsaa;
+			String fsaaHint;
+			bool sRGBwrite;
+
+			TextureDef(size_t w, size_t h, PixelFormat f, uint aa, const String& aaHint, bool srgb)
+				: width(w), height(h), format(f), fsaa(aa), fsaaHint(aaHint), sRGBwrite(srgb)
+			{
+
+			}
+		};
+		struct TextureDefLess
+		{
+			bool _OgreExport operator()(const TextureDef& x, const TextureDef& y) const
+			{
+				if (x.format < y.format)
+					return true;
+				else if (x.format == y.format)
+				{
+					if (x.width < y.width)
+						return true;
+					else if (x.width == y.width)
+					{
+						if (x.height < y.height)
+							return true;
+						else if (x.height == y.height)
+						{
+							if (x.fsaa < y.fsaa)
+								return true;
+							else if (x.fsaa == y.fsaa)
+							{
+								if (x.fsaaHint < y.fsaaHint)
+									return true;
+								else if (x.fsaaHint == y.fsaaHint)
+								{
+									if (!x.sRGBwrite && y.sRGBwrite)
+										return true;
+								}
+
+							}
+						}
+					}
+				}
+				return false;
+			}
+			virtual ~TextureDefLess() {}
+		};
+		typedef map<TextureDef, TextureList*, TextureDefLess>::type TexturesByDef;
+		TexturesByDef mTexturesByDef;
+
+		typedef std::pair<String, String> StringPair;
+		typedef map<TextureDef, TexturePtr, TextureDefLess>::type TextureDefMap;
+		typedef std::map<StringPair, TextureDefMap> ChainTexturesByDef;
+		
+		ChainTexturesByDef mChainTexturesByDef;
+
+		bool isInputPreviousTarget(CompositorInstance* inst, const Ogre::String& localName);
+		bool isInputPreviousTarget(CompositorInstance* inst, TexturePtr tex);
+		bool isInputToOutputTarget(CompositorInstance* inst, const Ogre::String& localName);
+		bool isInputToOutputTarget(CompositorInstance* inst, TexturePtr tex);
+
+    };
+	/** @} */
+	/** @} */
+
+}
+
+#endif

data/deps/include/OGRE/OgreConfig.h

@@ -0,0 +1,189 @@
+/*
+-----------------------------------------------------------------------------
+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 __Config_H_
+#define __Config_H_
+
+// Include the CMake-generated build settings.
+// If you get complaints that this file is missing, then you're probably
+// trying to link directly against your source dir. You must then add
+// %BUILD_DIR%/include to your include search path to find OgreBuildSettings.h.
+#include "OgreBuildSettings.h"
+
+/** If set to 1, profiling code will be included in the application. When you
+	are deploying your application you will probably want to set this to 0 */
+#ifndef OGRE_PROFILING
+#define OGRE_PROFILING 0
+#endif
+
+/** There are three modes for handling asserts in OGRE:
+0 - STANDARD - Standard asserts in debug builds, nothing in release builds
+1 - RELEASE_EXCEPTIONS - Standard asserts in debug builds, exceptions in release builds
+2 - EXCEPTIONS - Exceptions in debug builds, exceptions in release builds
+*/
+#define OGRE_ASSERT_MODE 0
+
+/** If set to >0, OGRE will always 'think' that the graphics card only has the
+    number of texture units specified. Very useful for testing multipass fallback.
+*/
+#define OGRE_PRETEND_TEXTURE_UNITS 0
+
+/** If set to 1, Real is typedef'ed to double. Otherwise, Real is typedef'ed
+    to float. Setting this allows you to perform mathematical operations in the
+	CPU (Quaternion, Vector3 etc) with more precision, but bear in mind that the
+	GPU still operates in single-precision mode.
+*/
+#ifndef OGRE_DOUBLE_PRECISION
+#define OGRE_DOUBLE_PRECISION 0
+#endif
+
+/** Define number of texture coordinate sets allowed per vertex.
+*/
+#define OGRE_MAX_TEXTURE_COORD_SETS 8
+
+/** Define max number of texture layers allowed per pass on any card.
+*/
+#define OGRE_MAX_TEXTURE_LAYERS 16
+
+/** Define max number of lights allowed per pass.
+*/
+#define OGRE_MAX_SIMULTANEOUS_LIGHTS 8
+
+/** Define max number of blending weights allowed per vertex.
+*/
+#define OGRE_MAX_BLEND_WEIGHTS 4
+
+/** Define this if you want to link OGRE as a static lib (preferably as a project file)
+*/
+//#define OGRE_STATIC_LIB
+
+
+// define the memory allocator configuration to use
+#define OGRE_MEMORY_ALLOCATOR_STD 1
+#define OGRE_MEMORY_ALLOCATOR_NED 2
+#define OGRE_MEMORY_ALLOCATOR_USER 3
+#define OGRE_MEMORY_ALLOCATOR_NEDPOOLING 4
+
+#ifndef OGRE_MEMORY_ALLOCATOR
+#  define OGRE_MEMORY_ALLOCATOR OGRE_MEMORY_ALLOCATOR_NEDPOOLING
+#endif
+
+// Whether to use the custom memory allocator in STL containers
+#ifndef OGRE_CONTAINERS_USE_CUSTOM_MEMORY_ALLOCATOR
+#  define OGRE_CONTAINERS_USE_CUSTOM_MEMORY_ALLOCATOR 1
+#endif
+
+//if you want to make Ogre::String use the custom memory allocator then set:
+//#define OGRE_STRING_USE_CUSTOM_MEMORY_ALLOCATOR 1
+// Doing this will mean Ogre's strings will not be compatible with std::string however
+#ifndef OGRE_STRING_USE_CUSTOM_MEMORY_ALLOCATOR
+#	define OGRE_STRING_USE_CUSTOM_MEMORY_ALLOCATOR 0
+#endif
+
+// enable or disable the memory tracker, recording the memory allocations & tracking leaks
+// default is to disable since it's expensive, but you can enable if needed per build target
+
+#ifndef OGRE_MEMORY_TRACKER_DEBUG_MODE
+#  define OGRE_MEMORY_TRACKER_DEBUG_MODE 0
+#endif
+
+#ifndef OGRE_MEMORY_TRACKER_RELEASE_MODE
+#  define OGRE_MEMORY_TRACKER_RELEASE_MODE 0
+#endif
+/** Define max number of multiple render targets (MRTs) to render to at once.
+*/
+#define OGRE_MAX_MULTIPLE_RENDER_TARGETS 8
+
+/** Support for multithreading, there are 3 options
+
+OGRE_THREAD_SUPPORT = 0
+	No support for threading.		
+OGRE_THREAD_SUPPORT = 1
+	Thread support for background loading, by both loading and constructing resources
+	in a background thread. Resource management and SharedPtr handling becomes
+	thread-safe, and resources may be completely loaded in the background. 
+	The places where threading is available are clearly
+	marked, you should assume state is NOT thread safe unless otherwise
+	stated in relation to this flag.
+OGRE_THREAD_SUPPORT = 2
+	Thread support for background resource preparation. This means that resource
+	data can streamed into memory in the background, but the final resource
+	construction (including RenderSystem dependencies) is still done in the primary
+	thread. Has a lower synchronisation primitive overhead than full threading
+	while still allowing the major blocking aspects of resource management (I/O)
+	to be done in the background.
+*/
+#ifndef OGRE_THREAD_SUPPORT
+#define OGRE_THREAD_SUPPORT 0
+#endif
+#if OGRE_THREAD_SUPPORT != 0 && OGRE_THREAD_SUPPORT != 1 && OGRE_THREAD_SUPPORT != 2
+#define OGRE_THREAD_SUPPORT 0
+#endif
+
+/** Provider for threading functionality, there are 4 options.
+
+OGRE_THREAD_PROVIDER = 0
+	No support for threading.
+OGRE_THREAD_PROVIDER = 1
+	Boost libraries provide threading functionality.
+OGRE_THREAD_PROVIDER = 2
+	Poco libraries provide threading functionality.
+OGRE_THREAD_PROVIDER = 3
+	TBB library provides threading functionality.
+*/
+#ifndef OGRE_THREAD_PROVIDER
+#define OGRE_THREAD_PROVIDER 0
+#endif
+
+/** Disables use of the FreeImage image library for loading images.
+WARNING: Use only when you want to provide your own image loading code via codecs.
+*/
+#ifndef OGRE_NO_FREEIMAGE
+#define OGRE_NO_FREEIMAGE 0
+#endif
+
+/** Disables use of the internal image codec for loading DDS files.
+WARNING: Use only when you want to provide your own image loading code via codecs.
+*/
+#ifndef OGRE_NO_DDS_CODEC
+#define OGRE_NO_DDS_CODEC 0
+#endif
+
+/** Disables use of the ZIP archive support.
+WARNING: Disabling this will make the samples unusable.
+*/
+#ifndef OGRE_NO_ZIP_ARCHIVE
+#define OGRE_NO_ZIP_ARCHIVE 0
+#endif
+
+/** Enables the use of the new script compilers when Ogre compiles resource scripts.
+*/
+#ifndef OGRE_USE_NEW_COMPILERS
+#define OGRE_USE_NEW_COMPILERS 1
+#endif
+
+#endif

data/deps/include/OGRE/OgreConfigDialog.h

@@ -0,0 +1,57 @@
+/*
+-----------------------------------------------------------------------------
+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 __CommonConfigDialog_H__
+#define __CommonConfigDialog_H__
+
+#include "OgrePrerequisites.h"
+#include "OgrePlatform.h"
+
+// Bring in the specific platform's header file: first allow forced override
+#if defined OGRE_GUI_WIN32
+# include "WIN32/OgreConfigDialogImp.h"
+#elif defined OGRE_GUI_gtk
+# include "gtk/OgreConfigDialogImp.h"
+#elif defined OGRE_GUI_GLX
+# include "GLX/OgreConfigDialogImp.h"
+#elif OGRE_PLATFORM == OGRE_PLATFORM_WIN32
+# include "WIN32/OgreConfigDialogImp.h"
+#elif OGRE_PLATFORM == OGRE_PLATFORM_LINUX
+# include "GLX/OgreConfigDialogImp.h"
+#elif OGRE_PLATFORM == OGRE_PLATFORM_NACL
+# include "NaCl/OgreConfigDialogImp.h"
+#elif OGRE_PLATFORM == OGRE_PLATFORM_APPLE
+# include "OSX/OgreConfigDialogImp.h"
+#elif OGRE_PLATFORM == OGRE_PLATFORM_APPLE_IOS
+# include "iOS/OgreConfigDialogImp.h"
+#elif OGRE_PLATFORM == OGRE_PLATFORM_SYMBIAN
+# include "Symbian/OgreConfigDialogImp.h"
+#elif OGRE_PLATFORM == OGRE_PLATFORM_ANDROID
+# include "Android/OgreConfigDialogImp.h"
+#endif
+
+#endif

data/deps/include/OGRE/OgreConfigFile.h

@@ -0,0 +1,110 @@
+/*
+-----------------------------------------------------------------------------
+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 __ConfigFile_H__
+#define __ConfigFile_H__
+
+#include "OgrePrerequisites.h"
+
+#include "OgreString.h"
+#include "OgreStringVector.h"
+#include "OgreIteratorWrappers.h"
+#include "OgreDataStream.h"
+
+namespace Ogre {
+
+	/** \addtogroup Core
+	*  @{
+	*/
+	/** \addtogroup General
+	*  @{
+	*/
+	/** Class for quickly loading settings from a text file.
+        @remarks
+            This class is designed to quickly parse a simple file containing
+            key/value pairs, mainly for use in configuration settings.
+        @par
+            This is a very simplified approach, no multiple values per key
+            are allowed, no grouping or context is being kept etc.
+        @par
+            By default the key/values pairs are tokenised based on a
+            separator of Tab, the colon (:) or equals (=) character. Each
+            key - value pair must end in a carriage return.
+        @par
+            Settings can be optionally grouped in sections, using a header
+            beforehand of the form [SectionName]. 
+    */
+	class _OgreExport ConfigFile : public ConfigAlloc
+    {
+    public:
+
+        ConfigFile();
+        virtual ~ConfigFile();
+        /// load from a filename (not using resource group locations)
+        void load(const String& filename, const String& separators = "\t:=", bool trimWhitespace = true);
+        /// load from a filename (using resource group locations)
+        void load(const String& filename, const String& resourceGroup, const String& separators = "\t:=", bool trimWhitespace = true);
+        /// load from a data stream
+        void load(const DataStreamPtr& stream, const String& separators = "\t:=", bool trimWhitespace = true);
+		/// load from a filename (not using resource group locations)
+		void loadDirect(const String& filename, const String& separators = "\t:=", bool trimWhitespace = true);
+		/// load from a filename (using resource group locations)
+		void loadFromResourceSystem(const String& filename, const String& resourceGroup, const String& separators = "\t:=", bool trimWhitespace = true);
+
+        /** Gets the first setting from the file with the named key. 
+        @param key The name of the setting
+        @param section The name of the section it must be in (if any)
+		@param defaultValue The value to return if the setting is not found
+        */
+        String getSetting(const String& key, const String& section = StringUtil::BLANK, const String& defaultValue = StringUtil::BLANK) const;
+        /** Gets all settings from the file with the named key. */
+        StringVector getMultiSetting(const String& key, const String& section = StringUtil::BLANK) const;
+
+        typedef multimap<String, String>::type SettingsMultiMap;
+        typedef MapIterator<SettingsMultiMap> SettingsIterator;
+        /** Gets an iterator for stepping through all the keys / values in the file. */
+        typedef map<String, SettingsMultiMap*>::type SettingsBySection;
+        typedef MapIterator<SettingsBySection> SectionIterator;
+        /** Get an iterator over all the available sections in the config file */
+        SectionIterator getSectionIterator(void);
+        /** Get an iterator over all the available settings in a section */
+        SettingsIterator getSettingsIterator(const String& section = StringUtil::BLANK);
+
+
+        
+        /** Clear the settings */
+        void clear(void);
+    protected:
+        SettingsBySection mSettings;
+    };
+	/** @} */
+	/** @} */
+
+}
+
+
+#endif