{ "openapi": "3.1.1", "info": { "title": "PBR Texture Set Export (glTF, Unreal, Unity) API", "version": "1.0.0", "summary": "Export a procedural material as a named PBR texture set for glTF, Unreal or Unity HDRP.", "description": "Every endpoint performs the same calculation as the human page and returns inputs, result, units, assumptions, sources, warnings and computedAt. MCP endpoint: /mcp." }, "servers": [ { "url": "https://renderloompbrexport.usefulweb.app" } ], "paths": { "/api/v1/calculate": { "post": { "operationId": "calculate", "summary": "Export a procedural material as a named PBR texture set for glTF, Unreal or Unity HDRP.", "description": "Render a Material Nodes preset or your own graph at up to 1024 px and download a ZIP named for your engine: base color, normal in the right Y convention, a packed ORM or HDRP mask map, separate roughness, metallic and occlusion maps, 8- and 16-bit height, the editable graph and a manifest that lists channels and color spaces.\n\nMethodology:\n- The graph is evaluated with the same engine as the Material Nodes dialog at the chosen size. Parameters are fractions of the tile, so a 1024 px export matches the 256 px preview in look.\n- glTF 2.0 / Blender / Godot: +Y (OpenGL-style) normal and an occlusion-roughness-metallic PNG — the glTF metallicRoughness texture reads roughness from G and metallic from B; the occlusion texture reads R, so the same ORM file can serve both.\n- Unreal Engine: the same ORM packing with a −Y (DirectX-style) normal; the green channel is inverted (255 − value).\n- Unity HDRP: +Y normal and a mask map with R = metallic, G = ambient occlusion, B = detail mask set to 0 (no detail map) and A = smoothness = 1 − roughness, as documented by Unity.\n- Every package adds separate roughness, metallic, occlusion and height PNGs (8-bit RGBA), an optional 16-bit grayscale height PNG, the editable graph and export-manifest.json with the channel and color-space list.\n\nCheck the import settings of your engine: base color is sRGB, all other maps are linear data. The maps come from a procedural graph and are not scanned materials.", "tags": [ "apps" ], "x-mcp-tool": "renderloom_pbr_export", "x-owner-app": "renderloom", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RenderloomPbrExportInput" }, "examples": { "example1": { "summary": "Oak planks for glTF and Blender", "value": { "preset": "wood", "size": 256 } }, "example2": { "summary": "Brushed metal for Unreal Engine", "value": { "preset": "metal", "size": 256, "convention": "unreal" } }, "example3": { "summary": "Woven fabric for Unity HDRP without 16-bit height", "value": { "preset": "fabric", "size": 128, "convention": "unity-hdrp", "height16": false } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RenderloomPbrExportResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tool": { "get": { "operationId": "getToolDefinition", "summary": "Inputs, output schema and examples for this tool", "responses": { "200": { "description": "Tool definition.", "content": { "application/json": { "schema": { "type": "object" } } } } } } } }, "components": { "schemas": { "Problem": { "type": "object", "description": "RFC 9457 problem details. 422 responses include per-field `errors`.", "required": [ "type", "title", "status", "detail" ], "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer" }, "detail": { "type": "string" }, "code": { "type": "string" }, "errors": { "type": "array", "items": { "type": "object", "required": [ "field", "message" ], "properties": { "field": { "type": "string" }, "message": { "type": "string" } } } } } }, "RenderloomPbrExportInput": { "type": "object", "additionalProperties": false, "properties": { "preset": { "title": "Material graph", "type": "string", "enum": [ "brick", "wood", "stone", "metal", "fabric", "custom" ], "default": "brick" }, "graph": { "title": "Graph JSON (for a custom graph)", "description": "Format renderloom-material-graph version 1 (schema at /static/apps/renderloom/material-graph.schema.json). Copy it from Renderloom → Material Nodes.", "type": "string", "maxLength": 200000, "default": "" }, "size": { "title": "Texture size (px)", "type": "integer", "minimum": 64, "maximum": 1024, "default": 512 }, "seed": { "title": "Graph seed (−1 keeps the graph’s seed)", "type": "integer", "minimum": -1, "maximum": 999999, "default": -1 }, "convention": { "title": "Target engine", "type": "string", "enum": [ "gltf", "unreal", "unity-hdrp" ], "default": "gltf" }, "height16": { "title": "Include a 16-bit height PNG", "type": "boolean", "default": true } }, "required": [] }, "RenderloomPbrExportResult": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "tool", "computedAt", "inputs", "summary", "result", "units", "assumptions", "sources", "warnings", "presentation", "links" ], "properties": { "schemaVersion": { "type": "string", "const": "1.0" }, "tool": { "type": "object", "additionalProperties": false, "required": [ "id", "name", "version" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "version": { "type": "string" } } }, "computedAt": { "type": "string", "format": "date-time" }, "inputs": { "type": "object", "description": "Normalised inputs actually used, including applied defaults." }, "summary": { "type": "string" }, "result": { "type": "object", "additionalProperties": false, "required": [ "project", "convention", "size", "manifest", "packed", "archive", "files" ], "properties": { "project": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "Renderloom material graph", "type": "object", "additionalProperties": false, "required": [ "format", "version", "name", "size", "seed", "nodes" ], "properties": { "format": { "const": "renderloom-material-graph" }, "version": { "const": 1 }, "name": { "type": "string", "minLength": 1, "maxLength": 120 }, "size": { "type": "integer", "minimum": 16, "maximum": 1024 }, "seed": { "type": "integer", "minimum": 0, "maximum": 999999 }, "nodes": { "type": "array", "minItems": 1, "maxItems": 48, "items": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "id", "type" ], "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,23}$" }, "type": { "const": "noise" }, "label": { "type": "string", "maxLength": 60 }, "params": { "type": "object", "additionalProperties": false, "properties": { "kind": { "enum": [ "perlin", "value", "simplex" ] }, "style": { "enum": [ "fbm", "turbulence", "ridged" ] }, "scaleX": { "type": "integer", "minimum": 1, "maximum": 256 }, "scaleY": { "type": "integer", "minimum": 1, "maximum": 256 }, "octaves": { "type": "integer", "minimum": 1, "maximum": 8 }, "persistence": { "type": "number", "minimum": 0, "maximum": 1 }, "contrast": { "type": "number", "minimum": 0.1, "maximum": 4 }, "seed": { "type": "integer", "minimum": 0, "maximum": 9999 } } }, "inputs": { "type": "object", "additionalProperties": false, "properties": {} } } }, { "type": "object", "additionalProperties": false, "required": [ "id", "type" ], "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,23}$" }, "type": { "const": "voronoi" }, "label": { "type": "string", "maxLength": 60 }, "params": { "type": "object", "additionalProperties": false, "properties": { "mode": { "enum": [ "f1", "f2", "edge", "cells" ] }, "scaleX": { "type": "integer", "minimum": 1, "maximum": 256 }, "scaleY": { "type": "integer", "minimum": 1, "maximum": 256 }, "jitter": { "type": "number", "minimum": 0, "maximum": 1 }, "metric": { "enum": [ "euclidean", "manhattan", "chebyshev" ] }, "seed": { "type": "integer", "minimum": 0, "maximum": 9999 } } }, "inputs": { "type": "object", "additionalProperties": false, "properties": {} } } }, { "type": "object", "additionalProperties": false, "required": [ "id", "type" ], "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,23}$" }, "type": { "const": "gradient" }, "label": { "type": "string", "maxLength": 60 }, "params": { "type": "object", "additionalProperties": false, "properties": { "kind": { "enum": [ "linear-x", "linear-y", "wave-x", "wave-y", "wave-diagonal", "radial", "checker" ] }, "repeat": { "type": "integer", "minimum": 1, "maximum": 128 } } }, "inputs": { "type": "object", "additionalProperties": false, "properties": {} } } }, { "type": "object", "additionalProperties": false, "required": [ "id", "type" ], "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,23}$" }, "type": { "const": "bricks" }, "label": { "type": "string", "maxLength": 60 }, "params": { "type": "object", "additionalProperties": false, "properties": { "mode": { "enum": [ "height", "cell" ] }, "columns": { "type": "integer", "minimum": 1, "maximum": 64 }, "rows": { "type": "integer", "minimum": 1, "maximum": 128 }, "offset": { "type": "number", "minimum": 0, "maximum": 1 }, "mortar": { "type": "number", "minimum": 0, "maximum": 0.5 }, "bevel": { "type": "number", "minimum": 0, "maximum": 0.5 }, "seed": { "type": "integer", "minimum": 0, "maximum": 9999 } } }, "inputs": { "type": "object", "additionalProperties": false, "properties": {} } } }, { "type": "object", "additionalProperties": false, "required": [ "id", "type" ], "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,23}$" }, "type": { "const": "value" }, "label": { "type": "string", "maxLength": 60 }, "params": { "type": "object", "additionalProperties": false, "properties": { "value": { "type": "number", "minimum": 0, "maximum": 1 } } }, "inputs": { "type": "object", "additionalProperties": false, "properties": {} } } }, { "type": "object", "additionalProperties": false, "required": [ "id", "type" ], "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,23}$" }, "type": { "const": "color" }, "label": { "type": "string", "maxLength": 60 }, "params": { "type": "object", "additionalProperties": false, "properties": { "color": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" } } }, "inputs": { "type": "object", "additionalProperties": false, "properties": {} } } }, { "type": "object", "additionalProperties": false, "required": [ "id", "type" ], "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,23}$" }, "type": { "const": "blend" }, "label": { "type": "string", "maxLength": 60 }, "params": { "type": "object", "additionalProperties": false, "properties": { "mode": { "enum": [ "normal", "multiply", "screen", "overlay", "soft-light", "hard-light", "add", "difference", "exclusion", "darken", "lighten", "color-dodge", "color-burn" ] }, "opacity": { "type": "number", "minimum": 0, "maximum": 1 } } }, "inputs": { "type": "object", "additionalProperties": false, "properties": { "a": { "type": "string" }, "b": { "type": "string" }, "mask": { "type": "string" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "id", "type" ], "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,23}$" }, "type": { "const": "warp" }, "label": { "type": "string", "maxLength": 60 }, "params": { "type": "object", "additionalProperties": false, "properties": { "strength": { "type": "number", "minimum": 0, "maximum": 0.5 } } }, "inputs": { "type": "object", "additionalProperties": false, "properties": { "source": { "type": "string" }, "warpX": { "type": "string" }, "warpY": { "type": "string" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "id", "type" ], "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,23}$" }, "type": { "const": "levels" }, "label": { "type": "string", "maxLength": 60 }, "params": { "type": "object", "additionalProperties": false, "properties": { "inLow": { "type": "number", "minimum": 0, "maximum": 0.99 }, "inHigh": { "type": "number", "minimum": 0.01, "maximum": 1 }, "gamma": { "type": "number", "minimum": 0.1, "maximum": 10 }, "outLow": { "type": "number", "minimum": 0, "maximum": 1 }, "outHigh": { "type": "number", "minimum": 0, "maximum": 1 } } }, "inputs": { "type": "object", "additionalProperties": false, "properties": { "source": { "type": "string" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "id", "type" ], "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,23}$" }, "type": { "const": "curves" }, "label": { "type": "string", "maxLength": 60 }, "params": { "type": "object", "additionalProperties": false, "properties": { "points": { "type": "string", "maxLength": 400 } } }, "inputs": { "type": "object", "additionalProperties": false, "properties": { "source": { "type": "string" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "id", "type" ], "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,23}$" }, "type": { "const": "invert" }, "label": { "type": "string", "maxLength": 60 }, "params": { "type": "object", "additionalProperties": false, "properties": {} }, "inputs": { "type": "object", "additionalProperties": false, "properties": { "source": { "type": "string" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "id", "type" ], "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,23}$" }, "type": { "const": "blur" }, "label": { "type": "string", "maxLength": 60 }, "params": { "type": "object", "additionalProperties": false, "properties": { "radius": { "type": "number", "minimum": 0, "maximum": 0.1 } } }, "inputs": { "type": "object", "additionalProperties": false, "properties": { "source": { "type": "string" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "id", "type" ], "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,23}$" }, "type": { "const": "colorize" }, "label": { "type": "string", "maxLength": 60 }, "params": { "type": "object", "additionalProperties": false, "properties": { "low": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" }, "mid": { "type": "string", "maxLength": 400 }, "high": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" } } }, "inputs": { "type": "object", "additionalProperties": false, "properties": { "source": { "type": "string" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "id", "type" ], "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,23}$" }, "type": { "const": "normal" }, "label": { "type": "string", "maxLength": 60 }, "params": { "type": "object", "additionalProperties": false, "properties": { "depth": { "type": "number", "minimum": 0, "maximum": 0.25 } } }, "inputs": { "type": "object", "additionalProperties": false, "properties": { "height": { "type": "string" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "id", "type" ], "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,23}$" }, "type": { "const": "ao" }, "label": { "type": "string", "maxLength": 60 }, "params": { "type": "object", "additionalProperties": false, "properties": { "radius": { "type": "number", "minimum": 0.002, "maximum": 0.2 }, "depth": { "type": "number", "minimum": 0, "maximum": 0.25 }, "strength": { "type": "number", "minimum": 0, "maximum": 2 } } }, "inputs": { "type": "object", "additionalProperties": false, "properties": { "height": { "type": "string" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "id", "type" ], "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,23}$" }, "type": { "const": "curvature" }, "label": { "type": "string", "maxLength": 60 }, "params": { "type": "object", "additionalProperties": false, "properties": { "radius": { "type": "number", "minimum": 0.002, "maximum": 0.1 }, "depth": { "type": "number", "minimum": 0, "maximum": 0.25 }, "strength": { "type": "number", "minimum": 0, "maximum": 8 } } }, "inputs": { "type": "object", "additionalProperties": false, "properties": { "height": { "type": "string" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "id", "type" ], "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,23}$" }, "type": { "const": "output" }, "label": { "type": "string", "maxLength": 60 }, "params": { "type": "object", "additionalProperties": false, "properties": { "normalDepth": { "type": "number", "minimum": 0, "maximum": 0.25 } } }, "inputs": { "type": "object", "additionalProperties": false, "properties": { "baseColor": { "type": "string" }, "height": { "type": "string" }, "roughness": { "type": "string" }, "metallic": { "type": "string" }, "ao": { "type": "string" }, "normal": { "type": "string" } } } } } ] } } } }, "convention": { "enum": [ "gltf", "unreal", "unity-hdrp" ] }, "size": { "type": "integer" }, "manifest": { "type": "object" }, "packed": { "type": "object", "additionalProperties": false, "required": [ "artifactId", "filename", "mime", "bytes", "sha256", "path" ], "properties": { "artifactId": { "type": "string" }, "filename": { "type": "string" }, "mime": { "type": "string" }, "bytes": { "type": "integer" }, "sha256": { "type": "string" }, "path": { "type": "string", "description": "Download path on the same site (valid for about 2 hours)." } } }, "archive": { "type": "object", "additionalProperties": false, "required": [ "artifactId", "filename", "mime", "bytes", "sha256", "path" ], "properties": { "artifactId": { "type": "string" }, "filename": { "type": "string" }, "mime": { "type": "string" }, "bytes": { "type": "integer" }, "sha256": { "type": "string" }, "path": { "type": "string", "description": "Download path on the same site (valid for about 2 hours)." } } }, "files": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "artifactId", "filename", "mime", "bytes", "sha256", "path" ], "properties": { "artifactId": { "type": "string" }, "filename": { "type": "string" }, "mime": { "type": "string" }, "bytes": { "type": "integer" }, "sha256": { "type": "string" }, "path": { "type": "string", "description": "Download path on the same site (valid for about 2 hours)." } } } } } }, "units": { "type": "object", "additionalProperties": { "type": "string" } }, "assumptions": { "type": "array", "items": { "type": "string" } }, "sources": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "title" ], "properties": { "title": { "type": "string" }, "url": { "type": "string" }, "publisher": { "type": "string" }, "retrievedAt": { "type": "string" }, "note": { "type": "string" } } } }, "warnings": { "type": "array", "items": { "type": "string" } }, "presentation": { "type": "array", "items": { "type": "object" }, "description": "Display blocks used by the human page (same data)." }, "links": { "type": "object", "additionalProperties": false, "required": [ "human", "api", "openapi", "methodology" ], "properties": { "human": { "type": "string", "format": "uri" }, "api": { "type": "string", "format": "uri" }, "openapi": { "type": "string", "format": "uri" }, "methodology": { "type": "string", "format": "uri" } } } } } } } }