2018-02-12 16:01:20 +00:00
|
|
|
/**
|
|
|
|
* @author Richard Davey <rich@photonstorm.com>
|
2020-01-15 12:07:09 +00:00
|
|
|
* @copyright 2020 Photon Storm Ltd.
|
2019-05-10 15:15:04 +00:00
|
|
|
* @license {@link https://opensource.org/licenses/MIT|MIT License}
|
2018-02-12 16:01:20 +00:00
|
|
|
*/
|
|
|
|
|
2017-11-16 19:09:07 +00:00
|
|
|
var IsInLayerBounds = require('./IsInLayerBounds');
|
|
|
|
|
2017-11-27 13:33:30 +00:00
|
|
|
/**
|
|
|
|
* Gets a tile at the given tile coordinates from the given layer.
|
|
|
|
*
|
2018-02-08 01:08:59 +00:00
|
|
|
* @function Phaser.Tilemaps.Components.GetTileAt
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2020-11-23 10:22:13 +00:00
|
|
|
* @param {number} tileX - X position to get the tile from (given in tile units, not pixels).
|
|
|
|
* @param {number} tileY - Y position to get the tile from (given in tile units, not pixels).
|
2020-11-23 10:48:24 +00:00
|
|
|
* @param {boolean} nonNull - If true getTile won't return null for empty tiles, but a Tile object with an index of -1.
|
2018-02-08 02:02:37 +00:00
|
|
|
* @param {Phaser.Tilemaps.LayerData} layer - The Tilemap Layer to act upon.
|
2020-09-02 10:54:24 +00:00
|
|
|
*
|
2020-10-15 10:09:37 +00:00
|
|
|
* @return {Phaser.Tilemaps.Tile} The tile at the given coordinates or null if no tile was found or the coordinates were invalid.
|
2017-11-27 13:33:30 +00:00
|
|
|
*/
|
2017-11-16 19:09:07 +00:00
|
|
|
var GetTileAt = function (tileX, tileY, nonNull, layer)
|
2017-11-15 19:50:56 +00:00
|
|
|
{
|
|
|
|
if (nonNull === undefined) { nonNull = false; }
|
|
|
|
|
2017-11-16 19:09:07 +00:00
|
|
|
if (IsInLayerBounds(tileX, tileY, layer))
|
2017-11-15 19:50:56 +00:00
|
|
|
{
|
2018-11-18 23:08:36 +00:00
|
|
|
var tile = layer.data[tileY][tileX] || null;
|
2020-10-15 10:09:37 +00:00
|
|
|
|
|
|
|
if (!tile)
|
2017-11-16 19:09:07 +00:00
|
|
|
{
|
|
|
|
return null;
|
|
|
|
}
|
|
|
|
else if (tile.index === -1)
|
2017-11-15 19:50:56 +00:00
|
|
|
{
|
|
|
|
return nonNull ? tile : null;
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
return tile;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
return null;
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
|
|
|
module.exports = GetTileAt;
|