Skip to content

Write HTML. Render video. Built for agents.

3.0 KB
Raw Blame
{
  "$schema": "https://hyperframes.heygen.com/schema/registry-item.json",
  "name": "iris-reveal",
  "type": "hyperframes:component",
  "title": "Iris Reveal",
  "description": "A circle clip-path opens from an authored origin revealing state B over state A in one confident pass, then holds on B. Classic register dims and desaturates the before state so the after state lands in full color; a thin accent rim rides the iris edge. Callers fill the named before/after slot panels; token-styled defaults render when a slot is left empty.",
  "tags": ["transition", "iris", "circle-reveal", "clip-path", "bridge", "slots"],
  "jobs": ["bridge", "reveal"],
  "family": "transitions",
  "profile": "holdable",
  "evidence": "Wave K2: the X expert demand study names the iris/circular reveal as a canonical scene transition; before-after-wipe donates the slot convention",
  "syncPoints": [{ "id": "iris-open", "phase": "in", "offset": 1.45 }],
  "files": [
    {
      "path": "iris-reveal.html",
      "target": "compositions/components/iris-reveal.html",
      "type": "hyperframes:snippet"
    }
  ],
  "variables": [
    {
      "id": "iris_x",
      "type": "number",
      "role": "layout",
      "label": "Iris origin X",
      "description": "Horizontal iris origin as a percent of the frame width.",
      "default": 50,
      "min": 0,
      "max": 100,
      "step": 1,
      "unit": "%"
    },
    {
      "id": "iris_y",
      "type": "number",
      "role": "layout",
      "label": "Iris origin Y",
      "description": "Vertical iris origin as a percent of the frame height.",
      "default": 50,
      "min": 0,
      "max": 100,
      "step": 1,
      "unit": "%"
    },
    {
      "id": "open_at",
      "type": "number",
      "role": "timing",
      "label": "Open start",
      "description": "Seconds after mount start when the iris begins opening.",
      "default": 0.35,
      "min": 0,
      "max": 8,
      "step": 0.05,
      "unit": "s"
    },
    {
      "id": "register",
      "type": "enum",
      "role": "style",
      "label": "Register",
      "description": "Color dims and desaturates the before state so the after state lands in full color. Plain leaves both untouched.",
      "default": "color",
      "options": [
        { "value": "color", "label": "Color" },
        { "value": "plain", "label": "Plain" }
      ]
    },
    {
      "id": "accent",
      "type": "enum",
      "role": "style",
      "label": "Accent",
      "description": "Iris rim ring and default after art tint.",
      "default": "green",
      "options": [
        { "value": "green", "label": "Green" },
        { "value": "blue", "label": "Blue" },
        { "value": "violet", "label": "Violet" }
      ]
    },
    {
      "id": "exit",
      "type": "enum",
      "role": "timing",
      "label": "Exit",
      "description": "Outgoing transition. None holds the final revealed frame.",
      "default": "none",
      "options": [
        { "value": "none", "label": "None" },
        { "value": "fade", "label": "Fade" },
        { "value": "up", "label": "Up" }
      ]
    }
  ]
}