Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
ResourceImporterImageFont¶
继承: ResourceImporter < RefCounted < Object
导入等宽位图字体,所有字形使用的都是相同的宽高。
描述¶
这种基于图像的工作流程比 ResourceImporterBMFont 更易于使用,但它要求所有字形具有相同的宽度和高度。这使得 ResourceImporterImageFont 最适合固定宽度字体。
教程¶
属性¶
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
属性说明¶
Rect2i character_margin = Rect2i(0, 0, 0, 0)
在每个导入的字形周围应用边距。如果你的字体图像包含参考线(以字形之间的线的形式)或者字符之间的间距看起来不正确,请尝试调整 character_margin。
PackedStringArray character_ranges = PackedStringArray()
从字体图像导入的字符范围。这是一个映射图像上每个位置的数组(以图块坐标,而不是像素映射)。字体图集是从左到右、从上到下遍历的。可以使用十进制数字(127)、十六进制数字(0x007f
)、或单引号之间('~'
)指定字符。可以使用字符之间的连字符指定范围。
例如,0-127
(或 0x0000-0x007f
)表示完整的 ASCII 范围。再比如,' '-'~'
等价于 32-127
,表示可打印(可见)ASCII 字符的范围。
确保 character_ranges 不超过定义的 columns * rows 的数量。否则,该字体将无法导入。
int columns = 1
字体图像中的列数。另见 rows。
bool compress = true
如果为 true
,则会对得到的字体使用无损压缩。
Array fallbacks = []
回退字体列表,在这个位图字体中未找到某个字形时使用。优先尝试靠前的字体。
Rect2i image_margin = Rect2i(0, 0, 0, 0)
整个图像两侧的裁减边距。这可被用于裁减该图像包含属性信息或类似信息的部分。
int rows = 1
字体图像中的行数。另见 columns。
int scaling_mode = 2
字体缩放模式。