Source: Particles/ParticleGameObject.js

/* File: ParticleGameObject.js 
 *
 * support particle object particulars: color change and expiration
 */

/*jslint node: true, vars: true, white: true */
/*global gEngine, GameObject, ParticleRenderable, Particle, vec4, vec2 */
/* find out more about jslint: http://www.jslint.com/help.html */

"use strict";  // Operate in Strict mode such that variables must be declared before used!

/**
 * Default Contsructor<p>
 * support particle object particulars: color change and expiration
 * @param {String} texture Texture filename
 * @param {Number} atX X Position of particle
 * @param {Number} atY Y Position of particle
 * @param {Number} cyclesToLive Number of gameupdates to live
 * @returns {ParticleGameObject} New instance of ParticleGameObject
 * @class ParticleGameObject
 */
function ParticleGameObject(texture, atX, atY, cyclesToLive) {
    var renderableObj = new ParticleRenderable(texture);
    this.xf = renderableObj.getXform();
    this.xf.setPosition(atX, atY);
    GameObject.call(this, renderableObj);
    
    this.mParticle = new Particle(this.xf.getPosition());
    this.mParticle.mOriginalPosition = [atX,atY];
    // this.setPhysicsComponent(p);  <-- does not work with the new physics engine
    
    this.mDeltaColor = [0, 0, 0, 0];
    this.mSizeDelta = 0;
    this.mCyclesToLive = cyclesToLive;
}
gEngine.Core.inheritPrototype(ParticleGameObject, GameObject);

/**
 * Set final color for the particle to change to during its life
 * @param {Float[]} f final color of particle [R, G, B, A]
 * @returns {void}
 * @memberOf ParticleGameObject
 */
ParticleGameObject.prototype.setFinalColor = function(f) {    
    vec4.sub(this.mDeltaColor, f, this.mRenderComponent.getColor());
    if (this.mCyclesToLive !== 0) {
        vec4.scale(this.mDeltaColor, this.mDeltaColor, 1/this.mCyclesToLive);
    }
};

/**
 * Set the size delta of the particle
 * @param {Number} d Size of particle
 * @returns {void}
 * @memberOf ParticleGameObject
 */
ParticleGameObject.prototype.setSizeDelta = function(d) {
    this.mSizeDelta = d;
};

/**
 * Return if the particle has expired
 * @returns {Boolean} True if the particle is out of cycles
 * @memberOf ParticleGameObject
 */
ParticleGameObject.prototype.hasExpired = function() {
    return (this.mCyclesToLive < 0);
};

/**
 * Update Function called by GameLoop
 * @returns {void}
 * @memberOf ParticleGameObject
 */
ParticleGameObject.prototype.update = function () {
    // GameObject.prototype.update.call(this); <== does not work (yet) with the new physics engine
    this.mParticle.update();
    this.getXform().setPosition(this.mParticle.getXPos(), this.mParticle.getYPos());
    
    this.mCyclesToLive--;
    var c = this.mRenderComponent.getColor();
    vec4.add(c, c, this.mDeltaColor);
    
    var xf = this.getXform();
    var s = xf.getWidth() * this.mSizeDelta;
    xf.setSize(s, s);
};
/**
 * Returns the Particle
 * @memberOf ParticleGameObject
 * @returns {Particle} The particle of the ParticleGameObject
 */
ParticleGameObject.prototype.getParticle = function () { return this.mParticle; };
/**
 * Return the transform of the particle
 * @memberOf ParticleGameObject
 * @returns {Transform} the transform tied to the particle
 */
ParticleGameObject.prototype.getX = function () { return this.getXform(); };