source: orxonox.OLD/trunk/src/world_entities/particles/particle_emitter.h

/*!
 * @file particle_emitter.h
  *  Definition of a ParticleEmitter
*/

#ifndef _PARTICLE_EMITTER_H
#define _PARTICLE_EMITTER_H

#include "p_node.h"

// FORWARD DECLARATION
class ParticleSystem;
class TiXmlElement;

// Default values
#define PARTICLE_EMITTER_DEFAULT_SIZE              1.0
#define PARTICLE_EMITTER_DEFAULT_EMISSION_RATE     50
#define PARTICLE_EMITTER_DEFAULT_INHERIT_SPEED     0.0
#define PARTICLE_EMITTER_DEFAULT_SPREAD            M_PI
#define PARTICLE_EMITTER_DEFAULT_VELOCITY          1.0

//! A class to handle an Emitter.
class ParticleEmitter : public PNode
{
  ObjectListDeclaration(ParticleEmitter);
  friend class ParticleSystem;
public:
  ParticleEmitter(float emissionRate = PARTICLE_EMITTER_DEFAULT_EMISSION_RATE,
                  float velocity = PARTICLE_EMITTER_DEFAULT_VELOCITY,
                  float angle = PARTICLE_EMITTER_DEFAULT_SPREAD);
  virtual ~ParticleEmitter();

  virtual void loadParams(const TiXmlElement* root = NULL);

  /* controlling the emitter: interface */
  void start();
  void stop();
  virtual void tick(float dt);

  void setSystem(ParticleSystem* system);
  ParticleSystem* getSystem() const { return this->system; };

  /* controlling the behavour: these can be used as Animation interfaces */
  void setEmissionRate(float emissionRate);
  void setInheritSpeed(float value);
  void setSpread(float angle, float randomAngle = 0.0);
  void setEmissionVelocity(float velocity, float randomVelocity = 0.0);
  void setEmissionMomentum(float momentum, float randomMomentum = 0.0);
  void setExtForce(float x, float y, float z);

  /** @returns the emissionRate */
  inline float getEmissionRate() const { return this->emissionRate; };
  /** @returns the inherit-speed-factor */
  inline float getInheritSpeed() const { return this->inheritSpeed; };
  /** @returns the SpreadAngle of the emitter */
  inline float getSpread() const { return this->angle; };
  /** @returns the EmissionVelocity of the emitter */
  inline float getEmissionVelocity() const { return this->velocity; };
  /** @returns the EmissionMomentum of this emitter */
  inline float getEmissionMomentum() const { return this->momentum; };


  void debug() const;

protected:
  virtual void emitParticles(unsigned int count) const = 0;

protected:
  float           inheritSpeed;      //!< How much speed the particle inherits from the Emitters speed.
  float           angle;             //!< max angle from the direction of the emitter
  float           randomAngle;       //!< random emission angle (angle +- angleRandom is the emitted angle.
  float           velocity;          //!< the initial speed of a Particles.
  float           randomVelocity;    //!< the random variation from the initial Speed.
  float           momentum;          //!< The Initial spped of the Rotation.
  float           momentumRandom;    //!< The random variation of the Momentum.
  Vector          extForce;          //!< The external Force

//private:
  ParticleSystem* system;            //!< The ParticleSystem this Emitter Emits into.
  float           saveTime;          //!< The time that was missing by the last Tick (otherwise there would be no emission when framefate is too big).
  float           emissionRate;      //!< amount of particles per seconds emitted by emitter.
};

#endif /* _PARTICLE_EMITTER_H */