本指南介绍 anyui-LIVE 中的字体库管理与字体相关功能。
概述
anyui-LIVE 区分两个相关概念:
| 术语 | 定义 |
|---|---|
| 字体 | 由你导入的字体文件(*.ttf、*.otf 或 *.woff),通常包含某个语言的完整字符集,如英文或中文。 |
| 字体库 | 只包含设计所需部分字符的专用库,会转换为 C 源数组并嵌入生成的固件。 |
仅导入字体文件还不足以渲染文字:还需创建字体库,指定所用的字体文件和设计需要的字符。字体文件在资源管理中导入。
字体库管理
字体库在字体库视图中管理:

字体库设置
| 设置 | 描述 |
|---|---|
| 库名称 | 字体库的名称;也是生成字体变量名的一部分。 |
| 字体资产 | 此库使用的字体文件。请先在资源管理中导入字体文件。 |
| 字号 | 生成字体库时使用的字号。 |
| Bpp | 生成的字体的每像素位数。 |
| 字符 | 字体库中包含的预设字符。 |
| 范围 | 字体库中包含的字符范围。 |
| 符号 | 字体库中包含的额外字符。 |
| 标志 | 字体转换的额外选项。默认值为 --no-compress --no-prefilter。 |
多数项目只需关注以下几项:
- 库名称 - 使用有意义的名称。
- 字体资产 - 选择正确的字体文件。
- 范围/符号 - 至少其中一项不能为空。
其余选项不熟悉时,保持默认值即可。
注
标志 选项控制 LVGL 的字体转换:
--no-compress:关闭字体压缩。--no-prefilter:关闭字体预过滤。
字体库转换选项
生成阶段会把字体库转换为字形位图表。关键转换选项:
- Bpp(每像素位数) - 取值较低(如 1 或 2)时内存占用小,但抗锯齿质量下降;取值较高(如 4)质量更好,内存也随之增加。
- 范围 - 只包含界面实际用到的字符码,让字体表保持精简。
- 符号 - 补充不在连续范围内的字形,如图标。
精简字符集是压缩字体库 ROM 占用最有效的手段。生成的字体代码如何进入构建,参见代码生成指南。
注意
请确认你导入和使用的每个字体都已获得相应授权,相关责任由你自行承担。