{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/vidplate-app/json-schema/vidplate-app-render-preset-list-schema.json",
  "title": "RenderPresetList",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/vidplate-app-render-presets-api-openapi.yml#/components/schemas/RenderPresetList",
  "type": "object",
  "properties": {
    "object": {
      "const": "list"
    },
    "data": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/RenderPreset"
      }
    },
    "has_more": {
      "type": "boolean"
    },
    "next_cursor": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "$defs": {
    "RenderPreset": {
      "type": "object",
      "description": "A 3D render preset. settings holds only what the preset sets; anything left out keeps the template's own value.",
      "properties": {
        "object": {
          "const": "render_preset"
        },
        "id": {
          "type": "string",
          "description": "rpr_... (standard presets: rpr_std_<code>)."
        },
        "built_in": {
          "type": "boolean",
          "description": "true for the eight standard presets every workspace has. They are read only, listed first, and their codes are reserved."
        },
        "description": {
          "type": [
            "string",
            "null"
          ],
          "description": "What a standard preset is for. null for your own presets."
        },
        "code": {
          "type": "string",
          "description": "What a render names: render_preset: \"<code>\". Unique in the workspace."
        },
        "name": {
          "type": "string"
        },
        "renderer": {
          "enum": [
            "volt",
            "prism"
          ],
          "description": "volt: real-time, fast. prism: the most realistic light, shadows and reflections, and much slower to render."
        },
        "settings": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "quality": {
              "enum": [
                "low",
                "medium",
                "high",
                "ultra"
              ],
              "description": "Detail budget for geometry, shadows, reflections and bloom: low, medium, high or ultra."
            },
            "exposure_ev": {
              "type": "number",
              "minimum": -5,
              "maximum": 5,
              "description": "Scene brightness in stops, -5 to 5."
            },
            "direct_lights": {
              "type": "boolean",
              "description": "Directional, point and scene lights."
            },
            "cast_shadows": {
              "type": "boolean",
              "description": "Objects cast shadows."
            },
            "contact_shadows": {
              "type": "boolean",
              "description": "Fine grounding shadows where objects meet."
            },
            "ambient_occlusion": {
              "type": "boolean",
              "description": "Soft shading where objects are close together."
            },
            "emissive_materials": {
              "type": "boolean",
              "description": "Self-lit material colour."
            },
            "ray_traced_shadows": {
              "type": "boolean",
              "description": "Volt only. Sharper, more accurate shadows. Slower to render."
            },
            "samples": {
              "type": "integer",
              "minimum": 1,
              "maximum": 256,
              "description": "Prism only. Samples per frame, 1 to 256. More samples mean less noise and longer renders."
            },
            "light_bounces": {
              "type": "integer",
              "minimum": 1,
              "maximum": 8,
              "description": "Prism only. How many times light bounces, 1 to 8."
            },
            "trace_resolution": {
              "enum": [
                0.25,
                0.5,
                0.67,
                0.75,
                1
              ],
              "description": "Prism only. Share of the output size that is traced before reconstruction: 0.25, 0.5, 0.67, 0.75 or 1 (native)."
            },
            "output_reconstruction": {
              "enum": [
                "balanced",
                "4k"
              ],
              "description": "Prism only. balanced, or 4k for extra detail on 4K outputs."
            },
            "denoiser": {
              "enum": [
                "interactive",
                "final",
                "compact",
                "off"
              ],
              "description": "Prism only. interactive: fast clean-up. final: the cleanest result, takes a little longer after sampling. compact: a lighter final clean-up. off: no clean-up."
            },
            "automatic_device_quality": {
              "type": "boolean",
              "description": "Prism only. Lets each render node pick resolution, samples and bounces to suit its speed."
            },
            "low_memory_tiled_final": {
              "type": "boolean",
              "description": "Prism only. Renders large frames in tiles so render nodes with less graphics memory can make them."
            },
            "secondary_ray_detail": {
              "enum": [
                "full",
                "balanced",
                "fast"
              ],
              "description": "Prism only. Texture detail in reflections and bounced light: full, balanced or fast."
            },
            "adaptive_sampling": {
              "type": "boolean",
              "description": "Prism only. Stops sampling pixels that are already clean and spends the time on noisy areas."
            },
            "many_light_reservoirs": {
              "type": "boolean",
              "description": "Prism only. Cleaner results in scenes with eight or more lights."
            },
            "noise_threshold": {
              "type": "number",
              "minimum": 0.0025,
              "maximum": 0.25,
              "description": "Prism only. With adaptive sampling, how much noise a pixel may keep, 0.0025 to 0.25. Lower is cleaner and slower."
            },
            "cached_bounce_lighting": {
              "type": "boolean",
              "description": "Colour bouncing between nearby objects."
            },
            "environment_colour": {
              "type": "string",
              "pattern": "^#[0-9A-Fa-f]{6}$",
              "description": "A solid world colour (#RRGGBB) that lights and reflects in the scene. Replaces the template's world. Cannot be combined with environment_map_url."
            },
            "environment_map_url": {
              "type": "string",
              "format": "uri",
              "description": "An https link to an equirectangular .hdr or .exr image to light and reflect the scene. Your render nodes download it, so it must allow cross-origin requests."
            },
            "world_lighting": {
              "type": "boolean",
              "description": "The world lights the scene."
            },
            "environment_shadows": {
              "type": "boolean",
              "description": "Objects shade each other from bright parts of the world."
            },
            "dynamic_bounce_lighting": {
              "type": "boolean",
              "description": "One light adds a soft colour bounce. Best for still, solid scenes."
            },
            "lighting_brightness": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000,
              "description": "Brightness of the world light in percent, 0 to 1,000 (100 is normal)."
            },
            "reflections": {
              "type": "boolean",
              "description": "Scene and world reflections."
            },
            "reflection_strength": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000,
              "description": "Strength of reflections in percent, 0 to 1,000 (100 is normal)."
            },
            "bloom": {
              "type": "boolean",
              "description": "Glow around bright highlights."
            },
            "bloom_intensity": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000,
              "description": "Glow strength in percent, 0 to 1,000 (100 is normal)."
            },
            "anamorphic_streaks": {
              "type": "boolean",
              "description": "Horizontal lens streaks from bright highlights."
            },
            "streak_intensity": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000,
              "description": "Streak strength in percent, 0 to 1,000 (100 is normal)."
            },
            "chromatic_aberration": {
              "type": "boolean",
              "description": "Slight colour fringing in the glow."
            },
            "colour_separation": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000,
              "description": "Colour fringing distance in percent, 0 to 1,000 (100 is normal)."
            },
            "cinematic_post_processing": {
              "type": "boolean",
              "description": "Smoother object edges and a cinematic finish."
            },
            "antialiasing_strength": {
              "type": "number",
              "minimum": 0,
              "maximum": 100,
              "description": "Edge smoothing in percent, 0 to 100."
            },
            "vignette": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000,
              "description": "Darkening of the frame edges in percent, 0 to 1,000 (100 is normal)."
            },
            "height_fog": {
              "type": "boolean",
              "description": "Distance haze that gathers low in the scene."
            },
            "fog_colour": {
              "type": "string",
              "pattern": "^#[0-9A-Fa-f]{6}$",
              "description": "Fog colour (#RRGGBB). Without it the fog matches the scene lighting."
            },
            "fog_density": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000,
              "description": "Fog density in percent, 0 to 1,000 (100 is normal)."
            },
            "progressive_final_lighting": {
              "type": "boolean",
              "description": "Extra lighting samples and full-resolution fog in every exported frame."
            }
          }
        },
        "created_at": {
          "type": [
            "string",
            "null"
          ]
        },
        "updated_at": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    }
  }
}