diff --git a/src/gameobjects/Text.js b/src/gameobjects/Text.js index 0a4b3ed29..66fc1cae9 100644 --- a/src/gameobjects/Text.js +++ b/src/gameobjects/Text.js @@ -805,6 +805,22 @@ Phaser.Text.prototype.addFontWeight = function (weight, position) { }; +/** +* Precalculates word wrap for a given text based on the Text object configuration. +* +* It may be useful is the developer wants to control pagination on long pieces of content. +* +* @method Phaser.Text#precalculateWordWrap +* @param {string} text - The text for which the wrapping will be precalculated. +* @return {array} An array of strings with the pieces of wrapped text. +*/ +Phaser.Text.prototype.precalculateWordWrap = function (text) { + this.texture.baseTexture.resolution = this._res; + this.context.font = this.style.font; + var wrappedLines = this.runWordWrap(text); + return wrappedLines.split(/(?:\r\n|\r|\n)/); +}; + /** * Greedy wrapping algorithm that will wrap words as the line grows longer than its horizontal bounds. *