Namespace: Parsers

Phaser.Tilemaps. Parsers

Namespaces

Impact
Tiled

Methods


<static> Parse(name, mapFormat, data, tileWidth, tileHeight, insertNull)

Parses raw data of a given Tilemap format into a new MapData object. If no recognized data format is found, returns null. When loading from CSV or a 2D array, you should specify the tileWidth & tileHeight. When parsing from a map from Tiled, the tileWidth & tileHeight will be pulled from the map data.

Parameters:
Name Type Description
name string

The name of the tilemap, used to set the name on the MapData.

mapFormat integer

See ../Formats.js.

data Array.<Array.<integer>> | string | object

2D array, CSV string or Tiled JSON object.

tileWidth integer

The width of a tile in pixels. Required for 2D array and CSV, but ignored for Tiled JSON.

tileHeight integer

The height of a tile in pixels. Required for 2D array and CSV, but ignored for Tiled JSON.

insertNull boolean

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.

Since: 3.0.0
Source: src/tilemaps/parsers/Parse.js (Line 13)
Returns:

The created MapData object.

Type
Phaser.Tilemaps.MapData

<static> Parse2DArray(name, data, tileWidth, tileHeight, insertNull)

Parses a 2D array of tile indexes into a new MapData object with a single layer.

Parameters:
Name Type Description
name string

The name of the tilemap, used to set the name on the MapData.

data Array.<Array.<integer>>

2D array, CSV string or Tiled JSON object.

tileWidth integer

The width of a tile in pixels.

tileHeight integer

The height of a tile in pixels.

insertNull boolean

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.

Since: 3.0.0
Source: src/tilemaps/parsers/Parse2DArray.js (Line 12)
Returns:

[description]

Type
Phaser.Tilemaps.MapData

<static> ParseCSV(name, data, tileWidth, tileHeight, insertNull)

Parses a CSV string of tile indexes into a new MapData object with a single layer.

Parameters:
Name Type Description
name string

The name of the tilemap, used to set the name on the MapData.

data string

CSV string of tile indexes.

tileWidth integer

The width of a tile in pixels.

tileHeight integer

The height of a tile in pixels.

insertNull boolean

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.

Since: 3.0.0
Source: src/tilemaps/parsers/ParseCSV.js (Line 10)
Returns:

The resulting MapData object.

Type
Phaser.Tilemaps.MapData