////////////////////////////////////////////////////////////////////////////////////// // // Copyright (c) 2014-present, Egret Technology. // All rights reserved. // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are met: // // * Redistributions of source code must retain the above copyright // notice, this list of conditions and the following disclaimer. // * Redistributions in binary form must reproduce the above copyright // notice, this list of conditions and the following disclaimer in the // documentation and/or other materials provided with the distribution. // * Neither the name of the Egret nor the // names of its contributors may be used to endorse or promote products // derived from this software without specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY EGRET AND CONTRIBUTORS "AS IS" AND ANY EXPRESS // OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES // OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. // IN NO EVENT SHALL EGRET AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, // INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;LOSS OF USE, DATA, // OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF // LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING // NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, // EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. // ////////////////////////////////////////////////////////////////////////////////////// namespace egret { /** * Bitmap font, texture set of a font. It is generally used as the value of the BitmapText.font attribute. * @see http://bbs.egret-labs.org/thread-918-1-1.html TextureMerger * @see http://bbs.egret-labs.org/forum.php?mod=viewthread&tid=251 Text(Containing the specific usage of the bitmap font ) * @version Egret 2.4 * @platform Web,Native * @includeExample egret/text/BitmapFont.ts * @language en_US */ /** * 位图字体,是一个字体的纹理集，通常作为BitmapText.font属性的值。 * @see http://bbs.egret-labs.org/thread-918-1-1.html TextureMerger * @see http://bbs.egret-labs.org/forum.php?mod=viewthread&tid=251 文本(含位图字体具体用法) * @version Egret 2.4 * @platform Web,Native * @includeExample egret/text/BitmapFont.ts * @language zh_CN */ export class BitmapFont extends SpriteSheet { /** * Create an egret.BitmapFont object * @param texture {egret.Texture} Texture set that use TextureMerger create * @param config {any} Configure data that use TextureMerger create * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 创建一个 egret.BitmapFont 对象 * @param texture {egret.Texture} 使用TextureMerger生成的纹理集 * @param config {any} 使用TextureMerger生成的配置数据 * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ public constructor(texture:Texture, config:any) { super(texture); if(typeof(config)=="string"){ this.charList = this.parseConfig(config); } else if(config&&config.hasOwnProperty("frames")){ this.charList = config.frames; } else{ this.charList = {}; } } /** * @private */ private charList:any; /** * Obtain corresponding texture through the name attribute * @param name {string} name Attribute * @returns {egret.Texture} * @version Egret 2.4 * @platform Web,Native * @language en_US */ /** * 通过 name 属性获取对应纹理 * @param name {string} name属性 * @returns {egret.Texture} * @version Egret 2.4 * @platform Web,Native * @language zh_CN */ public getTexture(name:string):Texture { let texture:Texture = this._textureMap[name]; if (!texture) { let c:any = this.charList[name]; if (!c) { return null; } texture = this.createTexture(name, c.x, c.y, c.w, c.h, c.offX, c.offY,c.sourceW,c.sourceH); this._textureMap[name] = texture; } return texture; } /** * @private */ public getConfig(name:string, key:string):number { if(!this.charList[name]) { return 0; } return this.charList[name][key]; } /** * @private */ private firstCharHeight:number = 0; /** * @private * * @returns */ public _getFirstCharHeight():number{ if(this.firstCharHeight==0){ for(let str in this.charList){ let c:any = this.charList[str]; if(c){ let sourceH:number = c.sourceH; if(sourceH === undefined){ let h:number = c.h; if(h===undefined){ h = 0; } let offY:number = c.offY; if(offY === undefined){ offY = 0; } sourceH = h+offY; } if(sourceH<=0){ continue; } this.firstCharHeight = sourceH; break; } } } return this.firstCharHeight; } /** * @private * * @param fntText * @returns */ private parseConfig(fntText:string):any { fntText = fntText.split("\r\n").join("\n"); let lines:string[] = fntText.split("\n"); let charsCount:number = this.getConfigByKey(lines[3], "count"); let chars:any = {}; for (let i:number = 4; i < 4 + charsCount; i++) { let charText:string = lines[i]; let letter:string = String.fromCharCode(this.getConfigByKey(charText, "id")); let c = {}; chars[letter] = c; c["x"] = this.getConfigByKey(charText, "x"); c["y"] = this.getConfigByKey(charText, "y"); c["w"] = this.getConfigByKey(charText, "width"); c["h"] = this.getConfigByKey(charText, "height"); c["offX"] = this.getConfigByKey(charText, "xoffset"); c["offY"] = this.getConfigByKey(charText, "yoffset"); c["xadvance"] = this.getConfigByKey(charText, "xadvance"); } return chars; } /** * @private * * @param configText * @param key * @returns */ private getConfigByKey(configText:string, key:string):number { let itemConfigTextList = configText.split(" "); for (let i = 0 , length = itemConfigTextList.length; i < length; i++) { let itemConfigText = itemConfigTextList[i]; if (key == itemConfigText.substring(0, key.length)) { let value:string = itemConfigText.substring(key.length + 1); return parseInt(value); } } return 0; } } }