Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

ResourceImporterImageFont

继承： ResourceImporter < RefCounted < Object

导入等宽位图字体，所有字形使用的都是相同的宽高。

描述

这种基于图像的工作流程比 ResourceImporterBMFont 更易于使用，但它要求所有字形具有相同的宽度和高度。这使得 ResourceImporterImageFont 最适合固定宽度字体。

另请参见 ResourceImporterDynamicFont。

教程

• 位图字体——使用字体

属性

Rect2i	character_margin	Rect2i(0, 0, 0, 0)
PackedStringArray	character_ranges	PackedStringArray()
int	columns	1
bool	compress	true
Array	fallbacks	[]
Rect2i	image_margin	Rect2i(0, 0, 0, 0)
int	rows	1
int	scaling_mode	2

---

属性说明

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

字体缩放模式。