Headless 3D and VFX engine for agents. Research preview.
{
"$defs": {
"AimTarget": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"format": "float",
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
}
],
"description": "Aiming references a node origin or a fixed point in world coordinates."
},
"Aov": {
"additionalProperties": false,
"properties": {
"name": {
"type": "string",
"x-help": "name; EXR channels <name>.X or <name>.R/G/B",
"x-help-path": "render.aovs.name",
"x-source": "Blender ViewLayer AOV.name"
},
"type": {
"$ref": "#/$defs/AovType",
"x-help": "value|color",
"x-help-path": "render.aovs.type",
"x-source": "Blender ViewLayer AOV.type"
}
},
"required": [
"name",
"type"
],
"type": "object"
},
"AovBinding": {
"additionalProperties": false,
"description": "A render.aovs entry: an Aov handle for surface programs, or the AOV image in compositor programs.",
"properties": {
"aov": {
"type": "string",
"x-help": "render.aovs name",
"x-help-path": "material.aov.aov",
"x-source": "vork (explicit contract/technique choice)"
}
},
"required": [
"aov"
],
"type": "object"
},
"AovType": {
"enum": [
"value",
"color"
],
"type": "string"
},
"AssetNodeOverrides": {
"additionalProperties": false,
"description": "Visibility is ANDed with ancestors. Reflections and diffuse transport query\nscene geometry independently of camera visibility. Diffuse visibility controls AO\nand indirect occlusion; specular visibility controls reflected appearance.",
"properties": {
"light_link_tags": {
"items": {
"type": "string"
},
"type": [
"array",
"null"
],
"x-help": "string[]|null; replaces inherited tags",
"x-help-path": "node.asset.nodes.<name>.light_link_tags",
"x-source": "vork (explicit contract/technique choice)"
},
"pass_index": {
"format": "uint32",
"maximum": 65535,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-help": "u32|null; 1..65535; object ID",
"x-help-path": "node.asset.nodes.<name>.pass_index",
"x-source": "vork (explicit contract/technique choice)"
},
"visible": {
"default": true,
"type": "boolean",
"x-help": "bool; false hides the subtree and disables its lights; animatable (step)",
"x-help-path": "node.visible",
"x-source": "vork visibility primitive"
},
"visible_camera": {
"default": true,
"type": "boolean",
"x-help": "bool",
"x-help-path": "node.visible_camera",
"x-source": "Blender Object.visible_camera"
},
"visible_diffuse": {
"default": true,
"type": "boolean",
"x-help": "bool",
"x-help-path": "node.visible_diffuse",
"x-source": "Blender Object.visible_diffuse"
},
"visible_glossy": {
"default": true,
"type": "boolean",
"x-help": "bool",
"x-help-path": "node.visible_glossy",
"x-source": "Blender Object.visible_glossy"
},
"visible_shadow": {
"default": true,
"type": "boolean",
"x-help": "bool; lights must stay true (a light without shadows: shadowed_by [])",
"x-help-path": "node.visible_shadow",
"x-source": "Blender Object.visible_shadow"
},
"visible_transmission": {
"default": true,
"type": "boolean",
"x-help": "bool; object visibility to transmission rays; lights must stay true",
"x-help-path": "node.visible_transmission",
"x-source": "Blender Object.visible_transmission"
}
},
"type": "object",
"x-help-extra": "node.asset.nodes.<name>.visible: bool; default true\nnode.asset.nodes.<name>.visible_camera: bool; default true\nnode.asset.nodes.<name>.visible_shadow: bool; default true\nnode.asset.nodes.<name>.visible_diffuse: bool; default true\nnode.asset.nodes.<name>.visible_glossy: bool; default true\nnode.asset.nodes.<name>.visible_transmission: bool; default true"
},
"AttributeBinding": {
"additionalProperties": false,
"description": "Install-resolved named float vertex data. Custom programs declare Attribute<float>\nthrough Attribute<float4>; read_attribute returns value, dx and dy. Missing or\nincompatible streams on any bound geometry fail install.",
"properties": {
"attribute": {
"type": "string",
"x-help": "string; geometry or instance attribute name; colour values are linear Rec.709 (no sRGB decoding)",
"x-help-path": "material.attribute.attribute",
"x-source": "vork (explicit contract/technique choice)"
},
"channel": {
"anyOf": [
{
"$ref": "#/$defs/Channel"
},
{
"type": "null"
}
],
"x-help": "r|g|b|a|rgb; omitted: r scalar, rgb colour, exact for vectors",
"x-help-path": "material.attribute.channel",
"x-source": "vork (explicit contract/technique choice)"
},
"factor": {
"anyOf": [
{
"$ref": "#/$defs/Factor"
},
{
"type": "null"
}
],
"x-help": "number|vector; omitted = 1",
"x-help-path": "material.attribute.factor",
"x-source": "vork (explicit contract/technique choice)"
}
},
"required": [
"attribute"
],
"type": "object",
"x-help-extra": "material.attribute: binds geometry or instance columns to numeric inputs; custom programs read_attribute(handle,ctx) gives value, dx, dy"
},
"Background": {
"anyOf": [
{
"items": {
"format": "float",
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
{
"$ref": "#/$defs/BackgroundMode"
}
]
},
"BackgroundMode": {
"enum": [
"environment",
"transparent"
],
"type": "string"
},
"Blend": {
"enum": [
"replace",
"add"
],
"type": "string"
},
"Buffer": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"count": {
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
],
"x-help": "u32|null; file only",
"x-help-path": "buffer.count",
"x-source": "vork (explicit contract/technique choice)"
},
"data": {
"anyOf": [
{
"$ref": "#/$defs/InlineDataSchema"
}
],
"x-help": "number[]|number[][]; XOR file; mat4 column-major",
"x-help-path": "buffer.data",
"x-source": "vork (explicit contract/technique choice)"
},
"dims": {
"type": "null"
},
"file": {
"type": "null"
},
"grid": {
"description": "OpenVDB/NanoVDB field name; buffer.type describes voxel values.",
"type": [
"string",
"null"
],
"x-help": "name|null; .vdb/.nvdb only; f32 or vec3 voxels",
"x-help-path": "buffer.grid",
"x-source": "OpenVDB/NanoVDB; USD OpenVDBAsset fieldName"
},
"offset": {
"default": 0,
"format": "uint64",
"minimum": 0,
"type": "integer",
"x-help": "u64; bytes, multiple of 4",
"x-help-path": "buffer.offset",
"x-source": "vork (explicit contract/technique choice)"
},
"type": {
"$ref": "#/$defs/BufferType",
"x-help": "f32|i32|u32|vec2|vec3|vec4|uvec4|mat4",
"x-help-path": "buffer.type",
"x-source": "vork (explicit contract/technique choice)"
}
},
"required": [
"type",
"data"
],
"title": "InlineBuffer",
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"count": {
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
],
"x-help": "u32|null; file only",
"x-help-path": "buffer.count",
"x-source": "vork (explicit contract/technique choice)"
},
"data": {
"type": "null"
},
"dims": {
"type": "null"
},
"file": {
"type": [
"string"
],
"x-help": "file-path; little-endian, or .vdb/.nvdb with grid; XOR data",
"x-help-path": "buffer.file",
"x-source": "vork (explicit contract/technique choice)"
},
"grid": {
"description": "OpenVDB/NanoVDB field name; buffer.type describes voxel values.",
"type": [
"string",
"null"
],
"x-help": "name|null; .vdb/.nvdb only; f32 or vec3 voxels",
"x-help-path": "buffer.grid",
"x-source": "OpenVDB/NanoVDB; USD OpenVDBAsset fieldName"
},
"offset": {
"default": 0,
"format": "uint64",
"minimum": 0,
"type": "integer",
"x-help": "u64; bytes, multiple of 4",
"x-help-path": "buffer.offset",
"x-source": "vork (explicit contract/technique choice)"
},
"type": {
"$ref": "#/$defs/BufferType",
"x-help": "f32|i32|u32|vec2|vec3|vec4|uvec4|mat4",
"x-help-path": "buffer.type",
"x-source": "vork (explicit contract/technique choice)"
}
},
"required": [
"type",
"file"
],
"title": "FileBuffer",
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"count": {
"type": "null"
},
"data": {
"anyOf": [
{
"$ref": "#/$defs/InlineDataSchema"
},
{
"type": "null"
}
],
"x-help": "number[]|number[][]; XOR file; mat4 column-major",
"x-help-path": "buffer.data",
"x-source": "vork (explicit contract/technique choice)"
},
"dims": {
"description": "Dense typed array, x contiguous. Initially zero unless data is supplied.\nField consumers interpret cell centres in local [-1,1]³.",
"items": {
"format": "uint32",
"minimum": 1,
"type": "integer"
},
"maxItems": 3,
"minItems": 3,
"type": "array",
"x-help": "[u32,u32,u32]|null; positive dense typed array dimensions; non-file; x contiguous; field cell centres span local [-1,1]³",
"x-help-path": "buffer.dims",
"x-source": "vork (explicit contract/technique choice)"
},
"file": {
"type": "null"
},
"grid": {
"type": "null"
},
"offset": {
"maximum": 0,
"minimum": 0,
"type": "integer"
},
"type": {
"enum": [
"f32",
"vec3"
]
}
},
"required": [
"type",
"dims"
],
"title": "DenseBuffer",
"type": "object"
}
]
},
"BufferType": {
"enum": [
"f32",
"i32",
"u32",
"vec2",
"vec3",
"vec4",
"uvec4",
"mat4"
],
"type": "string"
},
"Channel": {
"enum": [
"r",
"g",
"b",
"a",
"rgb"
],
"type": "string"
},
"ChannelBinding": {
"additionalProperties": false,
"description": "A kernel image channel read by a compositor program.",
"properties": {
"channel": {
"$ref": "#/$defs/KernelChannel",
"x-help": "color|depth|view_normal|object_index|motion|shadow_catcher; compositor programs",
"x-help-path": "material.channel.channel",
"x-source": "vork (explicit contract/technique choice)"
}
},
"required": [
"channel"
],
"type": "object"
},
"Clip": {
"additionalProperties": false,
"properties": {
"file": {
"type": [
"string",
"null"
],
"x-help": "file-path|null; null = the target asset's clips; else a glTF file retargeted by node name",
"x-help-path": "animation.clip.file",
"x-source": "vork (explicit contract/technique choice)"
},
"index": {
"format": "uint32",
"minimum": 0,
"type": [
"integer",
"null"
],
"x-help": "u32|null; XOR name",
"x-help-path": "animation.clip.index",
"x-source": "vork (explicit contract/technique choice)"
},
"name": {
"type": [
"string",
"null"
],
"x-help": "string|null; XOR index",
"x-help-path": "animation.clip.name",
"x-source": "vork (explicit contract/technique choice)"
},
"target": {
"type": "string",
"x-help": "asset-node-name",
"x-help-path": "animation.clip.target",
"x-source": "vork (explicit contract/technique choice)"
}
},
"required": [
"target"
],
"type": "object"
},
"ColorSpace": {
"description": "Blender colour space names, verbatim.",
"enum": [
"sRGB",
"Linear Rec.709",
"Non-Color"
],
"type": "string"
},
"CompositeEntry": {
"anyOf": [
{
"$ref": "#/$defs/NameOr"
},
{
"$ref": "#/$defs/CompositeNode"
}
],
"description": "An ordered image-graph node. Resource names remain shorthand for an unnamed node."
},
"CompositeNode": {
"additionalProperties": false,
"properties": {
"material": {
"$ref": "#/$defs/NameOr"
},
"name": {
"type": [
"string",
"null"
]
},
"resolution": {
"anyOf": [
{
"$ref": "#/$defs/CompositeResolution"
},
{
"type": "null"
}
],
"x-help": "[width,height] pixels or positive output scale; floor, minimum 1; null = output; last image resampled to output",
"x-help-path": "compositor.resolution",
"x-source": "vork"
}
},
"required": [
"material"
],
"type": "object"
},
"CompositeResolution": {
"anyOf": [
{
"items": {
"format": "uint32",
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 2,
"type": "array"
},
{
"format": "double",
"type": "number"
}
]
},
"ComputeDispatch": {
"anyOf": [
{
"format": "uint32",
"minimum": 0,
"type": "integer"
},
{
"items": {
"format": "uint32",
"minimum": 0,
"type": "integer"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
}
],
"description": "Number of threads, independent of the internal workgroup size."
},
"ComputeSchedule": {
"oneOf": [
{
"enum": [
"frame",
"install"
],
"type": "string"
},
{
"const": "simulation",
"description": "Invoked only by the scene simulation schedule.",
"type": "string"
}
]
},
"EdgeCrease": {
"additionalProperties": false,
"description": "An undirected cage edge. Crease is OpenSubdiv sharpness: 0 is smooth; 10 or greater is infinitely sharp.",
"properties": {
"crease": {
"format": "float",
"type": "number",
"x-help": "number; ≥0",
"x-help-path": "geometry.crease_edge.crease",
"x-source": "vork (explicit contract/technique choice)"
},
"vertices": {
"items": {
"format": "uint32",
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 2,
"type": "array",
"x-help": "[u32,u32]",
"x-help-path": "geometry.crease_edge.vertices",
"x-source": "vork (explicit contract/technique choice)"
}
},
"required": [
"vertices",
"crease"
],
"type": "object"
},
"Factor": {
"anyOf": [
{
"format": "float",
"type": "number"
},
{
"items": {
"format": "float",
"type": "number"
},
"type": "array"
}
]
},
"Geometry": {
"additionalProperties": false,
"properties": {
"attributes": {
"additionalProperties": {
"$ref": "#/$defs/NameOr3"
},
"type": "object",
"x-help": "{name: buffer-name|inline buffer}; POSITION required (glTF names and types; COLOR_n: linear vec3/vec4, alpha defaults to 1); implicit: exactly one f32 dense grid, zero threshold; custom f32/vec2/vec3/vec4 bind to material inputs",
"x-help-path": "geometry.attributes",
"x-source": "vork (explicit contract/technique choice)"
},
"count": {
"anyOf": [
{
"$ref": "#/$defs/NameOr3"
},
{
"type": "null"
}
],
"description": "Live point prefix within the installed POSITION/width capacity.",
"x-help": "one-element u32 buffer|null; points only; overflow rejects the exposure",
"x-help-path": "geometry.count",
"x-source": "vork"
},
"crease_edge": {
"description": "Endpoint vertex indices and OpenSubdiv/USD edge sharpness. Used by std subdivision.",
"items": {
"$ref": "#/$defs/EdgeCrease"
},
"type": "array",
"x-help": "{vertices:[u32,u32],crease:number}[]; OpenSubdiv sharpness, 0 smooth, ≥10 sharp",
"x-help-path": "geometry.crease_edge",
"x-source": "vork (explicit contract/technique choice)"
},
"curve_vertex_counts": {
"anyOf": [
{
"$ref": "#/$defs/NameOr3"
},
{
"type": "null"
}
],
"description": "USD-style point counts, one u32 per polyline curve.",
"x-help": "u32 buffer; points per curve, ≥2; curves only",
"x-help-path": "geometry.curve_vertex_counts",
"x-source": "USD (polyline subset)"
},
"face_vertex_counts": {
"description": "Corners per polygon in the index buffer (USD/OpenSubdiv cage); absent means triangles.",
"items": {
"format": "uint32",
"minimum": 0,
"type": "integer"
},
"type": [
"array",
"null"
],
"x-help": "u32[]|null; polygon corner counts; absent = triangles",
"x-help-path": "geometry.face_vertex_counts",
"x-source": "vork (explicit contract/technique choice)"
},
"ids": {
"anyOf": [
{
"$ref": "#/$defs/NameOr3"
},
{
"type": "null"
}
],
"description": "Temporal point identities; a changed identity is a birth, even when a row is reused.",
"x-help": "u32 buffer|null; points only; one unique identity per live point; matches previous poses across compact rows; births use current-pose motion placeholders",
"x-help-path": "geometry.ids",
"x-source": "vork"
},
"indices": {
"anyOf": [
{
"$ref": "#/$defs/NameOr3"
},
{
"type": "null"
}
],
"x-help": "u32-buffer-name|inline buffer|null",
"x-help-path": "geometry.indices",
"x-source": "vork (explicit contract/technique choice)"
},
"material_ranges": {
"default": [],
"items": {
"$ref": "#/$defs/MaterialRange"
},
"type": "array",
"x-help": "{start,count,material_index}[]; partition indices into node.materials slots; empty = one material",
"x-help-path": "geometry.material_ranges",
"x-source": "vork (explicit contract/technique choice)"
},
"morphs": {
"additionalProperties": {
"$ref": "#/$defs/Morph"
},
"default": {},
"type": "object",
"x-help": "{name:{POSITION,NORMAL?}}",
"x-help-path": "geometry.morphs",
"x-source": "vork (explicit contract/technique choice)"
},
"subdivision": {
"anyOf": [
{
"$ref": "#/$defs/SubdivisionSurface"
},
{
"type": "null"
}
],
"description": "Blender Subdivision Surface, evaluated after deformation and before displacement.",
"x-help": "{subdivision_type?,render_levels?,use_limit_surface?}|null; Blender Subdivision Surface; one material range",
"x-help-path": "geometry.subdivision",
"x-source": "Blender 5.2.1 (offline render subset)"
},
"topology": {
"$ref": "#/$defs/Topology",
"default": "triangles",
"x-help": "triangles|points|curves|implicit; points render as spheres",
"x-help-path": "geometry.topology",
"x-source": "glTF 2.0"
},
"widths": {
"anyOf": [
{
"$ref": "#/$defs/NameOr3"
},
{
"type": "null"
}
],
"description": "USD-style diameter in metres, one f32 per control point.",
"x-help": "f32 buffer; diameter per point; curves and points; required",
"x-help-path": "geometry.widths",
"x-source": "USD Points / BasisCurves"
}
},
"required": [
"attributes"
],
"type": "object"
},
"GridBinding": {
"additionalProperties": false,
"description": "A volume grid buffer for a FloatGrid or VectorGrid program input.",
"properties": {
"grid": {
"$ref": "#/$defs/NameOr3",
"x-help": "buffer-name|inline buffer; buffer with a grid",
"x-help-path": "material.grid.grid",
"x-source": "vork (explicit contract/technique choice)"
}
},
"required": [
"grid"
],
"type": "object"
},
"Image": {
"additionalProperties": false,
"properties": {
"color_space": {
"anyOf": [
{
"$ref": "#/$defs/ColorSpace"
},
{
"type": "null"
}
],
"default": null,
"description": "Blender `Image.colorspace_settings.name`. Omitted follows Blender's file default.",
"x-help": "sRGB|Linear Rec.709|Non-Color|null; null: hdr/exr/ies linear, others sRGB",
"x-help-path": "image.color_space",
"x-source": "Blender 5.2.1 Image.colorspace_settings.name"
},
"file": {
"type": [
"string",
"null"
],
"x-help": "file-path; XOR render; png jpg tif hdr exr ies mov mp4 mkv or %04d frame pattern; 8-bit may be block-compressed, use 16-bit for exact data; ies: LM-63 Type C",
"x-help-path": "image.file",
"x-source": "vork (explicit contract/technique choice)"
},
"mag_filter": {
"$ref": "#/$defs/MagFilter",
"default": "linear",
"x-help": "nearest|linear",
"x-help-path": "image.mag_filter",
"x-source": "glTF 2.0 sampler.magFilter (undefined default: vork linear)"
},
"min_filter": {
"$ref": "#/$defs/MinFilter",
"default": "linear_mipmap_linear",
"x-help": "nearest|linear|nearest_mipmap_nearest|linear_mipmap_nearest|nearest_mipmap_linear|linear_mipmap_linear",
"x-help-path": "image.min_filter",
"x-source": "glTF 2.0 sampler.minFilter (undefined default: vork linear_mipmap_linear, anisotropic)"
},
"render": {
"anyOf": [
{
"$ref": "#/$defs/ImageRender"
},
{
"type": "null"
}
],
"default": null,
"x-help": "ImageRender; renders a camera view into the texture; inherits integrator, fps, AOVs; sampling budget follows quality/cost level; closed shutter; scene-linear premultiplied RGBA",
"x-help-extra": "image.render restrictions: first shared pose; aperture sampling is renderer-selected; geometry_opacity/alpha_cutoff/geometry_normal/environment image inputs unsupported",
"x-help-path": "image.render",
"x-source": "vork (nested scene-linear render)"
},
"time": {
"default": null,
"description": "Seconds into media; omitted follows scene time. EXR sequences honor\nframesPerSecond metadata; other sequences use render.fps.",
"format": "float",
"type": [
"number",
"null"
],
"x-help": "number|null; seconds from first displayed frame; null follows scene time; animatable; subframes hold; out-of-range holds ends",
"x-help-path": "image.time",
"x-source": "vork (footage clock)"
},
"wrap_s": {
"$ref": "#/$defs/Wrap",
"default": "repeat",
"x-help": "repeat|clamp_to_edge|mirrored_repeat",
"x-help-path": "image.wrap_s",
"x-source": "glTF 2.0 sampler.wrapS"
},
"wrap_t": {
"$ref": "#/$defs/Wrap",
"default": "repeat",
"x-help": "repeat|clamp_to_edge|mirrored_repeat",
"x-help-path": "image.wrap_t",
"x-source": "glTF 2.0 sampler.wrapT"
}
},
"type": "object"
},
"ImageRender": {
"additionalProperties": false,
"description": "Settings that a nested image may author. The parent owns transport and time;\na capture has a closed shutter and runs the automatic per-step compositor.",
"properties": {
"background": {
"$ref": "#/$defs/Background",
"default": "environment",
"x-help": "environment|transparent|RGB",
"x-help-path": "image.render.background",
"x-source": "vork (Blender RenderSettings.film_transparent plus a constant RGB)"
},
"camera": {
"default": null,
"type": [
"string",
"null"
],
"x-help": "camera-node-name|null; null = the only authored camera, else first imported",
"x-help-path": "image.render.camera",
"x-source": "vork (explicit contract/technique choice)"
},
"compositor": {
"default": [],
"items": {
"$ref": "#/$defs/CompositeEntry"
},
"type": "array",
"x-help": "same image graph as render.compositor; names local to this capture",
"x-help-path": "image.render.compositor",
"x-source": "vork"
},
"resolution": {
"default": [
1920,
1080
],
"items": {
"format": "uint32",
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 2,
"type": "array",
"x-help": "uvec2",
"x-help-path": "image.render.resolution",
"x-source": "Blender 5.2.1 RenderSettings.resolution_x/resolution_y"
},
"root": {
"default": null,
"type": [
"string",
"null"
],
"x-help": "node-name|null; only this subtree draws and is lit; objects outside still cast shadows; null = whole scene",
"x-help-path": "image.render.root",
"x-source": "vork (explicit contract/technique choice)"
}
},
"type": "object"
},
"InlineDataSchema": {
"anyOf": [
{
"items": {
"format": "double",
"type": "number"
},
"type": "array"
},
{
"items": {
"items": {
"format": "double",
"type": "number"
},
"type": "array"
},
"type": "array"
}
],
"description": "Inline numeric elements. Matrices contain 16 column-major components."
},
"Input": {
"anyOf": [
{
"format": "float",
"type": "number"
},
{
"items": {
"format": "float",
"type": "number"
},
"type": "array"
},
{
"type": "boolean"
},
{
"$ref": "#/$defs/TextureBinding"
},
{
"$ref": "#/$defs/AttributeBinding"
},
{
"$ref": "#/$defs/GridBinding"
},
{
"$ref": "#/$defs/AovBinding"
},
{
"$ref": "#/$defs/ChannelBinding"
},
{
"$ref": "#/$defs/NodeBinding"
},
{
"description": "An enum token of the program's reflected input type.",
"type": "string"
}
],
"description": "A material input value. Resources are explicit tagged objects; a plain string is\nonly ever an enum token of the program's reflected input type."
},
"Instances": {
"additionalProperties": false,
"properties": {
"attributes": {
"additionalProperties": {
"$ref": "#/$defs/NameOr3"
},
"type": "object",
"x-help": "equal-length buffers: TRANSLATION vec3, ROTATION vec4 (xyzw), SCALE vec3 (omitted = identity; any zero world-scale component hides the instance), time_offset f32, pass_index u32, custom columns bind to material inputs",
"x-help-path": "node.mesh.instances.attributes",
"x-source": "glTF EXT_mesh_gpu_instancing; vork time_offset/pass_index"
},
"count": {
"anyOf": [
{
"$ref": "#/$defs/NameOr3"
},
{
"type": "null"
}
],
"x-help": "one-element u32 compute buffer; zero to attribute capacity; overflow rejects the exposure",
"x-help-path": "node.mesh.instances.count",
"x-source": "vork (explicit contract/technique choice)"
}
},
"required": [
"attributes"
],
"type": "object"
},
"Interpolation": {
"enum": [
"STEP",
"LINEAR",
"CUBICSPLINE"
],
"type": "string"
},
"KernelChannel": {
"enum": [
"color",
"depth",
"view_normal",
"object_index",
"motion",
"shadow_catcher"
],
"type": "string"
},
"Keys": {
"anyOf": [
{
"items": {
"items": true,
"type": "array"
},
"type": "array"
},
{
"additionalProperties": false,
"properties": {
"times": {
"$ref": "#/$defs/NameOr3"
},
"values": {
"$ref": "#/$defs/NameOr3"
}
},
"required": [
"times",
"values"
],
"type": "object"
}
],
"description": "Keyframes inline as `[time, value]` pairs, or two buffers for bulk data."
},
"Layer": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"blend": {
"$ref": "#/$defs/Blend",
"default": "replace",
"x-help": "replace|add",
"x-help-path": "animation.layer.blend",
"x-source": "vork (explicit contract/technique choice)"
},
"clip": {
"type": "null"
},
"loop": {
"default": false,
"type": "boolean",
"x-help": "bool",
"x-help-path": "animation.layer.loop",
"x-source": "vork (explicit contract/technique choice)"
},
"name": {
"type": [
"string",
"null"
],
"x-help": "string|null",
"x-help-path": "animation.layer.name",
"x-source": "vork (explicit contract/technique choice)"
},
"offset": {
"default": 0.0,
"format": "float",
"type": "number",
"x-help": "number; source time = offset + time*speed",
"x-help-path": "animation.layer.offset",
"x-source": "vork (explicit contract/technique choice)"
},
"speed": {
"default": 1.0,
"format": "float",
"type": "number",
"x-help": "number",
"x-help-path": "animation.layer.speed",
"x-source": "vork (explicit contract/technique choice)"
},
"tracks": {
"items": {
"$ref": "#/$defs/Track"
},
"type": [
"array"
],
"x-help": "track[]|null; XOR clip",
"x-help-path": "animation.layer.tracks",
"x-source": "vork (explicit contract/technique choice)"
},
"weight": {
"default": 1.0,
"format": "float",
"type": "number",
"x-help": "number",
"x-help-path": "animation.layer.weight",
"x-source": "vork (explicit contract/technique choice)"
}
},
"required": [
"tracks"
],
"title": "TrackLayer",
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"blend": {
"$ref": "#/$defs/Blend",
"default": "replace",
"x-help": "replace|add",
"x-help-path": "animation.layer.blend",
"x-source": "vork (explicit contract/technique choice)"
},
"clip": {
"anyOf": [
{
"$ref": "#/$defs/Clip"
}
],
"x-help": "clip|null; XOR tracks",
"x-help-path": "animation.layer.clip",
"x-source": "vork (explicit contract/technique choice)"
},
"loop": {
"default": false,
"type": "boolean",
"x-help": "bool",
"x-help-path": "animation.layer.loop",
"x-source": "vork (explicit contract/technique choice)"
},
"name": {
"type": [
"string",
"null"
],
"x-help": "string|null",
"x-help-path": "animation.layer.name",
"x-source": "vork (explicit contract/technique choice)"
},
"offset": {
"default": 0.0,
"format": "float",
"type": "number",
"x-help": "number; source time = offset + time*speed",
"x-help-path": "animation.layer.offset",
"x-source": "vork (explicit contract/technique choice)"
},
"speed": {
"default": 1.0,
"format": "float",
"type": "number",
"x-help": "number",
"x-help-path": "animation.layer.speed",
"x-source": "vork (explicit contract/technique choice)"
},
"tracks": {
"type": "null"
},
"weight": {
"default": 1.0,
"format": "float",
"type": "number",
"x-help": "number",
"x-help-path": "animation.layer.weight",
"x-source": "vork (explicit contract/technique choice)"
}
},
"required": [
"clip"
],
"title": "ClipLayer",
"type": "object"
}
]
},
"LightShape": {
"enum": [
"sun",
"point",
"spot",
"rectangle",
"ellipse",
"environment"
],
"type": "string",
"x-help-extra": "lights: with no environment light the world is RGB [0.05,0.05,0.05]"
},
"MagFilter": {
"enum": [
"nearest",
"linear"
],
"type": "string"
},
"Material": {
"additionalProperties": false,
"description": "A program instance. Its surface entry shades the assigned geometry.",
"properties": {
"double_sided": {
"default": true,
"type": "boolean",
"x-help": "bool; false culls back faces",
"x-help-path": "material.double_sided",
"x-source": "Blender renders both sides; imported glTF retains doubleSided"
},
"inputs": {
"additionalProperties": {
"$ref": "#/$defs/Input"
},
"default": {},
"type": "object",
"x-help": "{name: number|vector|bool|enum-token|{image}|{attribute}|{grid}|{aov}|{node}|{channel}}",
"x-help-extra": "material.inputs (transmission): transmission_depth 0 = sqrt(tint) per solid interface; thin sheets = full tint; positive-depth solids = Beer absorption\nmaterial.inputs (animation): numeric scalar/vector/colour inputs on surface/environment/compute/compositor/display programs use ordinary tracks; geometry_thin_walled is structural; an omitted animated program input has a zero blend baseline (author inputs for another baseline)\nmaterial.inputs.subsurface: thick: radius × radius_scale; thin: diffuse reflection/transmission split by scatter_anisotropy",
"x-help-path": "material.inputs",
"x-source": "OpenPBR Surface 1.1.1 defaults (spec table)"
},
"opacity": {
"anyOf": [
{
"$ref": "#/$defs/Opacity"
},
{
"type": "null"
}
],
"default": null,
"description": "Meaning of geometry_opacity; the renderer owns its integration method.",
"x-help": "coverage|transmittance|null; null = coverage, transmittance for transmitting surfaces; coverage = occupied area fraction; transmittance = continuous attenuation by 1 - geometry_opacity; renderer chooses integration",
"x-help-path": "material.opacity",
"x-source": "vork surface presence semantics"
},
"program": {
"$ref": "#/$defs/NameOr2",
"default": "std/openpbr",
"x-help": "program-name|inline program|<library>/<module>; std/openpbr, std/hair (curves only), or custom",
"x-help-extra": "program.surface emission: authoritative radiance for hits and light samples; lit output is authored shading\nprogram.surface: Closure|Blend|Hair surface(ShadingContext,Inputs); Hair needs curves",
"x-help-path": "material.program",
"x-source": "vork (explicit contract/technique choice)"
}
},
"type": "object",
"x-help-extra": "material (glTF import): mapped to OpenPBR; coat_ior 1.5; occlusion affects indirect only"
},
"MaterialRange": {
"additionalProperties": false,
"properties": {
"count": {
"format": "uint32",
"minimum": 0,
"type": "integer",
"x-help": "u32; whole triangles",
"x-help-path": "geometry.material_ranges.count",
"x-source": "vork (explicit contract/technique choice)"
},
"material_index": {
"format": "uint32",
"minimum": 0,
"type": "integer",
"x-help": "u32; node.materials slot",
"x-help-path": "geometry.material_ranges.material_index",
"x-source": "Blender MeshPolygon.material_index"
},
"start": {
"format": "uint32",
"minimum": 0,
"type": "integer",
"x-help": "u32; first index",
"x-help-path": "geometry.material_ranges.start",
"x-source": "vork (explicit contract/technique choice)"
}
},
"required": [
"start",
"count",
"material_index"
],
"type": "object"
},
"MinFilter": {
"enum": [
"nearest",
"linear",
"nearest_mipmap_nearest",
"linear_mipmap_nearest",
"nearest_mipmap_linear",
"linear_mipmap_linear"
],
"type": "string"
},
"Morph": {
"additionalProperties": false,
"properties": {
"NORMAL": {
"anyOf": [
{
"$ref": "#/$defs/NameOr3"
},
{
"type": "null"
}
],
"x-help": "buffer-name|inline buffer|null",
"x-help-path": "geometry.morphs.NORMAL",
"x-source": "vork (explicit contract/technique choice)"
},
"POSITION": {
"$ref": "#/$defs/NameOr3",
"x-help": "vec3-buffer-name|inline buffer",
"x-help-path": "geometry.morphs.POSITION",
"x-source": "vork (explicit contract/technique choice)"
}
},
"required": [
"POSITION"
],
"type": "object"
},
"MotionBlur": {
"additionalProperties": false,
"properties": {
"position": {
"$ref": "#/$defs/MotionBlurPosition",
"default": "center",
"x-help": "start|center|end",
"x-help-path": "render.motion_blur.position",
"x-source": "Blender 5.2.1 motion_blur_position"
},
"shutter": {
"default": 0.5,
"format": "float",
"type": "number",
"x-help": "number; frames",
"x-help-path": "render.motion_blur.shutter",
"x-source": "Blender 5.2.1 motion_blur_shutter"
}
},
"type": "object"
},
"MotionBlurPosition": {
"enum": [
"start",
"center",
"end"
],
"type": "string"
},
"NameOr": {
"anyOf": [
{
"type": "string"
},
{
"$ref": "#/$defs/Material"
}
],
"description": "A resource name or inline definition."
},
"NameOr2": {
"anyOf": [
{
"type": "string"
},
{
"$ref": "#/$defs/Program"
}
],
"description": "A resource name or inline definition."
},
"NameOr3": {
"anyOf": [
{
"type": "string"
},
{
"$ref": "#/$defs/Buffer"
}
],
"description": "A resource name or inline definition."
},
"NameOr4": {
"anyOf": [
{
"type": "string"
},
{
"$ref": "#/$defs/Image"
}
],
"description": "A resource name or inline definition."
},
"NameOr5": {
"anyOf": [
{
"type": "string"
},
{
"$ref": "#/$defs/Geometry"
}
],
"description": "A resource name or inline definition."
},
"Node": {
"description": "Translation, rotation and scale (glTF node TRS), flat on the node. Rotation is\nstored as a quaternion; an authored `{\"euler\": [x,y,z]}` converts losslessly.",
"oneOf": [
{
"properties": {
"children": {
"default": [],
"items": {
"$ref": "#/$defs/Node"
},
"type": "array",
"x-help": "node[]",
"x-help-path": "node.children",
"x-source": "vork (explicit contract/technique choice)"
},
"is_holdout": {
"default": false,
"description": "Cycles holdout: transparent black on transparent film; opaque black otherwise.",
"type": "boolean",
"x-help": "bool; RGB 0; alpha 0 on transparent background, 1 on opaque background",
"x-help-path": "node.is_holdout",
"x-source": "Blender Cycles Object.is_holdout"
},
"is_shadow_catcher": {
"default": false,
"description": "Cycles shadow catcher. Combined treats this surface as a holdout.",
"type": "boolean",
"x-help": "bool; shadow_catcher channel is material light with CG / without CG, unclamped; zero baseline gives neutral 1; CG light on an otherwise unlit catcher cannot be represented",
"x-help-path": "node.is_shadow_catcher",
"x-source": "Blender Cycles Object.is_shadow_catcher"
},
"light_link_tags": {
"default": [],
"items": {
"type": "string"
},
"type": "array",
"x-help": "string[]; matched by light illuminates/shadowed_by; inherited",
"x-help-path": "node.light_link_tags",
"x-source": "vork (explicit contract/technique choice)"
},
"name": {
"default": "",
"type": "string",
"x-help": "string; globally unique, including imported nodes",
"x-help-path": "node.name",
"x-source": "vork (explicit contract/technique choice)"
},
"pass_index": {
"format": "uint32",
"maximum": 65535,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-help": "u32|null; 1..65535; object ID",
"x-help-path": "node.pass_index",
"x-source": "vork (explicit contract/technique choice)"
},
"rotation": {
"$ref": "#/$defs/Rotation",
"default": [
0.0,
0.0,
0.0,
1.0
],
"x-help": "[x,y,z,w] quaternion | {euler:[x,y,z]} (Blender XYZ)",
"x-help-path": "node.rotation",
"x-source": "glTF 2.0 (quaternion); Blender XYZ Euler"
},
"scale": {
"default": [
1.0,
1.0,
1.0
],
"items": {
"format": "float",
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array",
"x-help": "[x,y,z]; any zero world-scale component hides geometry, including children",
"x-help-path": "node.scale",
"x-source": "glTF 2.0"
},
"target": {
"anyOf": [
{
"$ref": "#/$defs/AimTarget"
},
{
"type": "null"
}
],
"x-help": "node-name|[x,y,z]|null; aims -Z, world Y up; rotation is an offset on top; structural, not animatable: aim at a named node and animate its translation",
"x-help-path": "node.target",
"x-source": "Blender Track To constraint (vork target shorthand)"
},
"translation": {
"default": [
0.0,
0.0,
0.0
],
"items": {
"format": "float",
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array",
"x-help": "[x,y,z]; parent frame",
"x-help-path": "node.translation",
"x-source": "glTF 2.0"
},
"type": {
"const": "node",
"default": "node",
"type": "string"
},
"visible": {
"default": true,
"type": "boolean",
"x-help": "bool; false hides the subtree and disables its lights; animatable (step)",
"x-help-path": "node.visible",
"x-source": "vork visibility primitive"
},
"visible_camera": {
"default": true,
"type": "boolean",
"x-help": "bool",
"x-help-path": "node.visible_camera",
"x-source": "Blender Object.visible_camera"
},
"visible_diffuse": {
"default": true,
"type": "boolean",
"x-help": "bool",
"x-help-path": "node.visible_diffuse",
"x-source": "Blender Object.visible_diffuse"
},
"visible_glossy": {
"default": true,
"type": "boolean",
"x-help": "bool",
"x-help-path": "node.visible_glossy",
"x-source": "Blender Object.visible_glossy"
},
"visible_shadow": {
"default": true,
"type": "boolean",
"x-help": "bool; lights must stay true (a light without shadows: shadowed_by [])",
"x-help-path": "node.visible_shadow",
"x-source": "Blender Object.visible_shadow"
},
"visible_transmission": {
"default": true,
"type": "boolean",
"x-help": "bool; object visibility to transmission rays; lights must stay true",
"x-help-path": "node.visible_transmission",
"x-source": "Blender Object.visible_transmission"
}
},
"required": [],
"title": "TransformNode",
"type": "object"
},
{
"properties": {
"children": {
"default": [],
"items": {
"$ref": "#/$defs/Node"
},
"type": "array",
"x-help": "node[]",
"x-help-path": "node.children",
"x-source": "vork (explicit contract/technique choice)"
},
"geometry": {
"$ref": "#/$defs/NameOr5",
"x-help": "geometry-name|inline geometry",
"x-help-path": "node.mesh.geometry",
"x-source": "vork (explicit contract/technique choice)"
},
"instances": {
"anyOf": [
{
"$ref": "#/$defs/Instances"
},
{
"type": "null"
}
],
"x-help": "instances|null",
"x-help-path": "node.mesh.instances",
"x-source": "vork (explicit contract/technique choice)"
},
"is_holdout": {
"default": false,
"description": "Cycles holdout: transparent black on transparent film; opaque black otherwise.",
"type": "boolean",
"x-help": "bool; RGB 0; alpha 0 on transparent background, 1 on opaque background",
"x-help-path": "node.is_holdout",
"x-source": "Blender Cycles Object.is_holdout"
},
"is_shadow_catcher": {
"default": false,
"description": "Cycles shadow catcher. Combined treats this surface as a holdout.",
"type": "boolean",
"x-help": "bool; shadow_catcher channel is material light with CG / without CG, unclamped; zero baseline gives neutral 1; CG light on an otherwise unlit catcher cannot be represented",
"x-help-path": "node.is_shadow_catcher",
"x-source": "Blender Cycles Object.is_shadow_catcher"
},
"light_link_tags": {
"default": [],
"items": {
"type": "string"
},
"type": "array",
"x-help": "string[]; matched by light illuminates/shadowed_by; inherited",
"x-help-path": "node.light_link_tags",
"x-source": "vork (explicit contract/technique choice)"
},
"materials": {
"default": [],
"items": {
"$ref": "#/$defs/NameOr"
},
"type": "array",
"x-help": "(material-name|inline material)[]; empty = default std/openpbr with roughness 0.3",
"x-help-path": "node.mesh.materials",
"x-source": "OpenPBR Surface 1.1.1"
},
"morph_weights": {
"additionalProperties": {
"format": "float",
"type": "number"
},
"default": {},
"type": "object",
"x-help": "{name:number}",
"x-help-path": "node.mesh.morph_weights",
"x-source": "vork (explicit contract/technique choice)"
},
"name": {
"default": "",
"type": "string",
"x-help": "string; globally unique, including imported nodes",
"x-help-path": "node.name",
"x-source": "vork (explicit contract/technique choice)"
},
"pass_index": {
"format": "uint32",
"maximum": 65535,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-help": "u32|null; 1..65535; object ID",
"x-help-path": "node.pass_index",
"x-source": "vork (explicit contract/technique choice)"
},
"rotation": {
"$ref": "#/$defs/Rotation",
"default": [
0.0,
0.0,
0.0,
1.0
],
"x-help": "[x,y,z,w] quaternion | {euler:[x,y,z]} (Blender XYZ)",
"x-help-path": "node.rotation",
"x-source": "glTF 2.0 (quaternion); Blender XYZ Euler"
},
"scale": {
"default": [
1.0,
1.0,
1.0
],
"items": {
"format": "float",
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array",
"x-help": "[x,y,z]; any zero world-scale component hides geometry, including children",
"x-help-path": "node.scale",
"x-source": "glTF 2.0"
},
"skin": {
"anyOf": [
{
"$ref": "#/$defs/Skin"
},
{
"type": "null"
}
],
"x-help": "skin|null",
"x-help-path": "node.mesh.skin",
"x-source": "vork (explicit contract/technique choice)"
},
"target": {
"anyOf": [
{
"$ref": "#/$defs/AimTarget"
},
{
"type": "null"
}
],
"x-help": "node-name|[x,y,z]|null; aims -Z, world Y up; rotation is an offset on top; structural, not animatable: aim at a named node and animate its translation",
"x-help-path": "node.target",
"x-source": "Blender Track To constraint (vork target shorthand)"
},
"translation": {
"default": [
0.0,
0.0,
0.0
],
"items": {
"format": "float",
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array",
"x-help": "[x,y,z]; parent frame",
"x-help-path": "node.translation",
"x-source": "glTF 2.0"
},
"type": {
"const": "mesh",
"type": "string"
},
"visible": {
"default": true,
"type": "boolean",
"x-help": "bool; false hides the subtree and disables its lights; animatable (step)",
"x-help-path": "node.visible",
"x-source": "vork visibility primitive"
},
"visible_camera": {
"default": true,
"type": "boolean",
"x-help": "bool",
"x-help-path": "node.visible_camera",
"x-source": "Blender Object.visible_camera"
},
"visible_diffuse": {
"default": true,
"type": "boolean",
"x-help": "bool",
"x-help-path": "node.visible_diffuse",
"x-source": "Blender Object.visible_diffuse"
},
"visible_glossy": {
"default": true,
"type": "boolean",
"x-help": "bool",
"x-help-path": "node.visible_glossy",
"x-source": "Blender Object.visible_glossy"
},
"visible_shadow": {
"default": true,
"type": "boolean",
"x-help": "bool; lights must stay true (a light without shadows: shadowed_by [])",
"x-help-path": "node.visible_shadow",
"x-source": "Blender Object.visible_shadow"
},
"visible_transmission": {
"default": true,
"type": "boolean",
"x-help": "bool; object visibility to transmission rays; lights must stay true",
"x-help-path": "node.visible_transmission",
"x-source": "Blender Object.visible_transmission"
}
},
"required": [
"type",
"geometry"
],
"title": "MeshNode",
"type": "object"
},
{
"properties": {
"children": {
"default": [],
"items": {
"$ref": "#/$defs/Node"
},
"type": "array",
"x-help": "node[]",
"x-help-path": "node.children",
"x-source": "vork (explicit contract/technique choice)"
},
"file": {
"type": "string",
"x-help": "file-path",
"x-help-path": "node.asset.file",
"x-source": "vork (explicit contract/technique choice)"
},
"is_holdout": {
"default": false,
"description": "Cycles holdout: transparent black on transparent film; opaque black otherwise.",
"type": "boolean",
"x-help": "bool; RGB 0; alpha 0 on transparent background, 1 on opaque background",
"x-help-path": "node.is_holdout",
"x-source": "Blender Cycles Object.is_holdout"
},
"is_shadow_catcher": {
"default": false,
"description": "Cycles shadow catcher. Combined treats this surface as a holdout.",
"type": "boolean",
"x-help": "bool; shadow_catcher channel is material light with CG / without CG, unclamped; zero baseline gives neutral 1; CG light on an otherwise unlit catcher cannot be represented",
"x-help-path": "node.is_shadow_catcher",
"x-source": "Blender Cycles Object.is_shadow_catcher"
},
"light_link_tags": {
"default": [],
"items": {
"type": "string"
},
"type": "array",
"x-help": "string[]; matched by light illuminates/shadowed_by; inherited",
"x-help-path": "node.light_link_tags",
"x-source": "vork (explicit contract/technique choice)"
},
"materials": {
"additionalProperties": {
"$ref": "#/$defs/NameOr"
},
"default": {},
"type": "object",
"x-help": "{imported-name|#index|*: material-name|inline material}; #index = glTF material index; specific beats *",
"x-help-path": "node.asset.materials",
"x-source": "vork (explicit contract/technique choice)"
},
"name": {
"default": "",
"type": "string",
"x-help": "string; globally unique, including imported nodes",
"x-help-path": "node.name",
"x-source": "vork (explicit contract/technique choice)"
},
"nodes": {
"additionalProperties": {
"$ref": "#/$defs/AssetNodeOverrides"
},
"default": {},
"type": "object",
"x-help": "{imported-name|#index: overrides}; #index = glTF node index",
"x-help-path": "node.asset.nodes",
"x-source": "vork (explicit contract/technique choice)"
},
"pass_index": {
"format": "uint32",
"maximum": 65535,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-help": "u32|null; 1..65535; object ID",
"x-help-path": "node.pass_index",
"x-source": "vork (explicit contract/technique choice)"
},
"rotation": {
"$ref": "#/$defs/Rotation",
"default": [
0.0,
0.0,
0.0,
1.0
],
"x-help": "[x,y,z,w] quaternion | {euler:[x,y,z]} (Blender XYZ)",
"x-help-path": "node.rotation",
"x-source": "glTF 2.0 (quaternion); Blender XYZ Euler"
},
"scale": {
"default": [
1.0,
1.0,
1.0
],
"items": {
"format": "float",
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array",
"x-help": "[x,y,z]; any zero world-scale component hides geometry, including children",
"x-help-path": "node.scale",
"x-source": "glTF 2.0"
},
"target": {
"anyOf": [
{
"$ref": "#/$defs/AimTarget"
},
{
"type": "null"
}
],
"x-help": "node-name|[x,y,z]|null; aims -Z, world Y up; rotation is an offset on top; structural, not animatable: aim at a named node and animate its translation",
"x-help-path": "node.target",
"x-source": "Blender Track To constraint (vork target shorthand)"
},
"translation": {
"default": [
0.0,
0.0,
0.0
],
"items": {
"format": "float",
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array",
"x-help": "[x,y,z]; parent frame",
"x-help-path": "node.translation",
"x-source": "glTF 2.0"
},
"type": {
"const": "asset",
"type": "string"
},
"visible": {
"default": true,
"type": "boolean",
"x-help": "bool; false hides the subtree and disables its lights; animatable (step)",
"x-help-path": "node.visible",
"x-source": "vork visibility primitive"
},
"visible_camera": {
"default": true,
"type": "boolean",
"x-help": "bool",
"x-help-path": "node.visible_camera",
"x-source": "Blender Object.visible_camera"
},
"visible_diffuse": {
"default": true,
"type": "boolean",
"x-help": "bool",
"x-help-path": "node.visible_diffuse",
"x-source": "Blender Object.visible_diffuse"
},
"visible_glossy": {
"default": true,
"type": "boolean",
"x-help": "bool",
"x-help-path": "node.visible_glossy",
"x-source": "Blender Object.visible_glossy"
},
"visible_shadow": {
"default": true,
"type": "boolean",
"x-help": "bool; lights must stay true (a light without shadows: shadowed_by [])",
"x-help-path": "node.visible_shadow",
"x-source": "Blender Object.visible_shadow"
},
"visible_transmission": {
"default": true,
"type": "boolean",
"x-help": "bool; object visibility to transmission rays; lights must stay true",
"x-help-path": "node.visible_transmission",
"x-source": "Blender Object.visible_transmission"
}
},
"required": [
"type",
"file"
],
"title": "AssetNode",
"type": "object"
},
{
"properties": {
"children": {
"default": [],
"items": {
"$ref": "#/$defs/Node"
},
"type": "array",
"x-help": "node[]",
"x-help-path": "node.children",
"x-source": "vork (explicit contract/technique choice)"
},
"focus_object": {
"default": null,
"type": [
"string",
"null"
],
"x-help": "node-name|null; camera-axis depth supplied to the program at sample time",
"x-help-path": "camera.focus_object",
"x-source": "Blender CameraDOFSettings.focus_object"
},
"is_holdout": {
"default": false,
"description": "Cycles holdout: transparent black on transparent film; opaque black otherwise.",
"type": "boolean",
"x-help": "bool; RGB 0; alpha 0 on transparent background, 1 on opaque background",
"x-help-path": "node.is_holdout",
"x-source": "Blender Cycles Object.is_holdout"
},
"is_shadow_catcher": {
"default": false,
"description": "Cycles shadow catcher. Combined treats this surface as a holdout.",
"type": "boolean",
"x-help": "bool; shadow_catcher channel is material light with CG / without CG, unclamped; zero baseline gives neutral 1; CG light on an otherwise unlit catcher cannot be represented",
"x-help-path": "node.is_shadow_catcher",
"x-source": "Blender Cycles Object.is_shadow_catcher"
},
"light_link_tags": {
"default": [],
"items": {
"type": "string"
},
"type": "array",
"x-help": "string[]; matched by light illuminates/shadowed_by; inherited",
"x-help-path": "node.light_link_tags",
"x-source": "vork (explicit contract/technique choice)"
},
"material": {
"anyOf": [
{
"$ref": "#/$defs/NameOr"
},
{
"type": "null"
}
],
"default": null,
"x-help": "material-name|inline material|null; omitted = std/camera; optics are program inputs",
"x-help-path": "camera.material",
"x-source": "vork (programmable camera and sensor)"
},
"name": {
"default": "",
"type": "string",
"x-help": "string; globally unique, including imported nodes",
"x-help-path": "node.name",
"x-source": "vork (explicit contract/technique choice)"
},
"pass_index": {
"format": "uint32",
"maximum": 65535,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-help": "u32|null; 1..65535; object ID",
"x-help-path": "node.pass_index",
"x-source": "vork (explicit contract/technique choice)"
},
"rotation": {
"$ref": "#/$defs/Rotation",
"default": [
0.0,
0.0,
0.0,
1.0
],
"x-help": "[x,y,z,w] quaternion | {euler:[x,y,z]} (Blender XYZ)",
"x-help-path": "node.rotation",
"x-source": "glTF 2.0 (quaternion); Blender XYZ Euler"
},
"scale": {
"default": [
1.0,
1.0,
1.0
],
"items": {
"format": "float",
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array",
"x-help": "[x,y,z]; any zero world-scale component hides geometry, including children",
"x-help-path": "node.scale",
"x-source": "glTF 2.0"
},
"target": {
"anyOf": [
{
"$ref": "#/$defs/AimTarget"
},
{
"type": "null"
}
],
"x-help": "node-name|[x,y,z]|null; aims -Z, world Y up; rotation is an offset on top; structural, not animatable: aim at a named node and animate its translation",
"x-help-path": "node.target",
"x-source": "Blender Track To constraint (vork target shorthand)"
},
"translation": {
"default": [
0.0,
0.0,
0.0
],
"items": {
"format": "float",
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array",
"x-help": "[x,y,z]; parent frame",
"x-help-path": "node.translation",
"x-source": "glTF 2.0"
},
"type": {
"const": "camera",
"type": "string"
},
"visible": {
"default": true,
"type": "boolean",
"x-help": "bool; false hides the subtree and disables its lights; animatable (step)",
"x-help-path": "node.visible",
"x-source": "vork visibility primitive"
},
"visible_camera": {
"default": true,
"type": "boolean",
"x-help": "bool",
"x-help-path": "node.visible_camera",
"x-source": "Blender Object.visible_camera"
},
"visible_diffuse": {
"default": true,
"type": "boolean",
"x-help": "bool",
"x-help-path": "node.visible_diffuse",
"x-source": "Blender Object.visible_diffuse"
},
"visible_glossy": {
"default": true,
"type": "boolean",
"x-help": "bool",
"x-help-path": "node.visible_glossy",
"x-source": "Blender Object.visible_glossy"
},
"visible_shadow": {
"default": true,
"type": "boolean",
"x-help": "bool; lights must stay true (a light without shadows: shadowed_by [])",
"x-help-path": "node.visible_shadow",
"x-source": "Blender Object.visible_shadow"
},
"visible_transmission": {
"default": true,
"type": "boolean",
"x-help": "bool; object visibility to transmission rays; lights must stay true",
"x-help-path": "node.visible_transmission",
"x-source": "Blender Object.visible_transmission"
}
},
"required": [
"type"
],
"title": "CameraNode",
"type": "object"
},
{
"properties": {
"angle": {
"default": 0.009180432185530663,
"format": "float",
"type": "number",
"x-help": "number; sun",
"x-help-path": "light.angle",
"x-source": "Blender 5.2.1 SunLight.angle (Add Light default)"
},
"children": {
"default": [],
"items": {
"$ref": "#/$defs/Node"
},
"type": "array",
"x-help": "node[]",
"x-help-path": "node.children",
"x-source": "vork (explicit contract/technique choice)"
},
"color": {
"description": "None: LightShape::default_color (white, or Blender's world colour for an\nenvironment without an image).",
"items": {
"format": "float",
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": [
"array",
"null"
],
"x-help": "RGB",
"x-help-path": "light.color",
"x-source": "Blender 5.2.1 Light.color (Add Light default)"
},
"energy": {
"format": "float",
"type": [
"number",
"null"
],
"x-help": "number|null; sun W/m²; local W; environment multiplier",
"x-help-path": "light.energy",
"x-source": "Blender 5.2.1 Light.energy (Add Light default)"
},
"illuminates": {
"items": {
"type": "string"
},
"type": [
"array",
"null"
],
"x-help": "light-link-tag[]|null; receivers with any tag; null=all; []=none",
"x-help-path": "light.illuminates",
"x-source": "vork (explicit contract/technique choice)"
},
"image": {
"anyOf": [
{
"$ref": "#/$defs/NameOr4"
},
{
"type": "null"
}
],
"x-help": "image-name|inline image|null; LM-63 Type C IES (path only); non-environment lights; emits -Z, no peak normalization",
"x-help-path": "light.image",
"x-source": "vork (explicit contract/technique choice)"
},
"is_holdout": {
"default": false,
"description": "Cycles holdout: transparent black on transparent film; opaque black otherwise.",
"type": "boolean",
"x-help": "bool; RGB 0; alpha 0 on transparent background, 1 on opaque background",
"x-help-path": "node.is_holdout",
"x-source": "Blender Cycles Object.is_holdout"
},
"is_shadow_catcher": {
"default": false,
"description": "Cycles shadow catcher. Combined treats this surface as a holdout.",
"type": "boolean",
"x-help": "bool; shadow_catcher channel is material light with CG / without CG, unclamped; zero baseline gives neutral 1; CG light on an otherwise unlit catcher cannot be represented",
"x-help-path": "node.is_shadow_catcher",
"x-source": "Blender Cycles Object.is_shadow_catcher"
},
"light_link_tags": {
"default": [],
"items": {
"type": "string"
},
"type": "array",
"x-help": "string[]; matched by light illuminates/shadowed_by; inherited",
"x-help-path": "node.light_link_tags",
"x-source": "vork (explicit contract/technique choice)"
},
"material": {
"anyOf": [
{
"$ref": "#/$defs/NameOr"
},
{
"type": "null"
}
],
"description": "Environment radiance material instance.",
"x-help": "material-name|inline material|null; environment program",
"x-help-path": "light.material",
"x-source": "vork (explicit contract/technique choice)"
},
"name": {
"default": "",
"type": "string",
"x-help": "string; globally unique, including imported nodes",
"x-help-path": "node.name",
"x-source": "vork (explicit contract/technique choice)"
},
"pass_index": {
"format": "uint32",
"maximum": 65535,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-help": "u32|null; 1..65535; object ID",
"x-help-path": "node.pass_index",
"x-source": "vork (explicit contract/technique choice)"
},
"radius": {
"default": 0.0,
"format": "float",
"type": "number",
"x-help": "number; point/spot emitter radius (shadow softness)",
"x-help-path": "light.radius",
"x-source": "Blender 5.2.1 Light.shadow_soft_size (Add Light default)"
},
"rotation": {
"$ref": "#/$defs/Rotation",
"default": [
0.0,
0.0,
0.0,
1.0
],
"x-help": "[x,y,z,w] quaternion | {euler:[x,y,z]} (Blender XYZ)",
"x-help-path": "node.rotation",
"x-source": "glTF 2.0 (quaternion); Blender XYZ Euler"
},
"scale": {
"default": [
1.0,
1.0,
1.0
],
"items": {
"format": "float",
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array",
"x-help": "[x,y,z]; any zero world-scale component hides geometry, including children",
"x-help-path": "node.scale",
"x-source": "glTF 2.0"
},
"shadowed_by": {
"items": {
"type": "string"
},
"type": [
"array",
"null"
],
"x-help": "light-link-tag[]|null; casters with any tag; null=all; []=none",
"x-help-path": "light.shadowed_by",
"x-source": "vork (explicit contract/technique choice)"
},
"shape": {
"$ref": "#/$defs/LightShape",
"x-help": "sun|point|spot|rectangle|ellipse|environment",
"x-help-path": "light.shape",
"x-source": "vork (explicit contract/technique choice)"
},
"size": {
"default": 1.0,
"format": "float",
"type": "number",
"x-help": "number; rectangle full side, ellipse diameter",
"x-help-path": "light.size",
"x-source": "Blender 5.2.1 AreaLight.size (Add Light default)"
},
"size_y": {
"format": "float",
"type": [
"number",
"null"
],
"x-help": "number|null; second side/diameter; omitted = size (square/disk)",
"x-help-path": "light.size_y",
"x-source": "Blender 5.2.1 AreaLight square/disk sizing"
},
"spot_blend": {
"default": 0.15000000596046448,
"format": "float",
"type": "number",
"x-help": "number; 0..1",
"x-help-path": "light.spot_blend",
"x-source": "Blender 5.2.1 SpotLight.spot_blend"
},
"spot_size": {
"default": 0.7853981852531433,
"format": "float",
"type": "number",
"x-help": "number; full cone angle",
"x-help-path": "light.spot_size",
"x-source": "Blender 5.2.1 SpotLight.spot_size"
},
"target": {
"anyOf": [
{
"$ref": "#/$defs/AimTarget"
},
{
"type": "null"
}
],
"x-help": "node-name|[x,y,z]|null; aims -Z, world Y up; rotation is an offset on top; structural, not animatable: aim at a named node and animate its translation",
"x-help-path": "node.target",
"x-source": "Blender Track To constraint (vork target shorthand)"
},
"temperature": {
"description": "None: `color` alone. Some(kelvin): `color` × std.color blackbody(kelvin).",
"format": "float",
"type": [
"number",
"null"
],
"x-help": "number|null; K; multiplies color; not environment",
"x-help-path": "light.temperature",
"x-source": "Blender 5.2.1 Light.temperature with use_temperature"
},
"translation": {
"default": [
0.0,
0.0,
0.0
],
"items": {
"format": "float",
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array",
"x-help": "[x,y,z]; parent frame",
"x-help-path": "node.translation",
"x-source": "glTF 2.0"
},
"type": {
"const": "light",
"type": "string"
},
"visible": {
"default": true,
"type": "boolean",
"x-help": "bool; false hides the subtree and disables its lights; animatable (step)",
"x-help-path": "node.visible",
"x-source": "vork visibility primitive"
},
"visible_camera": {
"default": true,
"type": "boolean",
"x-help": "bool",
"x-help-path": "node.visible_camera",
"x-source": "Blender Object.visible_camera"
},
"visible_diffuse": {
"default": true,
"type": "boolean",
"x-help": "bool",
"x-help-path": "node.visible_diffuse",
"x-source": "Blender Object.visible_diffuse"
},
"visible_glossy": {
"default": true,
"type": "boolean",
"x-help": "bool",
"x-help-path": "node.visible_glossy",
"x-source": "Blender Object.visible_glossy"
},
"visible_shadow": {
"default": true,
"type": "boolean",
"x-help": "bool; lights must stay true (a light without shadows: shadowed_by [])",
"x-help-path": "node.visible_shadow",
"x-source": "Blender Object.visible_shadow"
},
"visible_transmission": {
"default": true,
"type": "boolean",
"x-help": "bool; object visibility to transmission rays; lights must stay true",
"x-help-path": "node.visible_transmission",
"x-source": "Blender Object.visible_transmission"
}
},
"required": [
"type",
"shape"
],
"title": "LightNode",
"type": "object"
}
],
"unevaluatedProperties": false,
"x-help-extra": "node.type: node|mesh|asset|camera|light; default \"node\"\nasset (glTF cameras): addressed as <asset>/<node-name|#index>",
"x-help-path": "node"
},
"NodeBinding": {
"additionalProperties": false,
"description": "An earlier named compositor entry, local to this graph.",
"properties": {
"node": {
"type": "string",
"x-help": "earlier compositor entry name; clamped bilinear image sampling",
"x-help-path": "material.node.node",
"x-source": "vork"
}
},
"required": [
"node"
],
"type": "object"
},
"Opacity": {
"enum": [
"coverage",
"transmittance"
],
"type": "string"
},
"Profile": {
"additionalProperties": false,
"description": "Profile file contents.",
"properties": {
"description": {
"default": "",
"type": "string",
"x-help": "string",
"x-help-path": "profile.description",
"x-source": "vork render profile"
},
"level": {
"description": "Quality/cost level, independent of the profile's name: 0 draft, 1 final, 2 reference, 3 previs (a separate blocking look).",
"format": "uint8",
"maximum": 3,
"minimum": 0,
"type": "integer",
"x-help": "u8; 0..3; quality/cost level; 3 is previs",
"x-help-path": "profile.level",
"x-source": "vork"
},
"settings": {
"$ref": "#/$defs/Settings",
"default": {},
"description": "Sampling seed, sample budget and denoising intent.",
"x-help": "Settings; seed, samples and denoise only",
"x-help-path": "profile.settings",
"x-source": "vork render profile"
},
"version": {
"description": "The profile's own revision, recorded in output metadata.",
"format": "uint32",
"minimum": 0,
"type": "integer",
"x-help": "u32",
"x-help-path": "profile.version",
"x-source": "vork render profile"
}
},
"required": [
"version",
"level"
],
"title": "ProfileFile",
"type": "object"
},
"Program": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"bindings": {
"additionalProperties": {
"$ref": "#/$defs/NameOr3"
},
"default": {},
"type": "object",
"x-help": "<binding>_load(i), _store(i,v), _count; dense grids also expose _dims; u32 _atomic_min(i,v) returns prior value (OOB: UINT_MAX); mat4 = VorkMat4 {c0..c3 columns}; out-of-range loads 0, stores ignored",
"x-help-path": "program.bindings",
"x-source": "vork (explicit contract/technique choice)"
},
"dispatch": {
"anyOf": [
{
"$ref": "#/$defs/ComputeDispatch"
},
{
"type": "null"
}
],
"x-help": "item count or [x,y,z] threads; install/init dt=0; frame schedule frame 0 dt=0; simulation ticks use fixed dt",
"x-help-path": "program.dispatch",
"x-source": "vork (explicit contract/technique choice)"
},
"file": {
"type": [
"string"
],
"x-help": "file-path; XOR source; Slang module, import vork",
"x-help-path": "program.file",
"x-source": "vork (explicit contract/technique choice)"
},
"schedule": {
"anyOf": [
{
"$ref": "#/$defs/ComputeSchedule"
},
{
"type": "null"
}
],
"x-help": "install|frame|simulation; frame uses output FPS; simulation uses scene.simulation pass order; each material instance dispatches with its inputs",
"x-help-path": "program.schedule",
"x-source": "vork (explicit contract/technique choice)"
},
"source": {
"type": "null"
},
"source_origin": {
"type": "null"
}
},
"required": [
"file"
],
"title": "FileProgram",
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"bindings": {
"additionalProperties": {
"$ref": "#/$defs/NameOr3"
},
"default": {},
"type": "object",
"x-help": "<binding>_load(i), _store(i,v), _count; dense grids also expose _dims; u32 _atomic_min(i,v) returns prior value (OOB: UINT_MAX); mat4 = VorkMat4 {c0..c3 columns}; out-of-range loads 0, stores ignored",
"x-help-path": "program.bindings",
"x-source": "vork (explicit contract/technique choice)"
},
"dispatch": {
"anyOf": [
{
"$ref": "#/$defs/ComputeDispatch"
},
{
"type": "null"
}
],
"x-help": "item count or [x,y,z] threads; install/init dt=0; frame schedule frame 0 dt=0; simulation ticks use fixed dt",
"x-help-path": "program.dispatch",
"x-source": "vork (explicit contract/technique choice)"
},
"file": {
"type": "null"
},
"schedule": {
"anyOf": [
{
"$ref": "#/$defs/ComputeSchedule"
},
{
"type": "null"
}
],
"x-help": "install|frame|simulation; frame uses output FPS; simulation uses scene.simulation pass order; each material instance dispatches with its inputs",
"x-help-path": "program.schedule",
"x-source": "vork (explicit contract/technique choice)"
},
"source": {
"type": [
"string"
],
"x-help": "Slang source; XOR file; import vork",
"x-help-extra": "program enum inputs: lowercased Slang case-name tokens (e.g. fog_glow)",
"x-help-path": "program.source",
"x-source": "vork (explicit contract/technique choice)"
},
"source_origin": {
"type": [
"string",
"null"
],
"x-help": "virtual filename|null; inline source only; resolves local imports",
"x-help-path": "program.source_origin",
"x-source": "vork program source location"
}
},
"required": [
"source"
],
"title": "SourceProgram",
"type": "object"
}
]
},
"Propagation": {
"additionalProperties": false,
"properties": {
"bounds": {
"description": "World-space minimum and maximum in metres; rays leaving continue straight.",
"items": {
"items": {
"format": "float",
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
"maxItems": 2,
"minItems": 2,
"type": "array"
},
"program": {
"description": "Program exporting PropagationStep propagation(PropagationContext, Inputs).",
"type": "string"
}
},
"required": [
"program",
"bounds"
],
"type": "object"
},
"Render": {
"additionalProperties": false,
"default": null,
"properties": {
"aovs": {
"default": [],
"description": "Shader AOV declarations; color outputs contain scene-linear RGB.",
"items": {
"$ref": "#/$defs/Aov"
},
"type": "array",
"x-help": "[{name,type:value|color}]; output with --channels all or aov:<name>",
"x-help-path": "render.aovs",
"x-source": "Blender ViewLayer.aovs"
},
"background": {
"$ref": "#/$defs/Background",
"default": "environment",
"x-help": "environment|transparent|RGB; RGB and transparent apply to camera escapes and opacity passthrough; path glass transmission sees the World",
"x-help-path": "render.background",
"x-source": "vork (Blender RenderSettings.film_transparent plus a constant RGB)"
},
"camera": {
"default": null,
"type": [
"string",
"null"
],
"x-help": "camera-node-name|null; null = the only authored camera, else first imported; a camera cut track may select",
"x-help-path": "render.camera",
"x-source": "vork (explicit contract/technique choice)"
},
"compositor": {
"default": [],
"items": {
"$ref": "#/$defs/CompositeEntry"
},
"type": "array",
"x-help": "(material-name|{material,name?,resolution?})[]; ordered image graph, last output; material may be inline",
"x-help-path": "render.compositor",
"x-source": "vork"
},
"display": {
"$ref": "#/$defs/NameOr",
"default": {
"double_sided": true,
"inputs": {},
"opacity": null,
"program": "std/agx"
},
"x-help": "material-name|inline material; display program; EXR stays scene-linear",
"x-help-path": "render.display",
"x-source": "Blender 5.2.1 AgX; display program: vork"
},
"duration": {
"default": 10.416666984558105,
"format": "float",
"type": "number",
"x-help": "number",
"x-help-path": "render.duration",
"x-source": "Blender 5.2.1 (frame range expressed in seconds)"
},
"fps": {
"default": 24.0,
"format": "float",
"type": "number",
"x-help": "number",
"x-help-path": "render.fps",
"x-source": "Blender 5.2.1 RenderSettings.fps"
},
"motion_blur": {
"anyOf": [
{
"$ref": "#/$defs/MotionBlur"
},
{
"type": "null"
}
],
"default": null,
"x-help": "MotionBlur|null; non-null enables; shutter in frames",
"x-help-path": "render.motion_blur",
"x-source": "Blender 5.2.1 render motion blur"
},
"resolution": {
"default": [
1920,
1080
],
"items": {
"format": "uint32",
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 2,
"type": "array",
"x-help": "uvec2",
"x-help-path": "render.resolution",
"x-source": "Blender 5.2.1 RenderSettings.resolution_x/resolution_y"
},
"root": {
"default": null,
"type": [
"string",
"null"
],
"x-help": "node-name|null; only this subtree draws and is lit; objects outside still cast shadows; null = whole scene",
"x-help-path": "render.root",
"x-source": "vork (explicit contract/technique choice)"
}
},
"type": "object"
},
"Rotation": {
"anyOf": [
{
"items": {
"format": "float",
"type": "number"
},
"maxItems": 4,
"minItems": 4,
"type": "array"
},
{
"additionalProperties": false,
"properties": {
"euler": {
"description": "Radians about X, then Y, then Z (fixed parent axes; Blender XYZ).",
"items": {
"format": "float",
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
}
},
"required": [
"euler"
],
"type": "object"
}
],
"description": "An authored rotation: a glTF quaternion or a tagged Euler triple."
},
"Settings": {
"additionalProperties": false,
"description": "User intent. Technique controls belong to the renderer.",
"properties": {
"denoise": {
"default": false,
"description": "Enable optional scene-linear OIDN. Off retains profile-owned reconstruction.",
"type": "boolean",
"x-help": "bool; optional OIDN on/off; off retains profile reconstruction",
"x-help-path": "settings.denoise",
"x-source": "vork"
},
"samples": {
"description": "Override the profile sample budget; more samples means cleaner and slower.",
"format": "uint32",
"maximum": 4096,
"minimum": 1,
"type": "integer",
"x-help": "u32; 1..4096; more samples means cleaner and slower",
"x-help-path": "settings.samples",
"x-source": "vork"
},
"seed": {
"default": 0,
"description": "Deterministic sampling seed, independent of the selected technique.",
"format": "uint32",
"minimum": 0,
"type": "integer",
"x-help": "u32; deterministic sampling seed",
"x-help-path": "settings.seed",
"x-source": "vork"
}
},
"type": "object"
},
"Simulation": {
"additionalProperties": false,
"description": "A deterministic fixed-clock schedule over ordinary typed named buffers.",
"properties": {
"dt": {
"description": "Positive fixed tick duration, in seconds; independent of render FPS.",
"format": "double",
"type": "number",
"x-help": "positive finite seconds; fixed tick independent of output FPS; inputs sample left endpoints",
"x-help-path": "simulation.dt",
"x-source": "vork simulation contract"
},
"init": {
"description": "Ordered compute program names establishing S0.",
"items": {
"type": "string"
},
"type": "array",
"x-help": "program-name[]; ordered initialization passes; schedule simulation",
"x-help-path": "simulation.init",
"x-source": "vork simulation contract"
},
"seed": {
"description": "Simulation randomness is independent of image sampling randomness.",
"format": "uint32",
"minimum": 0,
"type": "integer",
"x-help": "u32; independent of image sampling seed",
"x-help-path": "simulation.seed",
"x-source": "vork simulation contract"
},
"state": {
"description": "Complete persistent state and scratch buffers used by these passes.",
"items": {
"type": "string"
},
"type": "array",
"x-help": "buffer-name[]; complete typed persistent and scratch state; exclusive schedule ownership",
"x-help-path": "simulation.state",
"x-source": "vork simulation contract"
},
"steps": {
"description": "Ordered compute program names advancing Sn to Sn+1.",
"items": {
"type": "string"
},
"type": "array",
"x-help": "program-name[]; ordered tick passes with storage barriers; schedule simulation",
"x-help-path": "simulation.steps",
"x-source": "vork simulation contract"
},
"t0": {
"description": "Time of the initialized state S0, in seconds.",
"format": "double",
"type": "number",
"x-help": "seconds; initialized state S0; requests before t0 hold S0",
"x-help-path": "simulation.t0",
"x-source": "vork simulation contract"
}
},
"required": [
"t0",
"dt",
"seed",
"state",
"init",
"steps"
],
"type": "object"
},
"Skin": {
"additionalProperties": false,
"properties": {
"inverse_bind_matrices": {
"$ref": "#/$defs/NameOr3",
"x-help": "mat4-buffer-name|inline buffer",
"x-help-path": "node.mesh.skin.inverse_bind_matrices",
"x-source": "vork (explicit contract/technique choice)"
},
"joints": {
"items": {
"type": "string"
},
"type": "array",
"x-help": "node-name[]",
"x-help-path": "node.mesh.skin.joints",
"x-source": "vork (explicit contract/technique choice)"
}
},
"required": [
"joints",
"inverse_bind_matrices"
],
"type": "object"
},
"SubdivisionSurface": {
"additionalProperties": false,
"properties": {
"render_levels": {
"default": 2,
"format": "uint32",
"minimum": 0,
"type": "integer",
"x-help": "u32; refinement iterations; allocation checked against device limits",
"x-help-path": "geometry.subdivision.render_levels",
"x-source": "Blender 5.2.1 (offline render subset)"
},
"subdivision_type": {
"$ref": "#/$defs/SubdivisionType",
"default": "catmull_clark",
"x-help": "catmull_clark|simple",
"x-help-path": "geometry.subdivision.subdivision_type",
"x-source": "Blender 5.2.1 (offline render subset)"
},
"use_limit_surface": {
"default": true,
"type": "boolean",
"x-help": "bool",
"x-help-path": "geometry.subdivision.use_limit_surface",
"x-source": "Blender 5.2.1 (offline render subset)"
}
},
"type": "object"
},
"SubdivisionType": {
"enum": [
"catmull_clark",
"simple"
],
"type": "string"
},
"TextureBinding": {
"additionalProperties": false,
"description": "An image handle. Sampling and transformations belong to the receiving program.",
"properties": {
"image": {
"$ref": "#/$defs/NameOr4",
"x-help": "image-name|inline image; the program owns sampling and UV transforms",
"x-help-path": "material.texture.image",
"x-source": "vork"
}
},
"required": [
"image"
],
"type": "object"
},
"Topology": {
"oneOf": [
{
"enum": [
"triangles",
"points",
"curves"
],
"type": "string"
},
{
"const": "implicit",
"description": "Zero surface of one scalar dense grid; negative values are inside.",
"type": "string"
}
]
},
"Track": {
"additionalProperties": false,
"description": "A keyed property.",
"properties": {
"interpolation": {
"anyOf": [
{
"$ref": "#/$defs/Interpolation"
},
{
"type": "null"
}
],
"default": null,
"x-help": "STEP|LINEAR|CUBICSPLINE; omitted: STEP for strings/bools, else LINEAR",
"x-help-path": "animation.track.interpolation",
"x-source": "glTF 2.0 LINEAR"
},
"keys": {
"$ref": "#/$defs/Keys",
"x-help": "[[time, value], ...] | {times: buffer, values: buffer}; time increasing; CUBICSPLINE [time, value, in_tangent, out_tangent] (tangents per second) or [time, value] (zero tangents); rotation values as in node.rotation",
"x-help-path": "animation.track.keys",
"x-source": "vork; glTF 2.0 animation samplers"
},
"path": {
"description": "Segments naming the keyed property, e.g. [\"nodes\",\"Bone.001\",\"rotation\"].",
"items": {
"type": "string"
},
"type": "array",
"x-help": "string[]; [\"nodes\",node,property...] | [\"nodes\",asset,\"nodes\",imported-name|#index,property...] | [\"materials\",material,\"inputs\",input] | [\"animation\",layer,\"weight\"] | [\"render\",property...]",
"x-help-extra": "animation.track.path properties: node translation|rotation|scale|visible|visible_camera|visible_shadow|visible_diffuse|visible_glossy|visible_transmission|morph_weights,<morph>, camera/light numeric fields (camera optics are material inputs); imported nodes: translation|rotation|scale|morph_weights|visible\nanimation.track.path render properties: camera|background (RGB)|motion_blur,shutter",
"x-help-path": "animation.track.path",
"x-source": "vork (explicit contract/technique choice)"
}
},
"required": [
"path",
"keys"
],
"title": "Track",
"type": "object"
},
"Wrap": {
"enum": [
"repeat",
"clamp_to_edge",
"mirrored_repeat"
],
"type": "string"
}
},
"$id": "https://voyager.so/vork/schema/scene.schema.json",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"$schema": {
"description": "Editor JSON Schema address; metadata only, never fetched by the renderer.",
"type": [
"string",
"null"
],
"x-help": "string; editor schema URL",
"x-help-path": "scene.$schema"
},
"animation": {
"default": [],
"items": {
"$ref": "#/$defs/Layer"
},
"type": "array",
"x-help": "layer[]",
"x-help-path": "scene.animation",
"x-source": "vork (explicit contract/technique choice)"
},
"buffers": {
"additionalProperties": {
"$ref": "#/$defs/Buffer"
},
"default": {},
"type": "object",
"x-help": "{name:buffer}",
"x-help-path": "scene.buffers",
"x-source": "vork (explicit contract/technique choice)"
},
"geometry": {
"additionalProperties": {
"$ref": "#/$defs/Geometry"
},
"default": {},
"type": "object",
"x-help": "{name:geometry}",
"x-help-path": "scene.geometry",
"x-source": "vork (explicit contract/technique choice)"
},
"images": {
"additionalProperties": {
"$ref": "#/$defs/Image"
},
"default": {},
"type": "object",
"x-help": "{name:image}",
"x-help-path": "scene.images",
"x-source": "vork (explicit contract/technique choice)"
},
"materials": {
"additionalProperties": {
"$ref": "#/$defs/Material"
},
"default": {},
"type": "object",
"x-help": "{name:material}",
"x-help-path": "scene.materials",
"x-source": "vork (explicit contract/technique choice)"
},
"nodes": {
"items": {
"$ref": "#/$defs/Node"
},
"type": "array",
"x-help": "node[]",
"x-help-path": "scene.nodes",
"x-source": "vork (explicit contract/technique choice)"
},
"programs": {
"additionalProperties": {
"$ref": "#/$defs/Program"
},
"default": {},
"type": "object",
"x-help": "{name:program}",
"x-help-path": "scene.programs",
"x-source": "vork (explicit contract/technique choice)"
},
"propagation": {
"anyOf": [
{
"$ref": "#/$defs/Propagation"
},
{
"type": "null"
}
],
"description": "Authored straight segments inside a world-space box.",
"x-help": "{program,bounds}|null; authored straight ray segments inside world-space bounds",
"x-help-path": "scene.propagation",
"x-source": "vork authored propagation"
},
"render": {
"$ref": "#/$defs/Render",
"default": {
"aovs": [],
"background": "environment",
"camera": null,
"compositor": [],
"display": {
"double_sided": true,
"inputs": {},
"opacity": null,
"program": "std/agx"
},
"duration": 10.416666984558105,
"fps": 24.0,
"motion_blur": null,
"resolution": [
1920,
1080
],
"root": null
},
"x-help": "render",
"x-help-path": "scene.render",
"x-source": "vork (explicit contract/technique choice)"
},
"simulation": {
"anyOf": [
{
"$ref": "#/$defs/Simulation"
},
{
"type": "null"
}
],
"description": "Fixed-clock retained compute state, independent of output FPS.",
"x-help": "simulation|null; fixed-clock ordered retained compute",
"x-help-path": "scene.simulation",
"x-source": "vork simulation contract"
},
"version": {
"const": 2,
"format": "uint32",
"minimum": 0,
"type": "integer",
"x-help": "2",
"x-help-path": "scene.version",
"x-source": "vork (explicit contract/technique choice)"
}
},
"required": [
"version",
"nodes"
],
"title": "Scene",
"type": "object",
"x-help-extra": "coordinates: glTF right-handed Y-up; cameras look along local -Z",
"x-standards": {
"animation": "glTF 2.0 interpolation",
"assets": "glTF 2.0",
"camera JSON": "OpenCV",
"cameras": "Blender physical camera (Blender 5.2.1)",
"colour": "AgX as Blender 5.2.1",
"geometry": "glTF 2.0 topology and attribute semantics",
"hair": "Blender 5.2.1 Principled Hair; Chiang scattering in raster and path",
"lights": "Blender 5.2.1 normalized lights",
"materials": "OpenPBR Surface 1.1.1",
"textures": "glTF 2.0 samplers; KHR_texture_transform lowered on import"
},
"x-vork-differences": [
"animation.clip.file: file-path|null; null = the target asset's clips; else a glTF file retargeted by node name",
"animation.clip.index: u32|null; XOR name",
"animation.clip.name: string|null; XOR index",
"animation.clip.target: asset-node-name",
"animation.layer.blend: replace|add; default replace",
"animation.layer.clip: clip|null; XOR tracks",
"animation.layer.loop: bool; default false",
"animation.layer.name: string|null",
"animation.layer.offset: number; source time = offset + time*speed; default 0",
"animation.layer.speed: number; default 1",
"animation.layer.tracks: track[]|null; XOR clip",
"animation.layer.weight: number; default 1",
"animation.track.interpolation: STEP|LINEAR|CUBICSPLINE; omitted: STEP for strings/bools, else LINEAR; default null",
"animation.track.keys: [[time, value], ...] | {times: buffer, values: buffer}; time increasing; CUBICSPLINE [time, value, in_tangent, out_tangent] (tangents per second) or [time, value] (zero tangents); rotation values as in node.rotation",
"animation.track.path: string[]; [\"nodes\",node,property...] | [\"nodes\",asset,\"nodes\",imported-name|#index,property...] | [\"materials\",material,\"inputs\",input] | [\"animation\",layer,\"weight\"] | [\"render\",property...]",
"buffer.count: u32|null; file only",
"buffer.data: number[]|number[][]; XOR file; mat4 column-major",
"buffer.dims: [u32,u32,u32]|null; positive dense typed array dimensions; non-file; x contiguous; field cell centres span local [-1,1]³",
"buffer.file: file-path; little-endian, or .vdb/.nvdb with grid; XOR data",
"buffer.grid: name|null; .vdb/.nvdb only; f32 or vec3 voxels",
"buffer.offset: u64; bytes, multiple of 4; default 0",
"buffer.type: f32|i32|u32|vec2|vec3|vec4|uvec4|mat4",
"node.focus_object (camera): node-name|null; camera-axis depth supplied to the program at sample time; default null",
"node.material (camera): material-name|inline material|null; omitted = std/camera; optics are program inputs; default null",
"compositor.resolution: [width,height] pixels or positive output scale; floor, minimum 1; null = output; last image resampled to output",
"geometry.attributes: {name: buffer-name|inline buffer}; POSITION required (glTF names and types; COLOR_n: linear vec3/vec4, alpha defaults to 1); implicit: exactly one f32 dense grid, zero threshold; custom f32/vec2/vec3/vec4 bind to material inputs",
"geometry.count: one-element u32 buffer|null; points only; overflow rejects the exposure",
"geometry.crease_edge: {vertices:[u32,u32],crease:number}[]; OpenSubdiv sharpness, 0 smooth, ≥10 sharp",
"geometry.crease_edge.crease: number; ≥0",
"geometry.crease_edge.vertices: [u32,u32]",
"geometry.curve_vertex_counts: u32 buffer; points per curve, ≥2; curves only",
"geometry.face_vertex_counts: u32[]|null; polygon corner counts; absent = triangles",
"geometry.ids: u32 buffer|null; points only; one unique identity per live point; matches previous poses across compact rows; births use current-pose motion placeholders",
"geometry.indices: u32-buffer-name|inline buffer|null",
"geometry.material_ranges: {start,count,material_index}[]; partition indices into node.materials slots; empty = one material; default []",
"geometry.material_ranges.count: u32; whole triangles",
"geometry.material_ranges.material_index: u32; node.materials slot",
"geometry.material_ranges.start: u32; first index",
"geometry.morphs: {name:{POSITION,NORMAL?}}; default {}",
"geometry.morphs.NORMAL: buffer-name|inline buffer|null",
"geometry.morphs.POSITION: vec3-buffer-name|inline buffer",
"geometry.subdivision: {subdivision_type?,render_levels?,use_limit_surface?}|null; Blender Subdivision Surface; one material range",
"geometry.subdivision.render_levels: u32; refinement iterations; allocation checked against device limits; default 2",
"geometry.subdivision.subdivision_type: catmull_clark|simple; default catmull_clark",
"geometry.subdivision.use_limit_surface: bool; default true",
"geometry.topology: triangles|points|curves|implicit; points render as spheres; default triangles",
"geometry.widths: f32 buffer; diameter per point; curves and points; required",
"image.color_space: sRGB|Linear Rec.709|Non-Color|null; null: hdr/exr/ies linear, others sRGB; default null",
"image.file: file-path; XOR render; png jpg tif hdr exr ies mov mp4 mkv or %04d frame pattern; 8-bit may be block-compressed, use 16-bit for exact data; ies: LM-63 Type C",
"image.mag_filter: nearest|linear; default linear",
"image.min_filter: nearest|linear|nearest_mipmap_nearest|linear_mipmap_nearest|nearest_mipmap_linear|linear_mipmap_linear; default linear_mipmap_linear",
"image.render: ImageRender; renders a camera view into the texture; inherits integrator, fps, AOVs; sampling budget follows quality/cost level; closed shutter; scene-linear premultiplied RGBA; default null",
"image.render.background: environment|transparent|RGB; default environment",
"image.render.camera: camera-node-name|null; null = the only authored camera, else first imported; default null",
"image.render.compositor: same image graph as render.compositor; names local to this capture; default []",
"image.render.resolution: uvec2; default [1920,1080]",
"image.render.root: node-name|null; only this subtree draws and is lit; objects outside still cast shadows; null = whole scene; default null",
"image.time: number|null; seconds from first displayed frame; null follows scene time; animatable; subframes hold; out-of-range holds ends; default null",
"image.wrap_s: repeat|clamp_to_edge|mirrored_repeat; default repeat",
"image.wrap_t: repeat|clamp_to_edge|mirrored_repeat; default repeat",
"node.angle (light): number; sun; default 0.009180432",
"node.color (light): RGB",
"node.energy (light): number|null; sun W/m²; local W; environment multiplier",
"node.illuminates (light): light-link-tag[]|null; receivers with any tag; null=all; []=none",
"node.image (light): image-name|inline image|null; LM-63 Type C IES (path only); non-environment lights; emits -Z, no peak normalization",
"node.material (light): material-name|inline material|null; environment program",
"node.radius (light): number; point/spot emitter radius (shadow softness); default 0",
"node.shadowed_by (light): light-link-tag[]|null; casters with any tag; null=all; []=none",
"node.shape (light): sun|point|spot|rectangle|ellipse|environment",
"node.size (light): number; rectangle full side, ellipse diameter; default 1",
"node.size_y (light): number|null; second side/diameter; omitted = size (square/disk)",
"node.spot_blend (light): number; 0..1; default 0.15",
"node.spot_size (light): number; full cone angle; default 0.7853982",
"node.temperature (light): number|null; K; multiplies color; not environment",
"material.aov.aov: render.aovs name",
"material.attribute.attribute: string; geometry or instance attribute name; colour values are linear Rec.709 (no sRGB decoding)",
"material.attribute.channel: r|g|b|a|rgb; omitted: r scalar, rgb colour, exact for vectors",
"material.attribute.factor: number|vector; omitted = 1",
"material.channel.channel: color|depth|view_normal|object_index|motion|shadow_catcher; compositor programs",
"material.double_sided: bool; false culls back faces; default true",
"material.grid.grid: buffer-name|inline buffer; buffer with a grid",
"material.inputs: {name: number|vector|bool|enum-token|{image}|{attribute}|{grid}|{aov}|{node}|{channel}}; default {}",
"material.inputs (std/openpbr): OpenPBR Surface; shaded inputs: base_weight base_color base_metalness specular_weight specular_color specular_roughness specular_roughness_anisotropy specular_ior transmission_weight transmission_color transmission_depth subsurface_weight subsurface_color subsurface_radius subsurface_radius_scale subsurface_scatter_anisotropy coat_weight coat_color coat_roughness coat_ior coat_darkening fuzz_weight fuzz_color fuzz_roughness emission_luminance emission_color thin_film_weight thin_film_thickness thin_film_ior geometry_opacity geometry_thin_walled geometry_normal geometry_tangent geometry_coat_normal transmission_dispersion_scale transmission_dispersion_abbe_number alpha_cutoff",
"material.inputs.alpha_cutoff: number; Negative disables threshold; otherwise geometry_opacity >= alpha_cutoff produces 1, else 0; range [-1,1] per channel; units dimensionless; constant|texture; animatable; default -1",
"material.inputs.base_color: color3; Base reflection albedo (dielectric); F0 colour at normal incidence (metal); range [0,1] per channel; units dimensionless; constant|texture|attribute; animatable; default (0.8, 0.8, 0.8)",
"material.inputs.base_metalness: number; Fraction of the microsurface that is metallic; range [0,1] per channel; units dimensionless; constant|texture|attribute; animatable; default 0",
"material.inputs.base_weight: number; Scalar multiplier to `base_color`; range [0,1] per channel; units dimensionless; constant|texture|attribute; animatable; default 1",
"material.inputs.coat_color: color3; Square of the coat's normal-incidence transmittance; range [0,1] per channel; units dimensionless; constant|texture|attribute; animatable; default (1, 1, 1)",
"material.inputs.coat_darkening: number; Modulates the physical coat darkening effect; range [0,1] per channel; units dimensionless; constant|texture|attribute; animatable; default 1",
"material.inputs.coat_ior: number; Refractive index of the coat; range (0,inf) per channel; units dimensionless; constant|texture|attribute; animatable; default 1.6",
"material.inputs.coat_roughness: number; Roughness of the coat NDF; range [0,1] per channel; units dimensionless; constant|texture|attribute; animatable; default 0",
"material.inputs.coat_weight: number; Coverage weight of the coat slab; range [0,1] per channel; units dimensionless; constant|texture|attribute; animatable; default 0",
"material.inputs.emission_color: color3; Emission colour multiplier (emitted = `emission_color` × `emission_luminance`); range [0,inf) per channel; units dimensionless; constant|texture|attribute; animatable; default (1, 1, 1)",
"material.inputs.emission_luminance: number; Emission luminance with `emission_color` = (1,1,1), before coat and fuzz; range [0,inf) per channel; units cd/m² (nits); constant|texture|attribute; animatable; default 0",
"material.inputs.fuzz_color: color3; Reflection albedo colour of the fuzz; range [0,1] per channel; units dimensionless; constant|texture|attribute; animatable; default (1, 1, 1)",
"material.inputs.fuzz_roughness: number; Reflection roughness of the fuzz; range [0,1] per channel; units dimensionless; constant|texture|attribute; animatable; default 0.5",
"material.inputs.fuzz_weight: number; Coverage weight of the fuzz slab; range [0,1] per channel; units dimensionless; constant|texture|attribute; animatable; default 0",
"material.inputs.geometry_coat_normal: vector3; Shading normal of the coat; linear tangent-space RGB; factor scales XY; independent of base normal; range N/A; units dimensionless; constant or texture; animatable; default unperturbed normal",
"material.inputs.geometry_normal: vector3; Shading normal of the base; range N/A; units dimensionless; constant or texture; animatable; default unperturbed normal",
"material.inputs.geometry_opacity: number; Opacity (presence) of the surface; range [0,1] per channel; units dimensionless; constant|texture; animatable; default 1",
"material.inputs.geometry_tangent: vector3; Reference tangent for specular anisotropy; range N/A; units dimensionless; constant or texture; animatable; default unperturbed tangent",
"material.inputs.geometry_thin_walled: bool; Surface is a thin shell with no interior volume; range {false,true}; units dimensionless; constant only; not animatable; default false",
"material.inputs.specular_color: color3; Tints the dielectric Fresnel factor; metal colour at near-grazing incidence; range [0,1] per channel; units dimensionless; constant|texture|attribute; animatable; default (1, 1, 1)",
"material.inputs.specular_ior: number; Refractive index of the base dielectric; range (0,inf) per channel; units dimensionless; constant|texture|attribute; animatable; default 1.5",
"material.inputs.specular_roughness: number; Roughness of the NDF of the dielectric BSDF and conductor BRDF; range [0,1] per channel; units dimensionless; constant|texture|attribute; animatable; default 0.3",
"material.inputs.specular_roughness_anisotropy: number; Anisotropy of that NDF (stretch along `geometry_tangent`); range [0,1] per channel; units dimensionless; constant|texture|attribute; animatable; default 0",
"material.inputs.specular_weight: number; Modulates the dielectric reflectivity at normal incidence (via IOR); overall multiplier of the metallic Fresnel; range [0,inf) per channel; units dimensionless; constant|texture|attribute; animatable; default 1",
"material.inputs.subsurface_color: color3; Observed reflection colour of the subsurface medium; range [0,1] per channel; units dimensionless; constant|texture|attribute; animatable; default (0.8, 0.8, 0.8)",
"material.inputs.subsurface_radius: number; Length scale of the mean free path; range [0,inf) per channel; units metres; constant|texture|attribute; animatable; default 1",
"material.inputs.subsurface_radius_scale: color3; RGB multiplier to `subsurface_radius` (per-channel MFP); range [0,1] per channel; units dimensionless; constant|texture|attribute; animatable; default (1.0, 0.5, 0.25)",
"material.inputs.subsurface_scatter_anisotropy: number; Henyey-Greenstein anisotropy of the subsurface medium; range [-1,1] per channel; units dimensionless; constant|texture|attribute; animatable; default 0",
"material.inputs.subsurface_weight: number; Mix weight between subsurface and diffuse slabs; range [0,1] per channel; units dimensionless; constant|texture|attribute; animatable; default 0",
"material.inputs.thin_film_ior: number; Refractive index of the film; range (0,inf) per channel; units dimensionless; constant|texture|attribute; animatable; default 1.4",
"material.inputs.thin_film_thickness: number; Thickness of the film in micrometres; range [0,inf) per channel; units µm; constant|texture|attribute; animatable; default 0.5",
"material.inputs.thin_film_weight: number; Coverage weight of the thin film; range [0,1] per channel; units dimensionless; constant|texture|attribute; animatable; default 0",
"material.inputs.transmission_color: color3; Transmission colour; sets the extinction of the interior medium; range [0,1] per channel; units dimensionless; constant|texture|attribute; animatable; default (1, 1, 1)",
"material.inputs.transmission_depth: number; Depth at which `transmission_color` is realised; 0 = constant on-surface tint; range [0,inf) per channel; units metres; constant|texture|attribute; animatable; default 0",
"material.inputs.transmission_dispersion_abbe_number: number; Physical Abbe number of the base dielectric medium; range (0,inf) per channel; units dimensionless; constant|texture|attribute; animatable; default 20",
"material.inputs.transmission_dispersion_scale: number; Linearly scales the amount of dispersion; range [0,1] per channel; units dimensionless; constant|texture|attribute; animatable; default 0",
"material.inputs.transmission_weight: number; Mix weight between translucent base and opaque base slabs; range [0,1] per channel; units dimensionless; constant|texture|attribute; animatable; default 0",
"material.node.node: earlier compositor entry name; clamped bilinear image sampling",
"material.opacity: coverage|transmittance|null; null = coverage, transmittance for transmitting surfaces; coverage = occupied area fraction; transmittance = continuous attenuation by 1 - geometry_opacity; renderer chooses integration; default null",
"material.program: program-name|inline program|<library>/<module>; std/openpbr, std/hair (curves only), or custom; default std/openpbr",
"material.texture.image: image-name|inline image; the program owns sampling and UV transforms",
"node.file (asset): file-path",
"node.materials (asset): {imported-name|#index|*: material-name|inline material}; #index = glTF material index; specific beats *; default {}",
"node.nodes (asset): {imported-name|#index: overrides}; #index = glTF node index; default {}",
"node.nodes.<name>.light_link_tags (asset): string[]|null; replaces inherited tags",
"node.nodes.<name>.pass_index (asset): u32|null; 1..65535; object ID",
"node.children: node[]; default []",
"node.is_holdout: bool; RGB 0; alpha 0 on transparent background, 1 on opaque background; default false",
"node.is_shadow_catcher: bool; shadow_catcher channel is material light with CG / without CG, unclamped; zero baseline gives neutral 1; CG light on an otherwise unlit catcher cannot be represented; default false",
"node.light_link_tags: string[]; matched by light illuminates/shadowed_by; inherited; default []",
"node.geometry (mesh): geometry-name|inline geometry",
"node.instances (mesh): instances|null",
"node.instances.attributes (mesh): equal-length buffers: TRANSLATION vec3, ROTATION vec4 (xyzw), SCALE vec3 (omitted = identity; any zero world-scale component hides the instance), time_offset f32, pass_index u32, custom columns bind to material inputs",
"node.instances.count (mesh): one-element u32 compute buffer; zero to attribute capacity; overflow rejects the exposure",
"node.materials (mesh): (material-name|inline material)[]; empty = default std/openpbr with roughness 0.3; default []",
"node.morph_weights (mesh): {name:number}; default {}",
"node.skin (mesh): skin|null",
"node.skin.inverse_bind_matrices (mesh): mat4-buffer-name|inline buffer",
"node.skin.joints (mesh): node-name[]",
"node.name: string; globally unique, including imported nodes; default \"\"",
"node.pass_index: u32|null; 1..65535; object ID",
"node.rotation: [x,y,z,w] quaternion | {euler:[x,y,z]} (Blender XYZ); default [0,0,0,1]",
"node.scale: [x,y,z]; any zero world-scale component hides geometry, including children; default [1,1,1]",
"node.target: node-name|[x,y,z]|null; aims -Z, world Y up; rotation is an offset on top; structural, not animatable: aim at a named node and animate its translation",
"node.translation: [x,y,z]; parent frame; default [0,0,0]",
"node.visible: bool; false hides the subtree and disables its lights; animatable (step); default true",
"node.visible_camera: bool; default true",
"node.visible_diffuse: bool; default true",
"node.visible_glossy: bool; default true",
"node.visible_shadow: bool; lights must stay true (a light without shadows: shadowed_by []); default true",
"node.visible_transmission: bool; object visibility to transmission rays; lights must stay true; default true",
"profile.description: string; default \"\"",
"profile.level: u8; 0..3; quality/cost level; 3 is previs",
"profile.settings: Settings; seed, samples and denoise only; default {}",
"profile.version: u32",
"program.bindings: <binding>_load(i), _store(i,v), _count; dense grids also expose _dims; u32 _atomic_min(i,v) returns prior value (OOB: UINT_MAX); mat4 = VorkMat4 {c0..c3 columns}; out-of-range loads 0, stores ignored; default {}",
"program.dispatch: item count or [x,y,z] threads; install/init dt=0; frame schedule frame 0 dt=0; simulation ticks use fixed dt",
"program.file: file-path; XOR source; Slang module, import vork",
"program.schedule: install|frame|simulation; frame uses output FPS; simulation uses scene.simulation pass order; each material instance dispatches with its inputs",
"program.source: Slang source; XOR file; import vork",
"program.source_origin: virtual filename|null; inline source only; resolves local imports",
"render.aovs: [{name,type:value|color}]; output with --channels all or aov:<name>; default []",
"render.aovs.name: name; EXR channels <name>.X or <name>.R/G/B",
"render.aovs.type: value|color",
"render.background: environment|transparent|RGB; RGB and transparent apply to camera escapes and opacity passthrough; path glass transmission sees the World; default environment",
"render.camera: camera-node-name|null; null = the only authored camera, else first imported; a camera cut track may select; default null",
"render.compositor: (material-name|{material,name?,resolution?})[]; ordered image graph, last output; material may be inline; default []",
"render.display: material-name|inline material; display program; EXR stays scene-linear; default {\"program\":\"std/agx\"}",
"render.duration: number; default 10.416667",
"render.fps: number; default 24",
"render.motion_blur: MotionBlur|null; non-null enables; shutter in frames; default null",
"render.motion_blur.position: start|center|end; default center",
"render.motion_blur.shutter: number; frames; default 0.5",
"render.resolution: uvec2; default [1920,1080]",
"render.root: node-name|null; only this subtree draws and is lit; objects outside still cast shadows; null = whole scene; default null",
"scene.$schema: string; editor schema URL",
"scene.animation: layer[]; default []",
"scene.buffers: {name:buffer}; default {}",
"scene.geometry: {name:geometry}; default {}",
"scene.images: {name:image}; default {}",
"scene.materials: {name:material}; default {}",
"scene.nodes: node[]",
"scene.programs: {name:program}; default {}",
"scene.propagation: {program,bounds}|null; authored straight ray segments inside world-space bounds",
"scene.render: render; default {}",
"scene.simulation: simulation|null; fixed-clock ordered retained compute",
"scene.version: 2",
"settings.denoise: bool; optional OIDN on/off; off retains profile reconstruction; default false",
"settings.samples: u32; 1..4096; more samples means cleaner and slower",
"settings.seed: u32; deterministic sampling seed; default 0",
"simulation.dt: positive finite seconds; fixed tick independent of output FPS; inputs sample left endpoints",
"simulation.init: program-name[]; ordered initialization passes; schedule simulation",
"simulation.seed: u32; independent of image sampling seed",
"simulation.state: buffer-name[]; complete typed persistent and scratch state; exclusive schedule ownership",
"simulation.steps: program-name[]; ordered tick passes with storage barriers; schedule simulation",
"simulation.t0: seconds; initialized state S0; requests before t0 hold S0",
"animation.track.path properties: node translation|rotation|scale|visible|visible_camera|visible_shadow|visible_diffuse|visible_glossy|visible_transmission|morph_weights,<morph>, camera/light numeric fields (camera optics are material inputs); imported nodes: translation|rotation|scale|morph_weights|visible",
"animation.track.path render properties: camera|background (RGB)|motion_blur,shutter",
"coordinates: glTF right-handed Y-up; cameras look along local -Z",
"image.render restrictions: first shared pose; aperture sampling is renderer-selected; geometry_opacity/alpha_cutoff/geometry_normal/environment image inputs unsupported",
"lights: with no environment light the world is RGB [0.05,0.05,0.05]",
"material (glTF import): mapped to OpenPBR; coat_ior 1.5; occlusion affects indirect only",
"material.attribute: binds geometry or instance columns to numeric inputs; custom programs read_attribute(handle,ctx) gives value, dx, dy",
"material.inputs (transmission): transmission_depth 0 = sqrt(tint) per solid interface; thin sheets = full tint; positive-depth solids = Beer absorption",
"material.inputs (animation): numeric scalar/vector/colour inputs on surface/environment/compute/compositor/display programs use ordinary tracks; geometry_thin_walled is structural; an omitted animated program input has a zero blend baseline (author inputs for another baseline)",
"material.inputs.subsurface: thick: radius × radius_scale; thin: diffuse reflection/transmission split by scatter_anisotropy",
"node.nodes.<name>.visible (asset): bool; default true",
"node.nodes.<name>.visible_camera (asset): bool; default true",
"node.nodes.<name>.visible_shadow (asset): bool; default true",
"node.nodes.<name>.visible_diffuse (asset): bool; default true",
"node.nodes.<name>.visible_glossy (asset): bool; default true",
"node.nodes.<name>.visible_transmission (asset): bool; default true",
"node.type: node|mesh|asset|camera|light; default \"node\"",
"asset (glTF cameras): addressed as <asset>/<node-name|#index>",
"program enum inputs: lowercased Slang case-name tokens (e.g. fog_glow)",
"program.surface emission: authoritative radiance for hits and light samples; lit output is authored shading",
"program.surface: Closure|Blend|Hair surface(ShadingContext,Inputs); Hair needs curves",
"names: string; tables/layers nonempty; named entries unique; excludes '/'",
"paths: scene-relative",
"structure: install-time; non-keyable",
"normal maps: tangent-space; +Y",
"colour: linear Rec.709",
"node [type=\"node\"]: {\"type\":\"node\", …}; flat sibling fields: none; no variant wrapper",
"node [type=\"mesh\"]: {\"type\":\"mesh\", …}; flat sibling fields: geometry, instances, materials, morph_weights, skin; no variant wrapper",
"node [type=\"asset\"]: {\"type\":\"asset\", …}; flat sibling fields: file, materials, nodes; no variant wrapper",
"node [type=\"camera\"]: {\"type\":\"camera\", …}; flat sibling fields: focus_object, material; no variant wrapper",
"node [type=\"light\"]: {\"type\":\"light\", …}; flat sibling fields: angle, color, energy, illuminates, image, material, radius, shadowed_by, shape, size, size_y, spot_blend, spot_size, temperature; no variant wrapper"
]
}