Updated tilemap jsdocs

This commit is contained in:
jestarray 2019-01-23 11:30:08 -08:00
parent 901df292d5
commit 4b0464a632
3 changed files with 53 additions and 26 deletions

View file

@ -717,8 +717,8 @@ var Tilemap = new Class({
* *
* @param {(integer|string)} layerID - The layer array index value, or if a string is given, the layer name from Tiled. * @param {(integer|string)} layerID - The layer array index value, or if a string is given, the layer name from Tiled.
* @param {(string|string[]|Phaser.Tilemaps.Tileset|Phaser.Tilemaps.Tileset[])} tileset - The tileset, or an array of tilesets, used to render this layer. Can be a string or a Tileset object. * @param {(string|string[]|Phaser.Tilemaps.Tileset|Phaser.Tilemaps.Tileset[])} tileset - The tileset, or an array of tilesets, used to render this layer. Can be a string or a Tileset object.
* @param {number} x - The x position to place the layer in the world. If not specified, it will default to the layer offset from Tiled or 0. * @param {number} [x=0] - The x position to place the layer in the world. If not specified, it will default to the layer offset from Tiled or 0.
* @param {number} y - The y position to place the layer in the world. If not specified, it will default to the layer offset from Tiled or 0. * @param {number} [y=0] - The y position to place the layer in the world. If not specified, it will default to the layer offset from Tiled or 0.
* *
* @return {?Phaser.Tilemaps.StaticTilemapLayer} Returns the new layer was created, or null if it failed. * @return {?Phaser.Tilemaps.StaticTilemapLayer} Returns the new layer was created, or null if it failed.
*/ */

View file

@ -29,7 +29,7 @@ var LayerData = new Class({
if (config === undefined) { config = {}; } if (config === undefined) { config = {}; }
/** /**
* [description] * The name of the layer(specified in Tiled)
* *
* @name Phaser.Tilemaps.LayerData#name * @name Phaser.Tilemaps.LayerData#name
* @type {string} * @type {string}
@ -38,7 +38,7 @@ var LayerData = new Class({
this.name = GetFastValue(config, 'name', 'layer'); this.name = GetFastValue(config, 'name', 'layer');
/** /**
* [description] * The x offset of where to draw from the top left
* *
* @name Phaser.Tilemaps.LayerData#x * @name Phaser.Tilemaps.LayerData#x
* @type {number} * @type {number}
@ -47,7 +47,7 @@ var LayerData = new Class({
this.x = GetFastValue(config, 'x', 0); this.x = GetFastValue(config, 'x', 0);
/** /**
* [description] * The y offset of where to draw from the top left
* *
* @name Phaser.Tilemaps.LayerData#y * @name Phaser.Tilemaps.LayerData#y
* @type {number} * @type {number}
@ -56,7 +56,7 @@ var LayerData = new Class({
this.y = GetFastValue(config, 'y', 0); this.y = GetFastValue(config, 'y', 0);
/** /**
* [description] * The width in tile units of the layer.
* *
* @name Phaser.Tilemaps.LayerData#width * @name Phaser.Tilemaps.LayerData#width
* @type {number} * @type {number}
@ -65,7 +65,7 @@ var LayerData = new Class({
this.width = GetFastValue(config, 'width', 0); this.width = GetFastValue(config, 'width', 0);
/** /**
* [description] * The height in tiles units of the layer.
* *
* @name Phaser.Tilemaps.LayerData#height * @name Phaser.Tilemaps.LayerData#height
* @type {number} * @type {number}
@ -74,7 +74,7 @@ var LayerData = new Class({
this.height = GetFastValue(config, 'height', 0); this.height = GetFastValue(config, 'height', 0);
/** /**
* [description] * The pixel width of the tiles.
* *
* @name Phaser.Tilemaps.LayerData#tileWidth * @name Phaser.Tilemaps.LayerData#tileWidth
* @type {number} * @type {number}
@ -83,7 +83,7 @@ var LayerData = new Class({
this.tileWidth = GetFastValue(config, 'tileWidth', 0); this.tileWidth = GetFastValue(config, 'tileWidth', 0);
/** /**
* [description] * The pixel height of the tiles.
* *
* @name Phaser.Tilemaps.LayerData#tileHeight * @name Phaser.Tilemaps.LayerData#tileHeight
* @type {number} * @type {number}
@ -110,7 +110,7 @@ var LayerData = new Class({
this.baseTileHeight = GetFastValue(config, 'baseTileHeight', this.tileHeight); this.baseTileHeight = GetFastValue(config, 'baseTileHeight', this.tileHeight);
/** /**
* [description] * The width in pixels of the entire layer.
* *
* @name Phaser.Tilemaps.LayerData#widthInPixels * @name Phaser.Tilemaps.LayerData#widthInPixels
* @type {number} * @type {number}
@ -119,7 +119,7 @@ var LayerData = new Class({
this.widthInPixels = GetFastValue(config, 'widthInPixels', this.width * this.baseTileWidth); this.widthInPixels = GetFastValue(config, 'widthInPixels', this.width * this.baseTileWidth);
/** /**
* [description] * The height in pixels of the entire layer.
* *
* @name Phaser.Tilemaps.LayerData#heightInPixels * @name Phaser.Tilemaps.LayerData#heightInPixels
* @type {number} * @type {number}
@ -146,7 +146,7 @@ var LayerData = new Class({
this.visible = GetFastValue(config, 'visible', true); this.visible = GetFastValue(config, 'visible', true);
/** /**
* [description] * Layer specific properties (can be specified in Tiled)
* *
* @name Phaser.Tilemaps.LayerData#properties * @name Phaser.Tilemaps.LayerData#properties
* @type {object} * @type {object}
@ -191,10 +191,10 @@ var LayerData = new Class({
this.bodies = GetFastValue(config, 'bodies', []); this.bodies = GetFastValue(config, 'bodies', []);
/** /**
* [description] * An array of the tile indexes
* *
* @name Phaser.Tilemaps.LayerData#data * @name Phaser.Tilemaps.LayerData#data
* @type {array} * @type {(number[])}
* @since 3.0.0 * @since 3.0.0
*/ */
this.data = GetFastValue(config, 'data', []); this.data = GetFastValue(config, 'data', []);

View file

@ -6,6 +6,33 @@
var Class = require('../../utils/Class'); var Class = require('../../utils/Class');
var GetFastValue = require('../../utils/object/GetFastValue'); var GetFastValue = require('../../utils/object/GetFastValue');
var LayerData = require('./LayerData');
var ObjectLayer = require("./ObjectLayer");
var Tileset = require('../Tileset');
/**
* @typedef {object} MapDataConfig
* @property {string} [name] - The key in the Phaser cache that corresponds to the loaded tilemap data.
* @property {number} [width=0] - The width of the entire tilemap.
* @property {number} [height=0] - The height of the entire tilemap.
* @property {number} [tileWidth=0] - The width of the tiles.
* @property {number} [tileHeight=0] - The height of the tiles.
* @property {number} [widthInPixels] - The width in pixels of the entire tilemap.
* @property {number} [heightInPixels] - The height in pixels of the entire tilemap.
* @property {number} [widthInPixels=0] - The pixel size of the entire tilemap.
* @property {integer} [format] - [description]
* @property {string} [orientation] - The orientation of the map data (i.e. orthogonal, isometric, hexagonal), default 'orthogonal'.
* @property {string} [renderOrder] - Determines the draw order of tilemap. Default is right-down.
* @property {number} [version] - The version of Tiled the map uses.
* @property {number} [properties] - Map specific properties (can be specified in Tiled).
* @property {LayerData[]} [layers] - The layers of the tilemap.
* @property {array} [images] - An array with all the layers configured to the MapData.
* @property {object} [objects] - An array of Tiled Image Layers.
* @property {object} [collision] - An object of Tiled Object Layers.
* @property {Tileset[]} [tilesets] - The tilesets the map uses.
* @property {array} [imageCollections] - The collection of images the map uses(specified in Tiled).
* @property {array} [tiles] - [description]
*/
/** /**
* @classdesc * @classdesc
@ -18,7 +45,7 @@ var GetFastValue = require('../../utils/object/GetFastValue');
* @constructor * @constructor
* @since 3.0.0 * @since 3.0.0
* *
* @param {object} [config] - [description] * @param {MapDataConfig} [config] - [description]
*/ */
var MapData = new Class({ var MapData = new Class({
@ -29,7 +56,7 @@ var MapData = new Class({
if (config === undefined) { config = {}; } if (config === undefined) { config = {}; }
/** /**
* [description] * The key in the Phaser cache that corresponds to the loaded tilemap data.
* *
* @name Phaser.Tilemaps.MapData#name * @name Phaser.Tilemaps.MapData#name
* @type {string} * @type {string}
@ -38,7 +65,7 @@ var MapData = new Class({
this.name = GetFastValue(config, 'name', 'map'); this.name = GetFastValue(config, 'name', 'map');
/** /**
* [description] * The width of the entire tilemap.
* *
* @name Phaser.Tilemaps.MapData#width * @name Phaser.Tilemaps.MapData#width
* @type {number} * @type {number}
@ -47,7 +74,7 @@ var MapData = new Class({
this.width = GetFastValue(config, 'width', 0); this.width = GetFastValue(config, 'width', 0);
/** /**
* [description] * The height of the entire tilemap.
* *
* @name Phaser.Tilemaps.MapData#height * @name Phaser.Tilemaps.MapData#height
* @type {number} * @type {number}
@ -56,7 +83,7 @@ var MapData = new Class({
this.height = GetFastValue(config, 'height', 0); this.height = GetFastValue(config, 'height', 0);
/** /**
* [description] * The width of the tiles.
* *
* @name Phaser.Tilemaps.MapData#tileWidth * @name Phaser.Tilemaps.MapData#tileWidth
* @type {number} * @type {number}
@ -65,7 +92,7 @@ var MapData = new Class({
this.tileWidth = GetFastValue(config, 'tileWidth', 0); this.tileWidth = GetFastValue(config, 'tileWidth', 0);
/** /**
* [description] * The height of the tiles.
* *
* @name Phaser.Tilemaps.MapData#tileHeight * @name Phaser.Tilemaps.MapData#tileHeight
* @type {number} * @type {number}
@ -74,7 +101,7 @@ var MapData = new Class({
this.tileHeight = GetFastValue(config, 'tileHeight', 0); this.tileHeight = GetFastValue(config, 'tileHeight', 0);
/** /**
* [description] * The width in pixels of the entire tilemap.
* *
* @name Phaser.Tilemaps.MapData#widthInPixels * @name Phaser.Tilemaps.MapData#widthInPixels
* @type {number} * @type {number}
@ -83,7 +110,7 @@ var MapData = new Class({
this.widthInPixels = GetFastValue(config, 'widthInPixels', this.width * this.tileWidth); this.widthInPixels = GetFastValue(config, 'widthInPixels', this.width * this.tileWidth);
/** /**
* [description] * The height in pixels of the entire tilemap.
* *
* @name Phaser.Tilemaps.MapData#heightInPixels * @name Phaser.Tilemaps.MapData#heightInPixels
* @type {number} * @type {number}
@ -145,7 +172,7 @@ var MapData = new Class({
* An array with all the layers configured to the MapData. * An array with all the layers configured to the MapData.
* *
* @name Phaser.Tilemaps.MapData#layers * @name Phaser.Tilemaps.MapData#layers
* @type {array} * @type {Array.<LayerData|ObjectLayer>}
* @since 3.0.0 * @since 3.0.0
*/ */
this.layers = GetFastValue(config, 'layers', []); this.layers = GetFastValue(config, 'layers', []);
@ -169,7 +196,7 @@ var MapData = new Class({
this.objects = GetFastValue(config, 'objects', {}); this.objects = GetFastValue(config, 'objects', {});
/** /**
* An object of collision data. Must be created as physics object or will return undefined. * An object of collision data. Must be created as physics object or will return undefined.
* *
* @name Phaser.Tilemaps.MapData#collision * @name Phaser.Tilemaps.MapData#collision
* @type {object} * @type {object}
@ -181,13 +208,13 @@ var MapData = new Class({
* An array of Tilesets. * An array of Tilesets.
* *
* @name Phaser.Tilemaps.MapData#tilesets * @name Phaser.Tilemaps.MapData#tilesets
* @type {array} * @type {Tileset[]}
* @since 3.0.0 * @since 3.0.0
*/ */
this.tilesets = GetFastValue(config, 'tilesets', []); this.tilesets = GetFastValue(config, 'tilesets', []);
/** /**
* [description] * The collection of images the map uses(specified in Tiled)
* *
* @name Phaser.Tilemaps.MapData#imageCollections * @name Phaser.Tilemaps.MapData#imageCollections
* @type {array} * @type {array}