跳转到正文

暗角:尺寸与宽高比 ​

一个可以单独下载、开关、验证和修改的基础效果。课程代码只依赖固定公共合同。

算法与可见结果 ​

以 UV 中心为原点,将 X 乘纹理宽高比,用 length 得到径向距离,smoothstep(0.22,0.82) 形成遮罩。最终亮度乘 (1−0.65×strength×mask)。尺寸来自实际输入纹理,窗口改变后无需硬编码分辨率。横向更宽的画面会自然增加左右衰减;这不是摄影镜头模拟。

资源流与开关 ​

scene/color → [grade on: effect → post/color] → one present → screen

三个包互相独立;都使用四条 BuiltIn Terrain 路由,不复制宿主着色器。practice:grade 选择完整效果闭包,practice:strength 是 Program define,修改需要重编译。前置:独立包课程。

每行均已对照源码与新解压 ZIP。数量只统计活动节点;资源数包含存在的材质 buffer。

分支覆盖值资源命令
default{}36
grade-off{"practice:grade":false}25
strength-max{"practice:strength":1}36
精确活动闭包

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
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
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
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);
}
shaders/grade.psh
glsl
#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
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);
}

静态验证与实机范围 ​

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 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 作为恢复入口。

作者文档 · Manifest v5 / Scene ABI v2