ResourceImporterImageFont¶
继承: ResourceImporter < RefCounted < Object
导入位图字体,其中所有字形具有相同的宽度和高度。
描述¶
这种基于图像的工作流程可以比ResourceImporterBMFont更容易使用,但它要求所有字形具有相同的宽度和高度,字形前进和绘图偏移可以自定义。这使得ResourceImporterImageFont最适合固定宽度的字体。
属性¶
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
属性说明¶
字体上升(基线上方的像素数)。如果设置为0,则使用字符高度的一半。
Rect2i character_margin = Rect2i(0, 0, 0, 0) 🔗
在每个导入的字形周围应用边距。如果您的字体图像包含指南(字形之间的线条形式)或字符之间的行间距不正确,请尝试调整character_margin。
PackedStringArray character_ranges = PackedStringArray() 🔗
要从字体图像导入的字符范围。这是一个数组,用于映射图像上的每个位置(以图块坐标,而不是像素)。从左到右和从上到下遍历字体图集。可以使用十进制数(127)、十六进制数(0x007f或U+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.
字体图像中的列数。另请参见rows。
如果true,则对生成的字体使用无损压缩。
字体下降(基线以下的像素数)。如果设置为0,则使用字符高度的一半。
如果在此位图字体中找不到字形,则使用的字体回退列表。首先尝试数组开头的字体。
Rect2i image_margin = Rect2i(0, 0, 0, 0) 🔗
在整个图像的侧面剪切边距。这可用于剪切包含归因信息或类似信息的图像部分。
PackedStringArray kerning_pairs = PackedStringArray() 🔗
字体的字距调整对。字距调整对用于调整两个字符之间的间距。每个字符串由三个以空格分隔的值组成:“起始”字符串、“结束”字符串和整数偏移量。每两个字符串的组合构成一个字距调整对,例如,ab cd -3 将创建字距调整对 ac、ad、bc 和 bd,偏移量为 -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.
字体图像中的行数。另请参阅columns。
字体缩放模式。