OgreParticleSystem.h

Go to the documentation of this file.

/*
-----------------------------------------------------------------------------
This source file is part of OGRE 
    (Object-oriented Graphics Rendering Engine)
For the latest info, see http://www.ogre3d.org/

Copyright (c) 2000-2005 The OGRE Team
Also see acknowledgements in Readme.html

This program is free software; you can redistribute it and/or modify it under 
the terms of the GNU Lesser General Public License as published by the Free Software 
Foundation; either version 2 of the License, or (at your option) any later 
version.

This program is distributed in the hope that it will be useful, but WITHOUT 
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS 
FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with 
this program; if not, write to the Free Software Foundation, Inc., 59 Temple 
Place - Suite 330, Boston, MA 02111-1307, USA, or go to 
http://www.gnu.org/copyleft/lesser.txt.
-----------------------------------------------------------------------------
*/
#ifndef __ParticleSystem_H__
#define __ParticleSystem_H__

#include "OgrePrerequisites.h"

#include "OgreVector3.h"
#include "OgreString.h"
#include "OgreParticleIterator.h"
#include "OgreStringInterface.h"
#include "OgreMovableObject.h"

namespace Ogre {

    class _OgreExport ParticleSystem : public StringInterface, public MovableObject
    {
    public:

        class _OgrePrivate CmdQuota : public ParamCommand
        {
        public:
            String doGet(const void* target) const;
            void doSet(void* target, const String& val);
        };
        class _OgrePrivate CmdMaterial : public ParamCommand
        {
        public:
            String doGet(const void* target) const;
            void doSet(void* target, const String& val);
        };
        class _OgrePrivate CmdCull : public ParamCommand
        {
        public:
            String doGet(const void* target) const;
            void doSet(void* target, const String& val);
        };
        class _OgrePrivate CmdWidth : public ParamCommand
        {
        public:
            String doGet(const void* target) const;
            void doSet(void* target, const String& val);
        };
        class _OgrePrivate CmdHeight : public ParamCommand
        {
        public:
            String doGet(const void* target) const;
            void doSet(void* target, const String& val);
        };
        class _OgrePrivate CmdRenderer : public ParamCommand
        {
        public:
            String doGet(const void* target) const;
            void doSet(void* target, const String& val);
        };

        ParticleSystem();
        ParticleSystem(const String& name, const String& resourceGroupName);

        virtual ~ParticleSystem();

        void setRenderer(const String& typeName);

        ParticleSystemRenderer* getRenderer(void) const;
        const String& getRendererName(void) const;

        ParticleEmitter* addEmitter(const String& emitterType);

        ParticleEmitter* getEmitter(unsigned short index) const;

        unsigned short getNumEmitters(void) const;

        void removeEmitter(unsigned short index);

        void removeAllEmitters(void);


        ParticleAffector* addAffector(const String& affectorType);

        ParticleAffector* getAffector(unsigned short index) const;

        unsigned short getNumAffectors(void) const;

        void removeAffector(unsigned short index);

        void removeAllAffectors(void);

        void clear();

        size_t getNumParticles(void) const;

        Particle* createParticle(void);

        Particle* getParticle(size_t index);

        size_t getParticleQuota(void) const;

        void setParticleQuota(size_t quota);


        ParticleSystem& operator=(const ParticleSystem& rhs);

        void _update(Real timeElapsed);

        ParticleIterator _getIterator(void);

        virtual void setMaterialName(const String& name);

        virtual const String& getMaterialName(void) const;

        virtual void _notifyCurrentCamera(Camera* cam);

        void _notifyAttached(Node* parent, bool isTagPoint = false);

        virtual const AxisAlignedBox& getBoundingBox(void) const { return mAABB; }

        virtual Real getBoundingRadius(void) const { return mBoundingRadius; }

        virtual void _updateRenderQueue(RenderQueue* queue);

        const String& getName(void) const { return mName; }

        void fastForward(Real time, Real interval = 0.1);

        void setSpeedFactor(Real speedFactor) { mSpeedFactor = speedFactor; }

        Real getSpeedFactor(void) const { return mSpeedFactor; }


        const String& getMovableType(void) const;

        virtual void _notifyParticleResized(void);

        virtual void _notifyParticleRotated(void);

        virtual void setDefaultDimensions(Real width, Real height);

        virtual void setDefaultWidth(Real width);
        virtual Real getDefaultWidth(void) const;
        virtual void setDefaultHeight(Real height);
        virtual Real getDefaultHeight(void) const;
        virtual bool getCullIndividually(void) const;
        virtual void setCullIndividually(bool cullIndividual);
        virtual const String& getResourceGroupName(void) const { return mResourceGroupName; }
        const String& getOrigin(void) const { return mOrigin; }
        void _notifyOrigin(const String& origin) { mOrigin = origin; }

        void setRenderQueueGroup(RenderQueueGroupID queueID);

        void setBounds(const AxisAlignedBox& aabb);

        void setBoundsAutoUpdated(bool autoUpdate, Real stopIn = 0.0f);

        void _updateBounds(void);

    protected:

        static CmdCull msCullCmd;
        static CmdHeight msHeightCmd;
        static CmdMaterial msMaterialCmd;
        static CmdQuota msQuotaCmd;
        static CmdWidth msWidthCmd;
        static CmdRenderer msRendererCmd;


        AxisAlignedBox mAABB;
        Real mBoundingRadius;
        bool mBoundsAutoUpdate;
        Real mBoundsUpdateTime;

        AxisAlignedBox mWorldAABB;

        String mName;
        String mResourceGroupName;
        String mMaterialName;
        bool mIsRendererConfigured;
        MaterialPtr mpMaterial;
        Real mDefaultWidth;
        Real mDefaultHeight;
        Real mSpeedFactor;

        typedef std::list<Particle*> ActiveParticleList;
        typedef std::deque<Particle*> FreeParticleQueue;
        typedef std::vector<Particle*> ParticlePool;

        ActiveParticleList mActiveParticles;

        FreeParticleQueue mFreeParticles;

        ParticlePool mParticlePool;

        typedef std::vector<ParticleEmitter*> ParticleEmitterList;
        typedef std::vector<ParticleAffector*> ParticleAffectorList;
        
        ParticleEmitterList mEmitters;
        ParticleAffectorList mAffectors;

        ParticleSystemRenderer* mRenderer;

        bool mCullIndividual;

        String mRendererType;
        
        size_t mPoolSize;

        String mOrigin;


        void _expire(Real timeElapsed);

        void _triggerEmitters(Real timeElapsed);

        void _applyMotion(Real timeElapsed);

        void _triggerAffectors(Real timeElapsed);

        void increasePool(size_t size);

        void initParameters(void);

        void configureRenderer(void);

        void createVisualParticles(size_t poolstart, size_t poolend);
        void destroyVisualParticles(size_t poolstart, size_t poolend);


    };

}

#endif

---

Copyright © 2000-2005 by The OGRE Team

This work is licensed under a Creative Commons Attribution-ShareAlike 2.5 License.
Last modified Sun Feb 12 12:59:49 2006