Add methods for looping over & accessing groups of tiles to map & layers

Author: mikewesthad

v3/src/gameobjects/tilemap/Tilemap.js

@@ -127,6 +127,14 @@ var Tilemap = new Class({
         return layer;
     },
 
+    forEachTile: function (callback, context, tileX, tileY, width, height, layer)
+    {
+        layer = this.getLayer(layer);
+        if (layer === null) { return; }
+
+        TilemapComponents.ForEachTile(callback, context, tileX, tileY, width, height, layer);
+    },
+
     getIndex: function (location, name)
     {
         for (var i = 0; i < location.length; i++)
@@ -182,6 +190,14 @@ var Tilemap = new Class({
         return TilemapComponents.GetTileAt(tileX, tileY, layer, nonNull);
     },
 
+    getTilesWithin: function (tileX, tileY, width, height, layer)
+    {
+        layer = this.getLayer(layer);
+        if (layer === null) { return null; }
+
+        return TilemapComponents.GetTilesWithin(tileX, tileY, width, height, layer);
+    },
+
     getTilesetIndex: function (name)
     {
         return this.getIndex(this.tilesets, name);

v3/src/gameobjects/tilemap/components/ForEachTile.js

@@ -0,0 +1,9 @@
+var GetTilesWithin = require("./GetTilesWithin");
+
+var ForEachTile = function (callback, context, tileX, tileY, width, height, layer)
+{
+    var tiles = GetTilesWithin(tileX, tileY, width, height, layer);
+    tiles.forEach(callback, context);
+};
+
+module.exports = ForEachTile;

v3/src/gameobjects/tilemap/components/index.js

@@ -1,6 +1,8 @@
 module.exports = {
 
+    ForEachTile: require('./ForEachTile'),
     GetTileAt: require('./GetTileAt'),
-    HasTileAt: require('./HasTileAt')
+    HasTileAt: require('./HasTileAt'),
+    GetTilesWithin: require('./GetTilesWithin')
 
 };

v3/src/gameobjects/tilemap/dynamiclayer/DynamicTilemapLayer.js

@@ -96,11 +96,21 @@ var DynamicTilemapLayer = new Class({
         return culledTiles;
     },
 
+    forEachTile: function (callback, context, tileX, tileY, width, height)
+    {
+        return TilemapComponents.ForEachTile(callback, context, tileX, tileY, width, height, this.layer);
+    },
+
     getTileAt: function (tileX, tileY, nonNull)
     {
         return TilemapComponents.GetTileAt(tileX, tileY, this.layer, nonNull);
     },
 
+    getTilesWithin: function (tileX, tileY, width, height)
+    {
+        return TilemapComponents.GetTilesWithin(tileX, tileY, width, height, this.layer);
+    },
+
     hasTileAt: function (tileX, tileY)
     {
         return TilemapComponents.HasTileAt(tileX, tileY, this.layer);

v3/src/gameobjects/tilemap/staticlayer/StaticTilemapLayer.js

@@ -269,11 +269,21 @@ var StaticTilemapLayer = new Class({
         }
     },
 
+    forEachTile: function (callback, context, tileX, tileY, width, height)
+    {
+        return TilemapComponents.ForEachTile(callback, context, tileX, tileY, width, height, this.layer);
+    },
+
     getTileAt: function (tileX, tileY, nonNull)
     {
         return TilemapComponents.GetTileAt(tileX, tileY, this.layer, nonNull);
     },
 
+    getTilesWithin: function (tileX, tileY, width, height)
+    {
+        return TilemapComponents.GetTilesWithin(tileX, tileY, width, height, this.layer);
+    },
+
     hasTileAt: function (tileX, tileY)
     {
         return TilemapComponents.HasTileAt(tileX, tileY, this.layer);