ruby-ogre 0.0.1-x86-linux

data/deps/include/OGRE/Plugins/ParticleFX/OgreDeflectorPlaneAffectorFactory.h

@@ -0,0 +1,56 @@
+/*
+-----------------------------------------------------------------------------
+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 __DeflectorPlaneAffectorFactory_H__
+#define __DeflectorPlaneAffectorFactory_H__
+
+#include "OgreParticleFXPrerequisites.h"
+#include "OgreParticleAffectorFactory.h"
+#include "OgreDeflectorPlaneAffector.h"
+
+namespace Ogre {
+
+    /** Factory class for DeflectorPlaneAffector. */
+    class _OgreParticleFXExport DeflectorPlaneAffectorFactory : public ParticleAffectorFactory
+    {
+        /** See ParticleAffectorFactory */
+        String getName() const { return "DeflectorPlane"; }
+
+        /** See ParticleAffectorFactory */
+        ParticleAffector* createAffector(ParticleSystem* psys)
+        {
+            ParticleAffector* p = OGRE_NEW DeflectorPlaneAffector(psys);
+            mAffectors.push_back(p);
+            return p;
+        }
+    };
+
+
+}
+
+#endif
+

data/deps/include/OGRE/Plugins/ParticleFX/OgreDirectionRandomiserAffector.h

@@ -0,0 +1,109 @@
+/*
+-----------------------------------------------------------------------------
+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 __DirectionRandomiserAffector_H__
+#define __DirectionRandomiserAffector_H__
+
+#include "OgreParticleFXPrerequisites.h"
+#include "OgreParticleAffector.h"
+#include "OgreVector3.h"
+
+
+namespace Ogre {
+
+    /** This class defines a ParticleAffector which applies randomness to the movement of the particles.
+    @remarks
+        This affector (see ParticleAffector) applies randomness to the movement of the particles by
+		changing the direction vectors.
+    @par
+        The most important parameter to control the effect is randomness. It controls the range in which changes
+        are applied to each axis of the direction vector.
+		The parameter scope can be used to limit the effect to a certain percentage of the particles.
+    */
+    class _OgreParticleFXExport DirectionRandomiserAffector : public ParticleAffector
+    {
+    public:
+        /** Command object for randomness (see ParamCommand).*/
+        class CmdRandomness : public ParamCommand
+        {
+        public:
+            String doGet(const void* target) const;
+            void doSet(void* target, const String& val);
+        };
+
+		/** Command object for scope (see ParamCommand).*/
+        class CmdScope : public ParamCommand
+        {
+        public:
+            String doGet(const void* target) const;
+            void doSet(void* target, const String& val);
+        };
+
+		/** Command object for keep_velocity (see ParamCommand).*/
+        class CmdKeepVelocity : public ParamCommand
+        {
+        public:
+            String doGet(const void* target) const;
+            void doSet(void* target, const String& val);
+        };
+
+        /// Default constructor
+        DirectionRandomiserAffector(ParticleSystem* psys);
+
+        /** See ParticleAffector. */
+        void _affectParticles(ParticleSystem* pSystem, Real timeElapsed);
+
+
+        /** Sets the randomness to apply to the particles in a system. */
+        void setRandomness(Real force);
+		/** Sets the scope (percentage of particles which are randomised). */
+        void setScope(Real force);
+		/** Set flag which detemines whether particle speed is changed. */
+        void setKeepVelocity(bool keepVelocity);
+
+        /** Gets the randomness to apply to the particles in a system. */
+        Real getRandomness(void) const;
+		/** Gets the scope (percentage of particles which are randomised). */
+        Real getScope(void) const;
+		/** Gets flag which detemines whether particle speed is changed. */
+        bool getKeepVelocity(void) const;
+
+        /// Command objects
+        static CmdRandomness msRandomnessCmd;
+		static CmdScope msScopeCmd;
+		static CmdKeepVelocity msKeepVelocityCmd;
+
+    protected:
+        Real mRandomness;
+		Real mScope;
+		bool mKeepVelocity;
+
+    };
+
+}
+
+#endif

data/deps/include/OGRE/Plugins/ParticleFX/OgreDirectionRandomiserAffectorFactory.h

@@ -0,0 +1,54 @@
+/*
+-----------------------------------------------------------------------------
+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 __DirectionRandomiserAffectorFactory_H__
+#define __DirectionRandomiserAffectorFactory_H__
+
+#include "OgreParticleFXPrerequisites.h"
+#include "OgreParticleAffectorFactory.h"
+#include "OgreDirectionRandomiserAffector.h"
+
+namespace Ogre {
+
+    /** Factory class for DirectionRandomiserAffector. */
+    class _OgreParticleFXExport DirectionRandomiserAffectorFactory : public ParticleAffectorFactory
+    {
+        /** See ParticleAffectorFactory */
+        String getName() const { return "DirectionRandomiser"; }
+
+        /** See ParticleAffectorFactory */
+        ParticleAffector* createAffector(ParticleSystem* psys)
+        {
+            ParticleAffector* p = OGRE_NEW DirectionRandomiserAffector(psys);
+            mAffectors.push_back(p);
+            return p;
+        }
+    };
+
+}
+
+#endif

data/deps/include/OGRE/Plugins/ParticleFX/OgreEllipsoidEmitter.h

@@ -0,0 +1,64 @@
+/*
+-----------------------------------------------------------------------------
+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.
+-----------------------------------------------------------------------------
+*/
+// Original author: Tels <http://bloodgate.com>, released as public domain
+#ifndef __EllipsoidEmitter_H__
+#define __EllipsoidEmitter_H__
+
+#include "OgreParticleFXPrerequisites.h"
+#include "OgreAreaEmitter.h"
+
+namespace Ogre {
+
+    /** Particle emitter which emits particles randomly from points inside an ellipsoid.
+    @remarks
+        This basic particle emitter emits particles from a ellipsoid area.
+        The initial direction of these particles can either be a single
+        direction (i.e. a line), a random scattering inside a cone, or a random
+        scattering in all directions, depending the 'angle' parameter, which
+        is the angle across which to scatter the particles either side of the
+        base direction of the emitter. 
+    */
+    class _OgreParticleFXExport EllipsoidEmitter : public AreaEmitter
+    {
+    public:
+        // See AreaEmitter
+
+        EllipsoidEmitter(ParticleSystem* psys);
+
+        /** See ParticleEmitter. */
+        void _initParticle(Particle* pParticle);
+
+    protected:
+        
+
+    };
+
+}
+
+#endif
+

data/deps/include/OGRE/Plugins/ParticleFX/OgreEllipsoidEmitterFactory.h

@@ -0,0 +1,67 @@
+/*
+-----------------------------------------------------------------------------
+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.
+-----------------------------------------------------------------------------
+*/
+// Original author: Tels <http://bloodgate.com>, released as public domain
+#ifndef __EllipsoidEmitterFactory_H__
+#define __EllipsoidEmitterFactory_H__
+
+#include "OgreParticleFXPrerequisites.h"
+#include "OgreParticleEmitterFactory.h"
+#include "OgreEllipsoidEmitter.h"
+
+
+namespace Ogre {
+
+    /** Factory class for particle emitter of type "Ellipsoid".
+    @remarks
+        Creates instances of EllipsoidEmitter to be used in particle systems. 
+    */
+    class _OgreParticleFXExport EllipsoidEmitterFactory : public ParticleEmitterFactory
+    {
+    protected:
+
+    public:
+        /** See ParticleEmitterFactory */
+        String getName() const
+        { 
+            return "Ellipsoid"; 
+        }
+
+        /** See ParticleEmitterFactory */
+        ParticleEmitter* createEmitter(ParticleSystem* psys) 
+        {
+            ParticleEmitter* emit = OGRE_NEW EllipsoidEmitter(psys);
+            mEmitters.push_back(emit);
+            return emit;
+        }
+
+    };
+
+}
+
+#endif
+

data/deps/include/OGRE/Plugins/ParticleFX/OgreHollowEllipsoidEmitter.h

@@ -0,0 +1,126 @@
+/*
+-----------------------------------------------------------------------------
+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.
+-----------------------------------------------------------------------------
+*/
+// Original author: Tels <http://bloodgate.com>, released as public domain
+#ifndef __HollowEllipsoidEmitter_H__
+#define __HollowEllipsoidEmitter_H__
+
+#include "OgreParticleFXPrerequisites.h"
+#include "OgreEllipsoidEmitter.h"
+
+namespace Ogre {
+
+    /** Particle emitter which emits particles randomly from points inside a hollow ellipsoid.
+    @remarks
+        This particle emitter emits particles from a hollow ellipsoid area.
+        The initial direction of these particles can either be a single
+        direction (i.e. a line), a random scattering inside a cone, or a random
+        scattering in all directions, depending the 'angle' parameter, which
+        is the angle across which to scatter the particles either side of the
+        base direction of the emitter. 
+    */
+    class _OgreParticleFXExport HollowEllipsoidEmitter : public EllipsoidEmitter
+    {
+    public:
+        /** Command object for inner size (see ParamCommand).*/
+        class CmdInnerX : public ParamCommand
+        {
+        public:
+            String doGet(const void* target) const;
+            void doSet(void* target, const String& val);
+        };
+        /** Command object for inner size (see ParamCommand).*/
+        class CmdInnerY : public ParamCommand
+        {
+        public:
+            String doGet(const void* target) const;
+            void doSet(void* target, const String& val);
+        };
+        /** Command object for inner size (see ParamCommand).*/
+        class CmdInnerZ : public ParamCommand
+        {
+        public:
+            String doGet(const void* target) const;
+            void doSet(void* target, const String& val);
+        };
+        // See AreaEmitter
+
+        HollowEllipsoidEmitter(ParticleSystem* psys);
+
+        /** See ParticleEmitter. */
+        void _initParticle(Particle* pParticle);
+
+        /** Sets the size of the clear space inside the area from where NO particles are emitted.
+        @param x,y,z
+            Parametric values describing the proportion of the shape which is hollow in each direction.
+            E.g. 0 is solid, 0.5 is half-hollow etc
+        */
+        void setInnerSize(Real x, Real y, Real z);
+
+        /** Sets the x component of the area inside the ellipsoid which doesn't emit particles. 
+        @param x
+            Parametric value describing the proportion of the shape which is hollow in this direction.
+            E.g. 0 is solid, 0.5 is half-hollow etc
+        */
+        void setInnerSizeX(Real x);
+        /** Sets the y component of the area inside the ellipsoid which doesn't emit particles. 
+        @param y
+            Parametric value describing the proportion of the shape which is hollow in this direction.
+            E.g. 0 is solid, 0.5 is half-hollow etc
+        */
+        void setInnerSizeY(Real y);
+        /** Sets the z component of the area inside the ellipsoid which doesn't emit particles. 
+        @param z
+            Parametric value describing the proportion of the shape which is hollow in this direction.
+            E.g. 0 is solid, 0.5 is half-hollow etc
+        */
+        void setInnerSizeZ(Real z);
+        /** Gets the x component of the area inside the ellipsoid which doesn't emit particles. */
+        Real getInnerSizeX(void) const;
+        /** Gets the y component of the area inside the ellipsoid which doesn't emit particles. */
+        Real getInnerSizeY(void) const;
+        /** Gets the z component of the area inside the ellipsoid which doesn't emit particles. */
+        Real getInnerSizeZ(void) const;
+
+    protected:
+        // See ParticleEmitter
+
+        /// Size of 'clear' center area (> 0 and < 1.0)
+        Vector3 mInnerSize;
+
+        static CmdInnerX msCmdInnerX;
+        static CmdInnerY msCmdInnerY;
+        static CmdInnerZ msCmdInnerZ;
+
+
+
+    };
+
+}
+
+#endif
+

data/deps/include/OGRE/Plugins/ParticleFX/OgreHollowEllipsoidEmitterFactory.h

@@ -0,0 +1,67 @@
+/*
+-----------------------------------------------------------------------------
+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.
+-----------------------------------------------------------------------------
+*/
+// Original author: Tels <http://bloodgate.com>, released as public domain
+#ifndef __HollowEllipsoidEmitterFactory_H__
+#define __HollowEllipsoidEmitterFactory_H__
+
+#include "OgreParticleFXPrerequisites.h"
+#include "OgreParticleEmitterFactory.h"
+#include "OgreHollowEllipsoidEmitter.h"
+
+
+namespace Ogre {
+
+    /** Factory class for particle emitter of type "HollowEllipsoid".
+    @remarks
+        Creates instances of HollowEllipsoidEmitter to be used in particle systems. 
+    */
+    class _OgreParticleFXExport HollowEllipsoidEmitterFactory : public ParticleEmitterFactory
+    {
+    protected:
+
+    public:
+        /** See ParticleEmitterFactory */
+        String getName() const
+        { 
+            return "HollowEllipsoid"; 
+        }
+
+        /** See ParticleEmitterFactory */
+        ParticleEmitter* createEmitter(ParticleSystem* psys) 
+        {
+            ParticleEmitter* emit = OGRE_NEW HollowEllipsoidEmitter(psys);
+            mEmitters.push_back(emit);
+            return emit;
+        }
+
+    };
+
+}
+
+#endif
+

data/deps/include/OGRE/Plugins/ParticleFX/OgreLinearForceAffector.h

@@ -0,0 +1,120 @@
+/*
+-----------------------------------------------------------------------------
+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 __LinearForceAffector_H__
+#define __LinearForceAffector_H__
+
+#include "OgreParticleFXPrerequisites.h"
+#include "OgreParticleAffector.h"
+#include "OgreVector3.h"
+
+
+namespace Ogre {
+
+    /** This class defines a ParticleAffector which applies a linear force to particles in a system.
+    @remarks
+        This affector (see ParticleAffector) applies a linear force, such as gravity, to a particle system.
+        This force can be applied in 2 ways: by taking the average of the particle's current momentum and the 
+        force vector, or by adding the force vector to the current particle's momentum. 
+    @par
+        The former approach is self-stabilising i.e. once a particle's momentum
+        is equal to the force vector, no further change is made to it's momentum. It also results in
+        a non-linear acceleration of particles.
+        The latter approach is simpler and applies a constant acceleration to particles. However,
+        it is not self-stabilising and can lead to perpetually increasing particle velocities. 
+        You choose the approach by calling the setForceApplication method.
+    */
+    class _OgreParticleFXExport LinearForceAffector : public ParticleAffector
+    {
+    public:
+        /** Command object for force vector (see ParamCommand).*/
+        class CmdForceVector : public ParamCommand
+        {
+        public:
+            String doGet(const void* target) const;
+            void doSet(void* target, const String& val);
+        };
+
+        /** Command object for force application (see ParamCommand).*/
+        class CmdForceApp : public ParamCommand
+        {
+        public:
+            String doGet(const void* target) const;
+            void doSet(void* target, const String& val);
+        };
+        /// Choice of how to apply the force vector to particles
+        enum ForceApplication
+        {
+            /// Take the average of the force vector and the particle momentum
+            FA_AVERAGE,
+            /// Add the force vector to the particle momentum
+            FA_ADD
+        };
+        /// Default constructor
+        LinearForceAffector(ParticleSystem* psys);
+
+        /** See ParticleAffector. */
+        void _affectParticles(ParticleSystem* pSystem, Real timeElapsed);
+
+
+        /** Sets the force vector to apply to the particles in a system. */
+        void setForceVector(const Vector3& force);
+
+        /** Gets the force vector to apply to the particles in a system. */
+        Vector3 getForceVector(void) const;
+
+        /** Sets how the force vector is applied to a particle. 
+        @remarks
+          The default is FA_ADD.
+        @param fa A member of the ForceApplication enum.
+        */
+        void setForceApplication(ForceApplication fa);
+
+        /** Retrieves how the force vector is applied to a particle. 
+        @param fa A member of the ForceApplication enum.
+        */
+        ForceApplication getForceApplication(void) const;
+
+        /// Command objects
+        static CmdForceVector msForceVectorCmd;
+        static CmdForceApp msForceAppCmd;
+
+    protected:
+        /// Force vector
+        Vector3 mForceVector;
+
+        /// How to apply force
+        ForceApplication mForceApplication;
+
+    };
+
+
+}
+
+
+#endif
+