phaser/src/tilemaps/parsers/Parse2DArray.js

87 lines
2.7 KiB
JavaScript
Raw Normal View History

2018-02-12 16:01:20 +00:00
/**
* @author Richard Davey <rich@photonstorm.com>
2022-02-28 14:29:51 +00:00
* @copyright 2022 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
*/
var Formats = require('../Formats');
2018-02-09 18:44:16 +00:00
var LayerData = require('../mapdata/LayerData');
var MapData = require('../mapdata/MapData');
var Tile = require('../Tile');
2017-11-29 20:02:45 +00:00
/**
* Parses a 2D array of tile indexes into a new MapData object with a single layer.
*
2018-02-10 01:50:48 +00:00
* @function Phaser.Tilemaps.Parsers.Parse2DArray
* @since 3.0.0
*
2017-11-29 20:02:45 +00:00
* @param {string} name - The name of the tilemap, used to set the name on the MapData.
2020-11-23 10:24:10 +00:00
* @param {number[][]} data - 2D array, CSV string or Tiled JSON object.
2020-11-23 10:22:13 +00:00
* @param {number} tileWidth - The width of a tile in pixels.
* @param {number} tileHeight - The height of a tile in pixels.
2017-11-29 20:02:45 +00:00
* @param {boolean} insertNull - Controls how empty tiles, tiles with an index of -1, in the map
* data are handled. If `true`, empty locations will get a value of `null`. If `false`, empty
* location will get a Tile object with an index of -1. If you've a large sparsely populated map and
* the tile data doesn't need to change then setting this value to `true` will help with memory
* consumption. However if your map is small or you need to update the tiles dynamically, then leave
* the default value set.
*
2020-04-27 15:13:40 +00:00
* @return {Phaser.Tilemaps.MapData} The MapData object.
2017-11-29 20:02:45 +00:00
*/
var Parse2DArray = function (name, data, tileWidth, tileHeight, insertNull)
{
var layerData = new LayerData({
tileWidth: tileWidth,
tileHeight: tileHeight
});
2022-02-28 14:29:51 +00:00
var mapData = new MapData({
2017-11-29 20:02:45 +00:00
name: name,
tileWidth: tileWidth,
tileHeight: tileHeight,
2018-01-18 00:30:22 +00:00
format: Formats.ARRAY_2D,
layers: [ layerData ]
});
var tiles = [];
var height = data.length;
var width = 0;
for (var y = 0; y < data.length; y++)
{
tiles[y] = [];
var row = data[y];
for (var x = 0; x < row.length; x++)
{
var tileIndex = parseInt(row[x], 10);
if (isNaN(tileIndex) || tileIndex === -1)
{
tiles[y][x] = insertNull
? null
: new Tile(layerData, -1, x, y, tileWidth, tileHeight);
}
else
{
tiles[y][x] = new Tile(layerData, tileIndex, x, y, tileWidth, tileHeight);
}
}
if (width === 0)
{
width = row.length;
}
}
mapData.width = layerData.width = width;
mapData.height = layerData.height = height;
mapData.widthInPixels = layerData.widthInPixels = width * tileWidth;
mapData.heightInPixels = layerData.heightInPixels = height * tileHeight;
layerData.data = tiles;
return mapData;
};
module.exports = Parse2DArray;