从TTF到BDF：为U8G2高效定制中文字体的实践指南

1. 为什么需要定制U8G2中文字体

嵌入式开发中经常遇到一个头疼的问题：如何在有限的硬件资源下优雅地显示中文。U8G2作为嵌入式图形库的佼佼者，虽然自带英文字体支持，但对中文的支持却需要开发者自己动手。这就像给你一套精美的西餐餐具，却要你自己打造筷子来吃中餐。

我遇到过最典型的场景是在128x64的OLED屏上显示产品参数。系统自带的英文字体很漂亮，但一到中文就变成乱码。最初尝试过外挂字库芯片的方案，不仅增加了BOM成本，读取速度还慢得让人抓狂。后来发现U8G2其实支持BDF点阵字体，这才打开了新世界的大门。

BDF字体就像乐高积木，每个字都是固定大小的像素块。它的优势在于：

• 资源占用可控：只包含需要的字符，不像TTF那样包含全套字库
• 渲染速度快：不需要实时计算矢量轮廓
• 兼容性好：U8G2原生支持BDF转换后的C代码

但直接使用现成的BDF字体往往不合适。比如文泉驿的9pt字体包含6000+常用汉字，实际项目可能只需要几十个特定字符（如"温度"、"湿度"等）。这就好比带着整个工具箱出门，其实只需要一把螺丝刀。

2. 字体转换的核心原理与工具选型

2.1 TTF与BDF的本质区别

TTF就像用数学公式描述的矢量图，可以无限缩放而不失真。BDF则是固定分辨率的像素图，放大后会出现锯齿。这就解释了为什么直接转换会有毛边问题——矢量到点阵的采样过程就像用网格临摹一幅画，细节必然丢失。

在技术实现上：

• TTF使用贝塞尔曲线定义字形轮廓
• BDF用二进制矩阵记录每个像素的开关状态
• 转换过程本质是栅格化(Rasterization)

2.2 工具链的选择与优化

经过多次踩坑，我最终选定了Easy-u8g2-font-generate-tools这个Python工具。原版工具已经三年没更新，存在几个痛点：

1. 字符输入方式单一（只能手动输入）
2. 文件选择不够直观
3. 强制TTF→BDF转换流程

我的改进版主要做了这些优化：

• 增加文本文件导入功能（把需要的字写在txt里）
• 可视化文件选择器
• 支持直接使用现有BDF字体
• 去除影响显示的ANSI颜色代码

安装非常简单：

bash复制git clone https://gitee.com/etberzin/Easy-u8g2-font-generate-tools
cd Easy-u8g2-font-generate-tools
pip install -r requirements.txt

3. 实战：从TTF生成定制BDF字体

3.1 准备源字体文件

建议将字体文件放在指定目录：

• TTF文件放入/font文件夹
• BDF文件放入/bdf文件夹
• 待转换文字放入/text文件夹

对于中文显示，推荐这些开源字体：

• 文泉驿点阵体（原生BDF格式）
• 思源黑体（TTF格式）
• 阿里巴巴普惠体（TTF格式）

3.2 分步生成流程

1. 字符集准备：
   创建一个UTF-8编码的txt文件，例如menu.txt，内容包含所有需要显示的汉字：

   code复制主菜单
   设置
   温度
   湿度
   返回
   

2. 运行转换工具：

   bash复制python main.py
   

3. 关键参数设置：

   • 字体大小：9pt≈12x12px，10pt≈13x13px
   • 间距设置：保持默认即可
   • ASCII过滤：建议启用（使用U8G2内置英文字体）

4. 输出结果：

   • code/目录下生成C/C++源文件
   • bdf.tga预览图

3.3 常见问题解决

毛边问题：

• 优先选择点阵源字体（如文泉驿）
• 对于TTF转换，建议字号≥12pt
• 可以先用FontForge手动调整hinting

字号不匹配：

python复制# 字号与像素对应关系
size_map = {
    '9pt': (12,12),
    '10pt': (13,13),
    '11pt': (15,15),
    '12pt': (16,16)
}

字符缺失：

• 检查txt文件编码必须为UTF-8
• 确认源字体包含目标字符
• 繁体字需使用对应字体

4. 在U8G2项目中集成自定义字体

4.1 文件集成方式

生成的文件结构示例：

code复制u8g2_font_menu.c
u8g2_font_menu.h

头文件内容模板：

c复制#pragma once
#include "u8g2.h"

extern const uint8_t u8g2_font_menu[] U8G2_FONT_SECTION("u8g2_font_menu");

使用时只需：

c复制u8g2_SetFont(&u8g2, u8g2_font_menu);
u8g2_DrawUTF8(&u8g2, 10, 20, "温度:25℃");

4.2 内存优化技巧

对于资源紧张的MCU：

1. 使用PROGMEM关键字将字体存入Flash
2. 分段生成字体（如菜单项单独生成）
3. 复用相同字符（多个C文件共用字符集）

实测数据对比（STM32F103）：

4.3 显示效果调优

遇到显示错位时检查：

1. 字体基准线(baseline)设置
2. 字符间距(kerning)参数
3. 显示缓冲区的位深匹配

调试小技巧：

c复制// 显示字体边界框
u8g2_DrawFrame(&u8g2, x, y-height, width, height);

5. 高级应用与替代方案

5.1 动态字体生成

对于需要动态变更内容的场景（如用户输入），可以采用：

1. 运行时生成BDF（需集成Freetype）
2. 预生成常用字符组合
3. 混合使用内置字体+自定义字体

5.2 替代方案对比

5.3 性能优化实践

在ESP32上的实测数据显示：

• 直接渲染：约2ms/字符
• 使用显示列表：0.5ms/字符
• 双缓冲技术：可提升帧率30%

关键代码片段：

c复制// 创建显示列表
u8g2_uint_t dl = u8g2_GetDisplayList(&u8g2, "你好世界");
// 重复使用
u8g2_DrawDisplayList(&u8g2, x, y, dl);

经过多个项目的实战检验，这套字体定制方案在STM32、ESP8266、ESP32等平台上都表现稳定。特别是在智能家居控制面板这类需要中英文混合显示的场合，既能保证显示效果，又不会过度消耗宝贵的硬件资源。