Namespace: Parsers

Phaser.Tilemaps. Parsers

Namespaces

Impact
Tiled

Methods


<static> FromOrientationString( [orientation])

Get the Tilemap orientation from the given string.

Parameters:
Name Type Argument Description
orientation string <optional>

The orientation type as a string.

Since: 3.50.0
Source: src/tilemaps/parsers/FromOrientationString.js (Line 9)
Returns:

The Tilemap Orientation type.

Type
Phaser.Tilemaps.OrientationType

<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 number

See ../Formats.js.

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

2D array, CSV string or Tiled JSON object.

tileWidth number

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

tileHeight number

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.<number>>

2D array, CSV string or Tiled JSON object.

tileWidth number

The width of a tile in pixels.

tileHeight number

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:

The MapData object.

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 number

The width of a tile in pixels.

tileHeight number

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