Particle.h

Go to the documentation of this file.

/* -*-c++-*- OpenSceneGraph - Copyright (C) 1998-2006 Robert Osfield
 *
 * This library is open source and may be redistributed and/or modified under
 * the terms of the OpenSceneGraph Public License (OSGPL) version 0.0 or
 * (at your option) any later version.  The full license is in LICENSE file
 * included with this distribution, and on the openscenegraph.org website.
 *
 * This library 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
 * OpenSceneGraph Public License for more details.
*/
//osgParticle - Copyright (C) 2002 Marco Jez

#ifndef OSGPARTICLE_PARTICLE
#define OSGPARTICLE_PARTICLE 1

#include <osgParticle/Export>
#include <osgParticle/Interpolator>
#include <osgParticle/range>

#include <osg/ref_ptr>
#include <osg/Vec3>
#include <osg/Vec4>
#include <osg/Matrix>
#include <osg/Drawable>
#include <osg/GL>
#include <osg/GLBeginEndAdapter>

namespace osgParticle
{

    // forward declare so we can reference it
    class ParticleSystem;

    class OSGPARTICLE_EXPORT Particle {
        friend class ParticleSystem;
    public:

        enum
        {
            INVALID_INDEX = -1
        };

        enum Shape {
            POINT,            // uses GL_POINTS as primitive
            QUAD,            // uses GL_QUADS as primitive
            QUAD_TRIANGLESTRIP,    // uses GL_TRI_angleSTRIP as primitive, but each particle needs a glBegin/glEnd pair
            HEXAGON,            // may save some filling time, but uses more triangles
            LINE,               // uses GL_LINES to draw line segments that point to the direction of motion
            USER               // uses a user-defined drawable as primitive
        };

        Particle();

        inline Shape getShape() const;

        inline void setShape(Shape s);

        inline bool isAlive() const;

        inline double getLifeTime() const;

        inline double getAge() const;

        inline const rangef& getSizeRange() const;

        inline const rangef& getAlphaRange() const;

        inline const rangev4& getColorRange() const;

        inline const Interpolator* getSizeInterpolator() const;

        inline const Interpolator* getAlphaInterpolator() const;

        inline const Interpolator* getColorInterpolator() const;

        inline float getRadius() const;

        inline float getMass() const;

        inline float getMassInv() const;

        inline const osg::Vec3& getPosition() const;

        inline const osg::Vec3& getVelocity() const;

        inline const osg::Vec3& getPreviousPosition() const;

        inline const osg::Vec3& getAngle() const;

        inline const osg::Vec3& getAngularVelocity() const;

        inline const osg::Vec3& getPreviousAngle() const;

        inline const osg::Vec4& getCurrentColor() const { return _current_color; }

        inline float getCurrentAlpha() const { return _current_alpha; }

        inline float getSTexCoord() const { return _s_coord; }

        inline float getTTexCoord() const { return _t_coord; }

        inline int getTileS() const;

        inline int getTileT() const;

        inline int getNumTiles() const { return _end_tile - _start_tile + 1; }

        inline void kill();

        inline void setLifeTime(double t);

        inline void setSizeRange(const rangef& r);

        inline void setAlphaRange(const rangef& r);

        inline void setColorRange(const rangev4& r);

        inline void setSizeInterpolator(Interpolator* ri);

        inline void setAlphaInterpolator(Interpolator* ai);

        inline void setColorInterpolator(Interpolator* ci);

        inline void setRadius(float r);

        inline void setMass(float m);

        inline void setPosition(const osg::Vec3& p);

        inline void setVelocity(const osg::Vec3& v);

        inline void addVelocity(const osg::Vec3& dv);

        inline void transformPositionVelocity(const osg::Matrix& xform);

        void transformPositionVelocity(const osg::Matrix& xform1, const osg::Matrix& xform2, float r);

        inline void setAngle(const osg::Vec3& a);

        inline void setAngularVelocity(const osg::Vec3& v);

        inline void addAngularVelocity(const osg::Vec3& dv);

        inline void transformAngleVelocity(const osg::Matrix& xform);

        bool update(double dt, bool onlyTimeStamp);

        inline void beginRender(osg::GLBeginEndAdapter* gl) const;

        void render(osg::GLBeginEndAdapter* gl, const osg::Vec3& xpos, const osg::Vec3& px, const osg::Vec3& py, float scale = 1.0f) const;

        void render(osg::RenderInfo& renderInfo, const osg::Vec3& xpos, const osg::Vec3& xrot) const;

        inline void endRender(osg::GLBeginEndAdapter* gl) const;

        inline float getCurrentSize() const;

        inline void setTextureTileRange(int sTile, int tTile, int startTile, int endTile);

        inline void setTextureTile(int sTile, int tTile, int end = -1);

        inline int getStartTile() const;

        inline int getEndTile() const;

        inline void setPreviousParticle(int previous) { _previousParticle = previous; }

        inline int getPreviousParticle() const { return _previousParticle; }

        inline void setNextParticle(int next) { _nextParticle = next; }

        inline int getNextParticle() const { return _nextParticle; }

        inline void setDepth(double d) { _depth = d; }

        inline double getDepth() const { return _depth; }

        inline void setDrawable(osg::Drawable* d) { _drawable = d; }

        inline osg::Drawable* getDrawable() const { return _drawable.get(); }

        bool operator<(const Particle &P) const { return _depth < P._depth; }

        void setUpTexCoordsAsPartOfConnectedParticleSystem(ParticleSystem* ps);

    protected:

        Shape _shape;

        rangef _sr;
        rangef _ar;
        rangev4 _cr;

        osg::ref_ptr<Interpolator> _si;
        osg::ref_ptr<Interpolator> _ai;
        osg::ref_ptr<Interpolator> _ci;

        bool _mustdie;
        double _lifeTime;

        float _radius;
        float _mass;
        float _massinv;
        osg::Vec3 _prev_pos;
        osg::Vec3 _position;
        osg::Vec3 _velocity;

        osg::Vec3 _prev_angle;
        osg::Vec3 _angle;
        osg::Vec3 _angul_arvel;

        double _t0;

        float _alive;
        float _current_size;
        float _current_alpha;
        osg::Vec3 _base_prop;  // [0] _alive [1] _current_size [2] _current_alpha
        osg::Vec4 _current_color;

        float _s_tile;
        float _t_tile;
        int _start_tile;
        int _end_tile;
        int _cur_tile;
        float _s_coord;
        float _t_coord;

        // previous and next Particles are only used in ConnectedParticleSystems
        int _previousParticle;
        int _nextParticle;

        // the depth of the particle is used only when sorting is enabled
        double _depth;

        // the particle drawable is used only when USER shape is enabled
        osg::ref_ptr<osg::Drawable> _drawable;
    };

    // INLINE FUNCTIONS

    inline Particle::Shape Particle::getShape() const
    {
        return _shape;
    }

    inline void Particle::setShape(Shape s)
    {
        _shape = s;
    }

    inline bool Particle::isAlive() const
    {
        return _alive>0.0f;
    }

    inline double Particle::getLifeTime() const
    {
        return _lifeTime;
    }

    inline double Particle::getAge() const
    {
        return _t0;
    }

    inline float Particle::getRadius() const
    {
        return _radius;
    }

    inline void Particle::setRadius(float r)
    {
        _radius = r;
    }

    inline const rangef& Particle::getSizeRange() const
    {
        return _sr;
    }

    inline const rangef& Particle::getAlphaRange() const
    {
        return _ar;
    }

    inline const rangev4& Particle::getColorRange() const
    {
        return _cr;
    }

    inline const Interpolator* Particle::getSizeInterpolator() const
    {
        return _si.get();
    }

    inline const Interpolator* Particle::getAlphaInterpolator() const
    {
        return _ai.get();
    }

    inline const Interpolator* Particle::getColorInterpolator() const
    {
        return _ci.get();
    }

    inline const osg::Vec3& Particle::getPosition() const
    {
        return _position;
    }

    inline const osg::Vec3& Particle::getVelocity() const
    {
        return _velocity;
    }

    inline const osg::Vec3& Particle::getPreviousPosition() const
    {
        return _prev_pos;
    }

    inline const osg::Vec3& Particle::getAngle() const
    {
        return _angle;
    }

    inline const osg::Vec3& Particle::getAngularVelocity() const
    {
        return _angul_arvel;
    }

    inline const osg::Vec3& Particle::getPreviousAngle() const
    {
        return _prev_angle;
    }

    inline int Particle::getTileS() const
    {
        return (_s_tile>0.0f) ? static_cast<int>(1.0f / _s_tile) : 1;
    }

    inline int Particle::getTileT() const
    {
        return (_t_tile>0.0f) ? static_cast<int>(1.0f / _t_tile) : 1;
    }

    inline void Particle::kill()
    {
        _mustdie = true;
    }

    inline void Particle::setLifeTime(double t)
    {
        _lifeTime = t;
    }

    inline void Particle::setSizeRange(const rangef& r)
    {
        _sr = r;
    }

    inline void Particle::setAlphaRange(const rangef& r)
    {
        _ar = r;
    }

    inline void Particle::setColorRange(const rangev4& r)
    {
        _cr = r;
    }

    inline void Particle::setSizeInterpolator(Interpolator* ri)
    {
        _si = ri;
    }

    inline void Particle::setAlphaInterpolator(Interpolator* ai)
    {
        _ai = ai;
    }

    inline void Particle::setColorInterpolator(Interpolator* ci)
    {
        _ci = ci;
    }

    inline void Particle::setPosition(const osg::Vec3& p)
    {
        _position = p;
    }

    inline void Particle::setVelocity(const osg::Vec3& v)
    {
        _velocity = v;
    }

    inline void Particle::addVelocity(const osg::Vec3& dv)
    {
        _velocity += dv;
    }

    inline void Particle::transformPositionVelocity(const osg::Matrix& xform)
    {
        _position = xform.preMult(_position);
        _velocity = osg::Matrix::transform3x3(_velocity, xform);
    }

    inline void Particle::transformPositionVelocity(const osg::Matrix& xform1, const osg::Matrix& xform2, float r)
    {
        osg::Vec3 position1 = xform1.preMult(_position);
        osg::Vec3 velocity1 = osg::Matrix::transform3x3(_velocity, xform1);
        osg::Vec3 position2 = xform2.preMult(_position);
        osg::Vec3 velocity2 = osg::Matrix::transform3x3(_velocity, xform2);
        float one_minus_r = 1.0f-r;
        _position = position1*r + position2*one_minus_r;
        _velocity = velocity1*r + velocity2*one_minus_r;
    }

    inline void Particle::setAngle(const osg::Vec3& a)
    {
        _angle = a;
    }

    inline void Particle::setAngularVelocity(const osg::Vec3& v)
    {
        _angul_arvel = v;
    }

    inline void Particle::addAngularVelocity(const osg::Vec3& dv)
    {
        _angul_arvel += dv;
    }

    inline void Particle::transformAngleVelocity(const osg::Matrix& xform)
    {
        // this should be optimized!

        osg::Vec3 a1 = _angle + _angul_arvel;

        _angle = xform.preMult(_angle);
        a1 = xform.preMult(a1);

        _angul_arvel = a1 - _angle;
    }

    inline float Particle::getMass() const
    {
        return _mass;
    }

    inline float Particle::getMassInv() const
    {
        return _massinv;
    }

    inline void Particle::setMass(float m)
    {
        _mass = m;
        _massinv = 1 / m;
    }

    inline void Particle::beginRender(osg::GLBeginEndAdapter* gl) const
    {
        switch (_shape)
        {
        case POINT:
            gl->Begin(GL_POINTS);
            break;
        case QUAD:
            gl->Begin(GL_QUADS);
            break;
        case LINE:
            gl->Begin(GL_LINES);
            break;
        default: ;
        }
    }

    inline void Particle::endRender(osg::GLBeginEndAdapter* gl) const
    {
        switch (_shape)
        {
        case POINT:
        case QUAD:
        case LINE:
            gl->End();
            break;
        default: ;
        }
    }

    inline float Particle::getCurrentSize() const
    {
        return _current_size;
    }


    inline void Particle::setTextureTile(int sTile, int tTile, int end)
    {
        setTextureTileRange(sTile, tTile, -1, end);
    }

    inline void Particle::setTextureTileRange(int sTile, int tTile, int startTile, int endTile)
    {
       _s_tile = (sTile>0) ? 1.0f / static_cast<float>(sTile) : 1.0f;
       _t_tile = (tTile>0) ? 1.0f / static_cast<float>(tTile) : 1.0f;

       if(startTile == -1)
       {
          _start_tile = 0;
       }
       else
       {
          _start_tile = startTile;
       }

       if(endTile == -1)
       {
          _end_tile = sTile * tTile;
       }
       else
       {
          _end_tile = endTile;
       }
    }

    inline int Particle::getStartTile() const
    {
        return _start_tile;
    }

    inline int Particle::getEndTile() const
    {
        return _end_tile;
    }
}

#endif