Phaser Source: src/loader/LoaderParser.js

# Source: src/loader/LoaderParser.js

    /**
    * @author       Richard Davey <rich@photonstorm.com>
    * @copyright    2016 Photon Storm Ltd.
    * @license      {@link https://github.com/photonstorm/phaser/blob/master/license.txt|MIT License}
    */

    /**
    * Phaser.LoaderParser parses data objects from Phaser.Loader that need more preparation before they can be inserted into the Cache.
    *
    * @class Phaser.LoaderParser
    */
    Phaser.LoaderParser = {

        /**
        * Alias for xmlBitmapFont, for backwards compatibility.
        *
        * @method Phaser.LoaderParser.bitmapFont
        * @param {object} xml - XML data you want to parse.
        * @param {PIXI.BaseTexture} baseTexture - The BaseTexture this font uses.
        * @param {number} [xSpacing=0] - Additional horizontal spacing between the characters.
        * @param {number} [ySpacing=0] - Additional vertical spacing between the characters.
        * @return {object} The parsed Bitmap Font data.
        */
        bitmapFont: function (xml, baseTexture, xSpacing, ySpacing) {

            return this.xmlBitmapFont(xml, baseTexture, xSpacing, ySpacing);

        },

        /**
        * Parse a Bitmap Font from an XML file.
        *
        * @method Phaser.LoaderParser.xmlBitmapFont
        * @param {object} xml - XML data you want to parse.
        * @param {PIXI.BaseTexture} baseTexture - The BaseTexture this font uses.
        * @param {number} [xSpacing=0] - Additional horizontal spacing between the characters.
        * @param {number} [ySpacing=0] - Additional vertical spacing between the characters.
        * @return {object} The parsed Bitmap Font data.
        */
        xmlBitmapFont: function (xml, baseTexture, xSpacing, ySpacing) {

            var data = {};
            var info = xml.getElementsByTagName('info')[0];
            var common = xml.getElementsByTagName('common')[0];

            data.font = info.getAttribute('face');
            data.size = parseInt(info.getAttribute('size'), 10);
            data.lineHeight = parseInt(common.getAttribute('lineHeight'), 10) + ySpacing;
            data.chars = {};

            var letters = xml.getElementsByTagName('char');

            for (var i = 0; i < letters.length; i++)
            {
                var charCode = parseInt(letters[i].getAttribute('id'), 10);

                data.chars[charCode] = {
                    x: parseInt(letters[i].getAttribute('x'), 10),
                    y: parseInt(letters[i].getAttribute('y'), 10),
                    width: parseInt(letters[i].getAttribute('width'), 10),
                    height: parseInt(letters[i].getAttribute('height'), 10),
                    xOffset: parseInt(letters[i].getAttribute('xoffset'), 10),
                    yOffset: parseInt(letters[i].getAttribute('yoffset'), 10),
                    xAdvance: parseInt(letters[i].getAttribute('xadvance'), 10) + xSpacing,
                    kerning: {}
                };
            }

            var kernings = xml.getElementsByTagName('kerning');

            for (i = 0; i < kernings.length; i++)
            {
                var first = parseInt(kernings[i].getAttribute('first'), 10);
                var second = parseInt(kernings[i].getAttribute('second'), 10);
                var amount = parseInt(kernings[i].getAttribute('amount'), 10);

                data.chars[second].kerning[first] = amount;
            }

            return this.finalizeBitmapFont(baseTexture, data);

        },

        /**
        * Parse a Bitmap Font from a JSON file.
        *
        * @method Phaser.LoaderParser.jsonBitmapFont
        * @param {object} json - JSON data you want to parse.
        * @param {PIXI.BaseTexture} baseTexture - The BaseTexture this font uses.
        * @param {number} [xSpacing=0] - Additional horizontal spacing between the characters.
        * @param {number} [ySpacing=0] - Additional vertical spacing between the characters.
        * @return {object} The parsed Bitmap Font data.
        */
        jsonBitmapFont: function (json, baseTexture, xSpacing, ySpacing) {

            var data = {
                font: json.font.info._face,
                size: parseInt(json.font.info._size, 10),
                lineHeight: parseInt(json.font.common._lineHeight, 10) + ySpacing,
                chars: {}
            };

            json.font.chars["char"].forEach(

                function parseChar(letter) {

                    var charCode = parseInt(letter._id, 10);

                    data.chars[charCode] = {
                        x: parseInt(letter._x, 10),
                        y: parseInt(letter._y, 10),
                        width: parseInt(letter._width, 10),
                        height: parseInt(letter._height, 10),
                        xOffset: parseInt(letter._xoffset, 10),
                        yOffset: parseInt(letter._yoffset, 10),
                        xAdvance: parseInt(letter._xadvance, 10) + xSpacing,
                        kerning: {}
                    };
                }

            );

            if (json.font.kernings && json.font.kernings.kerning) {

                json.font.kernings.kerning.forEach(

                    function parseKerning(kerning) {

                        data.chars[kerning._second].kerning[kerning._first] = parseInt(kerning._amount, 10);

                    }

                );

            }

            return this.finalizeBitmapFont(baseTexture, data);

        },

        /**
        * Finalize Bitmap Font parsing.
        *
        * @method Phaser.LoaderParser.finalizeBitmapFont
        * @private
        * @param {PIXI.BaseTexture} baseTexture - The BaseTexture this font uses.
        * @param {object} bitmapFontData - Pre-parsed bitmap font data.
        * @return {object} The parsed Bitmap Font data.
        */
        finalizeBitmapFont: function (baseTexture, bitmapFontData) {

            Object.keys(bitmapFontData.chars).forEach(

                function addTexture(charCode) {

                    var letter = bitmapFontData.chars[charCode];

                    letter.texture = new PIXI.Texture(baseTexture, new Phaser.Rectangle(letter.x, letter.y, letter.width, letter.height));

                }

            );

            return bitmapFontData;

        }
    };