资源、目标与 drawBuffers
一张纹理只是可存储数据的资源。要把一次绘制的输出写进去,还需要声明绘制目标,并确定着色器输出和目标附件之间的对应关系。
资源声明解决存储问题
资源 ID 用于在配置中引用同一份对象;格式、大小和生命周期决定如何创建和管理它。当前公开资源类型包含 texture2D、textureCube 和 buffer。
以下是说明字段关系的资源对象片段,不构成完整光影包:
{
"id": "example:scene/color",
"kind": "texture2D",
"lifetime": "persistent",
"size": { "mode": "viewport" },
"format": "rgba8"
}这里声明了一个随 viewport 尺寸变化的持久颜色资源。它尚未说明由谁写入,也没有替任何 Program 建立采样输入。
来源:v5 作者指南中的资源与可重建示例 · f8aaa5c4
把四个层次分开
| 层次 | 解决的问题 |
|---|---|
| Resource | 哪个对象保存数据? |
| Target / attachment topology | 本次绘制目标包含哪些颜色或深度附件? |
GLSL 输出 location | 片元着色器从哪个输出位置写出数据? |
drawBuffers | 本次调用启用哪些颜色输出映射? |
附件布局与活动 draw buffers 是两个层次。某个目标包含多个颜色附件,不表示每次绘制都要写入全部附件;反过来,选择一个活动输出也不会自动创建缺失的资源或附件。
深度附件也有独立用途。它参与深度测试和相应深度操作,不能直接当作普通的颜色输出 location 使用。
多个颜色输出:MRT
MRT 让一次绘制产生多个颜色结果。例如一个包可以约定将最终颜色、法线编码和材质信息分别写入不同的颜色附件。
法线和材质的编码属于包自己的约定:生产者怎样编码,后续消费者就要怎样解码。文档中的示意不代表宿主提供了一套固定 G-buffer 格式。
GLSL 中声明多个 layout(location = ...) out 变量以后,还需核对配置里的目标布局、活动 drawBuffers、格式与实际驱动能力。源码能写出这些变量,只完成了其中一部分工作。
来源:v3/v4 指南中的 Scene ABI 与 MRT 示例 · f8aaa5c4
写入和采样分别建立关系
一个后处理读取前一步颜色时,检查以下路径:
生产命令 → 命名资源 → 后续命令的输入绑定 → sampler目标负责写入,binding 负责把资源连接到着色器输入。给资源取一个与 uniform 相似的名字,不会自动建立采样关系。
还要检查资源尺寸是否符合预期、数据是否需要保留、生产者是否在当前选项下启用,以及当前调用是否存在读写危害。
常见排查顺序
画面全黑或某个附件没有预期内容时,先核对:
- 资源是否存在,且格式适用于当前用途。
- 当前活动图中是否有命令写入该资源。
- 目标附件与输出 location 是否对应,
drawBuffers是否启用了预期输出。 - 消费者是否绑定了同一个资源,以及正确的 view / history。
- GLSL、帧缓冲与设备端结果是否有真实驱动证据。
用 Analyzer 定位配置与离线接口问题,再进入实际图形驱动验证。