Added GetFirst Action and bound to Layer.

Author: photonstorm

v3/src/actions/GetFirst.js

@@ -0,0 +1,32 @@
+//  compare = Object:
+//  {
+//      scaleX: 0.5,
+//      scaleY: 1
+//  }
+
+var GetFirst = function (items, compare, index)
+{
+    for (var i = index; i < items.length; i++)
+    {
+        var item = items[i];
+
+        var match = true;
+
+        for (var property in compare)
+        {
+            if (item[property] !== compare[property])
+            {
+                match = false;
+            }
+        }
+
+        if (match)
+        {
+            return item;
+        }
+    }
+
+    return null;
+};
+
+module.exports = GetFirst;

v3/src/actions/index.js

@@ -4,6 +4,7 @@ module.exports = {
 
     Angle: require('./Angle'),
     Call: require('./Call'),
+    GetFirst: require('./GetFirst'),
     GridAlign: require('./GridAlign'),
     IncAlpha: require('./IncAlpha'),
     IncX: require('./IncX'),

v3/src/gameobjects/layer/Layer.js

@@ -175,6 +175,13 @@ var Layer = new Class({
         return this.children.size;
     },
 
+    getFirst: function (compare, index)
+    {
+        if (index === undefined) { index = 0; }
+
+        return Actions.GetFirst(this.children.entries, compare, index);
+    },
+
     destroy: function ()
     {
         this.children.clear();