跳转到正文

Manifest v3、v4 与 v5 ​

行为与约束 ​

表面v3v4v5
传统资源/Program/命令与 source composition v1支持适用组合支持支持
显式 Scene category 与 sceneBindings不接受这些新增字段Scene ABI v2Scene ABI v2
materials/customData/customBindings/materialTable不支持不支持ABI v1
sampler2DShadow comparison v1不支持不支持仅支持的 graphics 边界
主线 Schema bundle / completionlegacy v1legacy v1v2
主教程地位兼容资料兼容资料主线

数字 3/4/5 是 Manifest 领域版本,不是光影包作者 version,也不等于 Scene ABI、Provider 或工具协议版本。不要向 v3/v4 配置粘贴 v5 字段;升级先选择新 Schema,再迁移显式 route、资源与调用所有权,重跑 Loader/graph/interface 和需要的运行验证。

下面独立生成 v3/v4 的完整结构定义,保留同名对象在版本间的真实差异。v3 Schema 中存在某些共享定义,不表示其 manifest/command 入口可引用它们;能否到达及版本门要看完整根与条件规则。

固定 Catalog.supportedFormats.manifest 保留 [3,4] 历史投影,v5 Schema、Loader 和已验证课程仍明确接受 v5。旧指南“11 个输入”和 temporal 早期 runtimeReady=false 同样保留历史身份;当前 23 项注册、后续接入与实际运行证据另行解释。兼容表不将这些资料整批改名为新发布状态。

Manifest v3 ​

manifest · v3 ​

字段 / 分支本对象必需性结构约束
authoroptional heretype="string"
descriptionoptional heretype="string"
idrequired$ref="#/$defs/identifier"
manifestVersionrequiredconst=3
namerequired$ref="#/$defs/nonEmptyString"
optionsrequiredtype="array"; items=#/$defs/option
passesoptional heretype="array"; items=#/$defs/pass
programsoptional heretype="array"; items=#/$defs/program
resourcesrequiredtype="array"; items=#/$defs/resource
settingsoptional here$ref="#/$defs/relativePath"
shaderRootoptional here$ref="#/$defs/relativePath"
versionrequired$ref="#/$defs/nonEmptyString"
完整结构规则: #/$defs/manifest
json
{
  "additionalProperties": false,
  "properties": {
    "author": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "id": {
      "$ref": "#/$defs/identifier"
    },
    "manifestVersion": {
      "const": 3
    },
    "name": {
      "$ref": "#/$defs/nonEmptyString"
    },
    "options": {
      "items": {
        "$ref": "#/$defs/option"
      },
      "type": "array"
    },
    "passes": {
      "items": {
        "$ref": "#/$defs/pass"
      },
      "type": "array"
    },
    "programs": {
      "items": {
        "$ref": "#/$defs/program"
      },
      "type": "array"
    },
    "resources": {
      "items": {
        "$ref": "#/$defs/resource"
      },
      "type": "array"
    },
    "settings": {
      "$ref": "#/$defs/relativePath"
    },
    "shaderRoot": {
      "$ref": "#/$defs/relativePath"
    },
    "version": {
      "$ref": "#/$defs/nonEmptyString"
    }
  },
  "required": [
    "manifestVersion",
    "id",
    "name",
    "version",
    "options",
    "resources"
  ],
  "type": "object"
}

sourceManifest · v3 ​

字段 / 分支本对象必需性结构约束
authoroptional heretype="string"
descriptionoptional heretype="string"
fragmentsrequiredtype="array"; minItems=1; uniqueItems=true; items=#/$defs/relativePath
idrequired$ref="#/$defs/identifier"
manifestVersionrequiredconst=3
namerequired$ref="#/$defs/nonEmptyString"
settingsoptional here$ref="#/$defs/relativePath"
shaderRootoptional here$ref="#/$defs/relativePath"
sourceFormatVersionrequiredconst=1
versionrequired$ref="#/$defs/nonEmptyString"
完整结构规则: #/$defs/sourceManifest
json
{
  "additionalProperties": false,
  "properties": {
    "author": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "fragments": {
      "items": {
        "$ref": "#/$defs/relativePath"
      },
      "minItems": 1,
      "type": "array",
      "uniqueItems": true
    },
    "id": {
      "$ref": "#/$defs/identifier"
    },
    "manifestVersion": {
      "const": 3
    },
    "name": {
      "$ref": "#/$defs/nonEmptyString"
    },
    "settings": {
      "$ref": "#/$defs/relativePath"
    },
    "shaderRoot": {
      "$ref": "#/$defs/relativePath"
    },
    "sourceFormatVersion": {
      "const": 1
    },
    "version": {
      "$ref": "#/$defs/nonEmptyString"
    }
  },
  "required": [
    "sourceFormatVersion",
    "manifestVersion",
    "id",
    "name",
    "version",
    "fragments"
  ],
  "type": "object"
}

fragment · v3 ​

字段 / 分支本对象必需性结构约束
optionsoptional heretype="array"; items=#/$defs/option
passesoptional heretype="array"; items=#/$defs/pass
programsoptional heretype="array"; items=#/$defs/program
resourcesoptional heretype="array"; items=#/$defs/resource
完整结构规则: #/$defs/fragment
json
{
  "additionalProperties": false,
  "properties": {
    "options": {
      "items": {
        "$ref": "#/$defs/option"
      },
      "type": "array"
    },
    "passes": {
      "items": {
        "$ref": "#/$defs/pass"
      },
      "type": "array"
    },
    "programs": {
      "items": {
        "$ref": "#/$defs/program"
      },
      "type": "array"
    },
    "resources": {
      "items": {
        "$ref": "#/$defs/resource"
      },
      "type": "array"
    }
  },
  "type": "object"
}

identifier · v3 ​

type="string"; pattern="^[a-z0-9][a-z0-9_.-]*:[a-z0-9][a-z0-9_./-]*$"

完整结构规则: #/$defs/identifier
json
{
  "pattern": "^[a-z0-9][a-z0-9_.-]*:[a-z0-9][a-z0-9_./-]*$",
  "type": "string"
}

relativePath · v3 ​

type="string"; minLength=1

完整结构规则: #/$defs/relativePath
json
{
  "minLength": 1,
  "type": "string"
}

nonEmptyString · v3 ​

type="string"; minLength=1

完整结构规则: #/$defs/nonEmptyString
json
{
  "minLength": 1,
  "type": "string"
}

positiveVersion · v3 ​

type="integer"; minimum=1

完整结构规则: #/$defs/positiveVersion
json
{
  "minimum": 1,
  "type": "integer"
}

option · v3 ​

字段 / 分支本对象必需性结构约束
allowedoptional heretype="array"; minItems=1; uniqueItems=true; items=#/$defs/optionScalar
defaultrequired$ref="#/$defs/optionScalar"
descriptionoptional heretype="string"
idrequired$ref="#/$defs/identifier"
impactrequiredtype="array"; uniqueItems=true
maxoptional heretype="number"
minoptional heretype="number"
nameoptional heretype="string"
typerequiredenum=["boolean","integer","number","string"]
完整结构规则: #/$defs/option
json
{
  "additionalProperties": false,
  "allOf": [
    {
      "if": {
        "properties": {
          "type": {
            "const": "boolean"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "properties": {
          "allowed": {
            "items": {
              "type": "boolean"
            },
            "minItems": 1,
            "type": "array",
            "uniqueItems": true
          },
          "default": {
            "type": "boolean"
          },
          "max": {
            "not": {}
          },
          "min": {
            "not": {}
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "integer"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "properties": {
          "allowed": {
            "items": {
              "type": "integer"
            },
            "minItems": 1,
            "type": "array",
            "uniqueItems": true
          },
          "default": {
            "type": "integer"
          },
          "max": {
            "type": "integer"
          },
          "min": {
            "type": "integer"
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "number"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "properties": {
          "allowed": {
            "items": {
              "type": "number"
            },
            "minItems": 1,
            "type": "array",
            "uniqueItems": true
          },
          "default": {
            "type": "number"
          },
          "max": {
            "type": "number"
          },
          "min": {
            "type": "number"
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "string"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "properties": {
          "allowed": {
            "items": {
              "type": "string"
            },
            "minItems": 1,
            "type": "array",
            "uniqueItems": true
          },
          "default": {
            "type": "string"
          },
          "max": {
            "not": {}
          },
          "min": {
            "not": {}
          }
        }
      }
    },
    {
      "not": {
        "required": [
          "allowed",
          "min"
        ]
      }
    },
    {
      "not": {
        "required": [
          "allowed",
          "max"
        ]
      }
    },
    {
      "oneOf": [
        {
          "required": [
            "min",
            "max"
          ]
        },
        {
          "not": {
            "anyOf": [
              {
                "required": [
                  "min"
                ]
              },
              {
                "required": [
                  "max"
                ]
              }
            ]
          }
        }
      ]
    }
  ],
  "properties": {
    "allowed": {
      "items": {
        "$ref": "#/$defs/optionScalar"
      },
      "minItems": 1,
      "type": "array",
      "uniqueItems": true
    },
    "default": {
      "$ref": "#/$defs/optionScalar"
    },
    "description": {
      "type": "string"
    },
    "id": {
      "$ref": "#/$defs/identifier"
    },
    "impact": {
      "items": {
        "enum": [
          "uniform",
          "program",
          "pipeline",
          "resources"
        ]
      },
      "type": "array",
      "uniqueItems": true
    },
    "max": {
      "type": "number"
    },
    "min": {
      "type": "number"
    },
    "name": {
      "type": "string"
    },
    "type": {
      "enum": [
        "boolean",
        "integer",
        "number",
        "string"
      ]
    }
  },
  "required": [
    "id",
    "type",
    "default",
    "impact"
  ],
  "type": "object"
}

optionScalar · v3 ​

type=["boolean","integer","number","string"]

完整结构规则: #/$defs/optionScalar
json
{
  "type": [
    "boolean",
    "integer",
    "number",
    "string"
  ]
}

condition · v3 ​

字段 / 分支本对象必需性结构约束
equalsoptional here$ref="#/$defs/optionScalar"
oneOfoptional heretype="array"; minItems=1; uniqueItems=true; items=#/$defs/optionScalar
optionrequired$ref="#/$defs/identifier"
完整结构规则: #/$defs/condition
json
{
  "additionalProperties": false,
  "allOf": [
    {
      "oneOf": [
        {
          "required": [
            "equals"
          ]
        },
        {
          "required": [
            "oneOf"
          ]
        }
      ]
    }
  ],
  "properties": {
    "equals": {
      "$ref": "#/$defs/optionScalar"
    },
    "oneOf": {
      "items": {
        "$ref": "#/$defs/optionScalar"
      },
      "minItems": 1,
      "type": "array",
      "uniqueItems": true
    },
    "option": {
      "$ref": "#/$defs/identifier"
    }
  },
  "required": [
    "option"
  ],
  "type": "object"
}

resource · v3 ​

字段 / 分支本对象必需性结构约束
oneOf[0].contentoptional here$ref="#/$defs/content"
oneOf[0].formatoptional here$ref="#/$defs/nonEmptyString"
oneOf[0].historyCapacityoptional heretype="integer"; minimum=2
oneOf[0].idrequired$ref="#/$defs/identifier"
oneOf[0].kindrequiredenum=["texture2D","textureCube"]
oneOf[0].lifetimerequiredoneOf: 2
oneOf[0].samplingoptional here$ref="#/$defs/sampling"
oneOf[0].sizeoptional here$ref="#/$defs/size"
oneOf[1].byteSizerequiredtype="integer"; minimum=1
oneOf[1].contentoptional here$ref="#/$defs/content"
oneOf[1].idrequired$ref="#/$defs/identifier"
oneOf[1].kindrequiredconst="buffer"
oneOf[1].lifetimerequiredoneOf: 2
oneOf[1].usageoptional hereenum=["staticDraw","dynamicDraw","streamDraw"]
完整结构规则: #/$defs/resource
json
{
  "oneOf": [
    {
      "additionalProperties": false,
      "properties": {
        "content": {
          "$ref": "#/$defs/content"
        },
        "format": {
          "$ref": "#/$defs/nonEmptyString"
        },
        "historyCapacity": {
          "minimum": 2,
          "type": "integer"
        },
        "id": {
          "$ref": "#/$defs/identifier"
        },
        "kind": {
          "enum": [
            "texture2D",
            "textureCube"
          ]
        },
        "lifetime": {
          "oneOf": [
            {
              "enum": [
                "persistent",
                "frame",
                "transient",
                "history",
                "external"
              ]
            },
            {
              "$ref": "#/$defs/historyLifetime"
            }
          ]
        },
        "sampling": {
          "$ref": "#/$defs/sampling"
        },
        "size": {
          "$ref": "#/$defs/size"
        }
      },
      "required": [
        "id",
        "kind",
        "lifetime"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "byteSize": {
          "minimum": 1,
          "type": "integer"
        },
        "content": {
          "$ref": "#/$defs/content"
        },
        "id": {
          "$ref": "#/$defs/identifier"
        },
        "kind": {
          "const": "buffer"
        },
        "lifetime": {
          "oneOf": [
            {
              "enum": [
                "persistent",
                "frame",
                "transient",
                "history",
                "external"
              ]
            },
            {
              "$ref": "#/$defs/historyLifetime"
            }
          ]
        },
        "usage": {
          "enum": [
            "staticDraw",
            "dynamicDraw",
            "streamDraw"
          ]
        }
      },
      "required": [
        "id",
        "kind",
        "lifetime",
        "byteSize"
      ],
      "type": "object"
    }
  ]
}

content · v3 ​

字段 / 分支本对象必需性结构约束
oneOf[1].typerequiredconst="undefined"
oneOf[2].typerequiredconst="external"
oneOf[3].typerequiredconst="clear"
oneOf[3].valuerequiredoneOf: 2
oneOf[4].encodingoptional hereenum=["image","raw"]
oneOf[4].facesoptional heretype="object"; additionalProperties=false
oneOf[4].faces.negativeXrequired$ref="#/$defs/relativePath"
oneOf[4].faces.negativeYrequired$ref="#/$defs/relativePath"
oneOf[4].faces.negativeZrequired$ref="#/$defs/relativePath"
oneOf[4].faces.positiveXrequired$ref="#/$defs/relativePath"
oneOf[4].faces.positiveYrequired$ref="#/$defs/relativePath"
oneOf[4].faces.positiveZrequired$ref="#/$defs/relativePath"
oneOf[4].pathoptional here$ref="#/$defs/relativePath"
oneOf[4].typerequiredconst="asset"
oneOf[5].generatorrequired$ref="#/$defs/identifier"
oneOf[5].typerequiredconst="generated"
oneOf[5].versionrequired$ref="#/$defs/positiveVersion"
oneOf[6].servicerequired$ref="#/$defs/identifier"
oneOf[6].typerequiredconst="service"
oneOf[6].versionrequired$ref="#/$defs/positiveVersion"
完整结构规则: #/$defs/content
json
{
  "oneOf": [
    {
      "enum": [
        "undefined",
        "external"
      ]
    },
    {
      "additionalProperties": false,
      "properties": {
        "type": {
          "const": "undefined"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "type": {
          "const": "external"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "type": {
          "const": "clear"
        },
        "value": {
          "oneOf": [
            {
              "items": {
                "type": "number"
              },
              "maxItems": 1,
              "minItems": 1,
              "type": "array"
            },
            {
              "items": {
                "type": "number"
              },
              "maxItems": 4,
              "minItems": 4,
              "type": "array"
            }
          ]
        }
      },
      "required": [
        "type",
        "value"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "allOf": [
        {
          "oneOf": [
            {
              "required": [
                "path"
              ]
            },
            {
              "required": [
                "faces"
              ]
            }
          ]
        }
      ],
      "properties": {
        "encoding": {
          "enum": [
            "image",
            "raw"
          ]
        },
        "faces": {
          "additionalProperties": false,
          "properties": {
            "negativeX": {
              "$ref": "#/$defs/relativePath"
            },
            "negativeY": {
              "$ref": "#/$defs/relativePath"
            },
            "negativeZ": {
              "$ref": "#/$defs/relativePath"
            },
            "positiveX": {
              "$ref": "#/$defs/relativePath"
            },
            "positiveY": {
              "$ref": "#/$defs/relativePath"
            },
            "positiveZ": {
              "$ref": "#/$defs/relativePath"
            }
          },
          "required": [
            "positiveX",
            "negativeX",
            "positiveY",
            "negativeY",
            "positiveZ",
            "negativeZ"
          ],
          "type": "object"
        },
        "path": {
          "$ref": "#/$defs/relativePath"
        },
        "type": {
          "const": "asset"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "generator": {
          "$ref": "#/$defs/identifier"
        },
        "type": {
          "const": "generated"
        },
        "version": {
          "$ref": "#/$defs/positiveVersion"
        }
      },
      "required": [
        "type",
        "generator",
        "version"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "service": {
          "$ref": "#/$defs/identifier"
        },
        "type": {
          "const": "service"
        },
        "version": {
          "$ref": "#/$defs/positiveVersion"
        }
      },
      "required": [
        "type",
        "service",
        "version"
      ],
      "type": "object"
    }
  ]
}

size · v3 ​

字段 / 分支本对象必需性结构约束
heightoptional heretype="integer"; minimum=1
moderequiredenum=["absolute","viewport","output"]
scaleoptional heretype="array"; minItems=2; maxItems=2
widthoptional heretype="integer"; minimum=1
完整结构规则: #/$defs/size
json
{
  "additionalProperties": false,
  "allOf": [
    {
      "if": {
        "properties": {
          "mode": {
            "const": "absolute"
          }
        },
        "required": [
          "mode"
        ]
      },
      "then": {
        "allOf": [
          {
            "not": {
              "anyOf": [
                {
                  "required": [
                    "scale"
                  ]
                }
              ]
            }
          }
        ],
        "required": [
          "width",
          "height"
        ]
      }
    },
    {
      "if": {
        "properties": {
          "mode": {
            "enum": [
              "viewport",
              "output"
            ]
          }
        }
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "width"
              ]
            },
            {
              "required": [
                "height"
              ]
            }
          ]
        }
      }
    }
  ],
  "properties": {
    "height": {
      "minimum": 1,
      "type": "integer"
    },
    "mode": {
      "enum": [
        "absolute",
        "viewport",
        "output"
      ]
    },
    "scale": {
      "items": {
        "exclusiveMinimum": 0,
        "type": "number"
      },
      "maxItems": 2,
      "minItems": 2,
      "type": "array"
    },
    "width": {
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "mode"
  ],
  "type": "object"
}

sampling · v3 ​

字段 / 分支本对象必需性结构约束
magFilteroptional hereenum=["nearest","linear"]
minFilteroptional hereenum=["nearest","linear"]
mipLevelsoptional heretype="integer"; minimum=1
wrapSoptional hereenum=["repeat","clampToEdge","mirroredRepeat"]
wrapToptional hereenum=["repeat","clampToEdge","mirroredRepeat"]
完整结构规则: #/$defs/sampling
json
{
  "additionalProperties": false,
  "properties": {
    "magFilter": {
      "enum": [
        "nearest",
        "linear"
      ]
    },
    "minFilter": {
      "enum": [
        "nearest",
        "linear"
      ]
    },
    "mipLevels": {
      "minimum": 1,
      "type": "integer"
    },
    "wrapS": {
      "enum": [
        "repeat",
        "clampToEdge",
        "mirroredRepeat"
      ]
    },
    "wrapT": {
      "enum": [
        "repeat",
        "clampToEdge",
        "mirroredRepeat"
      ]
    }
  },
  "type": "object"
}

historyLifetime · v3 ​

字段 / 分支本对象必需性结构约束
capacityrequiredtype="integer"; minimum=2
kindrequiredconst="history"
完整结构规则: #/$defs/historyLifetime
json
{
  "additionalProperties": false,
  "properties": {
    "capacity": {
      "minimum": 2,
      "type": "integer"
    },
    "kind": {
      "const": "history"
    }
  },
  "required": [
    "kind",
    "capacity"
  ],
  "type": "object"
}

resourceView · v3 ​

字段 / 分支本对象必需性结构约束
framesAgooptional heretype="integer"; minimum=1
resourcerequired$ref="#/$defs/identifier"
viewoptional hereenum=["dawnlight:direct","dawnlight:history/current","dawnlight:history/previous","dawnlight:shadow/consumer","dawnlight:shadow/producer"]
完整结构规则: #/$defs/resourceView
json
{
  "additionalProperties": false,
  "allOf": [
    {
      "if": {
        "properties": {
          "view": {
            "const": "dawnlight:history/previous"
          }
        },
        "required": [
          "view"
        ]
      },
      "then": {
        "required": [
          "framesAgo"
        ]
      }
    },
    {
      "if": {
        "not": {
          "properties": {
            "view": {
              "const": "dawnlight:history/previous"
            }
          },
          "required": [
            "view"
          ]
        }
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "framesAgo"
              ]
            }
          ]
        }
      }
    }
  ],
  "properties": {
    "framesAgo": {
      "minimum": 1,
      "type": "integer"
    },
    "resource": {
      "$ref": "#/$defs/identifier"
    },
    "view": {
      "enum": [
        "dawnlight:direct",
        "dawnlight:history/current",
        "dawnlight:history/previous",
        "dawnlight:shadow/consumer",
        "dawnlight:shadow/producer"
      ]
    }
  },
  "required": [
    "resource"
  ],
  "type": "object"
}

program · v3 ​

字段 / 分支本对象必需性结构约束
bindingsoptional here—
compileModeoptional hereenum=["legacyCustom","officialCompatible","manifestDriven"]
computeoptional here$ref="#/$defs/relativePath"
definesoptional heretype="object"; additionalProperties={"$ref":"#/$defs/defineValue"}
drawBuffersoptional here—
engineDrawStateoptional here—
fragmentoptional here$ref="#/$defs/relativePath"
idrequired$ref="#/$defs/identifier"
kindrequiredenum=["graphics","compute"]
stateoptional here—
targetsoptional here—
variantsoptional heretype="array"; items=#/$defs/variant
vertexoptional here$ref="#/$defs/relativePath"
完整结构规则: #/$defs/program
json
{
  "additionalProperties": false,
  "allOf": [
    {
      "if": {
        "properties": {
          "kind": {
            "const": "graphics"
          }
        },
        "required": [
          "kind"
        ]
      },
      "then": {
        "allOf": [
          {
            "not": {
              "anyOf": [
                {
                  "required": [
                    "compute"
                  ]
                }
              ]
            }
          }
        ],
        "required": [
          "vertex",
          "fragment"
        ]
      }
    },
    {
      "if": {
        "properties": {
          "kind": {
            "const": "compute"
          }
        },
        "required": [
          "kind"
        ]
      },
      "then": {
        "allOf": [
          {
            "not": {
              "anyOf": [
                {
                  "required": [
                    "vertex"
                  ]
                },
                {
                  "required": [
                    "fragment"
                  ]
                },
                {
                  "required": [
                    "compileMode"
                  ]
                }
              ]
            }
          }
        ],
        "required": [
          "compute"
        ]
      }
    }
  ],
  "properties": {
    "bindings": {
      "not": {}
    },
    "compileMode": {
      "enum": [
        "legacyCustom",
        "officialCompatible",
        "manifestDriven"
      ]
    },
    "compute": {
      "$ref": "#/$defs/relativePath"
    },
    "defines": {
      "additionalProperties": {
        "$ref": "#/$defs/defineValue"
      },
      "propertyNames": {
        "$ref": "#/$defs/glslIdentifier"
      },
      "type": "object"
    },
    "drawBuffers": {
      "not": {}
    },
    "engineDrawState": {
      "not": {}
    },
    "fragment": {
      "$ref": "#/$defs/relativePath"
    },
    "id": {
      "$ref": "#/$defs/identifier"
    },
    "kind": {
      "enum": [
        "graphics",
        "compute"
      ]
    },
    "state": {
      "not": {}
    },
    "targets": {
      "not": {}
    },
    "variants": {
      "items": {
        "$ref": "#/$defs/variant"
      },
      "type": "array"
    },
    "vertex": {
      "$ref": "#/$defs/relativePath"
    }
  },
  "required": [
    "id",
    "kind"
  ],
  "type": "object"
}

variant · v3 ​

字段 / 分支本对象必需性结构约束
definesrequiredtype="object"; additionalProperties={"$ref":"#/$defs/defineValue"}
idrequired$ref="#/$defs/identifier"
完整结构规则: #/$defs/variant
json
{
  "additionalProperties": false,
  "properties": {
    "defines": {
      "additionalProperties": {
        "$ref": "#/$defs/defineValue"
      },
      "propertyNames": {
        "$ref": "#/$defs/glslIdentifier"
      },
      "type": "object"
    },
    "id": {
      "$ref": "#/$defs/identifier"
    }
  },
  "required": [
    "id",
    "defines"
  ],
  "type": "object"
}

defineValue · v3 ​

oneOf: 2

完整结构规则: #/$defs/defineValue
json
{
  "oneOf": [
    {
      "$ref": "#/$defs/nullableDefineValue"
    },
    {
      "$ref": "#/$defs/defineBinding"
    }
  ]
}

defineBinding · v3 ​

字段 / 分支本对象必需性结构约束
capabilityoptional here$ref="#/$defs/identifier"
mapoptional heretype="object"; additionalProperties={"$ref":"#/$defs/nullableDefineValue"}
optionoptional here$ref="#/$defs/identifier"
完整结构规则: #/$defs/defineBinding
json
{
  "additionalProperties": false,
  "allOf": [
    {
      "oneOf": [
        {
          "required": [
            "option"
          ]
        },
        {
          "required": [
            "capability"
          ]
        }
      ]
    }
  ],
  "properties": {
    "capability": {
      "$ref": "#/$defs/identifier"
    },
    "map": {
      "additionalProperties": {
        "$ref": "#/$defs/nullableDefineValue"
      },
      "type": "object"
    },
    "option": {
      "$ref": "#/$defs/identifier"
    }
  },
  "type": "object"
}

nullableDefineValue · v3 ​

type=["string","boolean","integer","number","null"]

完整结构规则: #/$defs/nullableDefineValue
json
{
  "type": [
    "string",
    "boolean",
    "integer",
    "number",
    "null"
  ]
}

glslIdentifier · v3 ​

type="string"; pattern="^[A-Za-z_][A-Za-z0-9_]*$"

完整结构规则: #/$defs/glslIdentifier
json
{
  "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
  "type": "string"
}

pass · v3 ​

字段 / 分支本对象必需性结构约束
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 · v3 ​

字段 / 分支本对象必需性结构约束
orderingoptional here$ref="#/$defs/ordering"
phaserequiredenum=["modelShadow","framePrepare","shadow","opaque","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",
        "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 · v3 ​

字段 / 分支本对象必需性结构约束
orderingoptional here$ref="#/$defs/ordering"
phaserequiredenum=["modelShadow","framePrepare","shadow","opaque","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",
        "transparent",
        "cloudReflection",
        "shaftPrepare",
        "shaftSun",
        "cloud",
        "particles",
        "afterDraw",
        "afterFinal",
        "screenOutput"
      ]
    },
    "target": {
      "enum": [
        "world",
        "afterDraw"
      ]
    }
  },
  "required": [
    "target",
    "phase"
  ],
  "type": "object"
}

ordering · v3 ​

字段 / 分支本对象必需性结构约束
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 · v3 ​

字段 / 分支本对象必需性结构约束
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"
}

command · v3 ​

字段 / 分支本对象必需性结构约束
bindingsoptional heretype="array"; items=#/$defs/binding
clearoptional here$ref="#/$defs/clear"
copyoptional here$ref="#/$defs/copy"
dispatchoptional here$ref="#/$defs/dispatch"
drawBuffersoptional here—
programoptional here$ref="#/$defs/identifier"
provideroptional here$ref="#/$defs/provider"
resourceoptional here$ref="#/$defs/identifier"
semanticsoptional heretype="array"; items=#/$defs/semantic
stateoptional here$ref="#/$defs/state"
targetsoptional here$ref="#/$defs/targets"
typerequiredenum=["fullscreen","compute","copy","clear","present","engineDraw","historyCommit"]
viewportoptional here$ref="#/$defs/viewport"
完整结构规则: #/$defs/command
json
{
  "additionalProperties": false,
  "allOf": [
    {
      "if": {
        "properties": {
          "type": {
            "const": "fullscreen"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "required": [
          "program",
          "targets"
        ]
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "compute"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "required": [
          "program",
          "dispatch"
        ]
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "copy"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "required": [
          "copy"
        ]
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "clear"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "required": [
          "clear"
        ]
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "present"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "required": [
          "program"
        ]
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "historyCommit"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "required": [
          "resource"
        ]
      }
    },
    {
      "if": {
        "not": {
          "properties": {
            "type": {
              "const": "copy"
            }
          },
          "required": [
            "type"
          ]
        }
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "copy"
              ]
            }
          ]
        }
      }
    },
    {
      "if": {
        "not": {
          "properties": {
            "type": {
              "const": "historyCommit"
            }
          },
          "required": [
            "type"
          ]
        }
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "resource"
              ]
            }
          ]
        }
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "compute"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "viewport"
              ]
            },
            {
              "required": [
                "clear"
              ]
            },
            {
              "required": [
                "targets"
              ]
            },
            {
              "required": [
                "state"
              ]
            }
          ]
        }
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "present"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "targets"
              ]
            },
            {
              "required": [
                "drawBuffers"
              ]
            }
          ]
        }
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "copy"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "program"
              ]
            },
            {
              "required": [
                "bindings"
              ]
            },
            {
              "required": [
                "semantics"
              ]
            },
            {
              "required": [
                "sceneBindings"
              ]
            },
            {
              "required": [
                "targets"
              ]
            },
            {
              "required": [
                "drawBuffers"
              ]
            },
            {
              "required": [
                "state"
              ]
            },
            {
              "required": [
                "viewport"
              ]
            },
            {
              "required": [
                "clear"
              ]
            },
            {
              "required": [
                "dispatch"
              ]
            }
          ]
        }
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "clear"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "drawBuffers"
              ]
            }
          ]
        }
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "historyCommit"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "program"
              ]
            },
            {
              "required": [
                "bindings"
              ]
            },
            {
              "required": [
                "semantics"
              ]
            },
            {
              "required": [
                "sceneBindings"
              ]
            },
            {
              "required": [
                "targets"
              ]
            },
            {
              "required": [
                "drawBuffers"
              ]
            },
            {
              "required": [
                "state"
              ]
            },
            {
              "required": [
                "viewport"
              ]
            },
            {
              "required": [
                "clear"
              ]
            },
            {
              "required": [
                "dispatch"
              ]
            },
            {
              "required": [
                "copy"
              ]
            }
          ]
        }
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "engineDraw"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "required": [
          "provider"
        ]
      }
    },
    {
      "if": {
        "not": {
          "properties": {
            "type": {
              "const": "engineDraw"
            }
          },
          "required": [
            "type"
          ]
        }
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "provider"
              ]
            }
          ]
        }
      }
    }
  ],
  "properties": {
    "bindings": {
      "items": {
        "$ref": "#/$defs/binding"
      },
      "type": "array"
    },
    "clear": {
      "$ref": "#/$defs/clear"
    },
    "copy": {
      "$ref": "#/$defs/copy"
    },
    "dispatch": {
      "$ref": "#/$defs/dispatch"
    },
    "drawBuffers": {
      "not": {}
    },
    "program": {
      "$ref": "#/$defs/identifier"
    },
    "provider": {
      "$ref": "#/$defs/provider"
    },
    "resource": {
      "$ref": "#/$defs/identifier"
    },
    "semantics": {
      "items": {
        "$ref": "#/$defs/semantic"
      },
      "type": "array"
    },
    "state": {
      "$ref": "#/$defs/state"
    },
    "targets": {
      "$ref": "#/$defs/targets"
    },
    "type": {
      "enum": [
        "fullscreen",
        "compute",
        "copy",
        "clear",
        "present",
        "engineDraw",
        "historyCommit"
      ]
    },
    "viewport": {
      "$ref": "#/$defs/viewport"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

copy · v3 ​

字段 / 分支本对象必需性结构约束
aspectsrequiredtype="array"; minItems=1; uniqueItems=true
destinationrequiredoneOf: 2
filteroptional hereenum=["nearest","linear"]
restoreoptional hereenum=["none","frame"]
sourcerequiredoneOf: 2
完整结构规则: #/$defs/copy
json
{
  "additionalProperties": false,
  "properties": {
    "aspects": {
      "items": {
        "enum": [
          "color",
          "depth"
        ]
      },
      "minItems": 1,
      "type": "array",
      "uniqueItems": true
    },
    "destination": {
      "oneOf": [
        {
          "$ref": "#/$defs/identifier"
        },
        {
          "$ref": "#/$defs/resourceView"
        }
      ]
    },
    "filter": {
      "enum": [
        "nearest",
        "linear"
      ]
    },
    "restore": {
      "enum": [
        "none",
        "frame"
      ]
    },
    "source": {
      "oneOf": [
        {
          "$ref": "#/$defs/identifier"
        },
        {
          "$ref": "#/$defs/resourceView"
        }
      ]
    }
  },
  "required": [
    "source",
    "destination",
    "aspects"
  ],
  "type": "object"
}

clear · v3 ​

字段 / 分支本对象必需性结构约束
coloroptional heretype="array"; minItems=4; maxItems=4
depthoptional heretype="number"; minimum=0; maximum=1
stenciloptional heretype="integer"; minimum=0
完整结构规则: #/$defs/clear
json
{
  "additionalProperties": false,
  "minProperties": 1,
  "properties": {
    "color": {
      "items": {
        "type": "number"
      },
      "maxItems": 4,
      "minItems": 4,
      "type": "array"
    },
    "depth": {
      "maximum": 1,
      "minimum": 0,
      "type": "number"
    },
    "stencil": {
      "minimum": 0,
      "type": "integer"
    }
  },
  "type": "object"
}

dispatch · v3 ​

字段 / 分支本对象必需性结构约束
barriersoptional heretype="array"; uniqueItems=true
groupsrequiredtype="array"; minItems=3; maxItems=3
完整结构规则: #/$defs/dispatch
json
{
  "additionalProperties": false,
  "properties": {
    "barriers": {
      "items": {
        "enum": [
          "shaderImageAccess",
          "textureFetch",
          "textureUpdate",
          "shaderStorage",
          "bufferUpdate",
          "framebuffer"
        ]
      },
      "type": "array",
      "uniqueItems": true
    },
    "groups": {
      "items": {
        "minimum": 1,
        "type": "integer"
      },
      "maxItems": 3,
      "minItems": 3,
      "type": "array"
    }
  },
  "required": [
    "groups"
  ],
  "type": "object"
}

viewport · v3 ​

字段 / 分支本对象必需性结构约束
restorerequiredenum=["none","frame"]
sourcerequiredenum=["target","frame"]
synchronizeScissoroptional heretype="boolean"
完整结构规则: #/$defs/viewport
json
{
  "additionalProperties": false,
  "properties": {
    "restore": {
      "enum": [
        "none",
        "frame"
      ]
    },
    "source": {
      "enum": [
        "target",
        "frame"
      ]
    },
    "synchronizeScissor": {
      "type": "boolean"
    }
  },
  "required": [
    "source",
    "restore"
  ],
  "type": "object"
}

provider · v3 ​

字段 / 分支本对象必需性结构约束
idrequired$ref="#/$defs/identifier"
versionrequired$ref="#/$defs/positiveVersion"
完整结构规则: #/$defs/provider
json
{
  "additionalProperties": false,
  "properties": {
    "id": {
      "$ref": "#/$defs/identifier"
    },
    "version": {
      "$ref": "#/$defs/positiveVersion"
    }
  },
  "required": [
    "id",
    "version"
  ],
  "type": "object"
}

targets · v3 ​

字段 / 分支本对象必需性结构约束
colorsoptional heretype="array"; uniqueItems=true; items=#/$defs/colorTarget
depthoptional here$ref="#/$defs/depthTarget"
完整结构规则: #/$defs/targets
json
{
  "additionalProperties": false,
  "minProperties": 1,
  "properties": {
    "colors": {
      "items": {
        "$ref": "#/$defs/colorTarget"
      },
      "type": "array",
      "uniqueItems": true
    },
    "depth": {
      "$ref": "#/$defs/depthTarget"
    }
  },
  "type": "object"
}

colorTarget · v3 ​

字段 / 分支本对象必需性结构约束
clearValueoptional heretype="array"; minItems=4; maxItems=4
framesAgooptional heretype="integer"; minimum=1
loadOprequiredenum=["load","clear","dontCare"]
locationrequiredtype="integer"; minimum=0
resourcerequired$ref="#/$defs/identifier"
storeOprequiredenum=["store","dontCare"]
viewoptional hereenum=["dawnlight:direct","dawnlight:history/current","dawnlight:history/previous","dawnlight:shadow/consumer","dawnlight:shadow/producer"]
完整结构规则: #/$defs/colorTarget
json
{
  "additionalProperties": false,
  "allOf": [
    {
      "if": {
        "properties": {
          "loadOp": {
            "const": "clear"
          }
        },
        "required": [
          "loadOp"
        ]
      },
      "then": {
        "required": [
          "clearValue"
        ]
      }
    },
    {
      "if": {
        "not": {
          "properties": {
            "loadOp": {
              "const": "clear"
            }
          },
          "required": [
            "loadOp"
          ]
        }
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "clearValue"
              ]
            }
          ]
        }
      }
    }
  ],
  "properties": {
    "clearValue": {
      "items": {
        "type": "number"
      },
      "maxItems": 4,
      "minItems": 4,
      "type": "array"
    },
    "framesAgo": {
      "minimum": 1,
      "type": "integer"
    },
    "loadOp": {
      "enum": [
        "load",
        "clear",
        "dontCare"
      ]
    },
    "location": {
      "minimum": 0,
      "type": "integer"
    },
    "resource": {
      "$ref": "#/$defs/identifier"
    },
    "storeOp": {
      "enum": [
        "store",
        "dontCare"
      ]
    },
    "view": {
      "enum": [
        "dawnlight:direct",
        "dawnlight:history/current",
        "dawnlight:history/previous",
        "dawnlight:shadow/consumer",
        "dawnlight:shadow/producer"
      ]
    }
  },
  "required": [
    "location",
    "resource",
    "loadOp",
    "storeOp"
  ],
  "type": "object"
}

depthTarget · v3 ​

字段 / 分支本对象必需性结构约束
clearValueoptional heretype="number"; minimum=0; maximum=1
framesAgooptional heretype="integer"; minimum=1
loadOprequiredenum=["load","clear","dontCare"]
resourcerequired$ref="#/$defs/identifier"
storeOprequiredenum=["store","dontCare"]
viewoptional hereenum=["dawnlight:direct","dawnlight:history/current","dawnlight:history/previous","dawnlight:shadow/consumer","dawnlight:shadow/producer"]
完整结构规则: #/$defs/depthTarget
json
{
  "additionalProperties": false,
  "allOf": [
    {
      "if": {
        "properties": {
          "loadOp": {
            "const": "clear"
          }
        },
        "required": [
          "loadOp"
        ]
      },
      "then": {
        "required": [
          "clearValue"
        ]
      }
    },
    {
      "if": {
        "not": {
          "properties": {
            "loadOp": {
              "const": "clear"
            }
          },
          "required": [
            "loadOp"
          ]
        }
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "clearValue"
              ]
            }
          ]
        }
      }
    }
  ],
  "properties": {
    "clearValue": {
      "maximum": 1,
      "minimum": 0,
      "type": "number"
    },
    "framesAgo": {
      "minimum": 1,
      "type": "integer"
    },
    "loadOp": {
      "enum": [
        "load",
        "clear",
        "dontCare"
      ]
    },
    "resource": {
      "$ref": "#/$defs/identifier"
    },
    "storeOp": {
      "enum": [
        "store",
        "dontCare"
      ]
    },
    "view": {
      "enum": [
        "dawnlight:direct",
        "dawnlight:history/current",
        "dawnlight:history/previous",
        "dawnlight:shadow/consumer",
        "dawnlight:shadow/producer"
      ]
    }
  },
  "required": [
    "resource",
    "loadOp",
    "storeOp"
  ],
  "type": "object"
}

state · v3 ​

字段 / 分支本对象必需性结构约束
blendoptional hereenum=["inherit","opaque","alphaBlend","nonPremultiplied"]
blendTargetsoptional heretype="array"; minItems=1; uniqueItems=true
depthoptional hereenum=["inherit","default","depthWrite","depthTestWriteLess","disabled"]
rasterizeroptional hereenum=["inherit","cullCounterClockwiseScissor","cullClockwiseScissor","cullNoneScissor"]
完整结构规则: #/$defs/state
json
{
  "additionalProperties": false,
  "properties": {
    "blend": {
      "enum": [
        "inherit",
        "opaque",
        "alphaBlend",
        "nonPremultiplied"
      ]
    },
    "blendTargets": {
      "items": {
        "minimum": 0,
        "type": "integer"
      },
      "minItems": 1,
      "type": "array",
      "uniqueItems": true
    },
    "depth": {
      "enum": [
        "inherit",
        "default",
        "depthWrite",
        "depthTestWriteLess",
        "disabled"
      ]
    },
    "rasterizer": {
      "enum": [
        "inherit",
        "cullCounterClockwiseScissor",
        "cullClockwiseScissor",
        "cullNoneScissor"
      ]
    }
  },
  "type": "object"
}

drawBufferLayout · v3 ​

type="array"

完整结构规则: #/$defs/drawBufferLayout
json
{
  "items": {
    "oneOf": [
      {
        "const": "disabled"
      },
      {
        "minimum": 0,
        "type": "integer"
      }
    ]
  },
  "type": "array"
}

binding · v3 ​

字段 / 分支本对象必需性结构约束
accessoptional hereenum=["readOnly","writeOnly","readWrite"]
bindingrequiredtype="integer"; minimum=0
enabledWhenoptional heretype="array"; items=#/$defs/condition
fallbackoptional hereoneOf: 2
framesAgooptional heretype="integer"; minimum=1
kindrequiredenum=["sampler2D","samplerCube","image2D","uniformBuffer","storageBuffer"]
resourcerequired$ref="#/$defs/identifier"
symbolrequired$ref="#/$defs/glslIdentifier"
viewoptional hereenum=["dawnlight:direct","dawnlight:history/current","dawnlight:history/previous","dawnlight:shadow/consumer","dawnlight:shadow/producer"]
完整结构规则: #/$defs/binding
json
{
  "additionalProperties": false,
  "allOf": [
    {
      "if": {
        "properties": {
          "kind": {
            "enum": [
              "image2D",
              "storageBuffer"
            ]
          }
        }
      },
      "then": {
        "required": [
          "access"
        ]
      }
    },
    {
      "if": {
        "not": {
          "properties": {
            "kind": {
              "enum": [
                "image2D",
                "storageBuffer"
              ]
            }
          }
        }
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "access"
              ]
            }
          ]
        }
      }
    },
    {
      "if": {
        "properties": {
          "view": {
            "const": "dawnlight:history/previous"
          }
        },
        "required": [
          "view"
        ]
      },
      "then": {
        "required": [
          "framesAgo"
        ]
      }
    },
    {
      "if": {
        "not": {
          "properties": {
            "view": {
              "const": "dawnlight:history/previous"
            }
          },
          "required": [
            "view"
          ]
        }
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "framesAgo"
              ]
            }
          ]
        }
      }
    }
  ],
  "properties": {
    "access": {
      "enum": [
        "readOnly",
        "writeOnly",
        "readWrite"
      ]
    },
    "binding": {
      "minimum": 0,
      "type": "integer"
    },
    "enabledWhen": {
      "items": {
        "$ref": "#/$defs/condition"
      },
      "type": "array"
    },
    "fallback": {
      "oneOf": [
        {
          "$ref": "#/$defs/identifier"
        },
        {
          "$ref": "#/$defs/resourceView"
        }
      ]
    },
    "framesAgo": {
      "minimum": 1,
      "type": "integer"
    },
    "kind": {
      "enum": [
        "sampler2D",
        "samplerCube",
        "image2D",
        "uniformBuffer",
        "storageBuffer"
      ]
    },
    "resource": {
      "$ref": "#/$defs/identifier"
    },
    "symbol": {
      "$ref": "#/$defs/glslIdentifier"
    },
    "view": {
      "enum": [
        "dawnlight:direct",
        "dawnlight:history/current",
        "dawnlight:history/previous",
        "dawnlight:shadow/consumer",
        "dawnlight:shadow/producer"
      ]
    }
  },
  "required": [
    "kind",
    "symbol",
    "binding",
    "resource"
  ],
  "type": "object"
}

semantic · v3 ​

字段 / 分支本对象必需性结构约束
enabledWhenoptional heretype="array"; items=#/$defs/condition
semanticrequired$ref="#/$defs/identifier"
symbolrequired$ref="#/$defs/glslIdentifier"
versionrequired$ref="#/$defs/positiveVersion"
完整结构规则: #/$defs/semantic
json
{
  "additionalProperties": false,
  "properties": {
    "enabledWhen": {
      "items": {
        "$ref": "#/$defs/condition"
      },
      "type": "array"
    },
    "semantic": {
      "$ref": "#/$defs/identifier"
    },
    "symbol": {
      "$ref": "#/$defs/glslIdentifier"
    },
    "version": {
      "$ref": "#/$defs/positiveVersion"
    }
  },
  "required": [
    "symbol",
    "semantic",
    "version"
  ],
  "type": "object"
}

sceneBinding · v3 ​

字段 / 分支本对象必需性结构约束
bindingoptional heretype="integer"; minimum=0
contractrequired$ref="#/$defs/identifier"
frequencyrequiredenum=["frame","view","batch","draw"]
symbolrequired$ref="#/$defs/glslIdentifier"
versionrequired$ref="#/$defs/positiveVersion"
完整结构规则: #/$defs/sceneBinding
json
{
  "additionalProperties": false,
  "properties": {
    "binding": {
      "minimum": 0,
      "type": "integer"
    },
    "contract": {
      "$ref": "#/$defs/identifier"
    },
    "frequency": {
      "enum": [
        "frame",
        "view",
        "batch",
        "draw"
      ]
    },
    "symbol": {
      "$ref": "#/$defs/glslIdentifier"
    },
    "version": {
      "$ref": "#/$defs/positiveVersion"
    }
  },
  "required": [
    "symbol",
    "contract",
    "version",
    "frequency"
  ],
  "type": "object"
}

sceneRoute · v3 ​

字段 / 分支本对象必需性结构约束
idrequired$ref="#/$defs/identifier"
moderequiredenum=["override","builtin","disabled"]
stageoptional here$ref="#/$defs/identifier"
versionrequired$ref="#/$defs/positiveVersion"
完整结构规则: #/$defs/sceneRoute
json
{
  "additionalProperties": false,
  "allOf": [
    {
      "if": {
        "properties": {
          "mode": {
            "const": "override"
          }
        },
        "required": [
          "mode"
        ]
      },
      "then": {
        "required": [
          "stage"
        ]
      }
    },
    {
      "if": {
        "properties": {
          "mode": {
            "enum": [
              "builtin",
              "disabled"
            ]
          }
        }
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "stage"
              ]
            }
          ]
        }
      }
    }
  ],
  "properties": {
    "id": {
      "$ref": "#/$defs/identifier"
    },
    "mode": {
      "enum": [
        "override",
        "builtin",
        "disabled"
      ]
    },
    "stage": {
      "$ref": "#/$defs/identifier"
    },
    "version": {
      "$ref": "#/$defs/positiveVersion"
    }
  },
  "required": [
    "id",
    "version",
    "mode"
  ],
  "type": "object"
}

frameTarget · v3 ​

字段 / 分支本对象必需性结构约束
targetsrequired$ref="#/$defs/targets"
完整结构规则: #/$defs/frameTarget
json
{
  "additionalProperties": false,
  "properties": {
    "targets": {
      "$ref": "#/$defs/targets"
    }
  },
  "required": [
    "targets"
  ],
  "type": "object"
}

Manifest v4 ​

manifest · v4 ​

字段 / 分支本对象必需性结构约束
authoroptional heretype="string"
descriptionoptional heretype="string"
expectedCatalogSha256optional heretype="string"; pattern="^[0-9a-f]{64}$"
frameTargetoptional here$ref="#/$defs/frameTarget"
idrequired$ref="#/$defs/identifier"
manifestVersionrequiredconst=4
namerequired$ref="#/$defs/nonEmptyString"
optionsrequiredtype="array"; items=#/$defs/option
passesoptional heretype="array"; items=#/$defs/pass
programsoptional heretype="array"; items=#/$defs/program
resourcesrequiredtype="array"; items=#/$defs/resource
sceneAbiVersionrequiredconst=2
sceneCategoriesrequiredtype="array"; items=#/$defs/sceneRoute
settingsoptional here$ref="#/$defs/relativePath"
shaderRootoptional here$ref="#/$defs/relativePath"
versionrequired$ref="#/$defs/nonEmptyString"
完整结构规则: #/$defs/manifest
json
{
  "additionalProperties": false,
  "properties": {
    "author": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "expectedCatalogSha256": {
      "pattern": "^[0-9a-f]{64}$",
      "type": "string"
    },
    "frameTarget": {
      "$ref": "#/$defs/frameTarget"
    },
    "id": {
      "$ref": "#/$defs/identifier"
    },
    "manifestVersion": {
      "const": 4
    },
    "name": {
      "$ref": "#/$defs/nonEmptyString"
    },
    "options": {
      "items": {
        "$ref": "#/$defs/option"
      },
      "type": "array"
    },
    "passes": {
      "items": {
        "$ref": "#/$defs/pass"
      },
      "type": "array"
    },
    "programs": {
      "items": {
        "$ref": "#/$defs/program"
      },
      "type": "array"
    },
    "resources": {
      "items": {
        "$ref": "#/$defs/resource"
      },
      "type": "array"
    },
    "sceneAbiVersion": {
      "const": 2
    },
    "sceneCategories": {
      "items": {
        "$ref": "#/$defs/sceneRoute"
      },
      "type": "array"
    },
    "settings": {
      "$ref": "#/$defs/relativePath"
    },
    "shaderRoot": {
      "$ref": "#/$defs/relativePath"
    },
    "version": {
      "$ref": "#/$defs/nonEmptyString"
    }
  },
  "required": [
    "manifestVersion",
    "id",
    "name",
    "version",
    "options",
    "resources",
    "sceneAbiVersion",
    "sceneCategories"
  ],
  "type": "object"
}

sourceManifest · v4 ​

字段 / 分支本对象必需性结构约束
authoroptional heretype="string"
descriptionoptional heretype="string"
expectedCatalogSha256optional heretype="string"; pattern="^[0-9a-f]{64}$"
fragmentsrequiredtype="array"; minItems=1; uniqueItems=true; items=#/$defs/relativePath
frameTargetoptional here$ref="#/$defs/frameTarget"
idrequired$ref="#/$defs/identifier"
manifestVersionrequiredconst=4
namerequired$ref="#/$defs/nonEmptyString"
sceneAbiVersionrequiredconst=2
settingsoptional here$ref="#/$defs/relativePath"
shaderRootoptional here$ref="#/$defs/relativePath"
sourceFormatVersionrequiredconst=1
versionrequired$ref="#/$defs/nonEmptyString"
完整结构规则: #/$defs/sourceManifest
json
{
  "additionalProperties": false,
  "properties": {
    "author": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "expectedCatalogSha256": {
      "pattern": "^[0-9a-f]{64}$",
      "type": "string"
    },
    "fragments": {
      "items": {
        "$ref": "#/$defs/relativePath"
      },
      "minItems": 1,
      "type": "array",
      "uniqueItems": true
    },
    "frameTarget": {
      "$ref": "#/$defs/frameTarget"
    },
    "id": {
      "$ref": "#/$defs/identifier"
    },
    "manifestVersion": {
      "const": 4
    },
    "name": {
      "$ref": "#/$defs/nonEmptyString"
    },
    "sceneAbiVersion": {
      "const": 2
    },
    "settings": {
      "$ref": "#/$defs/relativePath"
    },
    "shaderRoot": {
      "$ref": "#/$defs/relativePath"
    },
    "sourceFormatVersion": {
      "const": 1
    },
    "version": {
      "$ref": "#/$defs/nonEmptyString"
    }
  },
  "required": [
    "sourceFormatVersion",
    "manifestVersion",
    "id",
    "name",
    "version",
    "fragments",
    "sceneAbiVersion"
  ],
  "type": "object"
}

fragment · v4 ​

字段 / 分支本对象必需性结构约束
optionsoptional heretype="array"; items=#/$defs/option
passesoptional heretype="array"; items=#/$defs/pass
programsoptional heretype="array"; items=#/$defs/program
resourcesoptional heretype="array"; items=#/$defs/resource
sceneCategoriesoptional heretype="array"; items=#/$defs/sceneRoute
完整结构规则: #/$defs/fragment
json
{
  "additionalProperties": false,
  "properties": {
    "options": {
      "items": {
        "$ref": "#/$defs/option"
      },
      "type": "array"
    },
    "passes": {
      "items": {
        "$ref": "#/$defs/pass"
      },
      "type": "array"
    },
    "programs": {
      "items": {
        "$ref": "#/$defs/program"
      },
      "type": "array"
    },
    "resources": {
      "items": {
        "$ref": "#/$defs/resource"
      },
      "type": "array"
    },
    "sceneCategories": {
      "items": {
        "$ref": "#/$defs/sceneRoute"
      },
      "type": "array"
    }
  },
  "type": "object"
}

identifier · v4 ​

type="string"; pattern="^[a-z0-9][a-z0-9_.-]*:[a-z0-9][a-z0-9_./-]*$"

完整结构规则: #/$defs/identifier
json
{
  "pattern": "^[a-z0-9][a-z0-9_.-]*:[a-z0-9][a-z0-9_./-]*$",
  "type": "string"
}

relativePath · v4 ​

type="string"; minLength=1

完整结构规则: #/$defs/relativePath
json
{
  "minLength": 1,
  "type": "string"
}

nonEmptyString · v4 ​

type="string"; minLength=1

完整结构规则: #/$defs/nonEmptyString
json
{
  "minLength": 1,
  "type": "string"
}

positiveVersion · v4 ​

type="integer"; minimum=1

完整结构规则: #/$defs/positiveVersion
json
{
  "minimum": 1,
  "type": "integer"
}

option · v4 ​

字段 / 分支本对象必需性结构约束
allowedoptional heretype="array"; minItems=1; uniqueItems=true; items=#/$defs/optionScalar
defaultrequired$ref="#/$defs/optionScalar"
descriptionoptional heretype="string"
idrequired$ref="#/$defs/identifier"
impactrequiredtype="array"; uniqueItems=true
maxoptional heretype="number"
minoptional heretype="number"
nameoptional heretype="string"
typerequiredenum=["boolean","integer","number","string"]
完整结构规则: #/$defs/option
json
{
  "additionalProperties": false,
  "allOf": [
    {
      "if": {
        "properties": {
          "type": {
            "const": "boolean"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "properties": {
          "allowed": {
            "items": {
              "type": "boolean"
            },
            "minItems": 1,
            "type": "array",
            "uniqueItems": true
          },
          "default": {
            "type": "boolean"
          },
          "max": {
            "not": {}
          },
          "min": {
            "not": {}
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "integer"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "properties": {
          "allowed": {
            "items": {
              "type": "integer"
            },
            "minItems": 1,
            "type": "array",
            "uniqueItems": true
          },
          "default": {
            "type": "integer"
          },
          "max": {
            "type": "integer"
          },
          "min": {
            "type": "integer"
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "number"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "properties": {
          "allowed": {
            "items": {
              "type": "number"
            },
            "minItems": 1,
            "type": "array",
            "uniqueItems": true
          },
          "default": {
            "type": "number"
          },
          "max": {
            "type": "number"
          },
          "min": {
            "type": "number"
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "string"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "properties": {
          "allowed": {
            "items": {
              "type": "string"
            },
            "minItems": 1,
            "type": "array",
            "uniqueItems": true
          },
          "default": {
            "type": "string"
          },
          "max": {
            "not": {}
          },
          "min": {
            "not": {}
          }
        }
      }
    },
    {
      "not": {
        "required": [
          "allowed",
          "min"
        ]
      }
    },
    {
      "not": {
        "required": [
          "allowed",
          "max"
        ]
      }
    },
    {
      "oneOf": [
        {
          "required": [
            "min",
            "max"
          ]
        },
        {
          "not": {
            "anyOf": [
              {
                "required": [
                  "min"
                ]
              },
              {
                "required": [
                  "max"
                ]
              }
            ]
          }
        }
      ]
    }
  ],
  "properties": {
    "allowed": {
      "items": {
        "$ref": "#/$defs/optionScalar"
      },
      "minItems": 1,
      "type": "array",
      "uniqueItems": true
    },
    "default": {
      "$ref": "#/$defs/optionScalar"
    },
    "description": {
      "type": "string"
    },
    "id": {
      "$ref": "#/$defs/identifier"
    },
    "impact": {
      "items": {
        "enum": [
          "uniform",
          "program",
          "pipeline",
          "resources"
        ]
      },
      "type": "array",
      "uniqueItems": true
    },
    "max": {
      "type": "number"
    },
    "min": {
      "type": "number"
    },
    "name": {
      "type": "string"
    },
    "type": {
      "enum": [
        "boolean",
        "integer",
        "number",
        "string"
      ]
    }
  },
  "required": [
    "id",
    "type",
    "default",
    "impact"
  ],
  "type": "object"
}

optionScalar · v4 ​

type=["boolean","integer","number","string"]

完整结构规则: #/$defs/optionScalar
json
{
  "type": [
    "boolean",
    "integer",
    "number",
    "string"
  ]
}

condition · v4 ​

字段 / 分支本对象必需性结构约束
equalsoptional here$ref="#/$defs/optionScalar"
oneOfoptional heretype="array"; minItems=1; uniqueItems=true; items=#/$defs/optionScalar
optionrequired$ref="#/$defs/identifier"
完整结构规则: #/$defs/condition
json
{
  "additionalProperties": false,
  "allOf": [
    {
      "oneOf": [
        {
          "required": [
            "equals"
          ]
        },
        {
          "required": [
            "oneOf"
          ]
        }
      ]
    }
  ],
  "properties": {
    "equals": {
      "$ref": "#/$defs/optionScalar"
    },
    "oneOf": {
      "items": {
        "$ref": "#/$defs/optionScalar"
      },
      "minItems": 1,
      "type": "array",
      "uniqueItems": true
    },
    "option": {
      "$ref": "#/$defs/identifier"
    }
  },
  "required": [
    "option"
  ],
  "type": "object"
}

resource · v4 ​

字段 / 分支本对象必需性结构约束
oneOf[0].contentoptional here$ref="#/$defs/content"
oneOf[0].formatoptional here$ref="#/$defs/nonEmptyString"
oneOf[0].historyCapacityoptional heretype="integer"; minimum=2
oneOf[0].idrequired$ref="#/$defs/identifier"
oneOf[0].kindrequiredenum=["texture2D","textureCube"]
oneOf[0].lifetimerequiredoneOf: 2
oneOf[0].samplingoptional here$ref="#/$defs/sampling"
oneOf[0].sizeoptional here$ref="#/$defs/size"
oneOf[1].byteSizerequiredtype="integer"; minimum=1
oneOf[1].contentoptional here$ref="#/$defs/content"
oneOf[1].idrequired$ref="#/$defs/identifier"
oneOf[1].kindrequiredconst="buffer"
oneOf[1].lifetimerequiredoneOf: 2
oneOf[1].usageoptional hereenum=["staticDraw","dynamicDraw","streamDraw"]
完整结构规则: #/$defs/resource
json
{
  "oneOf": [
    {
      "additionalProperties": false,
      "properties": {
        "content": {
          "$ref": "#/$defs/content"
        },
        "format": {
          "$ref": "#/$defs/nonEmptyString"
        },
        "historyCapacity": {
          "minimum": 2,
          "type": "integer"
        },
        "id": {
          "$ref": "#/$defs/identifier"
        },
        "kind": {
          "enum": [
            "texture2D",
            "textureCube"
          ]
        },
        "lifetime": {
          "oneOf": [
            {
              "enum": [
                "persistent",
                "frame",
                "transient",
                "history",
                "external"
              ]
            },
            {
              "$ref": "#/$defs/historyLifetime"
            }
          ]
        },
        "sampling": {
          "$ref": "#/$defs/sampling"
        },
        "size": {
          "$ref": "#/$defs/size"
        }
      },
      "required": [
        "id",
        "kind",
        "lifetime"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "byteSize": {
          "minimum": 1,
          "type": "integer"
        },
        "content": {
          "$ref": "#/$defs/content"
        },
        "id": {
          "$ref": "#/$defs/identifier"
        },
        "kind": {
          "const": "buffer"
        },
        "lifetime": {
          "oneOf": [
            {
              "enum": [
                "persistent",
                "frame",
                "transient",
                "history",
                "external"
              ]
            },
            {
              "$ref": "#/$defs/historyLifetime"
            }
          ]
        },
        "usage": {
          "enum": [
            "staticDraw",
            "dynamicDraw",
            "streamDraw"
          ]
        }
      },
      "required": [
        "id",
        "kind",
        "lifetime",
        "byteSize"
      ],
      "type": "object"
    }
  ]
}

content · v4 ​

字段 / 分支本对象必需性结构约束
oneOf[1].typerequiredconst="undefined"
oneOf[2].typerequiredconst="external"
oneOf[3].typerequiredconst="clear"
oneOf[3].valuerequiredoneOf: 2
oneOf[4].encodingoptional hereenum=["image","raw"]
oneOf[4].facesoptional heretype="object"; additionalProperties=false
oneOf[4].faces.negativeXrequired$ref="#/$defs/relativePath"
oneOf[4].faces.negativeYrequired$ref="#/$defs/relativePath"
oneOf[4].faces.negativeZrequired$ref="#/$defs/relativePath"
oneOf[4].faces.positiveXrequired$ref="#/$defs/relativePath"
oneOf[4].faces.positiveYrequired$ref="#/$defs/relativePath"
oneOf[4].faces.positiveZrequired$ref="#/$defs/relativePath"
oneOf[4].pathoptional here$ref="#/$defs/relativePath"
oneOf[4].typerequiredconst="asset"
oneOf[5].generatorrequired$ref="#/$defs/identifier"
oneOf[5].typerequiredconst="generated"
oneOf[5].versionrequired$ref="#/$defs/positiveVersion"
oneOf[6].servicerequired$ref="#/$defs/identifier"
oneOf[6].typerequiredconst="service"
oneOf[6].versionrequired$ref="#/$defs/positiveVersion"
完整结构规则: #/$defs/content
json
{
  "oneOf": [
    {
      "enum": [
        "undefined",
        "external"
      ]
    },
    {
      "additionalProperties": false,
      "properties": {
        "type": {
          "const": "undefined"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "type": {
          "const": "external"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "type": {
          "const": "clear"
        },
        "value": {
          "oneOf": [
            {
              "items": {
                "type": "number"
              },
              "maxItems": 1,
              "minItems": 1,
              "type": "array"
            },
            {
              "items": {
                "type": "number"
              },
              "maxItems": 4,
              "minItems": 4,
              "type": "array"
            }
          ]
        }
      },
      "required": [
        "type",
        "value"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "allOf": [
        {
          "oneOf": [
            {
              "required": [
                "path"
              ]
            },
            {
              "required": [
                "faces"
              ]
            }
          ]
        }
      ],
      "properties": {
        "encoding": {
          "enum": [
            "image",
            "raw"
          ]
        },
        "faces": {
          "additionalProperties": false,
          "properties": {
            "negativeX": {
              "$ref": "#/$defs/relativePath"
            },
            "negativeY": {
              "$ref": "#/$defs/relativePath"
            },
            "negativeZ": {
              "$ref": "#/$defs/relativePath"
            },
            "positiveX": {
              "$ref": "#/$defs/relativePath"
            },
            "positiveY": {
              "$ref": "#/$defs/relativePath"
            },
            "positiveZ": {
              "$ref": "#/$defs/relativePath"
            }
          },
          "required": [
            "positiveX",
            "negativeX",
            "positiveY",
            "negativeY",
            "positiveZ",
            "negativeZ"
          ],
          "type": "object"
        },
        "path": {
          "$ref": "#/$defs/relativePath"
        },
        "type": {
          "const": "asset"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "generator": {
          "$ref": "#/$defs/identifier"
        },
        "type": {
          "const": "generated"
        },
        "version": {
          "$ref": "#/$defs/positiveVersion"
        }
      },
      "required": [
        "type",
        "generator",
        "version"
      ],
      "type": "object"
    },
    {
      "additionalProperties": false,
      "properties": {
        "service": {
          "$ref": "#/$defs/identifier"
        },
        "type": {
          "const": "service"
        },
        "version": {
          "$ref": "#/$defs/positiveVersion"
        }
      },
      "required": [
        "type",
        "service",
        "version"
      ],
      "type": "object"
    }
  ]
}

size · v4 ​

字段 / 分支本对象必需性结构约束
heightoptional heretype="integer"; minimum=1
moderequiredenum=["absolute","viewport","output"]
scaleoptional heretype="array"; minItems=2; maxItems=2
widthoptional heretype="integer"; minimum=1
完整结构规则: #/$defs/size
json
{
  "additionalProperties": false,
  "allOf": [
    {
      "if": {
        "properties": {
          "mode": {
            "const": "absolute"
          }
        },
        "required": [
          "mode"
        ]
      },
      "then": {
        "allOf": [
          {
            "not": {
              "anyOf": [
                {
                  "required": [
                    "scale"
                  ]
                }
              ]
            }
          }
        ],
        "required": [
          "width",
          "height"
        ]
      }
    },
    {
      "if": {
        "properties": {
          "mode": {
            "enum": [
              "viewport",
              "output"
            ]
          }
        }
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "width"
              ]
            },
            {
              "required": [
                "height"
              ]
            }
          ]
        }
      }
    }
  ],
  "properties": {
    "height": {
      "minimum": 1,
      "type": "integer"
    },
    "mode": {
      "enum": [
        "absolute",
        "viewport",
        "output"
      ]
    },
    "scale": {
      "items": {
        "exclusiveMinimum": 0,
        "type": "number"
      },
      "maxItems": 2,
      "minItems": 2,
      "type": "array"
    },
    "width": {
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "mode"
  ],
  "type": "object"
}

sampling · v4 ​

字段 / 分支本对象必需性结构约束
magFilteroptional hereenum=["nearest","linear"]
minFilteroptional hereenum=["nearest","linear"]
mipLevelsoptional heretype="integer"; minimum=1
wrapSoptional hereenum=["repeat","clampToEdge","mirroredRepeat"]
wrapToptional hereenum=["repeat","clampToEdge","mirroredRepeat"]
完整结构规则: #/$defs/sampling
json
{
  "additionalProperties": false,
  "properties": {
    "magFilter": {
      "enum": [
        "nearest",
        "linear"
      ]
    },
    "minFilter": {
      "enum": [
        "nearest",
        "linear"
      ]
    },
    "mipLevels": {
      "minimum": 1,
      "type": "integer"
    },
    "wrapS": {
      "enum": [
        "repeat",
        "clampToEdge",
        "mirroredRepeat"
      ]
    },
    "wrapT": {
      "enum": [
        "repeat",
        "clampToEdge",
        "mirroredRepeat"
      ]
    }
  },
  "type": "object"
}

historyLifetime · v4 ​

字段 / 分支本对象必需性结构约束
capacityrequiredtype="integer"; minimum=2
kindrequiredconst="history"
完整结构规则: #/$defs/historyLifetime
json
{
  "additionalProperties": false,
  "properties": {
    "capacity": {
      "minimum": 2,
      "type": "integer"
    },
    "kind": {
      "const": "history"
    }
  },
  "required": [
    "kind",
    "capacity"
  ],
  "type": "object"
}

resourceView · v4 ​

字段 / 分支本对象必需性结构约束
framesAgooptional heretype="integer"; minimum=1
resourcerequired$ref="#/$defs/identifier"
viewoptional hereenum=["dawnlight:direct","dawnlight:history/current","dawnlight:history/previous","dawnlight:shadow/consumer","dawnlight:shadow/producer"]
完整结构规则: #/$defs/resourceView
json
{
  "additionalProperties": false,
  "allOf": [
    {
      "if": {
        "properties": {
          "view": {
            "const": "dawnlight:history/previous"
          }
        },
        "required": [
          "view"
        ]
      },
      "then": {
        "required": [
          "framesAgo"
        ]
      }
    },
    {
      "if": {
        "not": {
          "properties": {
            "view": {
              "const": "dawnlight:history/previous"
            }
          },
          "required": [
            "view"
          ]
        }
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "framesAgo"
              ]
            }
          ]
        }
      }
    }
  ],
  "properties": {
    "framesAgo": {
      "minimum": 1,
      "type": "integer"
    },
    "resource": {
      "$ref": "#/$defs/identifier"
    },
    "view": {
      "enum": [
        "dawnlight:direct",
        "dawnlight:history/current",
        "dawnlight:history/previous",
        "dawnlight:shadow/consumer",
        "dawnlight:shadow/producer"
      ]
    }
  },
  "required": [
    "resource"
  ],
  "type": "object"
}

program · v4 ​

字段 / 分支本对象必需性结构约束
bindingsoptional here—
compileModeoptional hereenum=["legacyCustom","officialCompatible","manifestDriven"]
computeoptional here$ref="#/$defs/relativePath"
definesoptional heretype="object"; additionalProperties={"$ref":"#/$defs/defineValue"}
drawBuffersoptional here—
engineDrawStateoptional here—
fragmentoptional here$ref="#/$defs/relativePath"
idrequired$ref="#/$defs/identifier"
kindrequiredenum=["graphics","compute"]
stateoptional here—
targetsoptional here—
variantsoptional heretype="array"; items=#/$defs/variant
vertexoptional here$ref="#/$defs/relativePath"
完整结构规则: #/$defs/program
json
{
  "additionalProperties": false,
  "allOf": [
    {
      "if": {
        "properties": {
          "kind": {
            "const": "graphics"
          }
        },
        "required": [
          "kind"
        ]
      },
      "then": {
        "allOf": [
          {
            "not": {
              "anyOf": [
                {
                  "required": [
                    "compute"
                  ]
                }
              ]
            }
          }
        ],
        "required": [
          "vertex",
          "fragment"
        ]
      }
    },
    {
      "if": {
        "properties": {
          "kind": {
            "const": "compute"
          }
        },
        "required": [
          "kind"
        ]
      },
      "then": {
        "allOf": [
          {
            "not": {
              "anyOf": [
                {
                  "required": [
                    "vertex"
                  ]
                },
                {
                  "required": [
                    "fragment"
                  ]
                },
                {
                  "required": [
                    "compileMode"
                  ]
                }
              ]
            }
          }
        ],
        "required": [
          "compute"
        ]
      }
    }
  ],
  "properties": {
    "bindings": {
      "not": {}
    },
    "compileMode": {
      "enum": [
        "legacyCustom",
        "officialCompatible",
        "manifestDriven"
      ]
    },
    "compute": {
      "$ref": "#/$defs/relativePath"
    },
    "defines": {
      "additionalProperties": {
        "$ref": "#/$defs/defineValue"
      },
      "propertyNames": {
        "$ref": "#/$defs/glslIdentifier"
      },
      "type": "object"
    },
    "drawBuffers": {
      "not": {}
    },
    "engineDrawState": {
      "not": {}
    },
    "fragment": {
      "$ref": "#/$defs/relativePath"
    },
    "id": {
      "$ref": "#/$defs/identifier"
    },
    "kind": {
      "enum": [
        "graphics",
        "compute"
      ]
    },
    "state": {
      "not": {}
    },
    "targets": {
      "not": {}
    },
    "variants": {
      "items": {
        "$ref": "#/$defs/variant"
      },
      "type": "array"
    },
    "vertex": {
      "$ref": "#/$defs/relativePath"
    }
  },
  "required": [
    "id",
    "kind"
  ],
  "type": "object"
}

variant · v4 ​

字段 / 分支本对象必需性结构约束
definesrequiredtype="object"; additionalProperties={"$ref":"#/$defs/defineValue"}
idrequired$ref="#/$defs/identifier"
完整结构规则: #/$defs/variant
json
{
  "additionalProperties": false,
  "properties": {
    "defines": {
      "additionalProperties": {
        "$ref": "#/$defs/defineValue"
      },
      "propertyNames": {
        "$ref": "#/$defs/glslIdentifier"
      },
      "type": "object"
    },
    "id": {
      "$ref": "#/$defs/identifier"
    }
  },
  "required": [
    "id",
    "defines"
  ],
  "type": "object"
}

defineValue · v4 ​

oneOf: 2

完整结构规则: #/$defs/defineValue
json
{
  "oneOf": [
    {
      "$ref": "#/$defs/nullableDefineValue"
    },
    {
      "$ref": "#/$defs/defineBinding"
    }
  ]
}

defineBinding · v4 ​

字段 / 分支本对象必需性结构约束
capabilityoptional here$ref="#/$defs/identifier"
mapoptional heretype="object"; additionalProperties={"$ref":"#/$defs/nullableDefineValue"}
optionoptional here$ref="#/$defs/identifier"
完整结构规则: #/$defs/defineBinding
json
{
  "additionalProperties": false,
  "allOf": [
    {
      "oneOf": [
        {
          "required": [
            "option"
          ]
        },
        {
          "required": [
            "capability"
          ]
        }
      ]
    }
  ],
  "properties": {
    "capability": {
      "$ref": "#/$defs/identifier"
    },
    "map": {
      "additionalProperties": {
        "$ref": "#/$defs/nullableDefineValue"
      },
      "type": "object"
    },
    "option": {
      "$ref": "#/$defs/identifier"
    }
  },
  "type": "object"
}

nullableDefineValue · v4 ​

type=["string","boolean","integer","number","null"]

完整结构规则: #/$defs/nullableDefineValue
json
{
  "type": [
    "string",
    "boolean",
    "integer",
    "number",
    "null"
  ]
}

glslIdentifier · v4 ​

type="string"; pattern="^[A-Za-z_][A-Za-z0-9_]*$"

完整结构规则: #/$defs/glslIdentifier
json
{
  "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
  "type": "string"
}

pass · v4 ​

字段 / 分支本对象必需性结构约束
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 · v4 ​

字段 / 分支本对象必需性结构约束
orderingoptional here$ref="#/$defs/ordering"
phaserequiredenum=["modelShadow","framePrepare","shadow","opaque","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",
        "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 · v4 ​

字段 / 分支本对象必需性结构约束
orderingoptional here$ref="#/$defs/ordering"
phaserequiredenum=["modelShadow","framePrepare","shadow","opaque","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",
        "transparent",
        "cloudReflection",
        "shaftPrepare",
        "shaftSun",
        "cloud",
        "particles",
        "afterDraw",
        "afterFinal",
        "screenOutput"
      ]
    },
    "target": {
      "enum": [
        "world",
        "afterDraw"
      ]
    }
  },
  "required": [
    "target",
    "phase"
  ],
  "type": "object"
}

ordering · v4 ​

字段 / 分支本对象必需性结构约束
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 · v4 ​

字段 / 分支本对象必需性结构约束
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"
}

command · v4 ​

字段 / 分支本对象必需性结构约束
bindingsoptional heretype="array"; items=#/$defs/binding
clearoptional here$ref="#/$defs/clear"
copyoptional here$ref="#/$defs/copy"
dispatchoptional here$ref="#/$defs/dispatch"
drawBuffersoptional here$ref="#/$defs/drawBufferLayout"
programoptional here$ref="#/$defs/identifier"
provideroptional here$ref="#/$defs/provider"
resourceoptional here$ref="#/$defs/identifier"
sceneBindingsoptional heretype="array"; items=#/$defs/sceneBinding
sceneProvideroptional here$ref="#/$defs/provider"
semanticsoptional heretype="array"; items=#/$defs/semantic
stateoptional here$ref="#/$defs/state"
targetsoptional here$ref="#/$defs/targets"
typerequiredenum=["fullscreen","compute","copy","clear","present","engineDraw","historyCommit"]
viewportoptional here$ref="#/$defs/viewport"
完整结构规则: #/$defs/command
json
{
  "additionalProperties": false,
  "allOf": [
    {
      "if": {
        "properties": {
          "type": {
            "const": "fullscreen"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "required": [
          "program",
          "targets"
        ]
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "compute"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "required": [
          "program",
          "dispatch"
        ]
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "copy"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "required": [
          "copy"
        ]
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "clear"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "required": [
          "clear"
        ]
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "present"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "required": [
          "program"
        ]
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "historyCommit"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "required": [
          "resource"
        ]
      }
    },
    {
      "if": {
        "not": {
          "properties": {
            "type": {
              "const": "copy"
            }
          },
          "required": [
            "type"
          ]
        }
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "copy"
              ]
            }
          ]
        }
      }
    },
    {
      "if": {
        "not": {
          "properties": {
            "type": {
              "const": "historyCommit"
            }
          },
          "required": [
            "type"
          ]
        }
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "resource"
              ]
            }
          ]
        }
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "compute"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "viewport"
              ]
            },
            {
              "required": [
                "clear"
              ]
            },
            {
              "required": [
                "targets"
              ]
            },
            {
              "required": [
                "state"
              ]
            }
          ]
        }
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "present"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "targets"
              ]
            },
            {
              "required": [
                "drawBuffers"
              ]
            }
          ]
        }
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "copy"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "program"
              ]
            },
            {
              "required": [
                "bindings"
              ]
            },
            {
              "required": [
                "semantics"
              ]
            },
            {
              "required": [
                "sceneBindings"
              ]
            },
            {
              "required": [
                "targets"
              ]
            },
            {
              "required": [
                "drawBuffers"
              ]
            },
            {
              "required": [
                "state"
              ]
            },
            {
              "required": [
                "viewport"
              ]
            },
            {
              "required": [
                "clear"
              ]
            },
            {
              "required": [
                "dispatch"
              ]
            }
          ]
        }
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "clear"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "drawBuffers"
              ]
            }
          ]
        }
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "historyCommit"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "program"
              ]
            },
            {
              "required": [
                "bindings"
              ]
            },
            {
              "required": [
                "semantics"
              ]
            },
            {
              "required": [
                "sceneBindings"
              ]
            },
            {
              "required": [
                "targets"
              ]
            },
            {
              "required": [
                "drawBuffers"
              ]
            },
            {
              "required": [
                "state"
              ]
            },
            {
              "required": [
                "viewport"
              ]
            },
            {
              "required": [
                "clear"
              ]
            },
            {
              "required": [
                "dispatch"
              ]
            },
            {
              "required": [
                "copy"
              ]
            }
          ]
        }
      }
    },
    {
      "if": {
        "properties": {
          "type": {
            "const": "engineDraw"
          }
        },
        "required": [
          "type"
        ]
      },
      "then": {
        "oneOf": [
          {
            "required": [
              "provider"
            ]
          },
          {
            "required": [
              "sceneProvider"
            ]
          }
        ]
      }
    },
    {
      "if": {
        "not": {
          "properties": {
            "type": {
              "const": "engineDraw"
            }
          },
          "required": [
            "type"
          ]
        }
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "provider"
              ]
            },
            {
              "required": [
                "sceneProvider"
              ]
            }
          ]
        }
      }
    }
  ],
  "properties": {
    "bindings": {
      "items": {
        "$ref": "#/$defs/binding"
      },
      "type": "array"
    },
    "clear": {
      "$ref": "#/$defs/clear"
    },
    "copy": {
      "$ref": "#/$defs/copy"
    },
    "dispatch": {
      "$ref": "#/$defs/dispatch"
    },
    "drawBuffers": {
      "$ref": "#/$defs/drawBufferLayout"
    },
    "program": {
      "$ref": "#/$defs/identifier"
    },
    "provider": {
      "$ref": "#/$defs/provider"
    },
    "resource": {
      "$ref": "#/$defs/identifier"
    },
    "sceneBindings": {
      "items": {
        "$ref": "#/$defs/sceneBinding"
      },
      "type": "array"
    },
    "sceneProvider": {
      "$ref": "#/$defs/provider"
    },
    "semantics": {
      "items": {
        "$ref": "#/$defs/semantic"
      },
      "type": "array"
    },
    "state": {
      "$ref": "#/$defs/state"
    },
    "targets": {
      "$ref": "#/$defs/targets"
    },
    "type": {
      "enum": [
        "fullscreen",
        "compute",
        "copy",
        "clear",
        "present",
        "engineDraw",
        "historyCommit"
      ]
    },
    "viewport": {
      "$ref": "#/$defs/viewport"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

copy · v4 ​

字段 / 分支本对象必需性结构约束
aspectsrequiredtype="array"; minItems=1; uniqueItems=true
destinationrequiredoneOf: 2
filteroptional hereenum=["nearest","linear"]
restoreoptional hereenum=["none","frame"]
sourcerequiredoneOf: 2
完整结构规则: #/$defs/copy
json
{
  "additionalProperties": false,
  "properties": {
    "aspects": {
      "items": {
        "enum": [
          "color",
          "depth"
        ]
      },
      "minItems": 1,
      "type": "array",
      "uniqueItems": true
    },
    "destination": {
      "oneOf": [
        {
          "$ref": "#/$defs/identifier"
        },
        {
          "$ref": "#/$defs/resourceView"
        }
      ]
    },
    "filter": {
      "enum": [
        "nearest",
        "linear"
      ]
    },
    "restore": {
      "enum": [
        "none",
        "frame"
      ]
    },
    "source": {
      "oneOf": [
        {
          "$ref": "#/$defs/identifier"
        },
        {
          "$ref": "#/$defs/resourceView"
        }
      ]
    }
  },
  "required": [
    "source",
    "destination",
    "aspects"
  ],
  "type": "object"
}

clear · v4 ​

字段 / 分支本对象必需性结构约束
coloroptional heretype="array"; minItems=4; maxItems=4
depthoptional heretype="number"; minimum=0; maximum=1
stenciloptional heretype="integer"; minimum=0
完整结构规则: #/$defs/clear
json
{
  "additionalProperties": false,
  "minProperties": 1,
  "properties": {
    "color": {
      "items": {
        "type": "number"
      },
      "maxItems": 4,
      "minItems": 4,
      "type": "array"
    },
    "depth": {
      "maximum": 1,
      "minimum": 0,
      "type": "number"
    },
    "stencil": {
      "minimum": 0,
      "type": "integer"
    }
  },
  "type": "object"
}

dispatch · v4 ​

字段 / 分支本对象必需性结构约束
barriersoptional heretype="array"; uniqueItems=true
groupsrequiredtype="array"; minItems=3; maxItems=3
完整结构规则: #/$defs/dispatch
json
{
  "additionalProperties": false,
  "properties": {
    "barriers": {
      "items": {
        "enum": [
          "shaderImageAccess",
          "textureFetch",
          "textureUpdate",
          "shaderStorage",
          "bufferUpdate",
          "framebuffer"
        ]
      },
      "type": "array",
      "uniqueItems": true
    },
    "groups": {
      "items": {
        "minimum": 1,
        "type": "integer"
      },
      "maxItems": 3,
      "minItems": 3,
      "type": "array"
    }
  },
  "required": [
    "groups"
  ],
  "type": "object"
}

viewport · v4 ​

字段 / 分支本对象必需性结构约束
restorerequiredenum=["none","frame"]
sourcerequiredenum=["target","frame"]
synchronizeScissoroptional heretype="boolean"
完整结构规则: #/$defs/viewport
json
{
  "additionalProperties": false,
  "properties": {
    "restore": {
      "enum": [
        "none",
        "frame"
      ]
    },
    "source": {
      "enum": [
        "target",
        "frame"
      ]
    },
    "synchronizeScissor": {
      "type": "boolean"
    }
  },
  "required": [
    "source",
    "restore"
  ],
  "type": "object"
}

provider · v4 ​

字段 / 分支本对象必需性结构约束
idrequired$ref="#/$defs/identifier"
versionrequired$ref="#/$defs/positiveVersion"
完整结构规则: #/$defs/provider
json
{
  "additionalProperties": false,
  "properties": {
    "id": {
      "$ref": "#/$defs/identifier"
    },
    "version": {
      "$ref": "#/$defs/positiveVersion"
    }
  },
  "required": [
    "id",
    "version"
  ],
  "type": "object"
}

targets · v4 ​

字段 / 分支本对象必需性结构约束
colorsoptional heretype="array"; uniqueItems=true; items=#/$defs/colorTarget
depthoptional here$ref="#/$defs/depthTarget"
完整结构规则: #/$defs/targets
json
{
  "additionalProperties": false,
  "minProperties": 1,
  "properties": {
    "colors": {
      "items": {
        "$ref": "#/$defs/colorTarget"
      },
      "type": "array",
      "uniqueItems": true
    },
    "depth": {
      "$ref": "#/$defs/depthTarget"
    }
  },
  "type": "object"
}

colorTarget · v4 ​

字段 / 分支本对象必需性结构约束
clearValueoptional heretype="array"; minItems=4; maxItems=4
framesAgooptional heretype="integer"; minimum=1
loadOprequiredenum=["load","clear","dontCare"]
locationrequiredtype="integer"; minimum=0
resourcerequired$ref="#/$defs/identifier"
storeOprequiredenum=["store","dontCare"]
viewoptional hereenum=["dawnlight:direct","dawnlight:history/current","dawnlight:history/previous","dawnlight:shadow/consumer","dawnlight:shadow/producer"]
完整结构规则: #/$defs/colorTarget
json
{
  "additionalProperties": false,
  "allOf": [
    {
      "if": {
        "properties": {
          "loadOp": {
            "const": "clear"
          }
        },
        "required": [
          "loadOp"
        ]
      },
      "then": {
        "required": [
          "clearValue"
        ]
      }
    },
    {
      "if": {
        "not": {
          "properties": {
            "loadOp": {
              "const": "clear"
            }
          },
          "required": [
            "loadOp"
          ]
        }
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "clearValue"
              ]
            }
          ]
        }
      }
    }
  ],
  "properties": {
    "clearValue": {
      "items": {
        "type": "number"
      },
      "maxItems": 4,
      "minItems": 4,
      "type": "array"
    },
    "framesAgo": {
      "minimum": 1,
      "type": "integer"
    },
    "loadOp": {
      "enum": [
        "load",
        "clear",
        "dontCare"
      ]
    },
    "location": {
      "minimum": 0,
      "type": "integer"
    },
    "resource": {
      "$ref": "#/$defs/identifier"
    },
    "storeOp": {
      "enum": [
        "store",
        "dontCare"
      ]
    },
    "view": {
      "enum": [
        "dawnlight:direct",
        "dawnlight:history/current",
        "dawnlight:history/previous",
        "dawnlight:shadow/consumer",
        "dawnlight:shadow/producer"
      ]
    }
  },
  "required": [
    "location",
    "resource",
    "loadOp",
    "storeOp"
  ],
  "type": "object"
}

depthTarget · v4 ​

字段 / 分支本对象必需性结构约束
clearValueoptional heretype="number"; minimum=0; maximum=1
framesAgooptional heretype="integer"; minimum=1
loadOprequiredenum=["load","clear","dontCare"]
resourcerequired$ref="#/$defs/identifier"
storeOprequiredenum=["store","dontCare"]
viewoptional hereenum=["dawnlight:direct","dawnlight:history/current","dawnlight:history/previous","dawnlight:shadow/consumer","dawnlight:shadow/producer"]
完整结构规则: #/$defs/depthTarget
json
{
  "additionalProperties": false,
  "allOf": [
    {
      "if": {
        "properties": {
          "loadOp": {
            "const": "clear"
          }
        },
        "required": [
          "loadOp"
        ]
      },
      "then": {
        "required": [
          "clearValue"
        ]
      }
    },
    {
      "if": {
        "not": {
          "properties": {
            "loadOp": {
              "const": "clear"
            }
          },
          "required": [
            "loadOp"
          ]
        }
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "clearValue"
              ]
            }
          ]
        }
      }
    }
  ],
  "properties": {
    "clearValue": {
      "maximum": 1,
      "minimum": 0,
      "type": "number"
    },
    "framesAgo": {
      "minimum": 1,
      "type": "integer"
    },
    "loadOp": {
      "enum": [
        "load",
        "clear",
        "dontCare"
      ]
    },
    "resource": {
      "$ref": "#/$defs/identifier"
    },
    "storeOp": {
      "enum": [
        "store",
        "dontCare"
      ]
    },
    "view": {
      "enum": [
        "dawnlight:direct",
        "dawnlight:history/current",
        "dawnlight:history/previous",
        "dawnlight:shadow/consumer",
        "dawnlight:shadow/producer"
      ]
    }
  },
  "required": [
    "resource",
    "loadOp",
    "storeOp"
  ],
  "type": "object"
}

state · v4 ​

字段 / 分支本对象必需性结构约束
blendoptional hereenum=["inherit","opaque","alphaBlend","nonPremultiplied"]
blendTargetsoptional heretype="array"; minItems=1; uniqueItems=true
depthoptional hereenum=["inherit","default","depthWrite","depthTestWriteLess","disabled"]
rasterizeroptional hereenum=["inherit","cullCounterClockwiseScissor","cullClockwiseScissor","cullNoneScissor"]
完整结构规则: #/$defs/state
json
{
  "additionalProperties": false,
  "properties": {
    "blend": {
      "enum": [
        "inherit",
        "opaque",
        "alphaBlend",
        "nonPremultiplied"
      ]
    },
    "blendTargets": {
      "items": {
        "minimum": 0,
        "type": "integer"
      },
      "minItems": 1,
      "type": "array",
      "uniqueItems": true
    },
    "depth": {
      "enum": [
        "inherit",
        "default",
        "depthWrite",
        "depthTestWriteLess",
        "disabled"
      ]
    },
    "rasterizer": {
      "enum": [
        "inherit",
        "cullCounterClockwiseScissor",
        "cullClockwiseScissor",
        "cullNoneScissor"
      ]
    }
  },
  "type": "object"
}

drawBufferLayout · v4 ​

type="array"

完整结构规则: #/$defs/drawBufferLayout
json
{
  "items": {
    "oneOf": [
      {
        "const": "disabled"
      },
      {
        "minimum": 0,
        "type": "integer"
      }
    ]
  },
  "type": "array"
}

binding · v4 ​

字段 / 分支本对象必需性结构约束
accessoptional hereenum=["readOnly","writeOnly","readWrite"]
bindingrequiredtype="integer"; minimum=0
enabledWhenoptional heretype="array"; items=#/$defs/condition
fallbackoptional hereoneOf: 2
framesAgooptional heretype="integer"; minimum=1
kindrequiredenum=["sampler2D","samplerCube","image2D","uniformBuffer","storageBuffer"]
resourcerequired$ref="#/$defs/identifier"
symbolrequired$ref="#/$defs/glslIdentifier"
viewoptional hereenum=["dawnlight:direct","dawnlight:history/current","dawnlight:history/previous","dawnlight:shadow/consumer","dawnlight:shadow/producer"]
完整结构规则: #/$defs/binding
json
{
  "additionalProperties": false,
  "allOf": [
    {
      "if": {
        "properties": {
          "kind": {
            "enum": [
              "image2D",
              "storageBuffer"
            ]
          }
        }
      },
      "then": {
        "required": [
          "access"
        ]
      }
    },
    {
      "if": {
        "not": {
          "properties": {
            "kind": {
              "enum": [
                "image2D",
                "storageBuffer"
              ]
            }
          }
        }
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "access"
              ]
            }
          ]
        }
      }
    },
    {
      "if": {
        "properties": {
          "view": {
            "const": "dawnlight:history/previous"
          }
        },
        "required": [
          "view"
        ]
      },
      "then": {
        "required": [
          "framesAgo"
        ]
      }
    },
    {
      "if": {
        "not": {
          "properties": {
            "view": {
              "const": "dawnlight:history/previous"
            }
          },
          "required": [
            "view"
          ]
        }
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "framesAgo"
              ]
            }
          ]
        }
      }
    }
  ],
  "properties": {
    "access": {
      "enum": [
        "readOnly",
        "writeOnly",
        "readWrite"
      ]
    },
    "binding": {
      "minimum": 0,
      "type": "integer"
    },
    "enabledWhen": {
      "items": {
        "$ref": "#/$defs/condition"
      },
      "type": "array"
    },
    "fallback": {
      "oneOf": [
        {
          "$ref": "#/$defs/identifier"
        },
        {
          "$ref": "#/$defs/resourceView"
        }
      ]
    },
    "framesAgo": {
      "minimum": 1,
      "type": "integer"
    },
    "kind": {
      "enum": [
        "sampler2D",
        "samplerCube",
        "image2D",
        "uniformBuffer",
        "storageBuffer"
      ]
    },
    "resource": {
      "$ref": "#/$defs/identifier"
    },
    "symbol": {
      "$ref": "#/$defs/glslIdentifier"
    },
    "view": {
      "enum": [
        "dawnlight:direct",
        "dawnlight:history/current",
        "dawnlight:history/previous",
        "dawnlight:shadow/consumer",
        "dawnlight:shadow/producer"
      ]
    }
  },
  "required": [
    "kind",
    "symbol",
    "binding",
    "resource"
  ],
  "type": "object"
}

semantic · v4 ​

字段 / 分支本对象必需性结构约束
enabledWhenoptional heretype="array"; items=#/$defs/condition
semanticrequired$ref="#/$defs/identifier"
symbolrequired$ref="#/$defs/glslIdentifier"
versionrequired$ref="#/$defs/positiveVersion"
完整结构规则: #/$defs/semantic
json
{
  "additionalProperties": false,
  "properties": {
    "enabledWhen": {
      "items": {
        "$ref": "#/$defs/condition"
      },
      "type": "array"
    },
    "semantic": {
      "$ref": "#/$defs/identifier"
    },
    "symbol": {
      "$ref": "#/$defs/glslIdentifier"
    },
    "version": {
      "$ref": "#/$defs/positiveVersion"
    }
  },
  "required": [
    "symbol",
    "semantic",
    "version"
  ],
  "type": "object"
}

sceneBinding · v4 ​

字段 / 分支本对象必需性结构约束
bindingoptional heretype="integer"; minimum=0
contractrequired$ref="#/$defs/identifier"
frequencyrequiredenum=["frame","view","batch","draw"]
symbolrequired$ref="#/$defs/glslIdentifier"
versionrequired$ref="#/$defs/positiveVersion"
完整结构规则: #/$defs/sceneBinding
json
{
  "additionalProperties": false,
  "properties": {
    "binding": {
      "minimum": 0,
      "type": "integer"
    },
    "contract": {
      "$ref": "#/$defs/identifier"
    },
    "frequency": {
      "enum": [
        "frame",
        "view",
        "batch",
        "draw"
      ]
    },
    "symbol": {
      "$ref": "#/$defs/glslIdentifier"
    },
    "version": {
      "$ref": "#/$defs/positiveVersion"
    }
  },
  "required": [
    "symbol",
    "contract",
    "version",
    "frequency"
  ],
  "type": "object"
}

sceneRoute · v4 ​

字段 / 分支本对象必需性结构约束
idrequired$ref="#/$defs/identifier"
moderequiredenum=["override","builtin","disabled"]
stageoptional here$ref="#/$defs/identifier"
versionrequired$ref="#/$defs/positiveVersion"
完整结构规则: #/$defs/sceneRoute
json
{
  "additionalProperties": false,
  "allOf": [
    {
      "if": {
        "properties": {
          "mode": {
            "const": "override"
          }
        },
        "required": [
          "mode"
        ]
      },
      "then": {
        "required": [
          "stage"
        ]
      }
    },
    {
      "if": {
        "properties": {
          "mode": {
            "enum": [
              "builtin",
              "disabled"
            ]
          }
        }
      },
      "then": {
        "not": {
          "anyOf": [
            {
              "required": [
                "stage"
              ]
            }
          ]
        }
      }
    }
  ],
  "properties": {
    "id": {
      "$ref": "#/$defs/identifier"
    },
    "mode": {
      "enum": [
        "override",
        "builtin",
        "disabled"
      ]
    },
    "stage": {
      "$ref": "#/$defs/identifier"
    },
    "version": {
      "$ref": "#/$defs/positiveVersion"
    }
  },
  "required": [
    "id",
    "version",
    "mode"
  ],
  "type": "object"
}

frameTarget · v4 ​

字段 / 分支本对象必需性结构约束
targetsrequired$ref="#/$defs/targets"
完整结构规则: #/$defs/frameTarget
json
{
  "additionalProperties": false,
  "properties": {
    "targets": {
      "$ref": "#/$defs/targets"
    }
  },
  "required": [
    "targets"
  ],
  "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