跳转到正文

独立效果 · 色彩平衡 ​

阅读对应章节

本 ZIP 包含全部所需文件,不依赖前一章。解压为游戏 shaderpacks 目录的直接子目录。静态收据与实机观察分别记录。

下载与身份 ​

下载本章 ZIP · 源码清单 · 静态收据

ZIP SHA-256:

3880779537d67fe635fec584cade69455f845630ecb87dc0e0a0f850a8eea082

源码指纹:

fa54b90617955a1d0a257f9e234bdb4135ce35a8d637227bf329292fb4fb3ba7

完整源码 ​

README.md

下载文件

md
# Feature · Color balance / 独立效果 · 色彩平衡

Standalone Manifest v5 / Scene ABI v2 pack for host f8aaa5c4218f54536ccf994a2d512aed2e3678b7.

Extract directly to shaderpacks/w7-color-balance/shaderpack.json. In a creative world use /switchshader w7-color-balance; /switchshader builtin restores BuiltIn. Press U → Options → Effect practice, toggle the effect and apply. Switching to the same pack reloads it.

practice:grade defaults true; false removes the post texture and effect Program/command. practice:strength is a 0–1 Program define (default 0.65). No extra Mod, data, history or private API is required. All four Terrain routes use BuiltIn.

This operates on the existing RGBA8 scene image. It does not add HDR, a physical camera, geometry edges or full scene coverage guarantees. Luminance outlines can mark texture detail and miss equal-luminance silhouettes.

Full instructions and cost model: https://core.eltancex.top/recipes/color-balance

Validate with the pinned Analyzer; scene/program interface use option overrides and graph branches require JSON-RPC dawnlight/dumpGraph inputs.options. Static receipts do not prove device behavior. Runtime evidence on the website is bound to exact source bytes.

Website-authored source: https://github.com/EltanceX/dawnlight-core-docs/tree/main/examples/features/color-balance
Public host: https://gitea.com/EltanceX/DawnlightCore
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
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}
shaderpack.json

下载文件

json
{
  "manifestVersion": 5,
  "sceneAbiVersion": 2,
  "expectedCatalogSha256": "4bc28c17beffea2311a422fff9f633d2e4f03784460d0254adda8af2e766d84c",
  "id": "practice:color-balance",
  "name": "Practice color-balance",
  "version": "1.0.0",
  "author": "EltanceX",
  "description": "Independent LDR color-balance 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"
}
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;
    vec3 balanced = (c - 0.5) * 1.12 + 0.5;
    balanced *= vec3(1.05, 1.0, 0.94);
    o_color = vec4(clamp(mix(c, balanced, float(GRADE_STRENGTH)), 0.0, 1.0), 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);
}

验证范围 ​

固定 Analyzer 对源码和新解压 ZIP 执行 pack、scene、graph 和全部 Program interface 检查,归一化输出哈希一致。此静态收据不提供驱动或真实世界结论;日期明确的运行观察与限制见对应章节。

作者文档 · Manifest v5 / Scene ABI v2