Creates a new and empty Tilemap Layer. The currently selected layer in the map is set to this new layer.
Prior to v3.50.0 this method was called createBlankDynamicLayer.
| name | type | arguments | description |
|---|---|---|---|
| name | string |
The name of this layer. Must be unique within the map. |
|
| tileset | string | Array.<string> | Phaser.Tilemaps.Tileset | Array.<Phaser.Tilemaps.Tileset> |
The tileset, or an array of tilesets, used to render this layer. Can be a string or a Tileset object. |
|
| x | number | <optional> |
The world x position where the top left of this layer will be placed. |
| y | number | <optional> |
The world y position where the top left of this layer will be placed. |
| width | number | <optional> |
The width of the layer in tiles. If not specified, it will default to the map's width. |
| height | number | <optional> |
The height of the layer in tiles. If not specified, it will default to the map's height. |
| tileWidth | number | <optional> |
The width of the tiles the layer uses for calculations. If not specified, it will default to the map's tileWidth. |
| tileHeight | number | <optional> |
The height of the tiles the layer uses for calculations. If not specified, it will default to the map's tileHeight. |
Returns the new layer that was created, or null if it failed.