From 33258a27c0b7b46ce1a7f06b0e51366e87d38539 Mon Sep 17 00:00:00 2001
From: photonstorm <rdavey@gmail.com>
Date: Thu, 20 Jul 2017 12:50:38 +0100
Subject: [PATCH] Added DisplayList.sortGameObjects and getTopGameObject
 methods which will sort a given array of game objects into display list
 order, factoring in the z-index as well.

---
 v3/src/checksum.js            |  2 +-
 v3/src/plugins/DisplayList.js | 39 +++++++++++++++++++++++++++++++++++
 2 files changed, 40 insertions(+), 1 deletion(-)

diff --git a/v3/src/checksum.js b/v3/src/checksum.js
index 3d43c967b..0ee9fffdf 100644
--- a/v3/src/checksum.js
+++ b/v3/src/checksum.js
@@ -1,4 +1,4 @@
 var CHECKSUM = {
-build: 'c4ee8ed0-6c88-11e7-9662-435d7268dd6f'
+build: '98dca120-6d40-11e7-8ba2-2f8841c28191'
 };
 module.exports = CHECKSUM;
\ No newline at end of file
diff --git a/v3/src/plugins/DisplayList.js b/v3/src/plugins/DisplayList.js
index a778d77a1..24048fa35 100644
--- a/v3/src/plugins/DisplayList.js
+++ b/v3/src/plugins/DisplayList.js
@@ -83,6 +83,45 @@ var DisplayList = new Class({
         return this.list.indexOf(child);
     },
 
+    //  Given an array of Game Objects, sort the array and return it,
+    //  so that the objects are in index order with the lowest at the bottom.
+    sortGameObjects: function (gameObjects)
+    {
+        if (gameObjects === undefined) { gameObjects = this.list; }
+
+        this.scene.sys.depthSort();
+
+        return gameObjects.sort(this.sortIndexHandler.bind(this));
+    },
+
+    getTopGameObject: function (gameObjects)
+    {
+        this.sortGameObjects(gameObjects);
+
+        return gameObjects[gameObjects.length - 1];
+    },
+
+    //  Return the child lowest down the display list (with the smallest index)
+    sortIndexHandler: function (childA, childB)
+    {
+        //  The lower the index, the lower down the display list they are
+        var indexA = this.getIndex(childA);
+        var indexB = this.getIndex(childB);
+
+        if (indexA < indexB)
+        {
+            return -1;
+        }
+        else if (indexA > indexB)
+        {
+            return 1;
+        }
+
+        //  Technically this shouldn't happen, but if the GO wasn't part of this display list then it'll
+        //  have an index of -1, so in some cases it can
+        return 0;
+    },
+
     /**
     * Gets the first item from the set based on the property strictly equaling the value given.
     * Returns null if not found.