Add GetTilesWithinWorldXY method to tilemap and layers

Author: mikewesthad

v3/src/gameobjects/tilemap/Tilemap.js

@@ -310,6 +310,13 @@ var Tilemap = new Class({
         return TilemapComponents.GetTilesWithin(tileX, tileY, width, height, layer);
     },
 
+    getTilesWithinWorldXY: function (worldX, worldY, width, height, camera, layer)
+    {
+        layer = this.getLayer(layer);
+        if (layer === null) { return null; }
+        return TilemapComponents.GetTilesWithinWorldXY(worldX, worldY, width, height, camera, layer);
+    },
+
     getTilesetIndex: function (name)
     {
         return this.getIndex(this.tilesets, name);

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

@@ -0,0 +1,20 @@
+var GetTilesWithin = require('./GetTilesWithin');
+var WorldToTileX = require('./WorldToTileX');
+var WorldToTileY = require('./WorldToTileY');
+
+// TODO: add options for filtering by empty, collides, interestingFace
+// { isNotEmpty, isColliding, hasInterestingFace }
+var GetTilesWithinWorldXY = function (worldX, worldY, width, height, camera, layer)
+{
+    // Top left corner of the rect, rounded down to include partial tiles
+    var xStart = WorldToTileX(worldX, true, camera, layer);
+    var yStart = WorldToTileY(worldY, true, camera, layer);
+
+    // Bottom right corner of the rect, rounded up to include partial tiles
+    var xEnd = Math.ceil(WorldToTileX(worldX + width, false, camera, layer));
+    var yEnd = Math.ceil(WorldToTileY(worldY + height, false, camera, layer));
+
+    return GetTilesWithin(xStart, yStart, xEnd - xStart, yEnd - yStart, layer);
+};
+
+module.exports = GetTilesWithinWorldXY;

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

@@ -8,6 +8,7 @@ module.exports = {
     GetTileAt: require('./GetTileAt'),
     GetTileAtWorldXY: require('./GetTileAtWorldXY'),
     GetTilesWithin: require('./GetTilesWithin'),
+    GetTilesWithinWorldXY: require('./GetTilesWithinWorldXY'),
     HasTileAt: require('./HasTileAt'),
     HasTileAtWorldXY: require('./HasTileAtWorldXY'),
     IsInLayerBounds: require('./IsInLayerBounds'),

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

@@ -108,6 +108,11 @@ var DynamicTilemapLayer = new Class({
         return TilemapComponents.GetTilesWithin(tileX, tileY, width, height, this.layer);
     },
 
+    getTilesWithinWorldXY: function (worldX, worldY, width, height, camera)
+    {
+        return TilemapComponents.GetTilesWithinWorldXY(worldX, worldY, width, height, camera, this.layer);
+    },
+
     hasTileAt: function (tileX, tileY)
     {
         return TilemapComponents.HasTileAt(tileX, tileY, this.layer);

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

@@ -249,6 +249,11 @@ var StaticTilemapLayer = new Class({
         return TilemapComponents.GetTilesWithin(tileX, tileY, width, height, this.layer);
     },
 
+    getTilesWithinWorldXY: function (worldX, worldY, width, height, camera)
+    {
+        return TilemapComponents.GetTilesWithinWorldXY(worldX, worldY, width, height, camera, this.layer);
+    },
+
     hasTileAt: function (tileX, tileY)
     {
         return TilemapComponents.HasTileAt(tileX, tileY, this.layer);