跳转到正文

Pass、Stage 与执行关系 ​

行为与约束 ​

Pass 的 id/enabled 标识声明,enabledWhen 控制条件。stage 使用精确 template/version/target/phase;传统 host 入口的可接受组合在兼容结构中单列,不把 host 与 stage 随意同时使用。主线 command_list 按 commands 的作者顺序执行,跨 Pass 顺序由 ordering.after/before/requires 和访问关系解析。

inputs/outputs 是资源访问合同,programs 是本 Pass 可调用 Program 集合;它们不替代命令绑定和附件。ordering 的 ID 必须可解析,requires 不是弱排序提示。反向 phase、循环、未满足依赖与读写 hazard 应在候选图拒绝。phase 名称以生成 Catalog/token 表为准,不宣称永远固定数量。

Services 使用 id/version,可声明 required/optional,条件与 unavailable=disablePass 影响活动闭包。所需 Service 的依赖要由固定 Catalog 和真实工厂共同满足;元数据登记不等于可执行 provider。optional 不是允许一个活动 command 无视缺失的必需功能。

通过 graph dump 查看声明与活动节点、command occurrence、访问和依赖。Program-less 的 clear/copy/historyCommit 仍参与相应资源或生命周期关系,不应被只遍历 Program 的分析遗漏。

自动生成的 v5 结构 ​

必需性只针对所展示的对象/分支。Schema 没写 default 不表示运行时没有默认值。完整定义保留条件规则;Loader 另行解析 ID、所有权、预算及设备约束。

pass · v5 ​

字段 / 分支本对象必需性结构约束
commandsoptional heretype="array"; items=#/$defs/command
enabledrequiredtype="boolean"
enabledWhenoptional heretype="array"; items=#/$defs/condition
hostoptional here$ref="#/$defs/host"
idrequired$ref="#/$defs/identifier"
inputsoptional heretype="array"
outputsoptional heretype="array"
programsoptional heretype="array"; uniqueItems=true; items=#/$defs/identifier
servicesoptional heretype="array"; items=#/$defs/service
stageoptional here$ref="#/$defs/stage"
完整结构规则: #/$defs/pass
json
{
  "additionalProperties": false,
  "allOf": [
    {
      "not": {
        "required": [
          "stage",
          "host"
        ]
      }
    }
  ],
  "properties": {
    "commands": {
      "items": {
        "$ref": "#/$defs/command"
      },
      "type": "array"
    },
    "enabled": {
      "type": "boolean"
    },
    "enabledWhen": {
      "items": {
        "$ref": "#/$defs/condition"
      },
      "type": "array"
    },
    "host": {
      "$ref": "#/$defs/host"
    },
    "id": {
      "$ref": "#/$defs/identifier"
    },
    "inputs": {
      "items": {
        "oneOf": [
          {
            "$ref": "#/$defs/identifier"
          },
          {
            "$ref": "#/$defs/resourceView"
          }
        ]
      },
      "type": "array"
    },
    "outputs": {
      "items": {
        "oneOf": [
          {
            "$ref": "#/$defs/identifier"
          },
          {
            "$ref": "#/$defs/resourceView"
          }
        ]
      },
      "type": "array"
    },
    "programs": {
      "items": {
        "$ref": "#/$defs/identifier"
      },
      "type": "array",
      "uniqueItems": true
    },
    "services": {
      "items": {
        "$ref": "#/$defs/service"
      },
      "type": "array"
    },
    "stage": {
      "$ref": "#/$defs/stage"
    }
  },
  "required": [
    "id",
    "enabled"
  ],
  "type": "object"
}

stage · v5 ​

字段 / 分支本对象必需性结构约束
orderingoptional here$ref="#/$defs/ordering"
phaserequiredenum=["modelShadow","framePrepare","shadow","opaque","sky","transparent","cloudReflection","shaftPrepare","shaftSun","cloud","particles","afterDraw","afterFinal","screenOutput"]
targetrequiredenum=["world","afterDraw"]
templaterequired$ref="#/$defs/identifier"
versionrequired$ref="#/$defs/positiveVersion"
完整结构规则: #/$defs/stage
json
{
  "additionalProperties": false,
  "properties": {
    "ordering": {
      "$ref": "#/$defs/ordering"
    },
    "phase": {
      "enum": [
        "modelShadow",
        "framePrepare",
        "shadow",
        "opaque",
        "sky",
        "transparent",
        "cloudReflection",
        "shaftPrepare",
        "shaftSun",
        "cloud",
        "particles",
        "afterDraw",
        "afterFinal",
        "screenOutput"
      ]
    },
    "target": {
      "enum": [
        "world",
        "afterDraw"
      ]
    },
    "template": {
      "$ref": "#/$defs/identifier"
    },
    "version": {
      "$ref": "#/$defs/positiveVersion"
    }
  },
  "required": [
    "template",
    "version",
    "target",
    "phase"
  ],
  "type": "object"
}

host · v5 ​

字段 / 分支本对象必需性结构约束
orderingoptional here$ref="#/$defs/ordering"
phaserequiredenum=["modelShadow","framePrepare","shadow","opaque","sky","transparent","cloudReflection","shaftPrepare","shaftSun","cloud","particles","afterDraw","afterFinal","screenOutput"]
targetrequiredenum=["world","afterDraw"]
完整结构规则: #/$defs/host
json
{
  "additionalProperties": false,
  "properties": {
    "ordering": {
      "$ref": "#/$defs/ordering"
    },
    "phase": {
      "enum": [
        "modelShadow",
        "framePrepare",
        "shadow",
        "opaque",
        "sky",
        "transparent",
        "cloudReflection",
        "shaftPrepare",
        "shaftSun",
        "cloud",
        "particles",
        "afterDraw",
        "afterFinal",
        "screenOutput"
      ]
    },
    "target": {
      "enum": [
        "world",
        "afterDraw"
      ]
    }
  },
  "required": [
    "target",
    "phase"
  ],
  "type": "object"
}

ordering · v5 ​

字段 / 分支本对象必需性结构约束
afteroptional heretype="array"; uniqueItems=true; items=#/$defs/identifier
beforeoptional heretype="array"; uniqueItems=true; items=#/$defs/identifier
requiresoptional heretype="array"; uniqueItems=true; items=#/$defs/identifier
完整结构规则: #/$defs/ordering
json
{
  "additionalProperties": false,
  "properties": {
    "after": {
      "items": {
        "$ref": "#/$defs/identifier"
      },
      "type": "array",
      "uniqueItems": true
    },
    "before": {
      "items": {
        "$ref": "#/$defs/identifier"
      },
      "type": "array",
      "uniqueItems": true
    },
    "requires": {
      "items": {
        "$ref": "#/$defs/identifier"
      },
      "type": "array",
      "uniqueItems": true
    }
  },
  "type": "object"
}

service · v5 ​

字段 / 分支本对象必需性结构约束
enabledWhenoptional heretype="array"; items=#/$defs/condition
idrequired$ref="#/$defs/identifier"
modeoptional hereenum=["required","optional"]
unavailableoptional hereenum=["disablePass"]
versionrequired$ref="#/$defs/positiveVersion"
完整结构规则: #/$defs/service
json
{
  "additionalProperties": false,
  "properties": {
    "enabledWhen": {
      "items": {
        "$ref": "#/$defs/condition"
      },
      "type": "array"
    },
    "id": {
      "$ref": "#/$defs/identifier"
    },
    "mode": {
      "enum": [
        "required",
        "optional"
      ]
    },
    "unavailable": {
      "enum": [
        "disablePass"
      ]
    },
    "version": {
      "$ref": "#/$defs/positiveVersion"
    }
  },
  "required": [
    "id",
    "version"
  ],
  "type": "object"
}

完整示例 ​

来源与机器记录 ​

字段归属清单 · Schema v5 · Catalog v2 · Completion v2

schema-v3 · schema-v4 · schema-v5 · completion-v1 · completion-v2 · temporal · settings-guide ·

ShaderPackManifestLoader.cs

作者文档 · Manifest v5 / Scene ABI v2