4. 渲染管线与调试视角
嵌入式 GPU 的渲染管线可以理解为一条“几何数据逐步变成屏幕像素”的流水线。调试时如果只盯着最终画面，往往很难判断问题出在哪个阶段。更有效的方式是把管线拆成四个可观察阶段：顶点处理、光栅化、片元处理、输出合并，并为每个阶段建立独立的调试视角——看输入、看中间结果、看状态、看输出。
一、顶点处理：几何数据的第一次“体检”
顶点处理阶段负责把模型空间的顶点属性，经过模型、视图、投影矩阵变换到裁剪空间，并完成法线变换、骨骼蒙皮、顶点动画等计算。调试时最值得关注的是“输入是否正确”和“输出是否合理”。
- 输入检查：顶点缓冲的步长、偏移、属性格式是否与着色器声明一致。例如位置是
float3，但步长按float4读取，会导致顶点错位。 - 矩阵检查：MVP 矩阵是否每帧更新，转置与乘法顺序是否符合 API 约定。嵌入式平台常见列主序与行主序混用问题。
- 数值检查：变换后坐标是否出现 NaN、Inf 或远超裁剪范围的数值，通常由除零、未初始化矩阵或骨骼权重异常引起。
调试技巧：将顶点着色器输出直接改为位置颜色，或用线框模式观察三角形连接关系，可以快速判断是顶点数据错还是索引错。
二、光栅化：从图元到片元的“覆盖判定”
光栅化阶段完成图元装配、裁剪、视口变换和三角形覆盖判定，并生成片元及其插值属性。这个阶段的问题往往表现为“模型整体消失”“面片缺失”或“边缘锯齿异常”。
- 面剔除与绕序：顺时针/逆时针绕序设置错误，会导致正面被剔除，模型看起来“内外翻转”或直接消失。
- 视口与裁剪：视口尺寸、深度范围、裁剪平面设置不当，会让几何体落在屏幕外或被错误裁剪。
- 插值问题：重心坐标插值依赖顶点属性，若属性未正确传递，片元阶段会得到错误颜色或纹理坐标。
常见误区：把“模型消失”直接归因于顶点着色器。实际上，面剔除、视口错误、深度范围错误都会造成同样现象，必须逐项排除。
三、片元处理：颜色与纹理的“计算中心”
片元处理阶段执行纹理采样、光照计算、Alpha 测试、discard 以及混合前的颜色计算。它是调试中最容易观察、也最容易出错的阶段。
- 纹理采样：检查纹理是否绑定、采样坐标是否越界、过滤模式与 mipmap 是否正确。嵌入式平台对非 2 次幂纹理和压缩纹理格式较敏感。
- 精度问题：移动 GPU 常用 mediump/highp，精度不足会导致颜色断层、光照闪烁或坐标抖动。
- 分支与 discard：过度使用 discard 会破坏早期深度测试，影响性能；分支发散也会导致部分片元结果异常。
// 片元着色器调试片段：输出法线可视化
vec3 n = normalize(vNormal);
gl_FragColor = vec4(n * 0.5 + 0.5, 1.0);
// 若颜色异常，优先检查 vNormal 是否被正确插值四、输出合并：最终像素的“守门员”
输出合并阶段执行深度测试、模板测试、混合和写掩码，最终把片元颜色写入帧缓冲。这个阶段的问题通常表现为遮挡关系错误、透明物体排序异常或颜色叠加不对。
- 深度测试：深度函数（LESS/GREATER/EQUAL）与深度写入开关必须匹配。透明物体通常关闭深度写入，否则会遮挡后续片元。
- 混合设置：源因子与目标因子配置错误，会导致透明物体过亮、过暗或完全不可见。
- Z-Fighting：深度精度不足或两个面共面时，会出现闪烁条纹，可通过调整近远平面或使用深度偏移缓解。
五、四阶段调试关注点对照表
| 阶段 | 核心输入 | 核心输出 | 调试关注点 | 常见问题 |
|---|---|---|---|---|
| 顶点处理 | 顶点属性、索引、矩阵 | 裁剪空间坐标 | 步长、偏移、矩阵更新、NaN | 顶点错位、模型消失、骨骼异常 |
| 光栅化 | 图元、视口、裁剪面 | 片元及插值属性 | 绕序、面剔除、视口、深度范围 | 面片缺失、内外翻转、边缘异常 |
| 片元处理 | 插值属性、纹理、常量 | 片元颜色、Alpha | 采样坐标、精度、discard、分支 | 颜色异常、纹理错位、闪烁 |
| 输出合并 | 片元颜色、深度、模板 | 帧缓冲像素 | 深度函数、混合因子、写掩码 | 遮挡错误、透明排序、Z-Fighting |
六、案例与复盘：一个“模型半透明异常”的排查过程
某嵌入式设备上，一个半透明 UI 面板出现“边缘发黑、背景被遮挡”的现象。排查过程如下：
- 用 GPU 捕获工具抓取一帧，确认顶点处理阶段坐标正常，排除几何问题。
- 切换到线框模式，光栅化覆盖正常，排除面剔除与视口问题。
- 查看片元输出，发现 Alpha 值正确，但颜色偏暗，怀疑混合设置。
- 检查输出合并状态，发现深度写入未关闭，且混合因子使用了
ONE / ZERO，导致透明区域被深度遮挡且未混合。 - 修正为关闭深度写入、使用
SRC_ALPHA / ONE_MINUS_SRC_ALPHA后，问题解决。
复盘结论：透明渲染问题优先检查输出合并阶段，而不是片元着色器。深度写入与混合因子是嵌入式 GPU 调试中最容易被忽略的两个状态。
整体来看，渲染管线调试的关键是建立“阶段化”思维：顶点处理看数据与变换，光栅化看覆盖与裁剪，片元处理看采样与计算，输出合并看测试与混合。每个阶段都有独立的输入、输出和状态，只有把问题定位到具体阶段，才能用最小的修改代价解决它。