ResourceImporterImageFont

继承: ResourceImporter < RefCounted < Object

导入位图字体,其中所有字形具有相同的宽度和高度。

描述

这种基于图像的工作流程可以比ResourceImporterBMFont更容易使用,但它要求所有字形具有相同的宽度和高度,字形前进和绘图偏移可以自定义。这使得ResourceImporterImageFont最适合固定宽度的字体。

另见ResourceImporterDynamicFont

属性


属性说明

int ascent = 0 🔗

字体上升(基线上方的像素数)。如果设置为0,则使用字符高度的一半。


Rect2i character_margin = Rect2i(0, 0, 0, 0) 🔗

在每个导入的字形周围应用边距。如果您的字体图像包含指南(字形之间的线条形式)或字符之间的行间距不正确,请尝试调整character_margin


PackedStringArray character_ranges = PackedStringArray() 🔗

要从字体图像导入的字符范围。这是一个数组,用于映射图像上的每个位置(以图块坐标,而不是像素)。从左到右和从上到下遍历字体图集。可以使用十进制数(127)、十六进制数(0x007fU+007f)或单引号('~')来指定字符范围。可以使用字符之间的连字符来指定范围。

例如,0-127表示完整的ASCII范围。它也可以写成0x0000-0x007f(或U+0000-U+007f)。作为另一个例子,' '-'~'等价于32-127,表示可打印(可见)ASCII字符的范围。

对于任何范围,可以通过在末尾附加三个空格分隔的整数值(附加推进、x偏移、y偏移)来自定义字符推进和偏移。例如,'a'-'b'4 5 2将'a'和'b'字符的推进设置为char_width+4并将偏移设置为Vector2(5,2)

确保character_ranges不超过定义的columns*rows的数量。否则,字体将无法导入。

Note: The returned array is copied and any changes to it will not update the original property value. See PackedStringArray for more details.


int columns = 1 🔗

字体图像中的列数。另请参见rows


bool compress = true 🔗

如果true,则对生成的字体使用无损压缩。


int descent = 0 🔗

字体下降(基线以下的像素数)。如果设置为0,则使用字符高度的一半。


Array fallbacks = [] 🔗

如果在此位图字体中找不到字形,则使用的字体回退列表。首先尝试数组开头的字体。


Rect2i image_margin = Rect2i(0, 0, 0, 0) 🔗

在整个图像的侧面剪切边距。这可用于剪切包含归因信息或类似信息的图像部分。


PackedStringArray kerning_pairs = PackedStringArray() 🔗

字体的字距调整对。字距调整对用于调整两个字符之间的间距。每个字符串由三个以空格分隔的值组成:“起始”字符串、“结束”字符串和整数偏移量。每两个字符串的组合构成一个字距调整对,例如,ab cd -3 将创建字距调整对 acadbcbd,偏移量为 -3。可以使用 \uXXXX 转义序列来添加 Unicode 字符。

Note: The returned array is copied and any changes to it will not update the original property value. See PackedStringArray for more details.


int rows = 1 🔗

字体图像中的行数。另请参阅columns


int scaling_mode = 2 🔗

字体缩放模式。