Creates a new Bitmap Text Game Object and adds it to the Scene.
BitmapText objects work by taking a texture file and an XML or JSON file that describes the font structure.
During rendering for each letter of the text is rendered to the display, proportionally spaced out and aligned to match the font structure.
BitmapText objects are less flexible than Text objects, in that they have less features such as shadows, fills and the ability to use Web Fonts, however you trade this flexibility for rendering speed. You can also create visually compelling BitmapTexts by processing the font texture in an image editor, applying fills and any other effects required.
To create multi-line text insert \r, \n or \r\n escape codes into the text string.
To create a BitmapText data files you need a 3rd party app such as:
For most use cases it is recommended to use XML. If you wish to use JSON, the formatting should be equal to the result of converting a valid XML file through the popular X2JS library. An online tool for conversion can be found here: http://codebeautify.org/xmltojson
Note: This method will only be available if the Bitmap Text Game Object has been built into Phaser.
The x position of the Game Object.
The y position of the Game Object.
The key of the font to use from the BitmapFont cache.
|text||string | Array.<string>||<optional>||
The string, or array of strings, to be set as the content of this Bitmap Text.
The font size to set.
The alignment of the text in a multi-line BitmapText object.
The Game Object that was created.