CameraManager.getTotal is a new method that will return the total number of Cameras being managed, with an optional isVisible argument, that only counts visible cameras if set.

Author: photonstorm

CHANGELOG.md

@@ -23,6 +23,7 @@
 * `CameraManager.currentCameraId` has been removed. IDs are assigned more intelligently now, via the `getNextID` internal method.
 * `CameraManager.addExisting` no longer needs to be passed a Camera that already exists in the pool (as the pool has been removed), meaning you can now create your own Cameras and pass them to `addExisting` and have them treated as normal cameras and not be ignored by the manager. They are also assigned a proper ID when added.
 * `CameraManager.addExisting` has a new boolean argument `makeMain` which will make the new camera the main one.
+* `CameraManager.getTotal` is a new method that will return the total number of Cameras being managed, with an optional `isVisible` argument, that only counts visible cameras if set.
 
 ### New Features
 
@@ -60,6 +61,7 @@
 * Fix extra argument passing in Array.Each (thanks @samme)
 * TileSprite was using the Size compontent instead of ComputedSize, meaning its `getBounds` and `displayWidth` and `displayHeight` results were incorrect. Fix #3789 (thanks @jjalonso)
 * ArrayUtils.AddAt didn't calculate the array offset correctly if you passed an array in to be merged with an existing array. This also caused Container.addAt to fail if an array was passed to it. Fix #3788 (thanks @jjalonso)
+* The `Pointer.camera` property would only be set if there was a viable Game Object in the camera view. Now it is set regardless, to always be the Camera the Pointer interacted with.
 
 ### Examples, Documentation and TypeScript
 

src/cameras/2d/CameraManager.js

@@ -237,6 +237,47 @@ var CameraManager = new Class({
         return camera;
     },
 
+    /**
+     * Adds an existing Camera into the Camera Manager.
+     * 
+     * The Camera should either be a `Phaser.Cameras.Scene2D.Camera` instance, or a class that extends from it.
+     * 
+     * The Camera will be assigned an ID, which is used for Game Object exclusion and then added to the
+     * manager. As long as it doesn't already exist in the manager it will be added then returned.
+     * 
+     * If this method returns `null` then the Camera already exists in this Camera Manager.
+     *
+     * @method Phaser.Cameras.Scene2D.CameraManager#addExisting
+     * @since 3.0.0
+     *
+     * @param {Phaser.Cameras.Scene2D.Camera} camera - The Camera to be added to the Camera Manager.
+     * @param {boolean} [makeMain=false] - Set this Camera as being the 'main' camera. This just makes the property `main` a reference to it.
+     *
+     * @return {?Phaser.Cameras.Scene2D.Camera} The Camera that was added to the Camera Manager, or `null` if it couldn't be added.
+     */
+    addExisting: function (camera, makeMain)
+    {
+        if (makeMain === undefined) { makeMain = false; }
+
+        var index = this.cameras.indexOf(camera);
+
+        if (index === -1)
+        {
+            camera.id = this.getNextID();
+
+            this.cameras.push(camera);
+
+            if (makeMain)
+            {
+                this.main = camera;
+            }
+    
+            return camera;
+        }
+
+        return null;
+    },
+
     /**
      * Gets the next available Camera ID number.
      * 
@@ -286,44 +327,36 @@ var CameraManager = new Class({
     },
 
     /**
-     * Adds an existing Camera into the Camera Manager.
-     * 
-     * The Camera should either be a `Phaser.Cameras.Scene2D.Camera` instance, or a class that extends from it.
-     * 
-     * The Camera will be assigned an ID, which is used for Game Object exclusion and then added to the
-     * manager. As long as it doesn't already exist in the manager it will be added then returned.
+     * Gets the total number of Cameras in this Camera Manager.
      * 
-     * If this method returns `null` then the Camera already exists in this Camera Manager.
+     * If the optional `isVisible` argument is set it will only count Cameras that are currently visible.
      *
-     * @method Phaser.Cameras.Scene2D.CameraManager#addExisting
-     * @since 3.0.0
-     *
-     * @param {Phaser.Cameras.Scene2D.Camera} camera - The Camera to be added to the Camera Manager.
-     * @param {boolean} [makeMain=false] - Set this Camera as being the 'main' camera. This just makes the property `main` a reference to it.
+     * @method Phaser.Cameras.Scene2D.CameraManager#getTotal
+     * @since 3.11.0
+     * 
+     * @param {boolean} [isVisible=false] - Set the `true` to only include visible Cameras in the total.
      *
-     * @return {?Phaser.Cameras.Scene2D.Camera} The Camera that was added to the Camera Manager, or `null` if it couldn't be added.
+     * @return {integer} The total number of Cameras in this Camera Manager.
      */
-    addExisting: function (camera, makeMain)
+    getTotal: function (isVisible)
     {
-        if (makeMain === undefined) { makeMain = false; }
+        if (isVisible === undefined) { isVisible = false; }
 
-        var index = this.cameras.indexOf(camera);
+        var total = 0;
 
-        if (index === -1)
-        {
-            camera.id = this.getNextID();
+        var cameras = this.cameras;
 
-            this.cameras.push(camera);
+        for (var i = 0; i < cameras.length; i++)
+        {
+            var camera = cameras[i];
 
-            if (makeMain)
+            if (!isVisible || (isVisible && camera.visible))
             {
-                this.main = camera;
+                total++;
             }
-    
-            return camera;
         }
 
-        return null;
+        return total;
     },
 
     /**