BitmapFont
Inherits: Font < Resource < Reference < Object
使用BMFont格式的字体来渲染文本。
处理扩展名为.fnt
的文件。
描述
使用 *.fnt
包含纹理图库的字体来渲染文本。支持距离字段。关于直接使用 TTF 等矢量字体文件,请参阅 DynamicFont。
属性
| ||
| ||
|
方法
void | add_char ( int character, int texture, Rect2 rect, Vector2 align=Vector2( 0, 0 ), float advance=-1 ) |
void | add_kerning_pair ( int char_a, int char_b, int kerning ) |
void | add_texture ( Texture texture ) |
void | clear ( ) |
create_from_fnt ( String path ) | |
get_kerning_pair ( int char_a, int char_b ) const | |
get_texture ( int idx ) const | |
get_texture_count ( ) const |
属性说明
- float ascent
Default |
|
Setter | set_ascent(value) |
Getter | get_ascent() |
上升(基线以上的像素数)。
- bool distance_field
Default |
|
Setter | set_distance_field_hint(value) |
Getter | is_distance_field_hint() |
如果true
,则启用距离字段提示。
- BitmapFont fallback
Setter | set_fallback(value) |
Getter | get_fallback() |
备用字体。
- float height
Default |
|
Setter | set_height(value) |
Getter | get_height() |
字体总高度(上升加下降),单位为像素。
方法说明
- void add_char ( int character, int texture, Rect2 rect, Vector2 align=Vector2( 0, 0 ), float advance=-1 )
添加一个字符到字体中,其中character
是Unicode值,texture
是纹理索引,rect
是纹理中的区域(以像素为单位!),align
是字符的对齐方式(可选),advance
是前进方式(可选)。
在 BitmapFont
中为字偶添加差值。字偶(距)是一种特殊情况,当前字体的前进量由下一个字符决定。
- void add_texture ( Texture texture )
为BitmapFont
添加一个纹理。
- void clear ( )
清除所有字体数据和设置。
从 *.fnt
文件的 path
处创建一个 BitmapFont。
返回字偶的差值。
返回位于索引idx
处的字体Atlas纹理。
- int get_texture_count ( ) const
返回BitmapFont图谱中纹理的数量。