axmol/cocos2dx/include/CCParticleSystem.h

/****************************************************************************
Copyright (c) 2010 cocos2d-x.org

http://www.cocos2d-x.org

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 __CCPARTICLE_SYSTEM_H__
#define __CCPARTICLE_SYSTEM_H__

#include "CCProtocols.h"
#include "CCNode.h"

#include <map>

namespace cocos2d {

#if CC_ENABLE_PROFILERS
	class CCProfilingTimer;
#endif

	//* @enum
	enum {
		/** The Particle emitter lives forever */
		kCCParticleDurationInfinity = -1,

		/** The starting size of the particle is equal to the ending size */
		kCCParticleStartSizeEqualToEndSize = -1,

		/** The starting radius of the particle is equal to the ending radius */
		kCCParticleStartRadiusEqualToEndRadius = -1,

		// backward compatible
		kParticleStartSizeEqualToEndSize = kCCParticleStartSizeEqualToEndSize,
		kParticleDurationInfinity = kCCParticleDurationInfinity,
	};

	//* @enum
	enum {
		/** Gravity mode (A mode) */
		kCCParticleModeGravity,

		/** Radius mode (B mode) */
		kCCParticleModeRadius,	
	};


	/** @typedef tCCPositionType
	possible types of particle positions
	*/
	typedef enum {
		/** If the emitter is repositioned, the living particles won't be repositioned */
		kCCPositionTypeFree,
		/** If the emitter is repositioned, the living particles will be repositioned too */
		kCCPositionTypeGrouped,
	}tCCPositionType;

	// backward compatible
	enum {
		kPositionTypeFree = kCCPositionTypeFree,
		kPositionTypeGrouped = kCCPositionTypeGrouped,
	}; 

	/** @struct tCCParticle
	Structure that contains the values of each particle
	*/
	typedef struct sCCParticle {
		CGPoint				pos;
		CGPoint				startPos;

		ccColor4F	color;
		ccColor4F	deltaColor;

		float		size;
		float		deltaSize;

		float		rotation;
		float		deltaRotation;

		ccTime		timeToLive;

		// Mode A: gravity, direction, radial accel, tangential accel
		struct {
			CGPoint		dir;
			float		radialAccel;
			float		tangentialAccel;
		} modeA;

		// Mode B: radius mode
		struct {
			float		angle;
			float		degreesPerSecond;
			float		radius;
			float		deltaRadius;
		} modeB;

	}tCCParticle;

	//typedef void (*CC_UPDATE_PARTICLE_IMP)(id, SEL, tCCParticle*, CGPoint);

	class CCTexture2D;

	/** Particle System base class
	Attributes of a Particle System:
	- emmision rate of the particles
	- Gravity Mode (Mode A):
	- gravity
	- direction
	- speed +-  variance
	- tangential acceleration +- variance
	- radial acceleration +- variance
	- Radius Mode (Mode B):
	- startRadius +- variance
	- endRadius +- variance
	- rotate +- variance
	- Properties common to all modes:
	- life +- life variance
	- start spin +- variance
	- end spin +- variance
	- start size +- variance
	- end size +- variance
	- start color +- variance
	- end color +- variance
	- life +- variance
	- blending function
	- texture

	cocos2d also supports particles generated by Particle Designer (http://particledesigner.71squared.com/).
	'Radius Mode' in Particle Designer uses a fixed emit rate of 30 hz. Since that can't be guarateed in cocos2d,
	cocos2d uses a another approach, but the results are almost identical. 

	cocos2d supports all the variables used by Particle Designer plus a bit more:
	- spinning particles (supported when using CCQuadParticleSystem)
	- tangential acceleration (Gravity mode)
	- radial acceleration (Gravity mode)
	- radius direction (Radius mode) (Particle Designer supports outwards to inwards direction only)

	It is possible to customize any of the above mentioned properties in runtime. Example:

	@code
	emitter.radialAccel = 15;
	emitter.startSpin = 0;
	@endcode

	*/
	class CCX_DLL CCParticleSystem : public CCNode, public CCTextureProtocol
	{	
	protected:
		// time elapsed since the start of the system (in seconds)
		float m_fElapsed;

		// Different modes
		// Mode A:Gravity + Tangential Accel + Radial Accel
		struct {
			// gravity of the particles
			CGPoint gravity;
			// The speed the particles will have.
			float speed;
			// The speed variance
			float speedVar;
			// Tangential acceleration
			float tangentialAccel;
			// Tangential acceleration variance
			float tangentialAccelVar;
			// Radial acceleration
			float radialAccel;
			// Radial acceleration variance
			float radialAccelVar;
		} modeA;

		// Mode B: circular movement (gravity, radial accel and tangential accel don't are not used in this mode)
		struct {
			// The starting radius of the particles
			float startRadius;
			// The starting radius variance of the particles
			float startRadiusVar;
			// The ending radius of the particles
			float endRadius;
			// The ending radius variance of the particles
			float endRadiusVar;			
			// Number of degress to rotate a particle around the source pos per second
			float rotatePerSecond;
			// Variance in degrees for rotatePerSecond
			float rotatePerSecondVar;
		} modeB;

		// Array of particles
		tCCParticle *m_pParticles;

		// color modulate
		//	BOOL colorModulate;

		// How many particles can be emitted per second
		float m_fEmitCounter;

		//  particle idx
		int m_nParticleIdx;

		// Optimization
		//CC_UPDATE_PARTICLE_IMP	updateParticleImp;
		//SEL						updateParticleSel;

		// profiling
#if CC_ENABLE_PROFILERS
		CCProfilingTimer* m_pProfilingTimer;
#endif

		/** Is the emitter active */
		CCX_PROPERTY_READONLY(bool, m_bIsActive, IsActive)
		/** Quantity of particles that are being simulated at the moment */
		CCX_PROPERTY_READONLY(int, m_nParticleCount, ParticleCount)
		/** How many seconds the emitter wil run. -1 means 'forever' */
		CCX_PROPERTY(float, m_fDuration, Duration)
		/** centerOfGravity of the emitter */
		CCX_PROPERTY(CGPoint, m_tCenterOfGravity, CenterOfGravity)
		/** Position variance of the emitter */
		CCX_PROPERTY(CGPoint, m_tPosVar, PosVar)
		/** life, and life variation of each particle */
		CCX_PROPERTY(float, m_fLife, Life)
		/** life variance of each particle */
		CCX_PROPERTY(float, m_fLifeVar, LifeVar)
		/** angle and angle variation of each particle */
		CCX_PROPERTY(float, m_fAngle, Angle)
		/** angle variance of each particle */
		CCX_PROPERTY(float, m_fAngleVar, AngleVar)

	//////////////////////////////////////////////////////////////////////////
	public:
		// mode A
		/** Gravity value. Only available in 'Gravity' mode. */
		virtual CGPoint getGravity();
		virtual void setGravity(CGPoint g);
		/** speed of each particle. Only available in 'Gravity' mode.  */
		virtual float getSpeed();
		virtual void setSpeed(float speed);
		/** speed variance of each particle. Only available in 'Gravity' mode. */
		virtual float getSpeedVar();
		virtual void setSpeedVar(float speed);
		/** tangential acceleration of each particle. Only available in 'Gravity' mode. */
		virtual float getTangentialAccel();
		virtual void setTangentialAccel(float t);
		/** tangential acceleration variance of each particle. Only available in 'Gravity' mode. */
		virtual float getTangentialAccelVar();
		virtual void setTangentialAccelVar(float t);
		/** radial acceleration of each particle. Only available in 'Gravity' mode. */
		virtual float getRadialAccel();
		virtual void setRadialAccel(float t);
		/** radial acceleration variance of each particle. Only available in 'Gravity' mode. */
		virtual float getRadialAccelVar();
		virtual void setRadialAccelVar(float t);
		// mode B
		/** The starting radius of the particles. Only available in 'Radius' mode. */
		virtual float getStartRadius();
		virtual void setStartRadius(float startRadius);
		/** The starting radius variance of the particles. Only available in 'Radius' mode. */
		virtual float getStartRadiusVar();
		virtual void setStartRadiusVar(float startRadiusVar);
		/** The ending radius of the particles. Only available in 'Radius' mode. */
		virtual float getEndRadius();
		virtual void setEndRadius(float endRadius);
		/** The ending radius variance of the particles. Only available in 'Radius' mode. */
		virtual float getEndRadiusVar();
		virtual void setEndRadiusVar(float endRadiusVar);
		/** Number of degress to rotate a particle around the source pos per second. Only available in 'Radius' mode. */
		virtual float getRotatePerSecond();
		virtual void setRotatePerSecond(float degrees);
		/** Variance in degrees for rotatePerSecond. Only available in 'Radius' mode. */
		virtual float getRotatePerSecondVar();
		virtual void setRotatePerSecondVar(float degrees);
	//////////////////////////////////////////////////////////////////////////
		
		/** start size in pixels of each particle */
		CCX_PROPERTY(float, m_fStartSize, StartSize)
		/** size variance in pixels of each particle */
		CCX_PROPERTY(float, m_fStartSizeVar, StartSizeVar)
		/** end size in pixels of each particle */
		CCX_PROPERTY(float, m_fEndSize, EndSize)
		/** end size variance in pixels of each particle */
		CCX_PROPERTY(float, m_fEndSizeVar, EndSizeVar)
		/** start color of each particle */
		CCX_PROPERTY(ccColor4F, m_tStartColor, StartColor)
		/** start color variance of each particle */
		CCX_PROPERTY(ccColor4F, m_tStartColorVar, StartColorVar)
		/** end color and end color variation of each particle */
		CCX_PROPERTY(ccColor4F, m_tEndColor, EndColor)
		/** end color variance of each particle */
		CCX_PROPERTY(ccColor4F, m_tEndColorVar, EndColorVar)
		//* initial angle of each particle
		CCX_PROPERTY(float, m_fStartSpin, StartSpin)
		//* initial angle of each particle
		CCX_PROPERTY(float, m_fStartSpinVar, StartSpinVar)
		//* initial angle of each particle
		CCX_PROPERTY(float, m_fEndSpin, EndSpin)
		//* initial angle of each particle
		CCX_PROPERTY(float, m_fEndSpinVar, EndSpinVar)
		/** emission rate of the particles */
		CCX_PROPERTY(float, m_fEmissionRate, EmissionRate)
		/** maximum particles of the system */
		CCX_PROPERTY(int, m_nTotalParticles, TotalParticles)
		/** conforms to CocosNodeTexture protocol */
		CCX_PROPERTY(CCTexture2D*, m_pTexture, Texture)
		/** conforms to CocosNodeTexture protocol */
		CCX_PROPERTY(ccBlendFunc, m_tBlendFunc, BlendFunc)
		/** whether or not the particles are using blend additive.
		If enabled, the following blending function will be used.
		@code
		source blend function = GL_SRC_ALPHA;
		dest blend function = GL_ONE;
		@endcode
		*/
		CCX_PROPERTY(bool, m_bIsBlendAdditive, IsBlendAdditive)
		/** particles movement type: Free or Grouped
		@since v0.8
		*/
		CCX_PROPERTY(tCCPositionType, m_ePositionType, PositionType)
		/** whether or not the node will be auto-removed when it has no particles left.
		By default it is NO.
		@since v0.8
		*/
		CCX_PROPERTY(bool, m_bIsAutoRemoveOnFinish, IsAutoRemoveOnFinish)
		/** Switch between different kind of emitter modes:
		- kCCParticleModeGravity: uses gravity, speed, radial and tangential acceleration
		- kCCParticleModeRadius: uses radius movement + rotation
		*/
		CCX_PROPERTY(int, m_nEmitterMode, EmitterMode)

	public:
		CCParticleSystem();
		virtual ~CCParticleSystem();
		/** creates an initializes a CCParticleSystem from a plist file.
		This plist files can be creted manually or with Particle Designer:
		http://particledesigner.71squared.com/
		@since v0.99.3
		*/
		static CCParticleSystem * particleWithFile(const char *plistFile);

		/** initializes a CCParticleSystem from a plist file.
		This plist files can be creted manually or with Particle Designer:
		http://particledesigner.71squared.com/
		@since v0.99.3
		*/
		bool initWithFile(const char *plistFile);

		/** initializes a CCQuadParticleSystem from a NSDictionary.
		@since v0.99.3
		*/
		bool initWithDictionary(std::map<std::string, void*> *dictionary);

		//! Initializes a system with a fixed number of particles
		virtual bool initWithTotalParticles(int numberOfParticles);
		//! Add a particle to the emitter
		bool addParticle();
		//! Initializes a particle
		void initParticle(tCCParticle* particle);
		//! stop emitting particles. Running particles will continue to run until they die
		void stopSystem();
		//! Kill all living particles.
		void resetSystem();
		//! whether or not the system is full
		bool isFull();

		//! should be overriden by subclasses
		virtual void updateQuadWithParticle(tCCParticle* particle, CGPoint newPosition);
		//! should be overriden by subclasses
		virtual void postStep();

		virtual void update(ccTime dt);
	private:
		inline const char * valueForKey(const char *key, std::map<std::string, void*> *dict)
		{
			std::map<std::string, void*>::iterator it = dict->find(key);
			return it!=dict->end() ? ((std::string*)(it->second))->c_str() : "";
		}
};

}// namespace cocos2d
#endif //__CCPARTICLE_SYSTEM_H__