排版是精美嵌入式界面的核心。本指南介绍 anyui-LIVE 中的自定义字体管理、排版设置以及字体相关功能。

概述

anyui-LIVE 允许你只导入一次自定义字体文件，并在整个项目中复用。字体会被转换为字体库并嵌入到生成的固件中，因此目标设备无需依赖宿主操作系统即可渲染文字。

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

自定义字体管理

在资源管理界面中管理字体：

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

create_font_library

字体库设置

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

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

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

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

注

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

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

排版设置

字体通过排版属性应用到文本组件上。常用属性如下：

属性描述
字体使用的字体库（在自定义字体管理中创建）。
字号渲染字形的大小。
文字颜色字形的颜色。
行高文本行之间的垂直间距。
字间距字形之间的水平间距。
对齐水平对齐方式：左、中或右。
文本样式加粗、斜体、下划线或删除线。

排版可在编辑器中于画布上编辑，并在预览中实时渲染。

字体转换选项

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

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

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

注意

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

相关指南

  • 图片 - 与字体一同管理位图资源。
  • 工作区 - 字体资源的存放位置。
  • 概览 - 在画布上应用排版属性。
  • 预览 - 在生成前验证字体渲染。
  • 代码生成 - 字体库如何成为生成代码。
  • 移植 - 目标设备上的内存与配置。