morphus.myles4miles.chatgpt.site

{
  "type": "object",
  "properties": {
    "nodeId": {
      "type": "string",
      "description": "Mesh terrain node ID. Omit when the scene contains exactly one mesh terrain."
    },
    "operation": {
      "type": "string",
      "enum": [
        "subtract",
        "add"
      ],
      "description": "\"subtract\" (default) removes the volumes from the terrain solid; \"add\" unions them into it."
    },
    "volumes": {
      "type": "array",
      "description": "The volumes to combine with the terrain. Fields other than `kind` and the shared surface fields apply only to the kinds named in their description.",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "capsule",
              "ellipsoid",
              "box",
              "sweep"
            ],
            "description": "Volume shape. `capsule` is a swept sphere between two points -- passages, tubes, and windows punched through a fin. `ellipsoid` is a rotated ellipsoid -- round for a chamber, flattened for a cliff undercut. `box` is a rotated box, for the straight-walled reaches of a slot canyon. `sweep` is a chain of elliptical rings, for one continuously varying cave shell."
          },
          "startX": {
            "type": "number",
            "description": "capsule: world X of the capsule axis start, in meters"
          },
          "startY": {
            "type": "number",
            "description": "capsule: world Y of the capsule axis start, in meters"
          },
          "startZ": {
            "type": "number",
            "description": "capsule: world Z of the capsule axis start, in meters"
          },
          "endX": {
            "type": "number",
            "description": "capsule: world X of the capsule axis end, in meters"
          },
          "endY": {
            "type": "number",
            "description": "capsule: world Y of the capsule axis end, in meters"
          },
          "endZ": {
            "type": "number",
            "description": "capsule: world Z of the capsule axis end, in meters"
          },
          "radiusMeters": {
            "type": "number",
            "description": "capsule: sphere radius swept along the axis, in meters"
          },
          "centerX": {
            "type": "number",
            "description": "ellipsoid and box: world X of the volume center, in meters"
          },
          "centerY": {
            "type": "number",
            "description": "ellipsoid and box: world Y of the volume center, in meters"
          },
          "centerZ": {
            "type": "number",
            "description": "ellipsoid and box: world Z of the volume center, in meters"
          },
          "radiusX": {
            "type": "number",
            "description": "ellipsoid: half-extent along the local forward axis, in meters"
          },
          "radiusY": {
            "type": "number",
            "description": "ellipsoid: half-extent along local up, in meters. Make this small relative to radiusX and radiusZ to undercut a cliff."
          },
          "radiusZ": {
            "type": "number",
            "description": "ellipsoid: half-extent along the local side axis, in meters"
          },
          "halfExtentX": {
            "type": "number",
            "description": "box: half-size along the local forward axis, in meters"
          },
          "halfExtentY": {
            "type": "number",
            "description": "box: half-size along local up, in meters"
          },
          "halfExtentZ": {
            "type": "number",
            "description": "box: half-size along the local side axis, in meters"
          },
          "forwardX": {
            "type": "number",
            "description": "ellipsoid and box: world direction the local +X axis points along. Defaults to (1,0,0)."
          },
          "forwardY": {
            "type": "number",
            "description": "ellipsoid and box: forward direction Y"
          },
          "forwardZ": {
            "type": "number",
            "description": "ellipsoid and box: forward direction Z"
          },
          "upX": {
            "type": "number",
            "description": "ellipsoid and box: optional world up reference, X. Defaults to (0,1,0)."
          },
          "upY": {
            "type": "number",
            "description": "ellipsoid and box: optional world up reference, Y"
          },
          "upZ": {
            "type": "number",
            "description": "ellipsoid and box: optional world up reference, Z"
          },
          "rings": {
            "type": "array",
            "description": "sweep: ordered elliptical cross-sections defining one continuous void. Three or more rings give a passage that widens and narrows convincingly.",
            "items": {
              "type": "object",
              "properties": {
                "x": {
                  "type": "number",
                  "description": "World X of the ring center, in meters"
                },
                "y": {
                  "type": "number",
                  "description": "World Y of the ring center, in meters"
                },
                "z": {
                  "type": "number",
                  "description": "World Z of the ring center, in meters"
                },
                "horizontalRadius": {
                  "type": "number",
                  "description": "Ring half-width in meters"
                },
                "verticalRadius": {
                  "type": "number",
                  "description": "Ring half-height in meters. Below the horizontal radius it reads as a bedding-plane crawl; above it, as a rift."
                }
              },
              "required": [
                "x",
                "y",
                "z",
                "horizontalRadius",
                "verticalRadius"
              ]
            }
          },
          "surface": {
            "type": "string",
            "enum": [
              "cave",
              "arch",
              "overhang",
              "canyon",
              "hoodoo",
              "default",
              "none"
            ],
            "description": "Displacement character applied to the cut face before the boolean runs. Pick the one that matches what the volume is for; \"none\" leaves an analytic, machined-looking surface and is only right for engineered geometry."
          },
          "noise": {
            "type": "number",
            "description": "Relative cross-section roughness, 0 or more. 0 is smooth."
          },
          "noiseScale": {
            "type": "number",
            "description": "World-space wavelength of the close-surface roughness, in meters."
          },
          "interior": {
            "type": "string",
            "enum": [
              "rock",
              "ember"
            ],
            "description": "Material classification for the faces this subtraction exposes."
          }
        },
        "required": [
          "kind"
        ]
      }
    }
  },
  "required": [
    "volumes"
  ]
}