Skip to content

Scene ABI and Terrain ​

Behavior and constraints ​

Scene ABI v2 explicitly routes four Terrain categories: opaque, alpha_tested, transparent and sorted_translucent. Exact category ID/version, target/phase and permitted modes come from the Catalog. Each category needs one valid owner. override selects an active pack-owned Stage and compatible sceneProvider; builtin materializes that category's recipe; disabled is allowed only by the category and may hide matching world content.

Provider v1/v2 is not an alias for the Scene ABI number. Select exact ID/version pairs and check category, vertexAbi, targetCapability, stateCapability, systemBindings and required/permittedServices. Terrain categories cannot exchange arbitrary Providers. Pack Programs use shaderRoot; fallback retains BuiltIn source ownership. Do not copy or redirect filenames to mix owners.

terrain_chunk uses stream 0 stride 20 and stream 1 stride 8. Vertex metadata lists locations 0–7, offsets, types, integerInput, normalized and spaces. Identifier at location 3 is an integer input. Location 4 carries three unnormalized oct-normal bytes, not XYZ. Symbols, semantic comments, origin and matrix conventions must match the shader.

frameTarget owns the whole frame, including interactions with sky, models and later renderers. Four Terrain declarations do not prove complete scene coverage. Opaque depth clearing and color load follow this ABI. Fallback currently writes RT0 only, even with multiple named attachments. Teaching encodings are separate from host ABI; incomplete auxiliary surfaces are not a complete visible-surface G-buffer.

World positions use blocks. Raw Engine row-vector matrices uploaded to GLSL are consumed as Projection × View × world, without another transpose. OPENGL_POSITION_FIX adjusts clip z; sampled depth remains host [0,1], so reconstruction must not apply another 2d−1. Custom data documents logical/render projection, auxiliary-camera and VR limits.

Generated v5 structure ​

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

sceneRoute · v5 ​

Field / branchPresence in this objectStructural constraints
idrequired$ref="#/$defs/identifier"
moderequiredenum=["override","builtin","disabled"]
stageoptional here$ref="#/$defs/identifier"
versionrequired$ref="#/$defs/positiveVersion"
Full structural rule: #/$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 · v5 ​

Field / branchPresence in this objectStructural constraints
targetsrequired$ref="#/$defs/targets"
Full structural rule: #/$defs/frameTarget
json
{
  "additionalProperties": false,
  "properties": {
    "targets": {
      "$ref": "#/$defs/targets"
    }
  },
  "required": [
    "targets"
  ],
  "type": "object"
}

Complete examples ​

Sources and machine records ​

Coverage inventory · Schema v5 · Catalog v2 · Completion v2

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

ShaderPackManifestLoader.cs

Author documentation · Manifest v5 / Scene ABI v2