More jsdoc updates

Author: photonstorm

src/gameobjects/GameObjectFactory.js

@@ -1,15 +1,41 @@
 var Class = require('../utils/Class');
 var PluginManager = require('../plugins/PluginManager');
 
+/**
+ * [description]
+ *
+ * @class GameObjectFactory
+ * @memberOf Phaser.GameObjects
+ * @constructor
+ * @since 3.0.0
+ *
+ * @param {Phaser.Scene} scene - The Scene to which this Game Object belongs.
+ */
 var GameObjectFactory = new Class({
 
     initialize:
 
     function GameObjectFactory (scene)
     {
-        //  The Scene that owns this plugin
+        /**
+         * The Scene to which this Game Object belongs.
+         * Game Objects can only belong to one Scene.
+         *
+         * @name Phaser.GameObjects.GameObjectFactory#scene
+         * @type {Phaser.Scene}
+         * @protected
+         * @since 3.0.0
+         */
         this.scene = scene;
 
+        /**
+         * A reference to the Scene.Systems.
+         *
+         * @name Phaser.GameObjects.GameObjectFactory#systems
+         * @type {Phaser.Scenes.Systems}
+         * @protected
+         * @since 3.0.0
+         */
         this.systems = scene.sys;
 
         if (!scene.sys.settings.isBooted)
@@ -18,9 +44,17 @@ var GameObjectFactory = new Class({
         }
 
         this.displayList;
+
         this.updateList;
     },
 
+    /**
+     * Boots the plugin.
+     *
+     * @method Phaser.GameObjects.GameObjectFactory#boot
+     * @private
+     * @since 3.0.0
+     */
     boot: function ()
     {
         this.displayList = this.systems.displayList;
@@ -32,6 +66,19 @@ var GameObjectFactory = new Class({
         eventEmitter.on('destroy', this.destroy, this);
     },
 
+    /**
+     * Adds an existing Game Object to this Scene.
+     * 
+     * If the Game Object renders, it will be added to the Display List.
+     * If it has a `preUpdate` method, it will be added to the Update List.
+     *
+     * @method Phaser.GameObjects.GameObjectFactory#existing
+     * @since 3.0.0
+     *
+     * @param {Phaser.GameObjects.GameObject} child - The child to be added to this Scene.
+     *
+     * @return {Phaser.GameObjects.GameObject} The Game Object that was added.
+     */
     existing: function (child)
     {
         if (child.renderCanvas || child.renderWebGL)
@@ -47,11 +94,22 @@ var GameObjectFactory = new Class({
         return child;
     },
 
+    /**
+     * Shuts this plugin down.
+     *
+     * @method Phaser.GameObjects.GameObjectFactory#shutdown
+     * @since 3.0.0
+     */
     shutdown: function ()
     {
-        //  TODO
     },
 
+    /**
+     * Destroys this plugin.
+     *
+     * @method Phaser.GameObjects.GameObjectFactory#destroy
+     * @since 3.0.0
+     */
     destroy: function ()
     {
         this.scene = null;

src/gameobjects/blitter/Blitter.js

@@ -125,19 +125,18 @@ var Blitter = new Class({
         return bob;
     },
 
-    //  frame MUST be part of the Blitter texture
     /**
      * [description]
      *
      * @method Phaser.GameObjects.Blitter#createFromCallback
      * @since 3.0.0
      *
-     * @param {[type]} callback - [description]
-     * @param {[type]} quantity - [description]
-     * @param {[type]} frame - [description]
-     * @param {[type]} visible - [description]
+     * @param {function} callback - The callback to invoke after creating a bob. It will be sent two arguments: The Bob and the index of the Bob.
+     * @param {integer} quantity - The quantity of Bob objects to create.
+     * @param {string} [frame] - The Frame the Bobs will use. It must be part of the Blitter Texture.
+     * @param {boolean} [visible=true] - [description]
      *
-     * @return {[type]} [description]
+     * @return {Phaser.GameObjects.Blitter.Bob[]} An array of Bob objects that were created.
      */
     createFromCallback: function (callback, quantity, frame, visible)
     {
@@ -153,18 +152,17 @@ var Blitter = new Class({
         return bobs;
     },
 
-    //  frame MUST be part of the Blitter texture
     /**
      * [description]
      *
      * @method Phaser.GameObjects.Blitter#createMultiple
      * @since 3.0.0
      *
-     * @param {[type]} quantity - [description]
-     * @param {[type]} frame - [description]
-     * @param {[type]} visible - [description]
+     * @param {integer} quantity - The quantity of Bob objects to create.
+     * @param {string} [frame] - The Frame the Bobs will use. It must be part of the Blitter Texture.
+     * @param {boolean} [visible=true] - [description]
      *
-     * @return {[type]} [description]
+     * @return {Phaser.GameObjects.Blitter.Bob[]} An array of Bob objects that were created.
      */
     createMultiple: function (quantity, frame, visible)
     {
@@ -196,9 +194,9 @@ var Blitter = new Class({
      * @method Phaser.GameObjects.Blitter#childCanRender
      * @since 3.0.0
      *
-     * @param {[type]} child - [description]
+     * @param {Phaser.GameObjects.Blitter.Bob} child - [description]
      *
-     * @return {[type]} [description]
+     * @return {boolean} [description]
      */
     childCanRender: function (child)
     {

src/gameobjects/blitter/BlitterCreator.js

@@ -3,8 +3,18 @@ var BuildGameObject = require('../BuildGameObject');
 var GameObjectCreator = require('../GameObjectCreator');
 var GetAdvancedValue = require('../../utils/object/GetAdvancedValue');
 
-//  When registering a factory function 'this' refers to the GameObjectCreator context.
-
+/**
+ * Creates a new Blitter Game Object and returns it.
+ *
+ * Note: This method will only be available if the Blitter Game Object has been built into Phaser.
+ *
+ * @method Phaser.GameObjects.GameObjectCreator#blitter
+ * @since 3.0.0
+ *
+ * @param {object} config - [description]
+ *
+ * @return {Phaser.GameObjects.Blitter} The Game Object that was created.
+ */
 GameObjectCreator.register('blitter', function (config)
 {
     var key = GetAdvancedValue(config, 'key', null);
@@ -16,3 +26,5 @@ GameObjectCreator.register('blitter', function (config)
 
     return blitter;
 });
+
+//  When registering a factory function 'this' refers to the GameObjectCreator context.

src/gameobjects/blitter/BlitterFactory.js

@@ -1,15 +1,30 @@
 var Blitter = require('./Blitter');
 var GameObjectFactory = require('../GameObjectFactory');
 
+/**
+ * Creates a new Blitter Game Object and adds it to the Scene.
+ *
+ * Note: This method will only be available if the Blitter Game Object has been built into Phaser.
+ *
+ * @method Phaser.GameObjects.GameObjectFactory#blitter
+ * @since 3.0.0
+ *
+ * @param {number} x - The x position of the Game Object.
+ * @param {number} y - The y position of the Game Object.
+ * @param {string} key - The key of the Texture the Blitter object will use.
+ * @param {string|integer} [frame] - The default Frame children of the Blitter will use.
+ * 
+ * @return {Phaser.GameObjects.Blitter} The Game Object that was created.
+ */
+GameObjectFactory.register('blitter', function (x, y, key, frame)
+{
+    return this.displayList.add(new Blitter(this.scene, x, y, key, frame));
+});
+
 //  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('blitter', function (x, y, key, frame)
-{
-    return this.displayList.add(new Blitter(this.scene, x, y, key, frame));
-});