diff --git a/src/gameobjects/text/GetTextSize.js b/src/gameobjects/text/GetTextSize.js index 183cca518..11fe7efdc 100644 --- a/src/gameobjects/text/GetTextSize.js +++ b/src/gameobjects/text/GetTextSize.js @@ -1,3 +1,6 @@ +/** + * Returns an object containing dimensions of the Text object. + */ var GetTextSize = function (text, size, lines) { diff --git a/src/gameobjects/text/MeasureText.js b/src/gameobjects/text/MeasureText.js index 5818f29d0..c6bab8b54 100644 --- a/src/gameobjects/text/MeasureText.js +++ b/src/gameobjects/text/MeasureText.js @@ -1,8 +1,9 @@ var CanvasPool = require('../../display/canvas/CanvasPool'); /** -* Calculates the ascent, descent and fontSize of a given font style. -*/ + * Calculates the ascent, descent and fontSize of a given font style. + */ + var MeasureText = function (textStyle) { // @property {HTMLCanvasElement} canvas - The canvas element that the text is rendered. diff --git a/src/gameobjects/text/TextStyle.js b/src/gameobjects/text/TextStyle.js index 290b64dd5..ea68b6bf3 100644 --- a/src/gameobjects/text/TextStyle.js +++ b/src/gameobjects/text/TextStyle.js @@ -21,8 +21,8 @@ var propertyMap = { shadowFill: [ 'shadow.fill', false ], align: [ 'align', 'left' ], maxLines: [ 'maxLines', 0 ], - fixedWidth: [ 'fixedWidth', false ], - fixedHeight: [ 'fixedHeight', false ], + fixedWidth: [ 'fixedWidth', 0 ], + fixedHeight: [ 'fixedHeight', 0 ], rtl: [ 'rtl', false ], testString: [ 'testString', '|MÉqgy' ], wordWrapWidth: [ 'wordWrap.width', null ], @@ -31,34 +31,228 @@ var propertyMap = { wordWrapUseAdvanced: [ 'wordWrap.useAdvancedWrap', false ] }; +/** + * [description] + * + * @class TextStyle + * @memberOf Phaser.GameObjects.Components + * @constructor + * @since 3.0.0 + * + * @param {Phaser.GameObjects.Text} text - The Text object that this TextStyle is styling. + * @param {object} style - [description] + */ var TextStyle = new Class({ initialize: function TextStyle (text, style) { + /** + * The Text object that this TextStyle is styling. + * + * @name Phaser.GameObjects.Components.TextStyle#parent + * @type {Phaser.GameObjects.Text} + * @since 3.0.0 + */ this.parent = text; + /** + * [description] + * + * @name Phaser.GameObjects.Components.TextStyle#fontFamily + * @type {string} + * @default 'Courier' + * @since 3.0.0 + */ this.fontFamily; + + /** + * [description] + * + * @name Phaser.GameObjects.Components.TextStyle#fontSize + * @type {string} + * @default '16px' + * @since 3.0.0 + */ this.fontSize; + + /** + * [description] + * + * @name Phaser.GameObjects.Components.TextStyle#fontStyle + * @type {string} + * @since 3.0.0 + */ this.fontStyle; + + /** + * [description] + * + * @name Phaser.GameObjects.Components.TextStyle#backgroundColor + * @type {string} + * @since 3.0.0 + */ this.backgroundColor; + + /** + * [description] + * + * @name Phaser.GameObjects.Components.TextStyle#color + * @type {string} + * @default '#fff' + * @since 3.0.0 + */ this.color; + + /** + * [description] + * + * @name Phaser.GameObjects.Components.TextStyle#stroke + * @type {string} + * @default '#fff' + * @since 3.0.0 + */ this.stroke; + + /** + * [description] + * + * @name Phaser.GameObjects.Components.TextStyle#strokeThickness + * @type {number} + * @default 0 + * @since 3.0.0 + */ this.strokeThickness; + + /** + * [description] + * + * @name Phaser.GameObjects.Components.TextStyle#shadowOffsetX + * @type {number} + * @default 0 + * @since 3.0.0 + */ this.shadowOffsetX; + + /** + * [description] + * + * @name Phaser.GameObjects.Components.TextStyle#shadowOffsetY + * @type {number} + * @default 0 + * @since 3.0.0 + */ this.shadowOffsetY; + + /** + * [description] + * + * @name Phaser.GameObjects.Components.TextStyle#shadowColor + * @type {string} + * @default '#000' + * @since 3.0.0 + */ this.shadowColor; + + /** + * [description] + * + * @name Phaser.GameObjects.Components.TextStyle#shadowBlur + * @type {number} + * @default 0 + * @since 3.0.0 + */ this.shadowBlur; + + /** + * [description] + * + * @name Phaser.GameObjects.Components.TextStyle#shadowStroke + * @type {boolean} + * @default false + * @since 3.0.0 + */ this.shadowStroke; + + /** + * [description] + * + * @name Phaser.GameObjects.Components.TextStyle#shadowFill + * @type {boolean} + * @default false + * @since 3.0.0 + */ this.shadowFill; + + /** + * [description] + * + * @name Phaser.GameObjects.Components.TextStyle#align + * @type {string} + * @default 'left' + * @since 3.0.0 + */ this.align; + + /** + * [description] + * + * @name Phaser.GameObjects.Components.TextStyle#maxLines + * @type {integer} + * @default 0 + * @since 3.0.0 + */ this.maxLines; + + /** + * [description] + * + * @name Phaser.GameObjects.Components.TextStyle#fixedWidth + * @type {number} + * @default 0 + * @since 3.0.0 + */ this.fixedWidth; + + /** + * [description] + * + * @name Phaser.GameObjects.Components.TextStyle#fixedHeight + * @type {number} + * @default 0 + * @since 3.0.0 + */ this.fixedHeight; + + /** + * [description] + * + * @name Phaser.GameObjects.Components.TextStyle#rtl + * @type {boolean} + * @default false + * @since 3.0.0 + */ this.rtl; + + /** + * [description] + * + * @name Phaser.GameObjects.Components.TextStyle#testString + * @type {string} + * @default '|MÉqgy' + * @since 3.0.0 + */ this.testString; + /** + * [description] + * + * @name Phaser.GameObjects.Components.TextStyle#_font + * @type {string} + * @private + * @since 3.0.0 + */ this._font; // Set to defaults + user style @@ -82,6 +276,17 @@ var TextStyle = new Class({ } }, + /** + * [description] + * + * @method Phaser.GameObjects.Components.TextStyle#setStyle + * @since 3.0.0 + * + * @param {[type]} style - [description] + * @param {[type]} updateText - [description] + * + * @return {Phaser.GameObjects.Components.TextStyle This TextStyle component. + */ setStyle: function (style, updateText) { if (updateText === undefined) { updateText = true; } @@ -133,11 +338,29 @@ var TextStyle = new Class({ return this; }, + /** + * [description] + * + * @method Phaser.GameObjects.Components.TextStyle#syncFont + * @since 3.0.0 + * + * @param {[type]} canvas - [description] + * @param {[type]} context - [description] + */ syncFont: function (canvas, context) { context.font = this._font; }, + /** + * [description] + * + * @method Phaser.GameObjects.Components.TextStyle#syncStyle + * @since 3.0.0 + * + * @param {[type]} canvas - [description] + * @param {[type]} context - [description] + */ syncStyle: function (canvas, context) { context.textBaseline = 'alphabetic'; @@ -150,6 +373,15 @@ var TextStyle = new Class({ context.lineJoin = 'round'; }, + /** + * [description] + * + * @method Phaser.GameObjects.Components.TextStyle#syncShadow + * @since 3.0.0 + * + * @param {[type]} context - [description] + * @param {[type]} enabled - [description] + */ syncShadow: function (context, enabled) { if (enabled) @@ -168,6 +400,16 @@ var TextStyle = new Class({ } }, + /** + * [description] + * + * @method Phaser.GameObjects.Components.TextStyle#update + * @since 3.0.0 + * + * @param {boolean} recalculateMetrics - [description] + * + * @return {Phaser.GameObjects.Text} The parent Text object. + */ update: function (recalculateMetrics) { if (recalculateMetrics) @@ -180,7 +422,16 @@ var TextStyle = new Class({ return this.parent.updateText(); }, - // Allows you to set them all in a single object + /** + * [description] + * + * @method Phaser.GameObjects.Components.TextStyle#setFont + * @since 3.0.0 + * + * @param {string|object} font - [description] + * + * @return {Phaser.GameObjects.Text} The parent Text object. + */ setFont: function (font) { if (typeof font === 'string') @@ -199,6 +450,16 @@ var TextStyle = new Class({ return this.update(true); }, + /** + * [description] + * + * @method Phaser.GameObjects.Components.TextStyle#setFontFamily + * @since 3.0.0 + * + * @param {[type]} family - [description] + * + * @return {Phaser.GameObjects.Text} The parent Text object. + */ setFontFamily: function (family) { this.fontFamily = family; @@ -206,6 +467,16 @@ var TextStyle = new Class({ return this.update(true); }, + /** + * [description] + * + * @method Phaser.GameObjects.Components.TextStyle#setFontStyle + * @since 3.0.0 + * + * @param {[type]} style - [description] + * + * @return {Phaser.GameObjects.Text} The parent Text object. + */ setFontStyle: function (style) { this.fontStyle = style; @@ -213,6 +484,16 @@ var TextStyle = new Class({ return this.update(true); }, + /** + * [description] + * + * @method Phaser.GameObjects.Components.TextStyle#setFontSize + * @since 3.0.0 + * + * @param {[type]} size - [description] + * + * @return {Phaser.GameObjects.Text} The parent Text object. + */ setFontSize: function (size) { if (typeof size === 'number') @@ -225,6 +506,16 @@ var TextStyle = new Class({ return this.update(true); }, + /** + * [description] + * + * @method Phaser.GameObjects.Components.TextStyle#setTestString + * @since 3.0.0 + * + * @param {[type]} string - [description] + * + * @return {Phaser.GameObjects.Text} The parent Text object. + */ setTestString: function (string) { this.testString = string; @@ -232,6 +523,17 @@ var TextStyle = new Class({ return this.update(true); }, + /** + * [description] + * + * @method Phaser.GameObjects.Components.TextStyle#setFixedSize + * @since 3.0.0 + * + * @param {number} width - [description] + * @param {number} height - [description] + * + * @return {Phaser.GameObjects.Text} The parent Text object. + */ setFixedSize: function (width, height) { this.fixedWidth = width; @@ -250,6 +552,16 @@ var TextStyle = new Class({ return this.update(false); }, + /** + * [description] + * + * @method Phaser.GameObjects.Components.TextStyle#setBackgroundColor + * @since 3.0.0 + * + * @param {string color - [description] + * + * @return {Phaser.GameObjects.Text} The parent Text object. + */ setBackgroundColor: function (color) { this.backgroundColor = color; @@ -257,6 +569,16 @@ var TextStyle = new Class({ return this.update(false); }, + /** + * [description] + * + * @method Phaser.GameObjects.Components.TextStyle#setFill + * @since 3.0.0 + * + * @param {string} color - [description] + * + * @return {Phaser.GameObjects.Text} The parent Text object. + */ setFill: function (color) { this.color = color; @@ -264,6 +586,16 @@ var TextStyle = new Class({ return this.update(false); }, + /** + * [description] + * + * @method Phaser.GameObjects.Components.TextStyle#setColor + * @since 3.0.0 + * + * @param {string} color - [description] + * + * @return {Phaser.GameObjects.Text} The parent Text object. + */ setColor: function (color) { this.color = color; @@ -271,6 +603,17 @@ var TextStyle = new Class({ return this.update(false); }, + /** + * [description] + * + * @method Phaser.GameObjects.Components.TextStyle#setStroke + * @since 3.0.0 + * + * @param {string} color - [description] + * @param {number} thickness - [description] + * + * @return {Phaser.GameObjects.Text} The parent Text object. + */ setStroke: function (color, thickness) { if (color === undefined) @@ -289,6 +632,21 @@ var TextStyle = new Class({ return this.update(true); }, + /** + * [description] + * + * @method Phaser.GameObjects.Components.TextStyle#setShadow + * @since 3.0.0 + * + * @param {number} [x=0] - [description] + * @param {number} [y=0] - [description] + * @param {string} [color='#000'] - [description] + * @param {number} [blur=0] - [description] + * @param {boolean} [shadowStroke=false] - [description] + * @param {boolean} [shadowFill=true] - [description] + * + * @return {Phaser.GameObjects.Text} The parent Text object. + */ setShadow: function (x, y, color, blur, shadowStroke, shadowFill) { if (x === undefined) { x = 0; } @@ -308,6 +666,17 @@ var TextStyle = new Class({ return this.update(false); }, + /** + * [description] + * + * @method Phaser.GameObjects.Components.TextStyle#setShadowOffset + * @since 3.0.0 + * + * @param {number} [x=0] - [description] + * @param {number} [y=0] - [description] + * + * @return {Phaser.GameObjects.Text} The parent Text object. + */ setShadowOffset: function (x, y) { if (x === undefined) { x = 0; } @@ -319,6 +688,16 @@ var TextStyle = new Class({ return this.update(false); }, + /** + * [description] + * + * @method Phaser.GameObjects.Components.TextStyle#setShadowColor + * @since 3.0.0 + * + * @param {string} [color='#000'] - [description] + * + * @return {Phaser.GameObjects.Text} The parent Text object. + */ setShadowColor: function (color) { if (color === undefined) { color = '#000'; } @@ -328,6 +707,16 @@ var TextStyle = new Class({ return this.update(false); }, + /** + * [description] + * + * @method Phaser.GameObjects.Components.TextStyle#setShadowBlur + * @since 3.0.0 + * + * @param {number} [blur=0] - [description] + * + * @return {Phaser.GameObjects.Text} The parent Text object. + */ setShadowBlur: function (blur) { if (blur === undefined) { blur = 0; } @@ -337,6 +726,16 @@ var TextStyle = new Class({ return this.update(false); }, + /** + * [description] + * + * @method Phaser.GameObjects.Components.TextStyle#setShadowStroke + * @since 3.0.0 + * + * @param {boolean} enabled - [description] + * + * @return {Phaser.GameObjects.Text} The parent Text object. + */ setShadowStroke: function (enabled) { this.shadowStroke = enabled; @@ -344,6 +743,16 @@ var TextStyle = new Class({ return this.update(false); }, + /** + * [description] + * + * @method Phaser.GameObjects.Components.TextStyle#setShadowFill + * @since 3.0.0 + * + * @param {boolean} enabled - [description] + * + * @return {Phaser.GameObjects.Text} The parent Text object. + */ setShadowFill: function (enabled) { this.shadowFill = enabled; @@ -352,15 +761,17 @@ var TextStyle = new Class({ }, /** - * Set the width (in pixels) to use for wrapping lines. Pass in null to remove wrapping by - * width. + * Set the width (in pixels) to use for wrapping lines. Pass in null to remove wrapping by width. * - * @param {number|null} width - The maximum width of a line in pixels. Set to null to remove - * wrapping. + * @method Phaser.GameObjects.Components.TextStyle#setWordWrapWidth + * @since 3.0.0 + * + * @param {number} width - The maximum width of a line in pixels. Set to null to remove wrapping. * @param {boolean} [useAdvancedWrap=false] - Whether or not to use the advanced wrapping * algorithm. If true, spaces are collapsed and whitespace is trimmed from lines. If false, * spaces and whitespace are left as is. - * @return {this} + * + * @return {Phaser.GameObjects.Text} The parent Text object. */ setWordWrapWidth: function (width, useAdvancedWrap) { @@ -375,12 +786,16 @@ var TextStyle = new Class({ /** * Set a custom callback for wrapping lines. Pass in null to remove wrapping by callback. * + * @method Phaser.GameObjects.Components.TextStyle#setWordWrapCallback + * @since 3.0.0 + * * @param {function} callback - A custom function that will be responsible for wrapping the * text. It will receive two arguments: text (the string to wrap), textObject (this Text * instance). It should return the wrapped lines either as an array of lines or as a string with * newline characters in place to indicate where breaks should happen. * @param {object} [scope=null] - The scope that will be applied when the callback is invoked. - * @return {this} + * + * @return {Phaser.GameObjects.Text} The parent Text object. */ setWordWrapCallback: function (callback, scope) { @@ -392,6 +807,16 @@ var TextStyle = new Class({ return this.update(false); }, + /** + * [description] + * + * @method Phaser.GameObjects.Components.TextStyle#setAlign + * @since 3.0.0 + * + * @param {string} align - [description] + * + * @return {Phaser.GameObjects.Text} The parent Text object. + */ setAlign: function (align) { if (align === undefined) { align = 'left'; } @@ -401,6 +826,16 @@ var TextStyle = new Class({ return this.update(false); }, + /** + * [description] + * + * @method Phaser.GameObjects.Components.TextStyle#setMaxLines + * @since 3.0.0 + * + * @param {integer} [max=0] - [description] + * + * @return {Phaser.GameObjects.Text} The parent Text object. + */ setMaxLines: function (max) { if (max === undefined) { max = 0; } @@ -410,6 +845,14 @@ var TextStyle = new Class({ return this.update(false); }, + /** + * [description] + * + * @method Phaser.GameObjects.Components.TextStyle#getTextMetrics + * @since 3.0.0 + * + * @return {object} [description] + */ getTextMetrics: function () { var metrics = this.metrics; @@ -421,6 +864,14 @@ var TextStyle = new Class({ }; }, + /** + * [description] + * + * @method Phaser.GameObjects.Components.TextStyle#toJSON + * @since 3.0.0 + * + * @return {object} [description] + */ toJSON: function () { var output = {}; @@ -435,6 +886,12 @@ var TextStyle = new Class({ return output; }, + /** + * [description] + * + * @method Phaser.GameObjects.Components.TextStyle#destroy + * @since 3.0.0 + */ destroy: function () { this.parent = undefined; diff --git a/src/gameobjects/text/static/Text.js b/src/gameobjects/text/static/Text.js index 2e5bdcb5a..fe03d08c6 100644 --- a/src/gameobjects/text/static/Text.js +++ b/src/gameobjects/text/static/Text.js @@ -512,7 +512,7 @@ var Text = new Class({ * * @param {object} style - [description] * - * @return {Phaser.GameObjects.Components.TextStyle} The TextStyle component. + * @return {Phaser.GameObjects.Text} This Text object. */ setStyle: function (style) { @@ -525,9 +525,9 @@ var Text = new Class({ * @method Phaser.GameObjects.Text#setFont * @since 3.0.0 * - * @param {[type]} font - [description] + * @param {string} font - [description] * - * @return {Phaser.GameObjects.Components.TextStyle} The TextStyle component. + * @return {Phaser.GameObjects.Text} This Text object. */ setFont: function (font) { @@ -540,9 +540,9 @@ var Text = new Class({ * @method Phaser.GameObjects.Text#setFontFamily * @since 3.0.0 * - * @param {[type]} family - [description] + * @param {string} family - [description] * - * @return {Phaser.GameObjects.Components.TextStyle} The TextStyle component. + * @return {Phaser.GameObjects.Text} This Text object. */ setFontFamily: function (family) { @@ -557,7 +557,7 @@ var Text = new Class({ * * @param {number} size - [description] * - * @return {Phaser.GameObjects.Components.TextStyle} The TextStyle component. + * @return {Phaser.GameObjects.Text} This Text object. */ setFontSize: function (size) { @@ -570,9 +570,9 @@ var Text = new Class({ * @method Phaser.GameObjects.Text#setFontStyle * @since 3.0.0 * - * @param {[type]} style - [description] + * @param {string} style - [description] * - * @return {[type]} [description] + * @return {Phaser.GameObjects.Text} This Text object. */ setFontStyle: function (style) { @@ -585,10 +585,10 @@ var Text = new Class({ * @method Phaser.GameObjects.Text#setFixedSize * @since 3.0.0 * - * @param {[type]} width - [description] - * @param {[type]} height - [description] + * @param {number} width - [description] + * @param {number} height - [description] * - * @return {[type]} [description] + * @return {Phaser.GameObjects.Text} This Text object. */ setFixedSize: function (width, height) { @@ -601,9 +601,9 @@ var Text = new Class({ * @method Phaser.GameObjects.Text#setBackgroundColor * @since 3.0.0 * - * @param {[type]} color - [description] + * @param {string} color - [description] * - * @return {[type]} [description] + * @return {Phaser.GameObjects.Text} This Text object. */ setBackgroundColor: function (color) { @@ -616,9 +616,9 @@ var Text = new Class({ * @method Phaser.GameObjects.Text#setFill * @since 3.0.0 * - * @param {[type]} color - [description] + * @param {string} color - [description] * - * @return {[type]} [description] + * @return {Phaser.GameObjects.Text} This Text object. */ setFill: function (color) { @@ -631,9 +631,9 @@ var Text = new Class({ * @method Phaser.GameObjects.Text#setColor * @since 3.0.0 * - * @param {[type]} color - [description] + * @param {string} color - [description] * - * @return {[type]} [description] + * @return {Phaser.GameObjects.Text} This Text object. */ setColor: function (color) { @@ -646,10 +646,10 @@ var Text = new Class({ * @method Phaser.GameObjects.Text#setStroke * @since 3.0.0 * - * @param {[type]} color - [description] - * @param {[type]} thickness - [description] + * @param {string} color - [description] + * @param {number} thickness - [description] * - * @return {[type]} [description] + * @return {Phaser.GameObjects.Text} This Text object. */ setStroke: function (color, thickness) { @@ -662,14 +662,14 @@ var Text = new Class({ * @method Phaser.GameObjects.Text#setShadow * @since 3.0.0 * - * @param {[type]} x - [description] - * @param {[type]} y - [description] - * @param {[type]} color - [description] - * @param {[type]} blur - [description] - * @param {[type]} shadowStroke - [description] - * @param {[type]} shadowFill - [description] + * @param {number} x - [description] + * @param {number} y - [description] + * @param {string} color - [description] + * @param {number} blur - [description] + * @param {boolean} shadowStroke - [description] + * @param {boolean} shadowFill - [description] * - * @return {[type]} [description] + * @return {Phaser.GameObjects.Text} This Text object. */ setShadow: function (x, y, color, blur, shadowStroke, shadowFill) { @@ -682,10 +682,10 @@ var Text = new Class({ * @method Phaser.GameObjects.Text#setShadowOffset * @since 3.0.0 * - * @param {[type]} x - [description] - * @param {[type]} y - [description] + * @param {number} x - [description] + * @param {number} y - [description] * - * @return {[type]} [description] + * @return {Phaser.GameObjects.Text} This Text object. */ setShadowOffset: function (x, y) { @@ -698,9 +698,9 @@ var Text = new Class({ * @method Phaser.GameObjects.Text#setShadowColor * @since 3.0.0 * - * @param {[type]} color - [description] + * @param {string} color - [description] * - * @return {[type]} [description] + * @return {Phaser.GameObjects.Text} This Text object. */ setShadowColor: function (color) { @@ -713,9 +713,9 @@ var Text = new Class({ * @method Phaser.GameObjects.Text#setShadowBlur * @since 3.0.0 * - * @param {[type]} blur - [description] + * @param {number} blur - [description] * - * @return {[type]} [description] + * @return {Phaser.GameObjects.Text} This Text object. */ setShadowBlur: function (blur) { @@ -728,9 +728,9 @@ var Text = new Class({ * @method Phaser.GameObjects.Text#setShadowStroke * @since 3.0.0 * - * @param {[type]} enabled - [description] + * @param {boolean} enabled - [description] * - * @return {[type]} [description] + * @return {Phaser.GameObjects.Text} This Text object. */ setShadowStroke: function (enabled) { @@ -743,9 +743,9 @@ var Text = new Class({ * @method Phaser.GameObjects.Text#setShadowFill * @since 3.0.0 * - * @param {[type]} enabled - [description] + * @param {boolean} enabled - [description] * - * @return {[type]} [description] + * @return {Phaser.GameObjects.Text} This Text object. */ setShadowFill: function (enabled) { @@ -753,26 +753,17 @@ var Text = new Class({ }, /** - * Set the width (in pixels) to use for wrapping lines. Pass in null to remove wrapping by - * width. - * - * @param {number|null} width - The maximum width of a line in pixels. Set to null to remove - * wrapping. - * @param {boolean} [useAdvancedWrap=false] - Whether or not to use the advanced wrapping - * algorithm. If true, spaces are collapsed and whitespace is trimmed from lines. If false, - * spaces and whitespace are left as is. - * @return {this} - */ - /** - * [description] + * Set the width (in pixels) to use for wrapping lines. Pass in null to remove wrapping by width. * * @method Phaser.GameObjects.Text#setWordWrapWidth * @since 3.0.0 * - * @param {[type]} width - [description] - * @param {[type]} useAdvancedWrap - [description] + * @param {number|null} width - The maximum width of a line in pixels. Set to null to remove wrapping. + * @param {boolean} [useAdvancedWrap=false] - Whether or not to use the advanced wrapping + * algorithm. If true, spaces are collapsed and whitespace is trimmed from lines. If false, + * spaces and whitespace are left as is. * - * @return {[type]} [description] + * @return {Phaser.GameObjects.Text} This Text object. */ setWordWrapWidth: function (width, useAdvancedWrap) { @@ -782,23 +773,16 @@ var Text = new Class({ /** * Set a custom callback for wrapping lines. Pass in null to remove wrapping by callback. * + * @method Phaser.GameObjects.Text#setWordWrapCallback + * @since 3.0.0 + * * @param {function} callback - A custom function that will be responsible for wrapping the * text. It will receive two arguments: text (the string to wrap), textObject (this Text * instance). It should return the wrapped lines either as an array of lines or as a string with * newline characters in place to indicate where breaks should happen. * @param {object} [scope=null] - The scope that will be applied when the callback is invoked. - * @return {this} - */ - /** - * [description] * - * @method Phaser.GameObjects.Text#setWordWrapCallback - * @since 3.0.0 - * - * @param {[type]} callback - [description] - * @param {[type]} scope - [description] - * - * @return {[type]} [description] + * @return {Phaser.GameObjects.Text} This Text object. */ setWordWrapCallback: function (callback, scope) { @@ -811,29 +795,28 @@ var Text = new Class({ * @method Phaser.GameObjects.Text#setAlign * @since 3.0.0 * - * @param {[type]} align - [description] + * @param {string} align - [description] * - * @return {[type]} [description] + * @return {Phaser.GameObjects.Text} This Text object. */ setAlign: function (align) { return this.style.setAlign(align); }, - // 'left' can be an object - // if only 'left' and 'top' are given they are treated as 'x' and 'y' /** - * [description] + * 'left' can be an object. + * If only 'left' and 'top' are given they are treated as 'x' and 'y' * * @method Phaser.GameObjects.Text#setPadding * @since 3.0.0 * - * @param {[type]} left - [description] - * @param {[type]} top - [description] - * @param {[type]} right - [description] - * @param {[type]} bottom - [description] + * @param {number|object} left - [description] + * @param {number} top - [description] + * @param {number} right - [description] + * @param {number} bottom - [description] * - * @return {[type]} [description] + * @return {Phaser.GameObjects.Text} This Text object. */ setPadding: function (left, top, right, bottom) { @@ -890,9 +873,9 @@ var Text = new Class({ * @method Phaser.GameObjects.Text#setMaxLines * @since 3.0.0 * - * @param {[type]} max - [description] + * @param {integer} [max=0] - [description] * - * @return {[type]} [description] + * @return {Phaser.GameObjects.Text} This Text object. */ setMaxLines: function (max) { @@ -905,7 +888,7 @@ var Text = new Class({ * @method Phaser.GameObjects.Text#updateText * @since 3.0.0 * - * @return {[type]} [description] + * @return {Phaser.GameObjects.Text} This Text object. */ updateText: function () { @@ -933,12 +916,12 @@ var Text = new Class({ var w = textSize.width + padding.left + padding.right; var h = textSize.height + padding.top + padding.bottom; - if (!style.fixedWidth) + if (style.fixedWidth === 0) { this.width = w; } - if (!style.fixedHeight) + if (style.fixedHeight === 0) { this.height = h; } @@ -1038,7 +1021,7 @@ var Text = new Class({ * @method Phaser.GameObjects.Text#getTextMetrics * @since 3.0.0 * - * @return {[type]} [description] + * @return {object} [description] */ getTextMetrics: function () { @@ -1051,7 +1034,7 @@ var Text = new Class({ * @method Phaser.GameObjects.Text#toJSON * @since 3.0.0 * - * @return {[type]} [description] + * @return {object} [description] */ toJSON: function () { diff --git a/src/gameobjects/tilemap/Tile.js b/src/gameobjects/tilemap/Tile.js index e45202ccf..6d347333a 100644 --- a/src/gameobjects/tilemap/Tile.js +++ b/src/gameobjects/tilemap/Tile.js @@ -2,6 +2,29 @@ var Class = require('../../utils/Class'); var Components = require('../components'); var Rectangle = require('../../geom/rectangle'); +/** + * A Tile is a representation of a single tile within the Tilemap. This is a lightweight data + * representation, so it's position information is stored without factoring in scroll, layer + * scale or layer position. + * + * @class Tile + * @memberOf Phaser.GameObjects.Tilemaps + * @constructor + * @since 3.0.0 + * + * @param {LayerData} layer - The LayerData object in the Tilemap that this tile belongs to. + * @param {integer} index - The unique index of this tile within the map. + * @param {integer} x - The x coordinate of this tile in tile coordinates. + * @param {integer} y - The y coordinate of this tile in tile coordinates. + * @param {integer} width - Width of the tile in pixels. + * @param {integer} height - Height of the tile in pixels. + * @param {integer} baseWidth - The base width a tile in the map (in pixels). Tiled maps support + * multiple tileset sizes within one map, but they are still placed at intervals of the base + * tile width. + * @param {integer} baseHeight - The base height of the tile in pixels (in pixels). Tiled maps + * support multiple tileset sizes within one map, but they are still placed at intervals of the + * base tile height. + */ var Tile = new Class({ Mixins: [ @@ -12,27 +35,6 @@ var Tile = new Class({ initialize: - /** - * A Tile is a representation of a single tile within the Tilemap. This is a lightweight data - * representation, so it's position information is stored without factoring in scroll, layer - * scale or layer position. - * - * @class Tile - * @constructor - * - * @param {LayerData} layer - The LayerData object in the Tilemap that this tile belongs to. - * @param {integer} index - The unique index of this tile within the map. - * @param {integer} x - The x coordinate of this tile in tile coordinates. - * @param {integer} y - The y coordinate of this tile in tile coordinates. - * @param {integer} width - Width of the tile in pixels. - * @param {integer} height - Height of the tile in pixels. - * @param {integer} baseWidth - The base width a tile in the map (in pixels). Tiled maps support - * multiple tileset sizes within one map, but they are still placed at intervals of the base - * tile width. - * @param {integer} baseHeight - The base height of the tile in pixels (in pixels). Tiled maps - * support multiple tileset sizes within one map, but they are still placed at intervals of the - * base tile height. - */ function Tile (layer, index, x, y, width, height, baseWidth, baseHeight) { /**