Skip to content

Passes, Stages and execution order ​

Behavior and constraints ​

Pass id/enabled identifies a declaration; enabledWhen constrains activity. stage selects exact template/version/target/phase. Legacy host combinations remain separately represented in compatibility structure; host and stage are not freely interchangeable or combinable. command_list executes commands in authored order. Across Passes, ordering.after/before/requires and accesses determine order.

inputs/outputs declare resource access and programs lists callable Programs. They do not replace command bindings or attachments. Ordering IDs must resolve; requires is more than a weak hint. Reject reversed phases, cycles, missing dependencies and hazards in the candidate graph. Use generated Catalog/token data for phase names rather than a permanent fixed count.

Services use id/version with required/optional mode. Conditions and unavailable=disablePass affect the active closure. Published dependencies and executable factories must both agree; metadata registration alone is not execution support. optional does not let an active command ignore a required feature.

Inspect declared/active nodes, command occurrences, accesses and dependencies with graph dump. Program-less clear/copy/historyCommit commands still contribute resource or lifecycle relations and must not disappear from Program-only analysis.

Generated v5 structure ​

Required applies to the displayed object/branch. Absence of a Schema default does not establish a runtime default. Conditional rules remain in the complete definition below; Loader validation also resolves IDs, ownership, budgets and device limits.

pass · v5 ​

Field / branchPresence in this objectStructural constraints
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"
Full structural rule: #/$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 ​

Field / branchPresence in this objectStructural constraints
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"
Full structural rule: #/$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 ​

Field / branchPresence in this objectStructural constraints
orderingoptional here$ref="#/$defs/ordering"
phaserequiredenum=["modelShadow","framePrepare","shadow","opaque","sky","transparent","cloudReflection","shaftPrepare","shaftSun","cloud","particles","afterDraw","afterFinal","screenOutput"]
targetrequiredenum=["world","afterDraw"]
Full structural rule: #/$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 ​

Field / branchPresence in this objectStructural constraints
afteroptional heretype="array"; uniqueItems=true; items=#/$defs/identifier
beforeoptional heretype="array"; uniqueItems=true; items=#/$defs/identifier
requiresoptional heretype="array"; uniqueItems=true; items=#/$defs/identifier
Full structural rule: #/$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 ​

Field / branchPresence in this objectStructural constraints
enabledWhenoptional heretype="array"; items=#/$defs/condition
idrequired$ref="#/$defs/identifier"
modeoptional hereenum=["required","optional"]
unavailableoptional hereenum=["disablePass"]
versionrequired$ref="#/$defs/positiveVersion"
Full structural rule: #/$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"
}

Complete examples ​

Sources and machine records ​

Coverage inventory · Schema v5 · Catalog v2 · Completion v2

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

ShaderPackManifestLoader.cs

Author documentation · Manifest v5 / Scene ABI v2