awtk/docs/awtk_font.md

# AWTK 中支持的字体

AWTK 支持显示以下两种字体：

1. 矢量字库，通常为 .ttf、.otf 格式的文件，AWTK 默认采用 stb 库将矢量字库解析为字模（位图）。
2. 点阵字，即已经解析好的位图字体。

它们的优缺点如下：

| 类型     | 优点                                                       | 缺点                                                                       |
| -------- | ---------------------------------------------------------- | -------------------------------------------------------------------------- |
| 矢量字库 | 管理方便，占用的 flash 空间小                              | 整个字库文件都需要加载到内存中，且需要消耗性能解码，同时解码时存在内存峰值 |
| 点阵字   | 可裁剪掉 AWTK 中的字体解码模块，显示时无需解码，加载速度快 | 由于提前解码好，所以非常占用 flash 空间                                    |

## 1 使用 AWTK 中的工具裁剪字体

如果需要对矢量字库进行裁剪或者生成点阵字，可以使用 AWTK 内置的字体工具，使用方法可以查看 [font_gen](https://github.com/zlgopen/awtk/tree/master/tools/font_gen)。

## 2 使用 AWTK Designer 裁剪字体

使用 AWTK Designer 创建项目后，字体文件一般存储项目目录的 `design/default/fonts` 中，其中包含以下目录或文件：

| 目录/文件   | 作用                                 |
| ----------- | ------------------------------------ |
| config      | 存放裁剪字体文件的配置               |
| origin      | 存放被裁剪前的原始字体文件           |
| default.ttf | 项目当前使用的被裁剪后的缺省矢量字库 |

使用 AWTK Designer 可以裁剪字体文件与生成点阵字文件，详情请参阅 [awtk文档](https://awtk.zlg.cn/docs) 中 "FAQ常见问题" 里的 "AWTK Designer" 章节。