00 · 外置起步包
这是课程的独立外置起步包:显式声明四类 Terrain fallback 路由、两张 persistent 纹理、整帧目标和一个包自有 present Program。当前没有可选效果或配置分支。
当前仅有静态证据
静态检查已通过。课程另行记录绑定测试宿主与精确源码身份的运行观察;加载步骤从第 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.md | 2581 | f7eb49f0f4b0… |
| shaderpack.json | 8592 | 24aea018e57e… |
| shaders/fullscreen.vsh | 298 | 77e9c0fcd780… |
| shaders/present.psh | 183 | e4237dad4d34… |
明确整帧目标
以下是从完整 Manifest 提取的 /frameTarget 值。帧开始时清理颜色与深度附件;Terrain opaque 命令按当前 Scene ABI 再清理深度,Terrain 颜色加载已有帧颜色。这里描述目标归属,不代表已经证明所有世界渲染器在实机中表现正确。
{
"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;本包不复制内置着色器源码。
[
{
"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 属于本包。
#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);
}#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
{
"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。
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