08 · A post chain and its cost
Add a separate half-resolution glow after grading and validate three output paths. Prerequisites: chapter 07, separate read/write resources from chapter 02 and viewport sizing. Estimate nominal capacity and explain the quality/cost tradeoff.
Changes and complete download
Add a course:post/glow RGBA8 texture with size.scale=[0.5,0.5], a glow Program/Pass and present-glow. Glow is active only with grade=true and glow=true. grade=false always selects present-raw even if glow remains true. grade=true/glow=false selects present-grade.
Previous chapter download · This complete ZIP, source inventory and receipt
Resource flow
grade writes post/color. glow samples it into a distinct post/glow, which present reads. Sampling the same subresource being written would create framebuffer feedback. glow orders after grade and present-glow after glow. Pass inputs/outputs must agree with bindings and targets.
The shader uses textureSize for input pixel spacing and samples the center plus four neighbors. It adds the part of blur above 0.55 at strength 0.16. Execution occurs in the half-size target before screen upsampling, so disabling glow preserves more sharpness. This is LDR teaching glow: RGBA8 has already clipped HDR range. It is not HDR bloom, physical exposure or a separable blur chain.
Ignoring rounding, the full-size post/color adds 4WH bytes and half-size post/glow adds WH. Scene color uses another 4WH; actual depth24 storage and driver alignment are separate. Glow performs about 5×WH/4 texture samples plus present upsampling. These are theoretical counts, not measured milliseconds. Disabling grade removes both post textures and their Programs/commands, while opaque still consumes materialTable.
Active branch matrix
Source and freshly extracted ZIP agree for every row. Counts include only active nodes; resources include the material buffer where present.
| Variant | Overrides | Resources | Commands |
|---|---|---|---|
default | {} | 5 | 7 |
grade-off | {"course:grade":false} | 3 | 5 |
strength-max | {"course:strength":1,"course:gain":1.2} | 5 | 7 |
glow-off | {"course:glow":false} | 4 | 6 |
all-off | {"course:grade":false,"course:glow":false} | 3 | 5 |
Exact active closure
default
resource:course:materials, resource:course:post/color, resource:course:post/glow, resource:course:scene/color, resource:course:scene/depth
command:course:glow:0, command:course:grade:0, command:course:present-glow:0, command:course:terrain_alpha_tested:0, command:course:terrain_opaque:0, command:course:terrain_sorted_translucent:0, command:course:terrain_transparent:0
program:course:post/glow, program:course:post/grade, program:course:post/present, program:course:scene/terrain, program:dawnlight:scene_fallback/terrain_alpha_tested, program:dawnlight:scene_fallback/terrain_sorted_translucent, program:dawnlight:scene_fallback/terrain_transparent
Active services: 0
grade-off
resource:course:materials, resource:course:scene/color, resource:course:scene/depth
command:course:present-raw:0, command:course:terrain_alpha_tested:0, command:course:terrain_opaque:0, command:course:terrain_sorted_translucent:0, command:course:terrain_transparent:0
program:course:post/present, program:course:scene/terrain, program:dawnlight:scene_fallback/terrain_alpha_tested, program:dawnlight:scene_fallback/terrain_sorted_translucent, program:dawnlight:scene_fallback/terrain_transparent
Active services: 0
strength-max
resource:course:materials, resource:course:post/color, resource:course:post/glow, resource:course:scene/color, resource:course:scene/depth
command:course:glow:0, command:course:grade:0, command:course:present-glow:0, command:course:terrain_alpha_tested:0, command:course:terrain_opaque:0, command:course:terrain_sorted_translucent:0, command:course:terrain_transparent:0
program:course:post/glow, program:course:post/grade, program:course:post/present, program:course:scene/terrain, program:dawnlight:scene_fallback/terrain_alpha_tested, program:dawnlight:scene_fallback/terrain_sorted_translucent, program:dawnlight:scene_fallback/terrain_transparent
Active services: 0
glow-off
resource:course:materials, resource:course:post/color, resource:course:scene/color, resource:course:scene/depth
command:course:grade:0, command:course:present-grade:0, command:course:terrain_alpha_tested:0, command:course:terrain_opaque:0, command:course:terrain_sorted_translucent:0, command:course:terrain_transparent:0
program:course:post/grade, program:course:post/present, program:course:scene/terrain, program:dawnlight:scene_fallback/terrain_alpha_tested, program:dawnlight:scene_fallback/terrain_sorted_translucent, program:dawnlight:scene_fallback/terrain_transparent
Active services: 0
all-off
resource:course:materials, resource:course:scene/color, resource:course:scene/depth
command:course:present-raw:0, command:course:terrain_alpha_tested:0, command:course:terrain_opaque:0, command:course:terrain_sorted_translucent:0, command:course:terrain_transparent:0
program:course:post/present, program:course:scene/terrain, program:dawnlight:scene_fallback/terrain_alpha_tested, program:dawnlight:scene_fallback/terrain_sorted_translucent, program:dawnlight:scene_fallback/terrain_transparent
Active services: 0
Complete shader sources
shaders/fullscreen.vsh
#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);
}shaders/glow.psh
#version 320 es
precision highp float;
uniform sampler2D u_source;
in vec2 v_uv;
layout(location = 0) out vec4 o_color;
void main() {
vec2 pixel = 1.0 / vec2(textureSize(u_source, 0));
vec3 center = texture(u_source, v_uv).rgb;
vec3 blur = center * 0.4;
blur += texture(u_source, v_uv + vec2(pixel.x * 2.0, 0.0)).rgb * 0.15;
blur += texture(u_source, v_uv - vec2(pixel.x * 2.0, 0.0)).rgb * 0.15;
blur += texture(u_source, v_uv + vec2(0.0, pixel.y * 2.0)).rgb * 0.15;
blur += texture(u_source, v_uv - vec2(0.0, pixel.y * 2.0)).rgb * 0.15;
o_color = vec4(clamp(center + max(blur - 0.55, 0.0) * 0.16, 0.0, 1.0), 1.0);
}shaders/grade.psh
#version 320 es
precision highp float;
uniform sampler2D u_sceneColor;
uniform float u_gain;
uniform float u_day;
uniform float u_rain;
in vec2 v_uv;
layout(location = 0) out vec4 o_color;
void main() {
vec3 source = texture(u_sceneColor, v_uv).rgb;
vec3 amber = (source - 0.5) * 1.06 + 0.5;
amber *= vec3(1.06, 1.0, 0.93);
float daylight = 0.5 + 0.5 * sin(6.2831853 * (u_day - 0.25));
amber *= mix(vec3(0.91, 0.96, 1.04), vec3(1.03, 1.01, 0.97), daylight);
amber = mix(amber, amber * vec3(0.91, 0.95, 1.0), u_rain * 0.45) * u_gain;
o_color = vec4(clamp(mix(source, amber, float(GRADE_STRENGTH)), 0.0, 1.0), 1.0);
}shaders/present.psh
#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);
}shaders/terrain.psh
#version 320 es
// <Sampler Name='u_samplerState' Texture='u_texture' />
precision highp float;
precision highp int;
#include "/dawnlight/materials-v1.glsl"
uniform sampler2D u_texture;
in vec2 v_texcoord;
in vec4 v_color;
flat in highp uint v_identifier;
layout(location = 0) out vec4 o_sceneColor;
void main() {
vec4 albedo = texture(u_texture, v_texcoord) * v_color;
highp uint record = LookupMaterial(v_identifier);
vec3 tint = AmberTint(record).rgb;
float response = AmberResponse(record);
if (MaterialHasTag(record, AMBER_MINERAL) && MaterialShaderId(record) == 1u)
response *= 0.75;
o_sceneColor = vec4(albedo.rgb * mix(vec3(1.0), tint, response), albedo.a);
}shaders/terrain.vsh
#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 highp 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;
}Complete Manifest and settings
settings.json
{
"schemaVersion": 1,
"defaultLocale": "en-US",
"translations": {
"zh-CN": {
"page.amber": "琥珀课程",
"course:grade": "调色",
"course:strength": "调色强度(重新编译)",
"course:gain": "曝光增益",
"course:glow": "半分辨率柔光"
},
"en-US": {
"page.amber": "Amber course",
"course:grade": "Color grade",
"course:strength": "Grade strength (recompile)",
"course:gain": "Exposure gain",
"course:glow": "Half-resolution glow"
}
},
"pages": [
{
"id": "amber",
"title": "page.amber",
"groups": [
{
"id": "look",
"controls": [
{
"id": "grade",
"option": "course:grade",
"widget": "toggle",
"label": "course:grade"
},
{
"id": "strength",
"option": "course:strength",
"widget": "slider",
"label": "course:strength",
"min": 0,
"max": 1,
"step": 0.05,
"format": "0.00",
"enabledWhen": [
{
"option": "course:grade",
"equals": true
}
]
},
{
"id": "gain",
"option": "course:gain",
"widget": "slider",
"label": "course:gain",
"min": 0.5,
"max": 1.5,
"step": 0.05,
"format": "0.00",
"enabledWhen": [
{
"option": "course:grade",
"equals": true
}
]
},
{
"id": "glow",
"option": "course:glow",
"widget": "toggle",
"label": "course:glow"
}
]
}
]
}
]
}shaderpack.json
{
"manifestVersion": 5,
"sceneAbiVersion": 2,
"expectedCatalogSha256": "4bc28c17beffea2311a422fff9f633d2e4f03784460d0254adda8af2e766d84c",
"id": "course:08-post-chain",
"name": "Dawnlight Course · Amber 08-post-chain",
"version": "1.0.0",
"author": "EltanceX",
"description": "Website-authored Amber course snapshot; see README for tested scope.",
"shaderRoot": "shaders",
"options": [
{
"id": "course:grade",
"type": "boolean",
"default": true,
"impact": [
"pipeline",
"resources"
]
},
{
"id": "course:strength",
"type": "number",
"default": 0.65,
"min": 0,
"max": 1,
"impact": [
"program"
]
},
{
"id": "course:gain",
"type": "number",
"default": 1,
"min": 0.5,
"max": 1.5,
"impact": [
"uniform"
]
},
{
"id": "course:glow",
"type": "boolean",
"default": true,
"impact": [
"pipeline",
"resources"
]
}
],
"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:materials",
"kind": "buffer",
"lifetime": "persistent",
"usage": "staticDraw",
"content": {
"type": "materialTable",
"version": 1
}
},
{
"id": "course:post/glow",
"kind": "texture2D",
"lifetime": "persistent",
"size": {
"mode": "viewport",
"scale": [
0.5,
0.5
]
},
"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",
"defines": {
"GRADE_STRENGTH": {
"option": "course:strength"
}
}
},
{
"id": "course:post/present",
"kind": "graphics",
"vertex": "fullscreen.vsh",
"fragment": "present.psh",
"compileMode": "manifestDriven"
},
{
"id": "course:post/glow",
"kind": "graphics",
"vertex": "fullscreen.vsh",
"fragment": "glow.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"
}
],
"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
}
],
"bindings": [
{
"kind": "storageBuffer",
"symbol": "MaterialTable",
"binding": 4,
"resource": "course:materials",
"access": "readOnly"
}
]
}
],
"inputs": [
"course:scene/color",
"course:scene/depth",
"course:materials"
],
"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: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"
}
],
"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"
}
]
},
"customBindings": [
{
"symbol": "u_gain",
"variable": "course:gain"
},
{
"symbol": "u_day",
"variable": "course:day"
},
{
"symbol": "u_rain",
"variable": "course:rain"
}
]
}
],
"inputs": [
"course:scene/color"
],
"outputs": [
"course:post/color"
],
"enabledWhen": [
{
"option": "course:grade",
"equals": true
}
]
},
{
"id": "course:glow",
"enabled": true,
"stage": {
"template": "dawnlight:command_list",
"version": 1,
"target": "afterDraw",
"phase": "afterDraw",
"ordering": {
"after": [
"course:grade"
]
}
},
"services": [],
"programs": [
"course:post/glow"
],
"commands": [
{
"type": "fullscreen",
"program": "course:post/glow",
"bindings": [
{
"kind": "sampler2D",
"symbol": "u_source",
"binding": 0,
"resource": "course:post/color"
}
],
"state": {
"blend": "opaque",
"depth": "disabled",
"rasterizer": "cullNoneScissor"
},
"viewport": {
"source": "target",
"restore": "frame",
"synchronizeScissor": true
},
"targets": {
"colors": [
{
"location": 0,
"resource": "course:post/glow",
"loadOp": "dontCare",
"storeOp": "store"
}
]
}
}
],
"inputs": [
"course:post/color"
],
"outputs": [
"course:post/glow"
],
"enabledWhen": [
{
"option": "course:grade",
"equals": true
},
{
"option": "course:glow",
"equals": true
}
]
},
{
"id": "course:present-grade",
"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": [],
"enabledWhen": [
{
"option": "course:grade",
"equals": true
},
{
"option": "course:glow",
"equals": false
}
]
},
{
"id": "course:present-raw",
"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_postColor",
"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": [],
"enabledWhen": [
{
"option": "course:grade",
"equals": false
}
]
},
{
"id": "course:present-glow",
"enabled": true,
"stage": {
"template": "dawnlight:command_list",
"version": 1,
"target": "afterDraw",
"phase": "screenOutput",
"ordering": {
"after": [
"course:glow"
]
}
},
"services": [],
"programs": [
"course:post/present"
],
"commands": [
{
"type": "present",
"program": "course:post/present",
"bindings": [
{
"kind": "sampler2D",
"symbol": "u_postColor",
"binding": 0,
"resource": "course:post/glow"
}
],
"state": {
"blend": "opaque",
"depth": "disabled",
"rasterizer": "cullNoneScissor"
},
"viewport": {
"source": "frame",
"restore": "none",
"synchronizeScissor": true
}
}
],
"inputs": [
"course:post/glow"
],
"outputs": [],
"enabledWhen": [
{
"option": "course:grade",
"equals": true
},
{
"option": "course:glow",
"equals": true
}
]
}
],
"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"
}
],
"settings": "settings.json",
"customData": {
"abiVersion": 1,
"variables": [
{
"id": "course:gain",
"type": "float",
"frequency": "generation",
"default": 1,
"onError": "useDefault",
"expression": {
"option": "course:gain",
"as": "float"
}
},
{
"id": "course:day",
"type": "float",
"frequency": "frame",
"unit": "day_fraction",
"default": 0.5,
"onError": "useDefault",
"expression": {
"input": "dawnlight:data/day_time",
"version": 1
}
},
{
"id": "course:rain",
"type": "float",
"frequency": "frame",
"unit": "dimensionless",
"default": 0,
"onError": "useDefault",
"expression": {
"call": "clamp",
"args": [
{
"input": "dawnlight:data/weather_precipitation",
"version": 1
},
{
"literal": 0,
"type": "float"
},
{
"literal": 1,
"type": "float"
}
]
}
}
]
},
"materials": {
"abiVersion": 1,
"fallback": "course:neutral",
"properties": [
{
"id": "course:tint",
"type": "vec4",
"default": [
1,
1,
1,
1
],
"glsl": "AmberTint"
},
{
"id": "course:response",
"type": "float",
"default": 0,
"range": [
0,
1
],
"glsl": "AmberResponse"
}
],
"tags": [
{
"id": "course:mineral",
"glsl": "AMBER_MINERAL"
}
],
"definitions": [
{
"id": "course:neutral",
"shaderId": 0
},
{
"id": "course:stone",
"shaderId": 1,
"tags": [
"course:mineral"
],
"values": {
"course:tint": [
1.08,
1.01,
0.92,
1
],
"course:response": 0.25
}
},
{
"id": "course:sand",
"shaderId": 2,
"values": {
"course:tint": [
1.06,
1.02,
0.94,
1
],
"course:response": 0.4
}
}
],
"contentGroups": [
{
"id": "course:stones",
"ids": [
"survivalcraft:GraniteBlock",
"survivalcraft:BasaltBlock"
]
}
],
"mappings": [
{
"id": "course:stone-map",
"match": {
"groups": [
"course:stones"
]
},
"material": "course:stone",
"priority": 10,
"onMissing": "skip"
},
{
"id": "course:sand-map",
"match": {
"ids": [
"survivalcraft:SandBlock"
]
},
"material": "course:sand",
"priority": 10,
"onMissing": "skip"
}
]
}
}Validation and game observations
Extract into a new direct child of shaderpacks. From that pack root, use the pinned Analyzer installed in environment setup. Zero diagnostics and exit code 0 are expected. With materials but no world snapshot, deferred mapping is expected. Apply the settings inside a creative world, reload, resize and restore BuiltIn.
$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:scene/terrain --contract 2
& $analyzer program interface . --program course:post/grade --contract 2
& $analyzer program interface . --program course:post/present --contract 2
& $analyzer program interface . --program course:post/glow --contract 2
& $analyzer data explain . --format json
& $analyzer materials explain . --format jsonThese graph CLI commands check defaults. The committed branch receipt uses JSON-RPC with explicit inputs.options; see the branch table and maintenance procedure.
For actual mapping, load the world, run /switchshader content-export, and pass that file as --content-snapshot world-final.json to materials explain. Export /switchshader export-data-driver-report for Data interface comparison. Keep the world snapshot private.
Actual game observations · W6
Observed 5 option branches, loading/switching, same-pack reload, actual window resizing and return to BuiltIn in the isolated creative world. Programs linked and framebuffers were complete. Data interfaces matched; no numeric readback was performed.
9dd946ffa7f6f666b3b3b60d6107fde0646da1513717dca3f6cb2073c4207943
Branch and lifecycle evidence summary

Troubleshooting
Persistent blur with glow disabled calls for checking that present-grade reads post/color. Black or stretched output after resizing calls for viewport sizing, the two-component scale and viewport.source=target. Ensure targets rebuild with the view instead of relying on an absolute size that happens to match once. Missing or duplicate output means the three present conditions may overlap or leave a gap.
Exercise
Predict all four grade/glow combinations and validate default, glow-off, grade-off and all-off. Change scale to [1,1], compare sharpness and compute extra capacity. Keep screenshots and dimensions; collect a separate performance measurement before discussing frame time.