Made particles more extendable.

.bowerrc

@@ -0,0 +1,3 @@
+{
+	"directory" : "examples/libs"
+}

bower.json

@@ -1,12 +1,13 @@
 {
 	"name": "pixi-particles",
-	"version": "1.0.0",
+	"version": "1.1.0",
 	"main": "dist/pixi-particles.min.js",
 	"dependencies": {
 		"pixi.js": "*"
 	},
 	"ignore": [
 		".gitignore",
+		".bowerrc",
 		"package.json",
 		"tasks",
 		"Gruntfile.js",
@@ -15,4 +16,4 @@
 		"docs",
 		"src"
 	]
-}
+}

build.json

@@ -1,6 +1,6 @@
 {
 	"name" : "PixiParticles",
-	"version" : "0.0.1",
+	"version" : "1.1.0",
 	"description" : "Particle system for PixiJS",
 	"url" : "http://github.com/CloudKidStudio/PixiParticles",
 	"output" : "pixi-particles",

dist/pixi-particles.js

@@ -1,4 +1,4 @@
-/*! PixiParticles 0.0.1 */
+/*! PixiParticles 1.1.0 */
 /**
 *  @module cloudkid
 */
@@ -212,7 +212,8 @@
 	*/
 	var Particle = function(emitter)
 	{
-		PIXI.Sprite.call(this, emitter.particleImages[0]);
+		var art = emitter.particleImages[0] instanceof PIXI.Texture ? [emitter.particleImages[0]] : emitter.particleImages[0];
+		PIXI.MovieClip.call(this, art);
 
 		/**
 		*	The emitter that controls this particle.
@@ -243,6 +244,11 @@
 		*/
 		this.ease = null;
 		/**
+		*	Extra data that the emitter passes along for custom particles.
+		*	@property {Object} extraData
+		*/
+		this.extraData = null;
+		/**
 		*	The alpha of the particle at the start of its life.
 		*	@property {Number} startAlpha
 		*/
@@ -357,7 +363,7 @@
 	};
 
 	// Reference to the prototype
-	var p = Particle.prototype = Object.create(PIXI.Sprite.prototype);
+	var p = Particle.prototype = Object.create(PIXI.MovieClip.prototype);
 
 	/**
 	*	Initializes the particle for use, based on the properties that have to
@@ -404,6 +410,17 @@
 		this.tint = ParticleUtils.combineRGBComponents(this._sR, this._sG, this._sB);
 	};
 
+	/**
+	*	Sets the texture for the particle. This can be overridden to allow
+	*	for an animated particle.
+	*	@method applyArt
+	*	@param {PIXI.Texture} art The texture to set.
+	*/
+	p.applyArt = function(art)
+	{
+		this.setTexture(art);
+	};
+
 	/**
 	*	Updates the particle.
 	*	@method update
@@ -416,7 +433,7 @@
 		//recycle particle if it is too old
 		if(this.age >= this.maxLife)
 		{
-			this.emitter.recycle(this);
+			this.kill();
 			return;
 		}
 
@@ -463,6 +480,16 @@
 		}
 	};
 
+	/**
+	*	Kills the particle, removing it from the display list
+	*	and telling the emitter to recycle it.
+	*	@method kill
+	*/
+	p.kill = function()
+	{
+		this.emitter.recycle(this);
+	};
+
 	/**
 	*	Destroys the particle, removing references and preventing future use.
 	*	@method destroy
@@ -498,6 +525,12 @@
 	*/
 	var Emitter = function(particleParent, particleImages, config)
 	{
+		/**
+		 *	The constructor used to create new particles. The default is
+		 *	the built in particle class.
+		 * 	@property {Function} particleConstructor
+		 */
+		this.particleConstructor = Particle;
 		//properties for individual particles
 		/**
 		*	An array of PIXI Texture objects.
@@ -587,9 +620,15 @@
 		/**
 		*	An easing function for nonlinear interpolation of values. Accepts a single parameter of time
 		*	as a value from 0-1, inclusive. Expected outputs are values from 0-1, inclusive.
-		*	@property {Function} customeEase
+		*	@property {Function} customEase
 		*/
 		this.customEase = null;
+		/**
+		 *	Extra data for use in custom particles. The emitter doesn't look inside, but
+		 *	passes it on to the particle to use in init().
+		 *	@property {Object} extraData
+		 */
+		this.extraData = null;
 		//properties for spawning particles
 		/**
 		*	Time between particle spawns in seconds.
@@ -836,6 +875,7 @@
 		{
 			this.customEase = typeof config.ease == "function" ? config.ease : ParticleUtils.generateEase(config.ease);
 		}
+		this.extraData = config.extraData || null;
 		//////////////////////////
 		// Emitter Properties   //
 		//////////////////////////
@@ -1066,12 +1106,12 @@
 					for(var len = Math.min(this.particlesPerWave, this.maxParticles - this._activeParticles.length); i < len; ++i)
 					{
 						//create particle
-						var p = this._pool.length ? this._pool.pop() : new Particle(this);
+						var p = this._pool.length ? this._pool.pop() : new this.particleConstructor(this);
 						//set a random texture if we have more than one
 						if(this.particleImages.length > 1)
-							p.setTexture(this.particleImages.random());
+							p.applyArt(this.particleImages.random());
 						else
-							p.setTexture(this.particleImages[0]);//if they are actually the same texture, this call will quit early
+							p.applyArt(this.particleImages[0]);//if they are actually the same texture, this call will quit early
 						//set up the start and end values
 						p.startAlpha = this.startAlpha;
 						p.endAlpha = this.endAlpha;
@@ -1081,11 +1121,17 @@
 						p.endScale = this.endScale;
 						p.startColor = this.startColor;
 						p.endColor = this.endColor;
+						//randomize the rotation speed
 						if(this.minRotationSpeed == this.maxRotationSpeed)
 							p.rotationSpeed = this.minRotationSpeed;
 						else
 							p.rotationSpeed = Math.random() * (this.maxRotationSpeed - this.minRotationSpeed) + this.minRotationSpeed;
+						//set up the lifetime
 						p.maxLife = lifetime;
+						//set the custom ease, if any
+						p.ease = this.customEase;
+						//set the extra data, if any
+						p.extraData = this.extraData;
 						//call the proper function to handle rotation and position of particle
 						this._spawnFunc(p, emitPosX, emitPosY, i);
 						//initialize particle

src/Emitter.js

@@ -18,6 +18,12 @@
 	*/
 	var Emitter = function(particleParent, particleImages, config)
 	{
+		/**
+		 *	The constructor used to create new particles. The default is
+		 *	the built in particle class.
+		 * 	@property {Function} particleConstructor
+		 */
+		this.particleConstructor = Particle;
 		//properties for individual particles
 		/**
 		*	An array of PIXI Texture objects.
@@ -107,9 +113,15 @@
 		/**
 		*	An easing function for nonlinear interpolation of values. Accepts a single parameter of time
 		*	as a value from 0-1, inclusive. Expected outputs are values from 0-1, inclusive.
-		*	@property {Function} customeEase
+		*	@property {Function} customEase
 		*/
 		this.customEase = null;
+		/**
+		 *	Extra data for use in custom particles. The emitter doesn't look inside, but
+		 *	passes it on to the particle to use in init().
+		 *	@property {Object} extraData
+		 */
+		this.extraData = null;
 		//properties for spawning particles
 		/**
 		*	Time between particle spawns in seconds.
@@ -356,6 +368,7 @@
 		{
 			this.customEase = typeof config.ease == "function" ? config.ease : ParticleUtils.generateEase(config.ease);
 		}
+		this.extraData = config.extraData || null;
 		//////////////////////////
 		// Emitter Properties   //
 		//////////////////////////
@@ -586,12 +599,12 @@
 					for(var len = Math.min(this.particlesPerWave, this.maxParticles - this._activeParticles.length); i < len; ++i)
 					{
 						//create particle
-						var p = this._pool.length ? this._pool.pop() : new Particle(this);
+						var p = this._pool.length ? this._pool.pop() : new this.particleConstructor(this);
 						//set a random texture if we have more than one
 						if(this.particleImages.length > 1)
-							p.setTexture(this.particleImages.random());
+							p.applyArt(this.particleImages.random());
 						else
-							p.setTexture(this.particleImages[0]);//if they are actually the same texture, this call will quit early
+							p.applyArt(this.particleImages[0]);//if they are actually the same texture, this call will quit early
 						//set up the start and end values
 						p.startAlpha = this.startAlpha;
 						p.endAlpha = this.endAlpha;
@@ -601,11 +614,17 @@
 						p.endScale = this.endScale;
 						p.startColor = this.startColor;
 						p.endColor = this.endColor;
+						//randomize the rotation speed
 						if(this.minRotationSpeed == this.maxRotationSpeed)
 							p.rotationSpeed = this.minRotationSpeed;
 						else
 							p.rotationSpeed = Math.random() * (this.maxRotationSpeed - this.minRotationSpeed) + this.minRotationSpeed;
+						//set up the lifetime
 						p.maxLife = lifetime;
+						//set the custom ease, if any
+						p.ease = this.customEase;
+						//set the extra data, if any
+						p.extraData = this.extraData;
 						//call the proper function to handle rotation and position of particle
 						this._spawnFunc(p, emitPosX, emitPosY, i);
 						//initialize particle

src/Particle.js

@@ -15,7 +15,8 @@
 	*/
 	var Particle = function(emitter)
 	{
-		PIXI.Sprite.call(this, emitter.particleImages[0]);
+		var art = emitter.particleImages[0] instanceof PIXI.Texture ? [emitter.particleImages[0]] : emitter.particleImages[0];
+		PIXI.MovieClip.call(this, art);
 
 		/**
 		*	The emitter that controls this particle.
@@ -46,6 +47,11 @@
 		*/
 		this.ease = null;
 		/**
+		*	Extra data that the emitter passes along for custom particles.
+		*	@property {Object} extraData
+		*/
+		this.extraData = null;
+		/**
 		*	The alpha of the particle at the start of its life.
 		*	@property {Number} startAlpha
 		*/
@@ -160,7 +166,7 @@
 	};
 
 	// Reference to the prototype
-	var p = Particle.prototype = Object.create(PIXI.Sprite.prototype);
+	var p = Particle.prototype = Object.create(PIXI.MovieClip.prototype);
 
 	/**
 	*	Initializes the particle for use, based on the properties that have to
@@ -207,6 +213,17 @@
 		this.tint = ParticleUtils.combineRGBComponents(this._sR, this._sG, this._sB);
 	};
 
+	/**
+	*	Sets the texture for the particle. This can be overridden to allow
+	*	for an animated particle.
+	*	@method applyArt
+	*	@param {PIXI.Texture} art The texture to set.
+	*/
+	p.applyArt = function(art)
+	{
+		this.setTexture(art);
+	};
+
 	/**
 	*	Updates the particle.
 	*	@method update
@@ -219,7 +236,7 @@
 		//recycle particle if it is too old
 		if(this.age >= this.maxLife)
 		{
-			this.emitter.recycle(this);
+			this.kill();
 			return;
 		}
 
@@ -266,6 +283,16 @@
 		}
 	};
 
+	/**
+	*	Kills the particle, removing it from the display list
+	*	and telling the emitter to recycle it.
+	*	@method kill
+	*/
+	p.kill = function()
+	{
+		this.emitter.recycle(this);
+	};
+
 	/**
 	*	Destroys the particle, removing references and preventing future use.
 	*	@method destroy