| Package | laya.display |
| Class | public class BitmapFont |
| Inheritance | BitmapFont  Object |
BitmapFont 是位图字体类，用于定义位图字体信息。
| Property | Defined By | ||
|---|---|---|---|
| autoScaleSize : Boolean = false 表示是否根据实际使用的字体大小缩放位图字体大小。 | BitmapFont | ||
| fontSize : Number = 12 当前位图字体字号。 | BitmapFont | ||
| letterSpacing : Number = 0 字符间距（以像素为单位）。 | BitmapFont | ||
| Method | Defined By | ||
|---|---|---|---|
destroy():void
销毁位图字体，调用Text.unregisterBitmapFont 时，默认会销毁。
| BitmapFont | ||
getCharTexture(char:String):Texture
获取指定字符的字体纹理对象。
| BitmapFont | ||
getCharWidth(char:String):Number
获取指定字符的宽度。
| BitmapFont | ||
getMaxHeight():Number
获取最大字符高度。
| BitmapFont | ||
getMaxWidth():Number
获取最大字符宽度。
| BitmapFont | ||
getTextWidth(text:String):Number
获取指定文本内容的宽度。
| BitmapFont | ||
通过指定位图字体文件路径，加载位图字体文件，加载完成后会自动解析。
| BitmapFont | ||
解析字体文件。
| BitmapFont | ||
setSpaceWidth(spaceWidth:Number):void
设置空格的宽（如果字体库有空格，这里就可以不用设置了）。
| BitmapFont | ||
| autoScaleSize | property |
public var autoScaleSize:Boolean = false表示是否根据实际使用的字体大小缩放位图字体大小。
| fontSize | property |
public var fontSize:Number = 12当前位图字体字号。
| letterSpacing | property |
public var letterSpacing:Number = 0字符间距（以像素为单位）。
| destroy | () | method |
public function destroy():void销毁位图字体，调用Text.unregisterBitmapFont 时，默认会销毁。
| getCharTexture | () | method |
public function getCharTexture(char:String):Texture获取指定字符的字体纹理对象。
Parameters
char:String — 字符。
|
Texture — 指定的字体纹理对象。
|
| getCharWidth | () | method |
public function getCharWidth(char:String):Number获取指定字符的宽度。
Parameters
char:String — 字符。
|
Number — 宽度。
|
| getMaxHeight | () | method |
public function getMaxHeight():Number获取最大字符高度。
ReturnsNumber |
| getMaxWidth | () | method |
public function getMaxWidth():Number获取最大字符宽度。
ReturnsNumber |
| getTextWidth | () | method |
public function getTextWidth(text:String):Number获取指定文本内容的宽度。
Parameters
text:String — 文本内容。
|
Number — 宽度。
|
| loadFont | () | method |
public function loadFont(path:String, complete:Handler):void通过指定位图字体文件路径，加载位图字体文件，加载完成后会自动解析。
Parameters
path:String — 位图字体文件的路径。
| |
complete:Handler — 加载并解析完成的回调。
|
| parseFont | () | method |
public function parseFont(xml:XmlDom, texture:Texture):void解析字体文件。
Parameters
xml:XmlDom — 字体文件XML。
| |
texture:Texture — 字体的纹理。
|
| setSpaceWidth | () | method |
public function setSpaceWidth(spaceWidth:Number):void设置空格的宽（如果字体库有空格，这里就可以不用设置了）。
Parameters
spaceWidth:Number — 宽度，单位为像素。
|