Particle Emitter Manager looks after all emitters bound to it

Author: photonstorm

v3/src/gameobjects/particles/ParticleEmitterManager.js

@@ -0,0 +1,88 @@
+var Class = require('../../utils/Class');
+var Components = require('../components');
+var GameObject = require('../GameObject');
+var ParticleEmitter = require('./ParticleEmitter');
+var Render = require('./ParticleManagerRender');
+
+var ParticleEmitterManager = new Class({
+
+    Extends: GameObject,
+
+    Mixins: [
+        Components.Texture,
+        Components.Visible,
+        Render
+    ],
+
+    initialize:
+
+    function ParticleEmitterManager (scene, texture, frame, emitters)
+    {
+        GameObject.call(this, scene, 'ParticleEmitterManager');
+
+        //  private
+        this.blendMode = -1;
+
+        this.setTexture(texture, frame);
+
+        this.emitters = [];
+
+        if (emitters !== undefined)
+        {
+            //  An array of emitter configs?
+            if (!Array.isArray(emitters))
+            {
+                emitters = [ emitters ];
+            }
+
+            for (var i = 0; i < emitters.length; i++)
+            {
+                this.createEmitter(emitters[i]);
+            }
+        }
+    },
+
+    addEmitter: function (emitter)
+    {
+        this.emitters.push(emitter);
+
+        return emitter;
+    },
+
+    createEmitter: function (config)
+    {
+        return this.addEmitter(new ParticleEmitter(this, config));
+    },
+
+    pause: function ()
+    {
+        this.active = false;
+
+        return this;
+    },
+
+    resume: function ()
+    {
+        this.active = true;
+
+        return this;
+    },
+
+    preUpdate: function (time, delta)
+    {
+        var emitters = this.emitters;
+
+        for (var i = 0; i < emitters.length; i++)
+        {
+            var emitter = emitters[i];
+
+            if (emitter.active)
+            {
+                emitter.preUpdate(time, delta);
+            }
+        }
+    }
+
+});
+
+module.exports = ParticleEmitterManager;

v3/src/gameobjects/particles/ParticleManagerCreator.js

@@ -0,0 +1,18 @@
+var BuildGameObject = require('../BuildGameObject');
+var GameObjectCreator = require('../../scene/plugins/GameObjectCreator');
+var GetAdvancedValue = require('../../utils/object/GetAdvancedValue');
+var ParticleEmitter = require('./ParticleEmitter');
+
+//  When registering a factory function 'this' refers to the GameObjectCreator context.
+
+GameObjectCreator.register('particles', function (config)
+{
+    var key = GetAdvancedValue(config, 'key', null);
+    var frame = GetAdvancedValue(config, 'frame', null);
+
+    var emitter = new ParticleEmitter(this.scene, 0, 0, key, frame);
+
+    BuildGameObject(this.scene, emitter, config);
+
+    return emitter;
+});

v3/src/gameobjects/particles/ParticleManagerFactory.js

@@ -0,0 +1,20 @@
+var ParticleEmitterManager = require('./ParticleEmitterManager');
+var GameObjectFactory = require('../../scene/plugins/GameObjectFactory');
+
+//  When registering a factory function 'this' refers to the GameObjectFactory context.
+//  
+//  There are several properties available to use:
+//  
+//  this.scene - a reference to the Scene that owns the GameObjectFactory
+//  this.displayList - a reference to the Display List the Scene owns
+//  this.updateList - a reference to the Update List the Scene owns
+
+GameObjectFactory.register('particles', function (key, frame, emitters)
+{
+    var manager = new ParticleEmitterManager(this.scene, key, frame, emitters);
+    
+    this.displayList.add(manager);
+    this.updateList.add(manager);
+    
+    return manager;
+});