跳转到正文

04 · 写入并查看 MRT 数据 ​

一次 opaque 绘制输出颜色、法线与教学材质数据,后处理显示法线调试图。前置:03、附件 location、uint 与位运算。

本章修改与完整包 ​

增加 normal / material 两张 RGBA8 纹理;Terrain 的 named target topology 包含 RT0/RT1/RT2 与相同深度。opaque 显式 drawBuffers=[0,1,2],fragment 输出三路,grade 读取辅助纹理。frameTarget 保持 RT0 + depth,以承接普通世界渲染。总计 5 张纹理、6 条命令。

下载并核对全部文件

资源流 ​

opaque → RT0 颜色 / RT1 法线 / RT2 数据 → grade 调试视图 → post/color → present

目标拓扑说明挂了哪些附件,drawBuffers 说明本次绘制启用哪些输出。其余三类 BuiltIn fallback 保留三附件 named topology,但解析 recipe 只启用 RT0;不能在 fallback 声明上直接填写 drawBuffers(会触发 DLMAN0001)。opaque 清零辅助目标并加载已有颜色,深度按 ABI 清理。宿主法线是 oct 编码的 RG 字节及符号字节,经 /255 原样写入 RGB;A=1 表示本课程 opaque 写入。本章直接显示编码,不能把 RGB 当作 XYZ 做 rgb*2-1 后归一化,方向解码留待后续。material 的 R/G 保存顶点 identifier 低 16 位的低/高字节,B 保存示范亮度,A 标记有效。这是课程约定,不是宿主 G-buffer 或稳定内容/材质 ID ABI。用 texelFetch 和整数坐标读取,避免过滤混合标识符字节。

完整着色器 ​

glsl
#version 320 es
precision highp float;
out vec2 v_uv;
void main() {
    const vec2 corners[4] = vec2[4](vec2(-1.0, -1.0), vec2(1.0, -1.0), vec2(-1.0, 1.0), vec2(1.0, 1.0));
    vec2 position = corners[gl_VertexID & 3];
    v_uv = position * 0.5 + 0.5;
    gl_Position = vec4(position, 0.0, 1.0);
}
glsl
#version 320 es
// <Semantic Name='TEXCOORD' Attribute='a_texcoord' />
// <Semantic Name='POSITION' Attribute='a_position' />
// <Semantic Name='COLOR' Attribute='a_color' />
// <Semantic Name='IDENTIFIER' Attribute='a_identifier' />
// <Semantic Name='NORMAL' Attribute='a_normal' />
// <Semantic Name='LIGHTLEVEL' Attribute='a_lightLevel' />
// <Semantic Name='PURELIGHT' Attribute='a_pureLight' />
// <Semantic Name='HEIGHTDATA' Attribute='a_heightData' />
uniform mat4 u_viewProjectionMatrix;
uniform vec2 u_origin;
uniform float u_lightTable[96];
layout(location = 0) in vec2 a_texcoord;
layout(location = 1) in vec3 a_position;
layout(location = 2) in vec4 a_color;
layout(location = 3) in uint a_identifier;
layout(location = 4) in vec3 a_normal;
layout(location = 5) in float a_lightLevel;
layout(location = 6) in float a_pureLight;
layout(location = 7) in float a_heightData;
out vec2 v_texcoord;
out vec4 v_color;
out vec3 v_normalEncoded;
flat out uint v_identifier;
void main() {
    int lightIndex = clamp(int(a_lightLevel) - 1, 0, 95);
    float light = clamp(u_lightTable[lightIndex], 0.0, 1.0);
    v_texcoord = a_texcoord;
    v_color = vec4(a_color.rgb * light, a_color.a);
    v_normalEncoded = clamp(a_normal / 255.0, 0.0, 1.0);
    v_identifier = a_identifier;
    vec3 relativePosition = vec3(a_position.x - u_origin.x, a_position.y, a_position.z - u_origin.y);
    gl_Position = u_viewProjectionMatrix * vec4(relativePosition, 1.0);
    OPENGL_POSITION_FIX;
}
glsl
#version 320 es
// <Sampler Name='u_samplerState' Texture='u_texture' />
precision highp float;
precision highp int;
uniform sampler2D u_texture;
in vec2 v_texcoord;
in vec4 v_color;
in vec3 v_normalEncoded;
flat in uint v_identifier;
layout(location = 0) out vec4 o_sceneColor;
layout(location = 1) out vec4 o_sceneNormal;
layout(location = 2) out vec4 o_sceneMaterial;
void main() {
    vec4 albedo = texture(u_texture, v_texcoord) * v_color;
    o_sceneColor = vec4(albedo.rgb * vec3(0.92, 1.0, 0.92), albedo.a);
    o_sceneNormal = vec4(v_normalEncoded, 1.0);
    // Pack convention: two identifier bytes, demonstration luminance, validity.
    float lowByte = float(v_identifier & 255u) / 255.0;
    float highByte = float((v_identifier >> 8u) & 255u) / 255.0;
    float luminance = dot(albedo.rgb, vec3(0.2126, 0.7152, 0.0722));
    o_sceneMaterial = vec4(lowByte, highByte, clamp(luminance, 0.0, 1.0), 1.0);
}
glsl
#version 320 es
precision highp float;
precision highp int;
uniform sampler2D u_sceneColor;
uniform sampler2D u_sceneNormal;
uniform sampler2D u_sceneMaterial;
in vec2 v_uv;
layout(location = 0) out vec4 o_color;
void main() {
    const int DEBUG_VIEW = 1; // 0: color, 1: encoded normal, 2: identifier bytes
    vec3 color = texture(u_sceneColor, v_uv).rgb;
    ivec2 size = textureSize(u_sceneNormal, 0);
    ivec2 pixel = clamp(ivec2(v_uv * vec2(size)), ivec2(0), size - 1);
    vec4 normalData = texelFetch(u_sceneNormal, pixel, 0);
    vec4 materialData = texelFetch(u_sceneMaterial, pixel, 0);
    if (DEBUG_VIEW == 1) {
        // Host encoded-normal bytes (oct RG plus a sign byte), not XYZ.
        // Display the encoding directly; decoding is outside this chapter.
        color = normalData.a > 0.5 ? normalData.rgb : vec3(0.12);
    } else if (DEBUG_VIEW == 2) {
        uint identifier = uint(round(materialData.r * 255.0)) | (uint(round(materialData.g * 255.0)) << 8u);
        color = materialData.a > 0.5 ? vec3(float(identifier & 15u) / 15.0, materialData.b, float((identifier >> 4u) & 15u) / 15.0) : vec3(0.12);
    }
    o_color = vec4(color, 1.0);
}
glsl
#version 320 es
precision highp float;
uniform sampler2D u_postColor;
in vec2 v_uv;
layout(location = 0) out vec4 o_color;
void main() {
    o_color = texture(u_postColor, v_uv);
}

完整 Manifest ​

shaderpack.json
json
{
  "manifestVersion": 5,
  "sceneAbiVersion": 2,
  "expectedCatalogSha256": "4bc28c17beffea2311a422fff9f633d2e4f03784460d0254adda8af2e766d84c",
  "id": "course:04-mrt",
  "name": "DawnlightCore Course 04-mrt",
  "version": "0.1.0",
  "author": "EltanceX",
  "description": "Write MRT data; independent v5 course snapshot, runtime not yet verified.",
  "shaderRoot": "shaders",
  "options": [],
  "resources": [
    {
      "id": "course:scene/color",
      "kind": "texture2D",
      "lifetime": "persistent",
      "size": {
        "mode": "viewport"
      },
      "format": "rgba8"
    },
    {
      "id": "course:scene/depth",
      "kind": "texture2D",
      "lifetime": "persistent",
      "size": {
        "mode": "viewport"
      },
      "format": "depth24"
    },
    {
      "id": "course:post/color",
      "kind": "texture2D",
      "lifetime": "persistent",
      "size": {
        "mode": "viewport"
      },
      "format": "rgba8"
    },
    {
      "id": "course:scene/normal",
      "kind": "texture2D",
      "lifetime": "persistent",
      "size": {
        "mode": "viewport"
      },
      "format": "rgba8"
    },
    {
      "id": "course:scene/material",
      "kind": "texture2D",
      "lifetime": "persistent",
      "size": {
        "mode": "viewport"
      },
      "format": "rgba8"
    }
  ],
  "programs": [
    {
      "id": "course:scene/terrain",
      "kind": "graphics",
      "vertex": "terrain.vsh",
      "fragment": "terrain.psh",
      "compileMode": "officialCompatible"
    },
    {
      "id": "course:post/grade",
      "kind": "graphics",
      "vertex": "fullscreen.vsh",
      "fragment": "grade.psh",
      "compileMode": "manifestDriven"
    },
    {
      "id": "course:post/present",
      "kind": "graphics",
      "vertex": "fullscreen.vsh",
      "fragment": "present.psh",
      "compileMode": "manifestDriven"
    }
  ],
  "frameTarget": {
    "targets": {
      "colors": [
        {
          "location": 0,
          "resource": "course:scene/color",
          "loadOp": "clear",
          "storeOp": "store",
          "clearValue": [
            0,
            0,
            0,
            1
          ]
        }
      ],
      "depth": {
        "resource": "course:scene/depth",
        "loadOp": "clear",
        "storeOp": "store",
        "clearValue": 1
      }
    }
  },
  "passes": [
    {
      "id": "course:terrain_opaque",
      "enabled": true,
      "stage": {
        "template": "dawnlight:command_list",
        "version": 1,
        "target": "world",
        "phase": "opaque"
      },
      "services": [],
      "programs": [
        "course:scene/terrain"
      ],
      "commands": [
        {
          "type": "engineDraw",
          "sceneProvider": {
            "id": "dawnlight:scene_draw/terrain_opaque",
            "version": 2
          },
          "targets": {
            "colors": [
              {
                "location": 0,
                "resource": "course:scene/color",
                "loadOp": "load",
                "storeOp": "store"
              },
              {
                "location": 1,
                "resource": "course:scene/normal",
                "loadOp": "clear",
                "storeOp": "store",
                "clearValue": [
                  0,
                  0,
                  0,
                  0
                ]
              },
              {
                "location": 2,
                "resource": "course:scene/material",
                "loadOp": "clear",
                "storeOp": "store",
                "clearValue": [
                  0,
                  0,
                  0,
                  0
                ]
              }
            ],
            "depth": {
              "resource": "course:scene/depth",
              "loadOp": "clear",
              "storeOp": "store",
              "clearValue": 1
            }
          },
          "state": {
            "blend": "opaque",
            "depth": "default",
            "rasterizer": "cullCounterClockwiseScissor"
          },
          "viewport": {
            "source": "target",
            "restore": "frame",
            "synchronizeScissor": true
          },
          "program": "course:scene/terrain",
          "sceneBindings": [
            {
              "symbol": "u_viewProjectionMatrix",
              "contract": "dawnlight:scene_binding/view_projection",
              "version": 1,
              "frequency": "view"
            },
            {
              "symbol": "u_origin",
              "contract": "dawnlight:scene_binding/terrain_origin",
              "version": 1,
              "frequency": "view"
            },
            {
              "symbol": "u_lightTable",
              "contract": "dawnlight:scene_binding/light_table",
              "version": 1,
              "frequency": "batch"
            },
            {
              "symbol": "u_texture",
              "contract": "dawnlight:scene_binding/block_texture",
              "version": 1,
              "frequency": "draw",
              "binding": 0
            }
          ],
          "drawBuffers": [
            0,
            1,
            2
          ]
        }
      ],
      "inputs": [
        "course:scene/color",
        "course:scene/depth"
      ],
      "outputs": [
        "course:scene/color",
        "course:scene/depth",
        "course:scene/normal",
        "course:scene/material"
      ]
    },
    {
      "id": "course:terrain_alpha_tested",
      "enabled": true,
      "stage": {
        "template": "dawnlight:command_list",
        "version": 1,
        "target": "world",
        "phase": "opaque",
        "ordering": {
          "after": [
            "course:terrain_opaque"
          ]
        }
      },
      "services": [],
      "programs": [],
      "commands": [
        {
          "type": "engineDraw",
          "sceneProvider": {
            "id": "dawnlight:scene_draw/terrain_alpha_tested",
            "version": 2
          },
          "targets": {
            "colors": [
              {
                "location": 0,
                "resource": "course:scene/color",
                "loadOp": "load",
                "storeOp": "store"
              },
              {
                "location": 1,
                "resource": "course:scene/normal",
                "loadOp": "load",
                "storeOp": "store"
              },
              {
                "location": 2,
                "resource": "course:scene/material",
                "loadOp": "load",
                "storeOp": "store"
              }
            ],
            "depth": {
              "resource": "course:scene/depth",
              "loadOp": "load",
              "storeOp": "store"
            }
          },
          "state": {
            "blend": "opaque",
            "depth": "default",
            "rasterizer": "cullCounterClockwiseScissor"
          },
          "viewport": {
            "source": "target",
            "restore": "frame",
            "synchronizeScissor": true
          }
        }
      ],
      "inputs": [
        "course:scene/color",
        "course:scene/depth",
        "course:scene/normal",
        "course:scene/material"
      ],
      "outputs": [
        "course:scene/color",
        "course:scene/depth",
        "course:scene/normal",
        "course:scene/material"
      ]
    },
    {
      "id": "course:terrain_transparent",
      "enabled": true,
      "stage": {
        "template": "dawnlight:command_list",
        "version": 1,
        "target": "world",
        "phase": "transparent"
      },
      "services": [],
      "programs": [],
      "commands": [
        {
          "type": "engineDraw",
          "sceneProvider": {
            "id": "dawnlight:scene_draw/terrain_transparent",
            "version": 2
          },
          "targets": {
            "colors": [
              {
                "location": 0,
                "resource": "course:scene/color",
                "loadOp": "load",
                "storeOp": "store"
              },
              {
                "location": 1,
                "resource": "course:scene/normal",
                "loadOp": "load",
                "storeOp": "store"
              },
              {
                "location": 2,
                "resource": "course:scene/material",
                "loadOp": "load",
                "storeOp": "store"
              }
            ],
            "depth": {
              "resource": "course:scene/depth",
              "loadOp": "load",
              "storeOp": "store"
            }
          },
          "state": {
            "blend": "alphaBlend",
            "depth": "default",
            "rasterizer": "cullCounterClockwiseScissor"
          },
          "viewport": {
            "source": "target",
            "restore": "frame",
            "synchronizeScissor": true
          }
        }
      ],
      "inputs": [
        "course:scene/color",
        "course:scene/depth",
        "course:scene/normal",
        "course:scene/material"
      ],
      "outputs": [
        "course:scene/color",
        "course:scene/depth",
        "course:scene/normal",
        "course:scene/material"
      ]
    },
    {
      "id": "course:terrain_sorted_translucent",
      "enabled": true,
      "stage": {
        "template": "dawnlight:command_list",
        "version": 1,
        "target": "world",
        "phase": "transparent",
        "ordering": {
          "after": [
            "course:terrain_transparent"
          ]
        }
      },
      "services": [],
      "programs": [],
      "commands": [
        {
          "type": "engineDraw",
          "sceneProvider": {
            "id": "dawnlight:scene_draw/terrain_sorted_translucent",
            "version": 2
          },
          "targets": {
            "colors": [
              {
                "location": 0,
                "resource": "course:scene/color",
                "loadOp": "load",
                "storeOp": "store"
              },
              {
                "location": 1,
                "resource": "course:scene/normal",
                "loadOp": "load",
                "storeOp": "store"
              },
              {
                "location": 2,
                "resource": "course:scene/material",
                "loadOp": "load",
                "storeOp": "store"
              }
            ],
            "depth": {
              "resource": "course:scene/depth",
              "loadOp": "load",
              "storeOp": "store"
            }
          },
          "state": {
            "blend": "alphaBlend",
            "depth": "default",
            "rasterizer": "cullCounterClockwiseScissor"
          },
          "viewport": {
            "source": "target",
            "restore": "frame",
            "synchronizeScissor": true
          }
        }
      ],
      "inputs": [
        "course:scene/color",
        "course:scene/depth",
        "course:scene/normal",
        "course:scene/material"
      ],
      "outputs": [
        "course:scene/color",
        "course:scene/depth",
        "course:scene/normal",
        "course:scene/material"
      ]
    },
    {
      "id": "course:grade",
      "enabled": true,
      "stage": {
        "template": "dawnlight:command_list",
        "version": 1,
        "target": "afterDraw",
        "phase": "afterDraw"
      },
      "services": [],
      "programs": [
        "course:post/grade"
      ],
      "commands": [
        {
          "type": "fullscreen",
          "program": "course:post/grade",
          "bindings": [
            {
              "kind": "sampler2D",
              "symbol": "u_sceneColor",
              "binding": 0,
              "resource": "course:scene/color"
            },
            {
              "kind": "sampler2D",
              "symbol": "u_sceneNormal",
              "binding": 1,
              "resource": "course:scene/normal"
            },
            {
              "kind": "sampler2D",
              "symbol": "u_sceneMaterial",
              "binding": 2,
              "resource": "course:scene/material"
            }
          ],
          "state": {
            "blend": "opaque",
            "depth": "disabled",
            "rasterizer": "cullNoneScissor"
          },
          "viewport": {
            "source": "target",
            "restore": "frame",
            "synchronizeScissor": true
          },
          "targets": {
            "colors": [
              {
                "location": 0,
                "resource": "course:post/color",
                "loadOp": "dontCare",
                "storeOp": "store"
              }
            ]
          }
        }
      ],
      "inputs": [
        "course:scene/color",
        "course:scene/normal",
        "course:scene/material"
      ],
      "outputs": [
        "course:post/color"
      ]
    },
    {
      "id": "course:present",
      "enabled": true,
      "stage": {
        "template": "dawnlight:command_list",
        "version": 1,
        "target": "afterDraw",
        "phase": "screenOutput",
        "ordering": {
          "after": [
            "course:grade"
          ]
        }
      },
      "services": [],
      "programs": [
        "course:post/present"
      ],
      "commands": [
        {
          "type": "present",
          "program": "course:post/present",
          "bindings": [
            {
              "kind": "sampler2D",
              "symbol": "u_postColor",
              "binding": 0,
              "resource": "course:post/color"
            }
          ],
          "state": {
            "blend": "opaque",
            "depth": "disabled",
            "rasterizer": "cullNoneScissor"
          },
          "viewport": {
            "source": "frame",
            "restore": "none",
            "synchronizeScissor": true
          }
        }
      ],
      "inputs": [
        "course:post/color"
      ],
      "outputs": []
    }
  ],
  "sceneCategories": [
    {
      "id": "dawnlight:scene/terrain_opaque",
      "version": 1,
      "mode": "override",
      "stage": "course:terrain_opaque"
    },
    {
      "id": "dawnlight:scene/terrain_alpha_tested",
      "version": 1,
      "mode": "builtin"
    },
    {
      "id": "dawnlight:scene/terrain_transparent",
      "version": 1,
      "mode": "builtin"
    },
    {
      "id": "dawnlight:scene/terrain_sorted_translucent",
      "version": 1,
      "mode": "builtin"
    }
  ]
}

验证与画面 ​

解压到新目录,在该包根目录打开 PowerShell,使用环境准备中安装的固定 Analyzer。预期退出码 0、无诊断,scene 显示四条活动 Terrain 路由;静态检查不等于驱动编译。

powershell
$analyzer = "C:\Tools\Dawnlight\shaderpack-analyzer.exe"
& $analyzer pack validate . --format json
& $analyzer scene explain . --include-inactive --format json
& $analyzer graph dump . --contract 2 --include-inactive
& $analyzer program interface . --program course:post/present --contract 2
& $analyzer program interface . --program course:post/grade --contract 2
& $analyzer program interface . --program course:scene/terrain --contract 2

实际游戏观察

在记录的 Windows 宿主与 NVIDIA 驱动上完成加载、同包重载、两种窗口尺寸及切回 BuiltIn;全部已报告 Program 链接成功,Analyzer 匹配驱动报告与各包自有 Program 接口。截图为同一源码快照的单场景观察。

2625bd72b6789d7ad170c827c588944190645fdd33cbaa4d66f19ddcca6a6600

已匹配的驱动报告 · 生命周期观察

直接显示宿主 oct 法线编码字节;灰色区域没有本章 opaque 数据。

测试宿主、方法与限制 →

常见卡点 ​

只见灰色:先确认 opaque 写入 A=1,再核对 grade 绑定。颜色有了但 RT1/2 没数据:检查输出 location 和 drawBuffers。水面/天空不含法线是覆盖边界;辅助纹理只记录 opaque Terrain,甚至可能保留被后续透明物体遮住的表面,不能用于完整可见表面的延迟渲染。额外两张 RGBA8 的标称容量为 8×W×H 字节,不含驱动分配开销。

动手练习 ​

在副本将 DEBUG_VIEW 从 1 改为 2,看低位标识符可视化,再改为 0 恢复颜色。为改动副本重跑接口检查和驱动验证;说明为什么“存在三个附件”不等于“每个场景类别都写三个附件”。

运行方法与证据 · 回顾资源模型

下一章:可选效果与设置

作者文档 · Manifest v5 / Scene ABI v2