DynamicFont
继承
简要描述
DynamicFont在运行时呈现矢量字体文件。
描述
DynamicFont在运行时动态地渲染矢量字体文件（例如TTF或OTF），而不是使用诸如BitmapFont之类的预渲染纹理图集。这需要用BitmapFont的更快加载时间来换取在运行时更改字体参数（如大小和间距）的能力。
DynamicFontData用于引用字体文件路径。DynamicFont还支持定义一种或多种后备字体，这些字体将在显示主字体不支持的字符时使用。
DynamicFont使用[url=https://www.freetype.org/]FreeType[/url]库进行栅格化。
var dynamic_font = DynamicFont.new()
dynamic_font.font_data = load("res://BarlowCondensed-Bold.ttf")
dynamic_font.size = 64
$"Label".set("custom_fonts/font", dynamic_font)
成员
| 类型 | 属性名 | 默认值 |
|---|---|---|
| int | extra_spacing_bottom | 0 |
| int | extra_spacing_char | 0 |
| int | extra_spacing_space | 0 |
| int | extra_spacing_top | 0 |
| DynamicFontData | font_data | |
| Color | outline_color | Color( 1, 1, 1, 1 ) |
| int | outline_size | 0 |
| int | size | 16 |
| bool | use_filter | false |
| bool | use_mipmaps | false |
方法
| 返回值类型 | 方法名称 |
|---|---|
| void | add_fallback(data: DynamicFontData) |
| DynamicFontData | get_fallback(idx: int) const |
| int | get_fallback_count() const |
| int | get_spacing(type: int) const |
| void | remove_fallback(idx: int) |
| void | set_fallback(idx: int, data: DynamicFontData) |
| void | set_spacing(type: int, value: int) |
枚举
enum SpacingType:
- **SPACING_TOP = 0**
顶部间距。
- **SPACING_BOTTOM = 1**
底部间距。
- **SPACING_CHAR = 2**
字符间距。
- **SPACING_SPACE = 3**
空格字符间距。
常量
成员说明
- int extra_spacing_bottom
| Default | 0 |
|---|---|
| setter | set_spacing(value) |
| getter | get_spacing |
- int extra_spacing_char
| Default | 0 |
|---|---|
| setter | set_spacing(value) |
| getter | get_spacing |
- int extra_spacing_space
| Default | 0 |
|---|---|
| setter | set_spacing(value) |
| getter | get_spacing |
- int extra_spacing_top
| Default | 0 |
|---|---|
| setter | set_spacing(value) |
| getter | get_spacing |
- DynamicFontData font_data
| setter | set_font_data(value) |
|---|---|
| getter | get_font_data |
- Color outline_color
| Default | Color( 1, 1, 1, 1 ) |
|---|---|
| setter | set_outline_color(value) |
| getter | get_outline_color |
- int outline_size
| Default | 0 |
|---|---|
| setter | set_outline_size(value) |
| getter | get_outline_size |
- int size
| Default | 16 |
|---|---|
| setter | set_size(value) |
| getter | get_size |
- bool use_filter
| Default | false |
|---|---|
| setter | set_use_filter(value) |
| getter | get_use_filter |
- bool use_mipmaps
| Default | false |
|---|---|
| setter | set_use_mipmaps(value) |
| getter | get_use_mipmaps |
方法说明
- add_fallback add_fallback(data: DynamicFontData)
添加后备字体。
- get_fallback get_fallback(idx: int) const
返回后备字体的索引idx。
- get_fallback_count get_fallback_count() const
返回后备字体的数量。
- get_spacing get_spacing(type: int) const
返回给定type的间距（见SpacingType）。
- remove_fallback remove_fallback(idx: int)
删除索引为idx的后备字体。
- set_fallback set_fallback(idx: int, data: DynamicFontData)
在索引idx处设置后备字体。
- set_spacing set_spacing(type: int, value: int)
将type（见SpacingType）的间距设置为以value像素为单位（与字体大小无关）。