Unity 字体渲染:Text 与 TextMeshPro 的原理、使用与描边等效果
UGUI 的整体原理见 UGUI 原理与核心机制。
一、字体渲染的基础
字体文件里存的是什么
TTF、OTF 等字体文件中,每个字符的形状(字形,Glyph)是用轮廓曲线(贝塞尔曲线)描述的矢量数据,另外还有排版需要的度量信息:
| 度量 | 含义 |
|---|---|
| Advance | 画完这个字后,光标前进多少 |
| Bearing | 字形相对于光标位置的偏移 |
| Ascender / Descender | 基线以上、以下的最大高度,用于计算行高 |
| Kerning | 特定字符组合之间的间距调整(如 “AV” 要靠近一些) |
GPU 不能直接画曲线
GPU 擅长画三角形和采样贴图,不擅长直接画曲线。所以游戏中的文字渲染都是这样做的:
- 把字形光栅化成位图,放进一张大贴图(字体图集)中;
- 每个字符生成一个四边形(4 个顶点),UV 指向图集中对应的字形;
- 一段文字就是一组四边形,用一个材质一次性画出来。
旧版 Text 和 TextMeshPro 都遵循这个思路,区别在于图集中存的是什么。
二、旧版 Text
原理:动态字体纹理
把 TTF 文件导入 Unity 后得到一个 Font 资源。默认是动态字体:
- 运行时用到某个字符时,用 FreeType 按照当前的字号和样式把它光栅化,写进字体纹理中(
Font.RequestCharactersInTexture)。 - 同一个字在 20 号和 40 号时是两个不同的位图,各占一份空间。
- 纹理放满了,Unity 会扩大纹理并重建,所有使用这个字体的文字都要重新生成网格(
Font.textureRebuilt回调),可能造成卡顿。
问题
| 问题 | 原因 |
|---|---|
| 缩放后模糊 | 位图按固定字号生成,放大后就是放大位图 |
| 描边、阴影开销大 | Outline 组件通过复制顶点实现,顶点数变成 5 倍;Shadow 变成 2 倍(见 网格生成) |
| 字号多时纹理压力大 | 每个字号各存一份位图 |
| Best Fit 开销大 | 为了自动适应大小,要反复尝试不同字号 |
| 排版能力有限 | 富文本标签少,不支持图文混排 |
Unity 已经推荐使用 TextMeshPro 代替旧版 Text。新版本中 TextMeshPro 已经合并进 UGUI 包。
位图字体
伤害数字、计分板这类只用到少量字符、风格夸张的文字,美术常常直接画好每个数字的图片,做成位图字体(BMFont 工具导出,或者自定义 Font 的字符信息)。它就是普通的图片拼接,效果完全由美术控制,开销也很小。TextMeshPro 中可以用 Sprite Asset 实现同样的效果(见后文)。
三、TextMeshPro 的原理:SDF
什么是 SDF
SDF(Signed Distance Field,有向距离场):图集中每个像素存的不是”这里是不是字”,而是”这里离字形的边缘有多远”:
字形外部 边缘 字形内部距离: 0.0 ──── 0.3 ──── 0.45 ── 0.5 ── 0.55 ──── 0.7 ──── 1.0 ▲ 0.5 就是字形的边缘- 值为 0.5 的位置是字形的边缘;
- 大于 0.5 在字形内部,越大离边缘越远;
- 小于 0.5 在外部。
渲染时,片元着色器采样到距离值,大于 0.5 就画成文字颜色,小于 0.5 就透明。
为什么放大不会模糊
普通位图放大时,相邻像素之间的颜色插值会让边缘变成一片模糊的灰色。
而距离值在像素之间做插值后,仍然是一个合理的距离。不管放大多少倍,“0.5 的那条线”始终可以被准确地算出来,所以边缘依然锐利。
float d = SAMPLE_TEXTURE2D(_MainTex, sampler_MainTex, uv).a; // 距离float w = fwidth(d); // 当前一个屏幕像素对应的距离变化float alpha = smoothstep(0.5 - w, 0.5 + w, d); // 在边缘附近一个像素宽度内做抗锯齿过渡fwidth 让抗锯齿的范围始终是”屏幕上的一个像素”,所以不管文字显示得多大多小,边缘都是平滑的一个像素宽。
这是简化后的原理代码。TMP 实际的 Shader 中还会根据字号、缩放、Gradient Scale 等参数换算,但核心思想一致。
距离场带来的能力
因为知道每个像素离边缘多远,很多效果只需要在 Shader 中换一个判断方式就能实现,不增加任何顶点:
| 效果 | 判断方式 |
|---|---|
| 字体本身 | 距离 > 0.5 |
| 加粗、变细(Dilate) | 把阈值从 0.5 往下或往上移 |
| 描边 | 距离在 [0.5 - 描边宽度, 0.5] 之间的部分涂描边色 |
| 柔边 | 扩大 smoothstep 的过渡范围 |
| 阴影(Underlay) | 用偏移后的 UV 再采样一次,画在字的下面 |
| 发光 | 按距离边缘的远近衰减 |
具体实现见第六节。
SDF 的局限
- 效果的宽度受 Padding 限制:生成图集时,每个字形四周会留出一圈空白(Padding),距离信息只存在于这个范围内。描边、发光的宽度不能超过它。
- 尖角会变圆:生成时的采样精度(Sampling Point Size)低时,细小的尖角和笔画细节会丢失。
- 特别小的字号:SDF 在很小的字号下,清晰度可能不如专门为这个字号光栅化的位图。
四、字体资源(Font Asset)
TMP 不直接使用 TTF,而是由 TTF 生成 TMP_FontAsset,其中包含:字形的 SDF 图集、每个字形的度量和 UV、默认材质。
生成参数
在 Font Asset Creator(Window → TextMeshPro → Font Asset Creator)中设置:
| 参数 | 说明 |
|---|---|
| Sampling Point Size | 生成 SDF 时的字号。越大细节越好,但每个字占的图集空间越大 |
| Padding | 字形四周留白的大小,决定描边、发光等效果的最大宽度。通常为采样字号的 10% 左右 |
| Atlas Resolution | 图集大小,如 1024 或 2048 |
| Character Set | 包含哪些字符:ASCII、自定义字符、从文件读取等 |
| Render Mode | SDF 的生成方式。SDFAA 速度快,适合动态生成;SDF8、SDF16、SDF32 质量更高,生成更慢 |
静态与动态
| 静态(Static) | 动态(Dynamic) | |
|---|---|---|
| 图集内容 | 生成时就确定,包含指定的字符 | 运行时用到新字符时才生成并加入图集 |
| 需要 TTF 源文件 | 运行时不需要 | 运行时需要,要打进包里 |
| 首次显示新字符 | 无开销 | 要实时生成 SDF,可能造成卡顿 |
| 适合 | 字符固定的内容 | 玩家名字、聊天等无法预知的内容 |
动态字体资源的图集满了,可以开启多图集(Multi Atlas Textures),自动新建一张图集继续写入。
后备字体(Fallback)
一个字体资源中找不到某个字符时,会依次在后备字体列表中查找:
主字体(静态:英文 + 常用 3500 个汉字) └─ 后备 1(动态:完整中文字库,用到才生成) └─ 后备 2(日文、韩文……) └─ TMP Settings 中的全局后备字体后备字体的字形在另一张图集中,使用另一个材质,所以同一段文字中混用了后备字体的字符,会多出额外的绘制批次。
五、中文字体方案
中文的难点
- 字符多:常用汉字约 3500 个,GB2312 有 6763 个,全部的 CJK 字符有数万个。全部做成静态图集,需要多张大图集。
- 图集内存:TMP 图集是单通道(Alpha8),每个像素 1 字节。一张 4096 × 4096 的图集就是 16 MB。
- 字体文件大:完整的中文 TTF 往往有十几 MB,动态字体需要把它打进包里。
常见方案
静态常用字 + 动态后备(最常用):
- 主字体:静态图集,包含英文、数字、标点、游戏中实际出现的所有文字。可以写个工具扫描配置表和界面 Prefab,自动收集用到的字符。
- 后备字体:动态,挂完整的字体文件,处理玩家输入、昵称等无法预知的字。
字体裁剪:对动态后备用的 TTF,用工具去掉不需要的字符(比如只保留常用的 7000 字),缩小包体。
多语言:每种语言一个主字体资源,切换语言时替换,或者通过后备链统一处理。完整的多语言方案见 多语言本地化。
字体版权
商业项目使用的字体必须有商用授权。系统自带的很多中文字体(比如部分 Windows 系统字体)不允许嵌入游戏中商用。可以使用免费可商用的开源字体,例如思源黑体(Source Han Sans / Noto Sans CJK),或者购买字体厂商的商用授权。
六、效果的实现
TMP 的材质效果
TMP 的效果都在材质上配置(使用 TextMeshPro/Distance Field 等 Shader):
| 效果 | 材质参数 |
|---|---|
| Face | 文字主体的颜色、贴图、Dilate(粗细)、Softness(柔边) |
| Outline | 描边的颜色、宽度,也可以叠加贴图 |
| Underlay | 阴影:颜色、偏移、Dilate、Softness |
| Glow | 发光:颜色、内外范围、强度 |
| Bevel / Lighting | 根据距离场的梯度计算法线,做出浮雕、金属的立体感 |
描边的原理(简化):
float d = SAMPLE_TEXTURE2D(_MainTex, sampler_MainTex, uv).a;float w = fwidth(d);
float faceEdge = 0.5; // 字体本身的边缘float outlineEdge = 0.5 - _OutlineWidth * 0.5; // 描边的外边缘,往外扩一段距离
float faceAlpha = smoothstep(faceEdge - w, faceEdge + w, d);float outlineAlpha = smoothstep(outlineEdge - w, outlineEdge + w, d);
// 字的内部显示文字颜色,字外面、描边范围内显示描边颜色,再往外透明half4 color = lerp(_OutlineColor, _FaceColor, faceAlpha);color.a *= outlineAlpha;阴影的原理:用偏移后的 UV 再采样一次距离,按同样的方法得到阴影的形状,画在文字的下层:
float shadowD = SAMPLE_TEXTURE2D(_MainTex, sampler_MainTex, uv - _UnderlayOffset).a;float shadowAlpha = smoothstep(0.5 - _UnderlaySoftness, 0.5 + _UnderlaySoftness, shadowD + _UnderlayDilate);// 最终颜色 = 文字颜色叠加在阴影颜色之上和旧版 Text 的 Outline 组件(复制 4 份顶点)相比,SDF 描边只是多算几行 Shader,顶点数不变,描边也更均匀圆滑。
材质预设(Material Preset)
同一个字体,经常需要多种风格:白字黑边、黄字红边、带阴影……
- 为同一个字体资源创建多个材质预设,每个预设设置不同的效果参数,它们共用同一张图集。
- 在 TMP 组件的 Material Preset 下拉框中切换。
- 使用相同预设的文字可以合批;不同预设是不同的材质,不能合批。
代码中修改效果参数的注意事项:
tmp.fontMaterial.SetFloat(ShaderUtilities.ID_OutlineWidth, 0.2f); // 会为这个文字创建一个材质实例tmp.fontSharedMaterial.SetFloat(ShaderUtilities.ID_OutlineWidth, 0.2f); // 修改共享材质,所有用它的文字都变和 renderer.material 一样,访问 fontMaterial 会复制出材质实例,打断合批。批量的风格差异应该用材质预设,而不是在运行时逐个修改。
颜色渐变
TMP 组件自带 Color Gradient:给文字四边形的四个顶点设置不同的颜色,实现上下或左右渐变。它是顶点色,不影响合批,也不需要额外材质。
更复杂的渐变(比如多段颜色、斜向渐变),可以在材质的 Face 中使用渐变贴图。
旧版 Text 的效果
| 效果 | 做法 | 开销 |
|---|---|---|
| 描边 | Outline 组件:向四个方向各复制一份顶点,画成描边色 | 顶点 × 5 |
| 阴影 | Shadow 组件:复制一份偏移后的顶点 | 顶点 × 2 |
| 渐变 | 自定义 BaseMeshEffect 修改顶点色 | 小 |
| Shader 描边 | 自定义 Shader,在片元着色器中向周围多个方向采样字体纹理,有字的地方就画描边 | 顶点不变,采样次数增加 |
七、TMP 的使用
两种组件
| 组件 | 用途 |
|---|---|
TextMeshProUGUI | UI 中的文字,挂在 Canvas 下,参与 UGUI 的合批和遮罩 |
TextMeshPro | 3D 场景中的文字,使用 MeshRenderer,比如场景中的告示牌、头顶名字 |
富文本
<color=#FF0000>红色</color> <b>粗体</b> <i>斜体</i> <size=150%>放大</size><u>下划线</u> <s>删除线</s> <mark=#FFFF0080>高亮</mark>H<sub>2</sub>O x<sup>2</sup> <cspace=5>字间距</cspace> <nobr>不换行</nobr><font="Title SDF">换字体</font> <material="Title SDF - Outline">换材质预设</material><link="item_1001">[传说之剑]</link>可点击的链接(聊天中的物品链接、玩家名字):
public void OnPointerClick(PointerEventData e){ int index = TMP_TextUtilities.FindIntersectingLink(tmp, e.position, e.pressEventCamera); if (index != -1) { string id = tmp.textInfo.linkInfo[index].GetLinkID(); // "item_1001" ShowItemTips(id); }}图文混排:Sprite Asset
把一组小图(表情、货币图标)做成 TMP Sprite Asset,就可以在文字中直接插入:
获得 <sprite name="coin"> × 100 // 按名字<sprite=3> // 按索引图标会随文字一起排版、换行。伤害数字也可以把美术画好的数字图做成 Sprite Asset 来显示。
排版设置
- Auto Size:在给定范围内自动调整字号以适应区域。和旧版的 Best Fit 一样,需要多次尝试排版,开销较大,文字频繁变化时慎用。
- Overflow:文字超出区域时的处理:
Overflow(溢出显示)、Ellipsis(末尾显示省略号)、Truncate(截断)、Masking、Page(分页)、Linked(溢出的部分接到另一个文本组件中)等。 - Wrapping:是否自动换行。
- 字间距、行间距、段间距、对齐方式。
打字机效果
async UniTask TypeWriter(TMP_Text tmp, CancellationToken token){ tmp.ForceMeshUpdate(); int total = tmp.textInfo.characterCount; for (int i = 0; i <= total; i++) { tmp.maxVisibleCharacters = i; // 只显示前 i 个字,不需要重新生成文字 await UniTask.Delay(50, cancellationToken: token); }}用 maxVisibleCharacters 而不是逐字截取字符串,避免每次都重新排版,也不会因为富文本标签被截断而显示出错。
逐字动画
TMP 排版后,每个字符的顶点都可以通过 textInfo 拿到,修改后提交即可实现波浪、抖动、逐字弹出等效果:
void Update(){ tmp.ForceMeshUpdate(); var textInfo = tmp.textInfo; for (int i = 0; i < textInfo.characterCount; i++) { var ch = textInfo.characterInfo[i]; if (!ch.isVisible) continue;
var verts = textInfo.meshInfo[ch.materialReferenceIndex].vertices; var offset = new Vector3(0, Mathf.Sin(Time.time * 5 + i * 0.5f) * 5, 0); // 波浪 for (int j = 0; j < 4; j++) verts[ch.vertexIndex + j] += offset; } tmp.UpdateVertexData(TMP_VertexDataUpdateFlags.Vertices);}这段示例每帧都调用
ForceMeshUpdate重新生成网格,便于理解。实际使用时可以只在文字变化时生成一次,缓存原始顶点,每帧只修改顶点位置。
八、性能注意事项
| 注意点 | 说明 |
|---|---|
| 避免字符串分配 | tmp.text = "HP: " + hp 每次都生成新字符串。TMP 提供了不产生 GC 的格式化接口:tmp.SetText("HP: {0}", hp) |
| 内容没变就不要赋值 | 每次设置文字都会重新排版、生成网格,并引起 Canvas 重建 |
| 少用 Auto Size | 多次排版尝试,开销大 |
不要随意访问 fontMaterial | 会创建材质实例,打断合批。用材质预设 |
| 注意后备字体 | 后备字体的字符在另一张图集中,会增加批次 |
| 预热动态字体 | 首次出现新字符时要实时生成 SDF,可以在加载阶段用 TMP_FontAsset.TryAddCharacters 预先加入需要的字符 |
| 控制图集数量和大小 | 每张图集都占内存,中文字体尤其注意 |
| 关闭 Raycast Target | 纯展示的文字不需要接收点击 |
UGUI 层面的通用优化见 UGUI 性能优化。
常见追问
TextMeshPro 和旧版 Text 有什么区别? Text 运行时按字号光栅化位图,放大模糊,描边阴影靠复制顶点;TMP 使用 SDF 图集,任意缩放都清晰,描边阴影发光在 Shader 中实现,不增加顶点,富文本和排版能力也更强。
SDF 的原理是什么?为什么放大不模糊? 图集中每个像素存储到字形边缘的距离,0.5 为边缘。渲染时根据距离判断内外。距离值插值后仍然准确,所以任何缩放下都能精确找到边缘。
TMP 的描边是怎么实现的? 在 Shader 中把阈值往外扩:距离在字形边缘外一定范围内的像素画成描边色。描边宽度受生成图集时的 Padding 限制。
旧版 Text 的 Outline 组件有什么问题? 通过向四个方向复制顶点实现,顶点数变成 5 倍,文字多时开销大,描边也不均匀。
中文字体怎么处理? 常用字和游戏中出现的文字做成静态图集,再挂一个动态的完整字库作为后备,处理玩家输入等不可预知的字符;同时注意字体的商用授权。
后备字体会带来什么问题? 后备字体的字形在另一张图集中,使用另一个材质,会增加绘制批次;动态生成时首次出现新字符可能卡顿。
怎么做多种风格的文字(不同描边颜色)?
同一个字体资源创建多个材质预设,共享图集。不要在运行时访问 fontMaterial 逐个修改,那样会生成材质实例打断合批。
打字机效果怎么做?
设置 maxVisibleCharacters 逐步增加,不需要截取字符串,也不会把富文本标签截断。
频繁更新的数字文本怎么避免 GC?
使用 SetText("{0}", value) 这类格式化接口,并且只在值变化时更新。
文章分享
如果这篇文章对你有帮助,欢迎分享给更多人!