暗角:尺寸与宽高比
一个可以单独下载、开关、验证和修改的基础效果。课程代码只依赖固定公共合同。
算法与可见结果
以 UV 中心为原点,将 X 乘纹理宽高比,用 length 得到径向距离,smoothstep(0.22,0.82) 形成遮罩。最终亮度乘 (1−0.65×strength×mask)。尺寸来自实际输入纹理,窗口改变后无需硬编码分辨率。横向更宽的画面会自然增加左右衰减;这不是摄影镜头模拟。
资源流与开关
三个包互相独立;都使用四条 BuiltIn Terrain 路由,不复制宿主着色器。practice:grade 选择完整效果闭包,practice:strength 是 Program define,修改需要重编译。前置:独立包课程。
每行均已对照源码与新解压 ZIP。数量只统计活动节点;资源数包含存在的材质 buffer。
| 分支 | 覆盖值 | 资源 | 命令 |
|---|---|---|---|
default | {} | 3 | 6 |
grade-off | {"practice:grade":false} | 2 | 5 |
strength-max | {"practice:strength":1} | 3 | 6 |
精确活动闭包
default
resource:practice:post/color, resource:practice:scene/color, resource:practice:scene/depth
command:practice:grade:0, command:practice:present-grade:0, command:practice:terrain_alpha_tested:0, command:practice:terrain_opaque:0, command:practice:terrain_sorted_translucent:0, command:practice:terrain_transparent:0
program:dawnlight:scene_fallback/terrain_alpha_tested, program:dawnlight:scene_fallback/terrain_opaque, program:dawnlight:scene_fallback/terrain_sorted_translucent, program:dawnlight:scene_fallback/terrain_transparent, program:practice:post/grade, program:practice:post/present
活动 services: 0
grade-off
resource:practice:scene/color, resource:practice:scene/depth
command:practice:present-raw:0, command:practice:terrain_alpha_tested:0, command:practice:terrain_opaque:0, command:practice:terrain_sorted_translucent:0, command:practice:terrain_transparent:0
program:dawnlight:scene_fallback/terrain_alpha_tested, program:dawnlight:scene_fallback/terrain_opaque, program:dawnlight:scene_fallback/terrain_sorted_translucent, program:dawnlight:scene_fallback/terrain_transparent, program:practice:post/present
活动 services: 0
strength-max
resource:practice:post/color, resource:practice:scene/color, resource:practice:scene/depth
command:practice:grade:0, command:practice:present-grade:0, command:practice:terrain_alpha_tested:0, command:practice:terrain_opaque:0, command:practice:terrain_sorted_translucent:0, command:practice:terrain_transparent:0
program:dawnlight:scene_fallback/terrain_alpha_tested, program:dawnlight:scene_fallback/terrain_opaque, program:dawnlight:scene_fallback/terrain_sorted_translucent, program:dawnlight:scene_fallback/terrain_transparent, program:practice:post/grade, program:practice:post/present
活动 services: 0
名义成本与禁用行为
一次纹理采样加径向 ALU;中间纹理 4WH,present 另一次采样。没有额外半分辨率链或 history。关闭效果会移除独立中间资源;strength=0 仍保留该分支和绘制,不能把参数归零当成释放资源。
WH 为渲染像素数,1920×1080 的 4WH 约 7.91 MiB,不含基础 color/depth、对齐和驱动开销。这些是逻辑容量/采样估算,不是显存或毫秒实测。
完整下载与源码
完整 ZIP、inventory 和收据。解压到 shaderpacks/w7-vignette/,在创造世界执行 /switchshader w7-vignette。按 U → Options → Effect practice 应用设置。所有源码如下,无需另一示例目录。
shaderpack.json
{
"manifestVersion": 5,
"sceneAbiVersion": 2,
"expectedCatalogSha256": "4bc28c17beffea2311a422fff9f633d2e4f03784460d0254adda8af2e766d84c",
"id": "practice:vignette",
"name": "Practice vignette",
"version": "1.0.0",
"author": "EltanceX",
"description": "Independent LDR vignette example. Static and runtime evidence are recorded separately.",
"shaderRoot": "shaders",
"options": [
{
"id": "practice:grade",
"type": "boolean",
"default": true,
"impact": [
"pipeline",
"resources"
]
},
{
"id": "practice:strength",
"type": "number",
"default": 0.65,
"min": 0,
"max": 1,
"impact": [
"program"
]
}
],
"resources": [
{
"id": "practice:scene/color",
"kind": "texture2D",
"lifetime": "persistent",
"size": {
"mode": "viewport"
},
"format": "rgba8"
},
{
"id": "practice:scene/depth",
"kind": "texture2D",
"lifetime": "persistent",
"size": {
"mode": "viewport"
},
"format": "depth24"
},
{
"id": "practice:post/color",
"kind": "texture2D",
"lifetime": "persistent",
"size": {
"mode": "viewport"
},
"format": "rgba8"
}
],
"programs": [
{
"id": "practice:post/grade",
"kind": "graphics",
"vertex": "fullscreen.vsh",
"fragment": "grade.psh",
"compileMode": "manifestDriven",
"defines": {
"GRADE_STRENGTH": {
"option": "practice:strength"
}
}
},
{
"id": "practice:post/present",
"kind": "graphics",
"vertex": "fullscreen.vsh",
"fragment": "present.psh",
"compileMode": "manifestDriven"
}
],
"frameTarget": {
"targets": {
"colors": [
{
"location": 0,
"resource": "practice:scene/color",
"loadOp": "clear",
"storeOp": "store",
"clearValue": [
0,
0,
0,
1
]
}
],
"depth": {
"resource": "practice:scene/depth",
"loadOp": "clear",
"storeOp": "store",
"clearValue": 1
}
}
},
"passes": [
{
"id": "practice: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": "practice:scene/color",
"loadOp": "load",
"storeOp": "store"
}
],
"depth": {
"resource": "practice:scene/depth",
"loadOp": "clear",
"storeOp": "store",
"clearValue": 1
}
},
"state": {
"blend": "opaque",
"depth": "default",
"rasterizer": "cullCounterClockwiseScissor"
},
"viewport": {
"source": "target",
"restore": "frame",
"synchronizeScissor": true
}
}
],
"inputs": [
"practice:scene/color",
"practice:scene/depth"
],
"outputs": [
"practice:scene/color",
"practice:scene/depth"
]
},
{
"id": "practice:terrain_alpha_tested",
"enabled": true,
"stage": {
"template": "dawnlight:command_list",
"version": 1,
"target": "world",
"phase": "opaque",
"ordering": {
"after": [
"practice:terrain_opaque"
]
}
},
"services": [],
"programs": [],
"commands": [
{
"type": "engineDraw",
"sceneProvider": {
"id": "dawnlight:scene_draw/terrain_alpha_tested",
"version": 2
},
"targets": {
"colors": [
{
"location": 0,
"resource": "practice:scene/color",
"loadOp": "load",
"storeOp": "store"
}
],
"depth": {
"resource": "practice:scene/depth",
"loadOp": "load",
"storeOp": "store"
}
},
"state": {
"blend": "opaque",
"depth": "default",
"rasterizer": "cullCounterClockwiseScissor"
},
"viewport": {
"source": "target",
"restore": "frame",
"synchronizeScissor": true
}
}
],
"inputs": [
"practice:scene/color",
"practice:scene/depth"
],
"outputs": [
"practice:scene/color",
"practice:scene/depth"
]
},
{
"id": "practice: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": "practice:scene/color",
"loadOp": "load",
"storeOp": "store"
}
],
"depth": {
"resource": "practice:scene/depth",
"loadOp": "load",
"storeOp": "store"
}
},
"state": {
"blend": "alphaBlend",
"depth": "default",
"rasterizer": "cullCounterClockwiseScissor"
},
"viewport": {
"source": "target",
"restore": "frame",
"synchronizeScissor": true
}
}
],
"inputs": [
"practice:scene/color",
"practice:scene/depth"
],
"outputs": [
"practice:scene/color",
"practice:scene/depth"
]
},
{
"id": "practice:terrain_sorted_translucent",
"enabled": true,
"stage": {
"template": "dawnlight:command_list",
"version": 1,
"target": "world",
"phase": "transparent",
"ordering": {
"after": [
"practice:terrain_transparent"
]
}
},
"services": [],
"programs": [],
"commands": [
{
"type": "engineDraw",
"sceneProvider": {
"id": "dawnlight:scene_draw/terrain_sorted_translucent",
"version": 2
},
"targets": {
"colors": [
{
"location": 0,
"resource": "practice:scene/color",
"loadOp": "load",
"storeOp": "store"
}
],
"depth": {
"resource": "practice:scene/depth",
"loadOp": "load",
"storeOp": "store"
}
},
"state": {
"blend": "alphaBlend",
"depth": "default",
"rasterizer": "cullCounterClockwiseScissor"
},
"viewport": {
"source": "target",
"restore": "frame",
"synchronizeScissor": true
}
}
],
"inputs": [
"practice:scene/color",
"practice:scene/depth"
],
"outputs": [
"practice:scene/color",
"practice:scene/depth"
]
},
{
"id": "practice:grade",
"enabled": true,
"stage": {
"template": "dawnlight:command_list",
"version": 1,
"target": "afterDraw",
"phase": "afterDraw"
},
"services": [],
"programs": [
"practice:post/grade"
],
"commands": [
{
"type": "fullscreen",
"program": "practice:post/grade",
"bindings": [
{
"kind": "sampler2D",
"symbol": "u_sceneColor",
"binding": 0,
"resource": "practice:scene/color"
}
],
"state": {
"blend": "opaque",
"depth": "disabled",
"rasterizer": "cullNoneScissor"
},
"viewport": {
"source": "target",
"restore": "frame",
"synchronizeScissor": true
},
"targets": {
"colors": [
{
"location": 0,
"resource": "practice:post/color",
"loadOp": "dontCare",
"storeOp": "store"
}
]
}
}
],
"inputs": [
"practice:scene/color"
],
"outputs": [
"practice:post/color"
],
"enabledWhen": [
{
"option": "practice:grade",
"equals": true
}
]
},
{
"id": "practice:present-grade",
"enabled": true,
"stage": {
"template": "dawnlight:command_list",
"version": 1,
"target": "afterDraw",
"phase": "screenOutput",
"ordering": {
"after": [
"practice:grade"
]
}
},
"services": [],
"programs": [
"practice:post/present"
],
"commands": [
{
"type": "present",
"program": "practice:post/present",
"bindings": [
{
"kind": "sampler2D",
"symbol": "u_postColor",
"binding": 0,
"resource": "practice:post/color"
}
],
"state": {
"blend": "opaque",
"depth": "disabled",
"rasterizer": "cullNoneScissor"
},
"viewport": {
"source": "frame",
"restore": "none",
"synchronizeScissor": true
}
}
],
"inputs": [
"practice:post/color"
],
"outputs": [],
"enabledWhen": [
{
"option": "practice:grade",
"equals": true
}
]
},
{
"id": "practice:present-raw",
"enabled": true,
"stage": {
"template": "dawnlight:command_list",
"version": 1,
"target": "afterDraw",
"phase": "screenOutput"
},
"services": [],
"programs": [
"practice:post/present"
],
"commands": [
{
"type": "present",
"program": "practice:post/present",
"bindings": [
{
"kind": "sampler2D",
"symbol": "u_postColor",
"binding": 0,
"resource": "practice:scene/color"
}
],
"state": {
"blend": "opaque",
"depth": "disabled",
"rasterizer": "cullNoneScissor"
},
"viewport": {
"source": "frame",
"restore": "none",
"synchronizeScissor": true
}
}
],
"inputs": [
"practice:scene/color"
],
"outputs": [],
"enabledWhen": [
{
"option": "practice:grade",
"equals": false
}
]
}
],
"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"
}
],
"settings": "settings.json"
}settings.json
{
"schemaVersion": 1,
"defaultLocale": "en-US",
"translations": {
"zh-CN": {
"page.amber": "效果实践",
"practice:grade": "效果",
"practice:strength": "效果强度(重新编译)"
},
"en-US": {
"page.amber": "Effect practice",
"practice:grade": "Effect enabled",
"practice:strength": "Effect strength (recompile)"
}
},
"pages": [
{
"id": "amber",
"title": "page.amber",
"groups": [
{
"id": "look",
"controls": [
{
"id": "grade",
"option": "practice:grade",
"widget": "toggle",
"label": "practice:grade"
},
{
"id": "strength",
"option": "practice:strength",
"widget": "slider",
"label": "practice:strength",
"min": 0,
"max": 1,
"step": 0.05,
"format": "0.00",
"enabledWhen": [
{
"option": "practice:grade",
"equals": true
}
]
}
]
}
]
}
]
}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/grade.psh
#version 320 es
precision highp float;
uniform sampler2D u_sceneColor;
in vec2 v_uv;
layout(location = 0) out vec4 o_color;
void main() {
vec3 c = texture(u_sceneColor, v_uv).rgb;
vec2 extent = vec2(textureSize(u_sceneColor, 0));
vec2 p = (v_uv - 0.5) * vec2(extent.x / extent.y, 1.0);
float mask = smoothstep(0.22, 0.82, length(p));
o_color = vec4(c * (1.0 - 0.65 * float(GRADE_STRENGTH) * mask), 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);
}静态验证与实机范围
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 practice:post/grade --contract 2
shaderpack-analyzer.exe program interface . --program practice:post/present --contract 2默认、grade-off、strength-max 均对源码与新 ZIP 检查。上面的 CLI graph 只检查默认配置,选项分支由显式 inputs.options 的 JSON-RPC 检查。
实际游戏观察 · W7 · features/vignette
三个选项分支、同包重载、真实窗口尺寸变化及返回 BuiltIn 通过。链接 Program 与静态活动闭包一致,帧缓冲完整。范围为一台 Windows 设备、一个世界和单主 view,不提供性能或数值读回结论。
00e02eaa46a886f4e0d64a51562724501b18f1664117d237d6e39ff6002474c0

练习与排错
修改本章算法中的一个常量,保存并同包重载,记录新的源码身份。先观察开关,再观察 strength=0 与关闭的成本差异。出现黑屏先关闭效果,按症状排错定位;始终保留 /switchshader builtin 作为恢复入口。