4. 字形渲染模式：FT_RENDER_MODE_NORMAL、FT_RENDER_MODE_LIGHT、FT_RENDER_MODE_MONO、FT_RENDER_MODE_LCD
渲染模式，说白了就是告诉 FreeType：「你要怎么把那个数学轮廓变成屏幕上的像素点。」
我刚开始接触 FreeType 时，觉得这玩意儿不就是个开关嘛。后来在项目里踩了坑才发现——选错模式，轻则字体发虚，重则整个 UI 的阅读体验直接崩掉。
FreeType 提供了四种核心渲染模式。咱们一个一个过。
4.1 FT_RENDER_MODE_NORMAL：标准抗锯齿
这是默认模式。它用 8 位灰度表示每个像素的覆盖程度。0 表示完全透明，255 表示完全不透明。
说白了，就是让字体的边缘有「半透明」的过渡。你想想看，如果没有这个过渡，字体的斜线就会像楼梯一样，一阶一阶的，特别扎眼。
核心特点：
- 输出 8 位灰度位图（每个像素 1 字节）
- 边缘平滑，适合屏幕阅读
- 对字体 hinting 敏感——hinting 做得好，字就清晰；hinting 做差了，字就糊
我在一个电子书阅读器项目里用过这个模式。当时觉得效果不错，直到用户反馈说「小字号下字体重叠」。后来发现是 hinting 没开对，加上渲染模式没配合好。
4.2 FT_RENDER_MODE_LIGHT：轻量抗锯齿
这个模式跟 NORMAL 很像，也是 8 位灰度。但有一个关键区别——它禁用水平方向的 hinting。
为什么会这样？
因为 hinting 虽然能让字形对齐像素网格，但有时候会破坏字体的原始比例。特别是水平方向，hinting 一用力，字间距就变得不均匀了。
| 对比项 | FT_RENDER_MODE_NORMAL | FT_RENDER_MODE_LIGHT |
|---|---|---|
| 水平 hinting | 启用 | 禁用 |
| 垂直 hinting | 启用 | 启用 |
| 输出格式 | 8 位灰度 | 8 位灰度 |
| 适用场景 | 正文阅读，对清晰度要求高 | 标题、大字号，对字形比例要求高 |
我的习惯：做嵌入式 UI 时，正文用 NORMAL，标题用 LIGHT。这样正文清晰，标题舒展。你可以试试看。
4.3 FT_RENDER_MODE_MONO：黑白二值
这个模式只输出 1 位位图。每个像素要么是 0（白），要么是 1（黑）。没有灰度，没有过渡。
听起来很原始对吧？但它在嵌入式系统里反而很常用。
- 优势：内存占用极小。一个 100x100 的字符，NORMAL 模式要 10KB，MONO 模式只要 1.25KB。
- 劣势：锯齿明显。小字号下几乎没法看。
我曾经在一个低端 MCU 项目里用过 MONO 模式。那个芯片只有 64KB RAM，跑 NORMAL 模式直接内存溢出。换成 MONO 模式后，配合 hinting 优化，效果勉强能接受。
注意：MONO 模式对 hinting 的依赖极高。没有 hinting 的 MONO 渲染，字形会严重变形。如果你用 MONO 模式，一定要确保字体文件包含 hinting 指令，或者你自己做 hinting 优化。
4.4 FT_RENDER_MODE_LCD：亚像素渲染
这个模式利用了 LCD 屏幕的物理特性。每个像素其实由 R、G、B 三个子像素组成。LCD 模式把每个子像素当作一个独立的「微型像素」来处理。
效果就是：水平分辨率提升了 3 倍。
我举个例子。一个 12px 的字体，在 NORMAL 模式下只有 12 个像素点来描述水平细节。但在 LCD 模式下，相当于有 36 个「子像素点」。字体的边缘自然就细腻多了。
| 参数 | FT_RENDER_MODE_LCD |
|---|---|
| 输出格式 | 24 位彩色位图（每个子像素 1 字节） |
| 水平分辨率 | 3 倍于 NORMAL |
| 内存占用 | 3 倍于 NORMAL |
| 适用屏幕 | 标准 RGB 排列的 LCD 屏幕 |
关键点：LCD 模式输出的位图是彩色的。如果你要把它显示在单色屏或灰度屏上，需要做颜色转换。否则会出现「彩色边缘」的诡异效果。
嗯，这里要注意。LCD 模式还有一个变体叫 FT_RENDER_MODE_LCD_V，它是垂直方向的亚像素渲染。但说实话，我在实际项目中几乎没用过。因为大多数 LCD 屏幕的子像素排列是水平的，垂直方向做亚像素没有意义。
4.5 四种模式的对比与选择
我整理了一张对比表，方便你快速决策。
| 模式 | 位深 | 抗锯齿 | 内存 | 适用场景 |
|---|---|---|---|---|
| NORMAL | 8 位 | 是 | 中 | 通用屏幕阅读 |
| LIGHT | 8 位 | 是（水平 hinting 关闭） | 中 | 大字号、标题 |
| MONO | 1 位 | 否 | 低 | 低端 MCU、OLED 屏 |
| LCD | 24 位 | 是（亚像素） | 高 | 高分辨率 LCD 屏 |
选择其实不难。你只要问自己三个问题：
- 屏幕是什么类型？——LCD 屏优先考虑 LCD 模式；OLED 或单色屏用 NORMAL 或 MONO。
- 内存够不够？——RAM 紧张就上 MONO，配合 hinting 优化。
- 对字形比例要求高不高？——高就用 LIGHT，避免 hinting 破坏比例。
4.6 渲染模式选择流程图
下面这张图是我自己总结的决策流程。每次做新项目，我都会走一遍这个流程。
一个小技巧：如果你不确定选哪个模式，先用 NORMAL 模式跑一遍。它是最通用的选择。然后根据实际效果再调整。我大部分项目都是从 NORMAL 起步的。
4.7 代码示例：如何设置渲染模式
设置渲染模式其实就一行代码。但要注意，渲染模式是在 FT_Load_Glyph 之后、FT_Render_Glyph 之前设置的。
FT_GlyphSlot slot = face->glyph;
// 加载字形
FT_Load_Glyph(face, glyph_index, FT_LOAD_DEFAULT);
// 设置渲染模式
slot->format = FT_GLYPH_FORMAT_OUTLINE; // 确保是轮廓格式
FT_Render_Glyph(slot, FT_RENDER_MODE_NORMAL); // 这里替换成你需要的模式
// 获取位图
FT_Bitmap* bitmap = &slot->bitmap;嗯，这里有个坑。如果你用的是 FT_Load_Char，它内部会调用 FT_Render_Glyph，默认使用 NORMAL 模式。所以如果你想用其他模式，记得分开调用 FT_Load_Glyph 和 FT_Render_Glyph。
我曾经踩过的坑：在 STM32F4 上做字体渲染时，用了 LCD 模式，但屏幕是单色 OLED。结果字体边缘全是彩色条纹。后来才意识到——LCD 模式输出的彩色位图需要做颜色空间转换。如果你用的是单色屏，老老实实用 MONO 或 NORMAL 模式。
四种模式，各有各的脾气。选对了，渲染效率高、显示效果好。选错了，调试起来能让你怀疑人生。我个人建议，新项目上手先用 NORMAL 模式跑通流程，然后再根据实际需求切换到其他模式。