配置字体渲染质量

O3DE 的内置 UI 系统LyShine使用字体纹理呈现文本。屏幕上文本的质量受字体纹理大小、字体纹理中的字符槽数以及在屏幕上呈现时文本本身的大小的影响。

使用本节中的过程配置字体大小和纹理，以实现高质量的文本呈现。

字体纹理宽度和高度属性

字体在 XML 中由*.font文件定义。.font文件中的 XML 定义各种参数，例如源 TTF/OTF 资产的路径和重要的渲染属性。O3DE 项目中包含的字体文件Engine/Fonts/default-ui.font包含以下内容。

<fontshader>
    <font path="Vera.ttf" w="512" h="256"/>
    <effect name="default">
        <pass>
        </pass>
    </effect>
    <effect name="drop_shadow">
        <pass>
        </pass>
        <pass>
            <color r="0" g="0" b="0" a="1"/>
            <pos x="1" y="1"/>
        </pass>
    </effect>
</fontshader>

字体纹理分辨率由以下行控制。

<font path="Vera.ttf" w="512" h="256"/>

在此示例中，字体纹理的分辨率为 512x256。此分辨率大小（以及字符槽的数量）是确定字体渲染质量的重要值。

字符插槽

在 O3DE 中，字体纹理在逻辑上被划分为大小相等的槽。在每个插槽中，每个字符（字形）都有统一的间距。默认情况下（无需额外配置），有 128 个唯一字符（16 行 * 8 列）。

如果您支持包含许多唯一字符的语言，例如中文、日语或韩语，则默认槽数（128）可能不足以满足您的需求，需要进一步配置。否则，对于大多数语言来说，128 个唯一字符可能就足够了。以下有关字符槽的信息进一步详细介绍了 O3DE 中的字体渲染管道。

当渲染一个字符串时，字符串中唯一字符的数量与字符串中的字符数（它的长度）不同。字体纹理中的字符槽数仅对可在单个帧中呈现的唯一字符数施加限制。

例如，下面是一个字体定义，它定义了一个具有 1 (1x1) 纹理槽的字体纹理。

<font path="Vera.ttf" w="512" h="512" widthslots="1" heightslots="1"/>

widthslots 和 heightslots 的默认值分别为 16 和 8。但是，如前面的示例所示，您可以配置字符槽 (1) 的数量。此字体可以在屏幕上呈现单个唯一字符，次数不限，例如以下字符串。

AAAA

AAAA 中的唯一字符数为 1，字符串的长度为 4。此字体纹理配置可以无限次呈现此字符（即可变长度的字符串），只要字符串仅包含单个字符即可。但是，此字体无法呈现以下字符串。

AABB

由于纹理中仅存在一个字符槽，因此它无法同时存储大写字母 ‘A’ 和大写字母 ‘B’ 的字形，并将它们同时呈现在一个帧中。要渲染这个字符串，你需要使用 widthslots 和 heightslots 参数来增加插槽的数量。

这是另一个例子。

<font path="NotoSansSC-Regular.otf" w="4096" h="4096" widthslots="128" heightslots="128"/>

在此示例中，字体纹理大小为 4096x4096，并且总共有128x128（16,384）个字符槽。要确定每个字符的可用大小，请将纹理大小（4096x4096）除以槽数（128x128），从而得出每个字符 32x32 像素空间。此配置使您能够在单个帧中以 32 像素大小渲染超过 16,000 个唯一字符。

Create the font .font file for the font to use.
首先选择任意字体纹理大小，例如上一个示例中使用的 512x256。
使用 UI 编辑器 模拟画布，其中包含具有使用您的字体 .font 文件的文本组件的元素。
在 UI 编辑器的 Properties 窗格中，先在 Text 下，再在 Font size 下，尝试字体大小以找到适合你的用例的理想大小。
在确定了适合自己的用途的字体大小后，使用以下公式确定字体纹理的宽度和高度：
- Texture width = Font size * widthslots
- Texture height = Font size * heightslots
注意:
widthslots 和 heightslots 的默认值分别是 16 和 8，总共有 128 个字符槽。如果您需要在单个帧中在屏幕上呈现超过 128 个唯一字符（例如，如果您的游戏支持中文、日语或韩语文本），请相应地调整这些值。
编辑字体 .font 以使用计算的字体纹理大小。
注意:
字体纹理大小不一定需要是 2 的幂：128、256、512、1024、2048 等。但是，width 必须是 widthslots 的倍数（默认值是 16），高度必须是 heightslots 的倍数（默认值是 8）。
您可以有多个字体.font 文件，它们引用相同的 TTF/OTF 文件，但具有不同的字体纹理大小。
例如，您可能有一些字幕文本只需要以较小的字体显示，但您还有其他屏幕（可能是菜单屏幕），您希望使用相同的字体来获得相同的外观。但是，它需要更大，因此需要更高分辨率的字体纹理。您可以为每个用例使用单独的 .font 文件来实现这一点，并调整字体纹理设置以获得理想的渲染质量。

配置字体渲染质量

字体纹理宽度和高度属性

字符插槽

Font Size