awtk/tools/font_gen
2021-12-19 11:36:40 +08:00
..
.gitignore init 2018-02-21 19:36:38 +08:00
font_dump.c support 4bit fonts 2021-12-19 11:36:40 +08:00
font_gen.c support 4bit fonts 2021-12-19 11:36:40 +08:00
font_gen.h support 4bit fonts 2021-12-19 11:36:40 +08:00
gen_ascii.c add nanovg lcd 2018-04-13 10:25:58 +08:00
main.c support 4bit fonts 2021-12-19 11:36:40 +08:00
README.md support 4bit fonts 2021-12-19 11:36:40 +08:00
SConscript add fontdump 2021-12-14 17:50:22 +08:00

字体工具

点阵字体生成工具

1. 功能


fontgen 从指定的 tff 文件,提取指定字符集(从文件中读取)的 glyph生成点阵字体文件二进制或者 C 语言常量数组)。

2. 用法

Usage: ./bin/fontgen ttf_filename str_filename out_filename font_size [mono|4bits]
  • ttf_filename tff 文件名。
  • str_filename 字符集合 需要哪些字符就把那些字符放在本文件中UTF-8 编码,参考 demos/assets/default/raw/fonts/text.txt)。
  • output_filename 输出文件名。如果文件扩展名为“.bin“生成二进制格式否则生成 C 语言常量数据。
  • font_size 字体大小(像素)。
  • mono 是否生成单色字体,目前只有启用 freetype 时才有效。可选。
  • 4bits 每个点用4位表示(可选默认8位)。

示例:

./bin/fontgen design/default/fonts/default_full.ttf test.txt test.bin 18

3. 文本文件格式


为了使用方便,在文本文件中,除了可以直接列出需要的字符外,也可以指定一个范围,或者混合两种用法。

  • 范围用 括起来,中间用-分隔。
[[0-9]]
  • 指定 ASCII 字符范围。下面的文本表示所有数字,小写字母和大写字母。
[[0-9]][[a-z]][[A-Z]]
  • 用十进制指定 uncode 的范围。下面的文本表示"中丮丯"三个字符。
[[20013-20015]]
  • 用十六进制指定 uncode 的范围。下面的文本表示"中丮丯"三个字符。
[[0x4e2d-0x4e2f]]

[[0X4e2d-0X4e2f]]

[[0X4E2D-0X4E2F]]

从 TTF 字体文件中提取部分字体

可以使用 fonttools 中的 pyftsubset 工具提取:

安装:

pip install fonttools

示例:

pyftsubset ../../../fonts/msyh.ttf --text-file=../../demos/assets/raw/fonts/text.txt  --output-file=../../demos/assets/raw/fonts/default.mini.ttf