跳转到正文

00 · 外置起步包 ​

这是课程的独立外置起步包:显式声明四类 Terrain fallback 路由、两张 persistent 纹理、整帧目标和一个包自有 present Program。当前没有可选效果或配置分支。

当前仅有静态证据

静态检查已通过。课程另行记录绑定测试宿主与精确源码身份的运行观察;加载步骤从第 00 章开始。

进入第 00 章:加载起步包

下载与身份 ​

下载起步包 ZIP · 源码清单与片段映射 · 静态验证收据

解压到新目录,根目录直接包含 shaderpack.json、README.md 和 shaders/,不依赖上一章文件。本包是分配两张纹理的外置包,不能当作零扩展资源的 BuiltIn Minimal。

压缩包 SHA-256:

432356b77d9247a98a764064b5cc7a290d033ad609064b4edaedf62d63bbe034

源码指纹:

a85731589fbb852352a486c378d51cb49a6b27e38a749aaf16a199bf98ba12be

源码指纹覆盖基线、示例 ID 与精确文件字节;它和 Loader canonical manifest hash、ZIP 哈希分别表示不同身份。

源码文件 ​

网站源码 · Manifest v5 / Scene ABI v2 · docs-tools-f8aaa5c4-w1.1

文件字节SHA-256
README.md2581f7eb49f0f4b0…
shaderpack.json859224aea018e57e…
shaders/fullscreen.vsh29877e9c0fcd780…
shaders/present.psh183e4237dad4d34…

明确整帧目标 ​

以下是从完整 Manifest 提取的 /frameTarget 值。帧开始时清理颜色与深度附件;Terrain opaque 命令按当前 Scene ABI 再清理深度,Terrain 颜色加载已有帧颜色。这里描述目标归属,不代表已经证明所有世界渲染器在实机中表现正确。

json
{
  "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
    }
  }
}

显式 Terrain 路由 ​

四类路由都使用 builtin,完整 Manifest 中还为每一类声明一条不指定 Program 的 engineDraw 命令。Dawnlight 为其生成对应 fallback Program;本包不复制内置着色器源码。

json
[
  {
    "id": "dawnlight:scene/terrain_opaque",
    "version": 1,
    "mode": "builtin"
  },
  {
    "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"
  }
]

本包自有着色器 ​

顶点着色器从 gl_VertexID 生成全屏四边形;片元着色器采样场景颜色,不额外改变颜色空间。这两个文件的 source owner 属于本包。

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
precision highp float;
uniform sampler2D u_sceneColor;
in vec2 v_uv;
layout(location = 0) out vec4 o_color;
void main() {
    o_color = texture(u_sceneColor, v_uv);
}

完整 Manifest ​

shaderpack.json
json
{
  "manifestVersion": 5,
  "sceneAbiVersion": 2,
  "expectedCatalogSha256": "4bc28c17beffea2311a422fff9f633d2e4f03784460d0254adda8af2e766d84c",
  "id": "course:starter",
  "name": "DawnlightCore Course Starter",
  "version": "0.1.0",
  "author": "EltanceX",
  "description": "External v5 starter with explicit built-in terrain routes and frame target.",
  "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"
    }
  ],
  "programs": [
    {
      "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": [],
      "commands": [
        {
          "type": "engineDraw",
          "sceneProvider": {
            "id": "dawnlight:scene_draw/terrain_opaque",
            "version": 2
          },
          "targets": {
            "colors": [
              {
                "location": 0,
                "resource": "course:scene/color",
                "loadOp": "load",
                "storeOp": "store"
              }
            ],
            "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
          }
        }
      ],
      "inputs": [
        "course:scene/color",
        "course:scene/depth"
      ],
      "outputs": [
        "course:scene/color",
        "course:scene/depth"
      ]
    },
    {
      "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"
              }
            ],
            "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"
      ],
      "outputs": [
        "course:scene/color",
        "course:scene/depth"
      ]
    },
    {
      "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"
              }
            ],
            "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"
      ],
      "outputs": [
        "course:scene/color",
        "course:scene/depth"
      ]
    },
    {
      "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"
              }
            ],
            "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"
      ],
      "outputs": [
        "course:scene/color",
        "course:scene/depth"
      ]
    },
    {
      "id": "course:present",
      "enabled": true,
      "stage": {
        "template": "dawnlight:command_list",
        "version": 1,
        "target": "afterDraw",
        "phase": "screenOutput"
      },
      "services": [],
      "programs": [
        "course:post/present"
      ],
      "commands": [
        {
          "type": "present",
          "program": "course:post/present",
          "bindings": [
            {
              "kind": "sampler2D",
              "symbol": "u_sceneColor",
              "binding": 0,
              "resource": "course:scene/color"
            }
          ],
          "state": {
            "blend": "opaque",
            "depth": "disabled",
            "rasterizer": "cullNoneScissor"
          },
          "viewport": {
            "source": "frame",
            "restore": "none",
            "synchronizeScissor": true
          }
        }
      ],
      "inputs": [
        "course:scene/color"
      ],
      "outputs": []
    }
  ],
  "sceneCategories": [
    {
      "id": "dawnlight:scene/terrain_opaque",
      "version": 1,
      "mode": "builtin"
    },
    {
      "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"
    }
  ]
}

已经检查什么 ​

固定 Analyzer 对源码目录和新解压 ZIP 分别运行以下命令。文件哈希、canonical manifest hash 和归一化 Analyzer 输出一致。收据绑定源码指纹、ZIP SHA-256 与工具清单 SHA-256。

powershell
shaderpack-analyzer.exe pack validate . --format json
shaderpack-analyzer.exe scene explain . --include-inactive --format json
shaderpack-analyzer.exe graph dump . --contract 2 --include-inactive
shaderpack-analyzer.exe program interface . --program course:post/present --contract 2

仍需完成的实机检查 ​

下述静态收据不提供运行证据。第 00 章与实机记录另行增加按日期记录的驱动报告、画面和生命周期观察;完整类别覆盖、device reset 与其他平台仍未验证。单纯路由解析成功不能替代画面证据。

driverStatus=notProvided · runtimeEvaluated=false · liveWorldVerified=false · visual=notRun

阅读 Analyzer 的证据边界

作者文档 · Manifest v5 / Scene ABI v2