在 GPU 上实现高质量矢量字体渲染时，用 Slug…

适用于需要在任意缩放下无纹理图集、无预栅格化地渲染 TrueType/OpenType 字形并实现高质量抗锯齿的 GPU 字体渲染场景。

适用场景

解决思路

1. 采用 Slug 的总体做法：把 TrueType/OpenType 字形轮廓编码为二次 Bézier 曲线和线段列表，在片段着色器中直接解算 coverage，不使用纹理图集或预栅格化纹理。
2. 获取 Slug 参考实现：执行 `git clone https://github.com/EricLengyel/Slug.git`。
3. 将仓库中的 `.hlsl` 文件（如 `slug.hlsl`、`band.hlsl`、`curve.hlsl`）复制到你的着色器目录；在管线中通过 `#include "slug.hlsl"` 和 `#include "curve.hlsl"` 引入。
4. 在 CPU 端预处理字体轮廓：把 TrueType/OTF 字形轮廓转换成 Slug 的 curve buffer 格式。
5. 将字形轮廓分解为二次 Bézier 曲线段和线段。
6. 把曲线数据上传到 GPU 的 structured buffer 或 texture buffer。
7. 为每个字形预计算 band 元数据，用于 band 优化。
8. 字形轮廓保持在 font units（通常每 em 0–2048 或 0–1000）。
9. 在顶点着色器中把 glyph-space 坐标作为插值顶点属性传给片段着色器。
10. 在片段着色器中通过统计 Y 方向上的有符号曲线交叉次数（winding number）计算覆盖率。
11. 定义曲线数据格式：线段存 `p0`、`p1`；二次 Bézier 存 `p0`、控制点 `p1`、终点 `p2`；用额外字段或 padding 编码类型/标志。结构如 `struct CurveRecord { float2 p0; float2 p1; float2 p2; }`。
12. 实现 band 优化：把字形包围盒按水平方向分成若干 band。
13. 每个 band 只存储与该 band 相交的曲线，把每片段计算复杂度从 O(所有曲线) 降到 O(局部曲线)。
14. 片段着色器输入包括 `position`、`glyphCoord`、`bandOffset`、`curveCount`；用 `StructuredBuffer<float4> CurveBuffer : register(t0)` 读取曲线。
15. 在片段着色器入口调用 `ComputeGlyphCoverage(input.glyphCoord, CurveBuffer, input.bandOffset, input.curveCount)` 得到 coverage。
16. 输出预乘 alpha 颜色：`float4(textColor.rgb * coverage, coverage)`。
17. 实现二次 Bézier 覆盖率函数 `QuadraticBezierCoverage(p, p0, p1, p2)`：先变换到 canonical space，计算 `a = p1 - p0`、`b = p0 - 2.0 * p1 + p2`。
18. 在二次 Bézier 覆盖率函数中，为求 Bézier 的 Y 等于 `p.y` 的 t 值，设 `delta = p - p0`、`A = b.y`、`B = a.y`、`C = p0.y - p.y`。
19. 当 `abs(A) > 1e-6` 时，计算判别式 `disc = B * B - A * C`；若 `disc >= 0`，计算 `sqrtDisc = sqrt(disc)`，`t0 = (-B - sqrtDisc) / A`，`t1 = (-B + sqrtDisc) / A`。
20. 对每个落在 `[0,1]` 的 t，计算 x：`x = (A * t + 2.0 * B) * t + p0.x + delta.x`，并累加有符号 coverage。
21. 当 `abs(A) <= 1e-6` 时，退化为线性情况：`t = -C / (2.0 * B)`；若 t 在 `[0,1]`，计算 `x = 2.0 * a.x * t + p0.x`，并累加有符号 coverage。
22. 实现线段覆盖率函数 `LineCoverage(p, p0, p1)`：先求 `minY = min(p0.y, p1.y)`、`maxY = max(p0.y, p1.y)`；若 `p.y < minY || p.y >= maxY` 返回 0。
23. 线段覆盖率中，按 `t = (p.y - p0.y) / (p1.y - p0.y)` 插值 X：`x = lerp(p0.x, p1.x, t)`。
24. 线段覆盖率中，按 winding 规则返回：`dir = (p1.y > p0.y) ? 1.0 : -1.0`；若 `p.x <= x` 则返回 `dir`，否则返回 0。
25. 为平滑边缘实现抗锯齿：用最近曲线的距离做亚像素覆盖。
26. 实现 `AntiAliasedCoverage(int windingNumber, float distToEdge)`：`bool inside = (windingNumber != 0)`；`float edgeCoverage = clamp(distToEdge + 0.5, 0.0, 1.0)`；返回 `inside ? edgeCoverage : (1.0 - edgeCoverage)`。
27. 顶点着色器输入结构包含 `position : POSITION`、`glyphCoord : TEXCOORD0`、`bandOffset : TEXCOORD1`、`curveCount : TEXCOORD2`。
28. 顶点着色器输出结构包含 `position : SV_Position`、`glyphCoord : TEXCOORD0`，并用 `nointerpolation` 标记 `bandOffset` 和 `curveCount`。
29. 在 `VS_Slug` 中执行 `output.position = mul(float4(input.position, 0.0, 1.0), WorldViewProjection)`，并把 `glyphCoord`、`bandOffset`、`curveCount` 原样传递。
30. CPU 侧加载字体文件并提取字形轮廓：`FontOutline outline = LoadGlyphOutline(font, glyphIndex)`。
31. CPU 侧分解为二次 Bézier：TrueType 本身是二次曲线；OTF 三次曲线必须用二次曲线近似或拆分；例如 `std::vector<SlugCurve> curves = DecomposeToQuadratics(outline)`。
32. CPU 侧计算 band：`float bandHeight = outline.bounds.height / NUM_BANDS`，然后 `std::vector<BandData> bands = ComputeBands(curves, NUM_BANDS, bandHeight)`。
33. CPU 侧上传数据到 GPU：`UploadStructuredBuffer(curveBuffer, curves.data(), curves.size())` 和 `UploadStructuredBuffer(bandBuffer, bands.data(), bands.size())`。
34. 对每个字形实例，把每 band 的 `bandOffset` 和 `curveCount` 存到顶点数据中，使片段着色器可直接索引。
35. 设置混合状态为预乘 alpha：`BlendEnable = TRUE`，`SrcBlend = ONE`，`DestBlend = INV_SRC_ALPHA`，`BlendOp = ADD`，`SrcBlendAlpha = ONE`，`DestBlendAlpha = INV_SRC_ALPHA`，`BlendOpAlpha = ADD`。
36. 设置深度状态：通常文字叠加层 `DepthEnable = FALSE`，`DepthWriteMask = ZERO`。
37. 设置光栅化状态：`CullMode = NONE`，`FillMode = SOLID`，因为字形 quad 是 2D。
38. 渲染字符串时，为字符串中的每个 glyph 发一个覆盖该 glyph 包围盒的 quad（2 个三角形）。
39. 每个顶点携带：屏幕位置、同一角在 font units 中的 glyph-space 坐标、该 glyph 的 `bandOffset` 和 `curveCount`。
40. 用 `EmitQuad(min, max, glyphMin, glyphMax, glyph.bandOffset, glyph.curveCount)` 形式发出 quad，其中 min/max 是屏幕坐标，glyphMin/glyphMax 是字体单位坐标。
41. 缩放文本时只在 CPU 侧变换屏幕空间 quad；glyph-space 坐标保持不变，片段着色器始终在 font units 中工作。
42. 计算缩放：`float scale = desiredPixelSize / font.unitsPerEm`，`float2 screenMin = origin + glyph.fontMin * scale`，`float2 screenMax = origin + glyph.fontMax * scale`。
43. 问题：字形 hollow/inverted。原因：winding order 反了。修复：检查轮廓方向；TrueType 外轮廓使用顺时针。
44. 问题：边缘锯齿。原因：未应用抗锯齿。修复：确保计算 distance-to-edge 并用于最终 coverage。
45. 问题：性能差。原因：band 优化未生效。修复：验证每片段曲线数较小（< ~20）；增加 band 数量。
46. 问题：三次曲线不渲染。原因：OTF 三次 Bézier 不被原生支持。修复：在 CPU 端将三次曲线拆分为二次近似。
47. 问题：字形重叠处出现伪影。原因：曲线未裁剪到 band。修复：上传前把曲线 Y 范围裁剪到 band 范围。
48. 问题：显示黑方块而不是字形。原因：混合状态错误。修复：使用预乘 alpha 混合（`ONE`，`INV_SRC_ALPHA`）。
49. 问题：字形缺失。原因：band offset 不正确。修复：验证 `bandOffset` 索引与 buffer 布局对齐。
50. 如果分发使用该代码的软件，必须按许可证给 Eric Lengyel 和 Slug 算法署名；建议署名文本：`Font rendering uses the Slug Algorithm by Eric Lengyel (https://jcgt.org/published/0006/02/02/)`。
51. 参考 Slug 论文（JCGT 2017）、博客（A Decade of Slug）和 GitHub 仓库以了解算法更新与实现细节。

适用边界 · 注意事项

• 渲染管线不支持可编程顶点/片段着色器时，无法使用 Slug，因为覆盖率必须在 shader 中计算。
• 只需要固定小尺寸、低质量或已有预烘焙纹理图集字体时，引入 Slug 的曲线缓冲、band 预处理和 shader 复杂度不划算。
• 无法在 CPU 端做字体轮廓预处理（提取、分解为二次 Bézier、上传曲线与 band 元数据）时，不适合直接集成该参考实现。