Added processOptions config object to InputManager, allowing to set if all callbacks fire, or just that on the top of the display list. Added Input CONSTs. Updated Input Manager so events only fire once, carrying an array of all impacted GOs as a property.

Author: photonstorm

v3/src/checksum.js

@@ -1,4 +1,4 @@
 var CHECKSUM = {
-build: '98dca120-6d40-11e7-8ba2-2f8841c28191'
+build: '668ff4c0-6d49-11e7-a9ff-d120a05f4baf'
 };
 module.exports = CHECKSUM;

v3/src/input/const.js

@@ -0,0 +1,8 @@
+var INPUT_CONST = {
+
+    ALL: 0,
+    TOP: 1
+
+};
+
+module.exports = INPUT_CONST;

v3/src/input/events/PointerDownEvent.js

@@ -7,16 +7,20 @@ var PointerDownEvent = new Class({
 
     initialize:
 
-    function PointerDownEvent (pointer, gameObject)
+    function PointerDownEvent (pointer, topObject, gameObjects)
     {
         Event.call(this, 'POINTER_DOWN_EVENT');
 
         this.pointer = pointer;
-        this.gameObject = gameObject;
-        this.input = gameObject.input;
 
-        this.x = gameObject.input.localX;
-        this.y = gameObject.input.localY;
+        this.x = pointer.x;
+        this.y = pointer.y;
+
+        //  An array of all the game objects the pointer event occurred on
+        this.gameObjects = gameObjects;
+
+        //  A reference to the top-most game object in the list (based on display list order)
+        this.top = topObject;
     }
 
 });

v3/src/input/events/PointerOutEvent.js

@@ -7,16 +7,20 @@ var PointerOutEvent = new Class({
 
     initialize:
 
-    function PointerOutEvent (pointer, gameObject)
+    function PointerOutEvent (pointer, topObject, gameObjects)
     {
         Event.call(this, 'POINTER_OUT_EVENT');
 
         this.pointer = pointer;
-        this.gameObject = gameObject;
-        this.input = gameObject.input;
 
-        this.x = gameObject.input.localX;
-        this.y = gameObject.input.localY;
+        this.x = pointer.x;
+        this.y = pointer.y;
+
+        //  An array of all the game objects the pointer event occurred on
+        this.gameObjects = gameObjects;
+
+        //  A reference to the top-most game object in the list (based on display list order)
+        this.top = topObject;
     }
 
 });

v3/src/input/events/PointerOverEvent.js

@@ -7,16 +7,20 @@ var PointerOverEvent = new Class({
 
     initialize:
 
-    function PointerOverEvent (pointer, gameObject)
+    function PointerOverEvent (pointer, topObject, gameObjects)
     {
         Event.call(this, 'POINTER_OVER_EVENT');
 
         this.pointer = pointer;
-        this.gameObject = gameObject;
-        this.input = gameObject.input;
 
-        this.x = gameObject.input.localX;
-        this.y = gameObject.input.localY;
+        this.x = pointer.x;
+        this.y = pointer.y;
+
+        //  An array of all the game objects the pointer event occurred on
+        this.gameObjects = gameObjects;
+
+        //  A reference to the top-most game object in the list (based on display list order)
+        this.top = topObject;
     }
 
 });

v3/src/input/events/PointerUpEvent.js

@@ -7,16 +7,20 @@ var PointerUpEvent = new Class({
 
     initialize:
 
-    function PointerUpEvent (pointer, gameObject)
+    function PointerUpEvent (pointer, topObject, gameObjects)
     {
         Event.call(this, 'POINTER_UP_EVENT');
 
         this.pointer = pointer;
-        this.gameObject = gameObject;
-        this.input = gameObject.input;
 
-        this.x = gameObject.input.localX;
-        this.y = gameObject.input.localY;
+        this.x = pointer.x;
+        this.y = pointer.y;
+
+        //  An array of all the game objects the pointer event occurred on
+        this.gameObjects = gameObjects;
+
+        //  A reference to the top-most game object in the list (based on display list order)
+        this.top = topObject;
     }
 
 });

v3/src/input/index.js

@@ -2,6 +2,10 @@
 
 module.exports = {
 
+    //  CONSTs (makes them visible under Phaser.Input)
+    RETURN_ALL: 0,
+    RETURN_TOP: 1,
+
     Keyboard: require('./keyboard'),
     Mouse: require('./mouse')
 

v3/src/plugins/DisplayList.js

@@ -94,6 +94,7 @@ var DisplayList = new Class({
         return gameObjects.sort(this.sortIndexHandler.bind(this));
     },
 
+    //  Note that the given array is sorted in place, even though it isn't returned directly it will still be updated.
     getTopGameObject: function (gameObjects)
     {
         this.sortGameObjects(gameObjects);