Text Layer Description

文本编辑器

在动效设计层面，PAG 更多的是作为动效模版存在，设计师在 AE 中设计好动效后，导出 PAG 文件，开发者在使用的过程中可以动态编辑文本或替换占位图，如果需要类似文本编辑器的功能，由于 PAG 对齐的是 AE，实现层面建议通过各平台侧的文本组件。

语言适配

在语言适配层面，PAG 仅支持从左向右排版的语言，对于从右向左排版的语言如阿拉伯语，目前 PAG 是不支持的，一种折衷的实现方式 是文本的排版显示通过系统控件，将文本显示内容截图，通过占位图填充的方式在 PAG 中使用。

文本字体显示：

由于字体文件一般都比较大，pag 文件中不会包含字体文件，但文本内容的显示依赖于字体文件。

如果需要显示特定字体，无论那个平台就需要进行字体注册。字体注册相关接口参考 PAGFont 的相关方法。 RegisterFont 方法 用来注册字体，SetFallbackFontPaths 用来设置字体回退列表。当输入文本的字体无法匹配到时，会使用回退列表中的字体。

在Android、iOS、macOS 和 Windows 平台，我们内部注册了部分系统字体为回退字体，所以即便没有注册字体，文本的字体没 有匹配到也可以回退到部分系统字体。但在 Linux 平台没有注册默认字体为回退字体的逻辑，因此如果没有注册字体，文本是无法 正常显示的。

如果 PAG 文件中的字体设置了特殊的字体，由于桌面端预览工具 PAGViewer 没有提供注入外部字体的功能，可能在显示层面与 AE 中的效果不一致， 但这不影响在终端的使用，终端通过注入字体可以达到和 AE 中相同的效果。