本指南介绍 anyui-LIVE 中的字体库管理以及字体相关功能。

概述

anyui-LIVE 区分两个相关概念：

术语定义
字体由你导入的字体文件（*.ttf、*.otf 或 *.woff2），通常包含某个语言的完整字符集，如英文或中文。
字体库只包含设计所需的部分字符集合的专用库，会被转换为 C 源数组并嵌入到生成的固件中。

仅导入字体文件并不能让文字可渲染：你必须创建字体库来选定字体文件以及设计所需的字符。字体文件在资源管理中导入。

相关的资源概念参见图片指南，资源管线参见代码生成指南。

字体库管理

在字体库视图中管理字体库：

  1. 在资源视图中导入字体文件；参见资源管理。
  2. 点击视图栏中的字体库按钮打开字体库视图。
  3. 创建字体库。

create_font_library

字体库设置

设置描述
库名称字体库的名称；也是生成字体变量名的一部分。
字体资产此库使用的字体文件。请先在资源管理中导入字体文件。
字号生成字体库时使用的字号。
Bpp生成的字体的每像素位数。
字符字体库中包含的预设字符。
范围字体库中包含的字符范围。
符号字体库中包含的额外字符。
标志字体转换的额外选项。默认值为 --no-compress --no-prefilter。

对大多数项目而言，最重要的几项是：

  • 库名称 - 使用有意义的名称。
  • 字体资产 - 选择正确的字体文件。
  • 范围/符号 - 至少其中一项不能为空。

如果你不熟悉其他选项，请保持默认值。

注

标志选项控制 LVGL 字体转换：

  • --no-compress：不对字体进行压缩。
  • --no-prefilter：不对字体进行预过滤。

字体库转换选项

生成阶段会将字体库转换为字形位图表。关键转换选项：

  • Bpp（每像素位数） - 较低的值（如 1 或 2）会降低内存占用，但抗锯齿质量下降；较高的值（如 4）提升质量但增加内存。
  • 范围 - 仅包含界面实际使用的字符码，以保持字体表精简。
  • 符号 - 添加不属于连续范围的具体字形（如图标）。

优化字符集是减少字体库 ROM 占用最有效的方式。参见代码生成指南了解生成的字体代码如何集成到构建中。

注意

你有责任确保导入并使用的每个字体都具备相应的权利与许可。

相关指南

  • 资源管理 - 导入字体库使用的字体文件。
  • 图片 - 与字体库一同管理位图资源。
  • 概览 - 在画布上应用排版属性。
  • 预览 - 在生成前验证字体渲染。
  • 代码生成 - 字体库如何成为生成代码。
  • 移植 - 目标设备上的内存与配置。
  • 模拟器 - 在本地机器上运行应用程序。