> ## Documentation Index
> Fetch the complete documentation index at: https://hyperframes.heygen.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Blur Out Up

> Words arrive clean and depart upward with increasing blur for airy exits.

export const InstallCommand = ({command}) => {
  const [copied, setCopied] = React.useState(false);
  const copy = async () => {
    try {
      if (navigator.clipboard && window.isSecureContext) {
        await navigator.clipboard.writeText(command);
      } else {
        const previous = document.activeElement;
        const scratch = document.createElement("textarea");
        scratch.value = command;
        scratch.setAttribute("readonly", "");
        scratch.style.position = "fixed";
        scratch.style.opacity = "0";
        document.body.appendChild(scratch);
        scratch.select();
        document.execCommand("copy");
        document.body.removeChild(scratch);
        previous?.focus?.();
      }
      setCopied(true);
      setTimeout(() => setCopied(false), 2000);
    } catch {}
  };
  return <div className="hf-install-command not-prose my-4 flex items-stretch overflow-hidden rounded-xl border border-zinc-200 bg-zinc-50 dark:border-zinc-800 dark:bg-zinc-900">
      <code className="flex-1 overflow-x-auto whitespace-nowrap border-r border-zinc-200 px-4 py-3 font-mono text-sm text-zinc-800 dark:border-zinc-800 dark:text-zinc-100">
        {command}
      </code>
      <button type="button" onClick={copy} data-copied={copied ? "true" : "false"} aria-label={`Copy ${command} to the clipboard`} className="hf-install-copy">
        <svg className="hf-install-copy-clipboard" xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 18 18" fill="none" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">
          <path d="M14.25 5.25H7.25C6.14543 5.25 5.25 6.14543 5.25 7.25V14.25C5.25 15.3546 6.14543 16.25 7.25 16.25H14.25C15.3546 16.25 16.25 15.3546 16.25 14.25V7.25C16.25 6.14543 15.3546 5.25 14.25 5.25Z" />
          <path d="M2.80103 11.998L1.77203 5.07397C1.61003 3.98097 2.36403 2.96397 3.45603 2.80197L10.38 1.77297C11.313 1.63397 12.19 2.16297 12.528 3.00097" />
        </svg>
        <svg className="hf-install-copy-check" xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 18 18" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">
          <path d="M2.75 9.5L6.5 13.25L15.25 4.5" />
        </svg>
      </button>
      <span className="hf-install-copy-status" role="status" aria-live="polite">
        {copied ? "Copied" : ""}
      </span>
    </div>;
};

<iframe className="w-full aspect-video rounded-xl border-0 bg-zinc-100 dark:bg-zinc-800" title="blur-out-up preview" loading="lazy" srcDoc={`<!doctype html><html><head><meta charset="utf-8"><style>html,body{margin:0;height:100%;overflow:hidden;background:transparent}hyperframes-player{display:block;width:100%;height:100%}</style><script src="https://cdn.jsdelivr.net/npm/@hyperframes/player@0.7/dist/hyperframes-player.global.js"><\/script></head><body><script>fetch("/public/catalog/components/blur-out-up.json").then(function(r){return r.json()}).then(function(d){var p=document.createElement("hyperframes-player");p.setAttribute("srcdoc",d.html);p.setAttribute("controls","");p.setAttribute("autoplay","");p.setAttribute("loop","");p.setAttribute("muted","");p.setAttribute("poster","https://static.heygen.ai/hyperframes-oss/docs/images/catalog/components/blur-out-up.png");document.body.appendChild(p)});<\/script></body></html>`} />

## Install

<InstallCommand command="npx hyperframes add blur-out-up" />

That writes one file: `compositions/components/blur-out-up.html`.

## Variables

Every one of these has a default, so the piece works untouched. Set the ones you
want to change on the element:

| Variable    | Default    | Accepts                       | What it does                                                                           |
| ----------- | ---------- | ----------------------------- | -------------------------------------------------------------------------------------- |
| `direction` | `up`       | `up`, `down`, `left`, `right` | Where the offset the timeline drives points.                                           |
| `distance`  | `standard` | `close`, `standard`, `far`    | Scales the travel offset, so the words cover a shorter or longer run in the same time. |
| `blur`      | `standard` | `soft`, `standard`, `heavy`   | Scales the blur radius the timeline drives, from a light haze to a full smear.         |
| `tone`      | `ink`      | `ink`, `paper`, `accent`      | Word colour: ink for light frames, paper for dark ones, accent rides --brand.          |

Set them with `data-variable-values` on the element that mounts it. These are the
defaults, so this behaves exactly like the preview above until you change one:

```html wrap theme={null}
<div
  data-composition-id="blur-out-up"
  data-composition-src="compositions/components/blur-out-up.html"
  data-variable-values='{"direction":"up","distance":"standard","blur":"standard","tone":"ink"}'
></div>
```

## Source

<Accordion title={`blur-out-up.html`}>
  ```html theme={null}
  <!--
    Blur Out Up - remocn typography primitive for HyperFrames.

    Paste the markup, CSS and script into a composition. Drive the timeline
    integration from a paused GSAP timeline so renders remain deterministic.

    Variables. The script reads each one, falls back to the declared default on
    anything missing or unrecognised, and writes the result as a custom property
    the CSS above consumes. The timeline recipe below is untouched by them: it
    keeps driving one offset and one blur, and these decide what that offset and
    that blur mean on screen.

      - direction (up | down | left | right, default up): where the offset
        points. up rises into place, down drops in, left and right slide in
        along the baseline.
      - distance (close | standard | far, default standard): scales the offset.
        close covers half the run, far nearly double, in the same time.
      - blur (soft | standard | heavy, default standard): scales the blur radius,
        from a light haze to a full smear.
      - tone (ink | paper | accent, default ink): word colour. ink is near-black
        for light frames, paper near-white for dark ones, accent rides --brand.

    On every default the result is identical to the original: words rise 22px
    through a 5px blur in near-black.
  -->

  <div
    class="hf-remocn-blur-out-up"
    data-composition-variables='[
      { "id": "direction", "type": "enum", "role": "motion", "label": "Direction", "description": "Where the offset the timeline drives points.", "default": "up", "options": [{ "value": "up", "label": "Up" }, { "value": "down", "label": "Down" }, { "value": "left", "label": "Left" }, { "value": "right", "label": "Right" }] },
      { "id": "distance", "type": "enum", "role": "motion", "label": "Distance", "description": "Scales the travel offset, so the words cover a shorter or longer run in the same time.", "default": "standard", "options": [{ "value": "close", "label": "Close" }, { "value": "standard", "label": "Standard" }, { "value": "far", "label": "Far" }] },
      { "id": "blur", "type": "enum", "role": "style", "label": "Blur", "description": "Scales the blur radius the timeline drives, from a light haze to a full smear.", "default": "standard", "options": [{ "value": "soft", "label": "Soft" }, { "value": "standard", "label": "Standard" }, { "value": "heavy", "label": "Heavy" }] },
      { "id": "tone", "type": "enum", "role": "style", "label": "Tone", "description": "Word colour: ink for light frames, paper for dark ones, accent rides --brand.", "default": "ink", "options": [{ "value": "ink", "label": "Ink" }, { "value": "paper", "label": "Paper" }, { "value": "accent", "label": "Accent" }] }
    ]'
  >
    <span>HELLO</span>
  </div>

  <style>
    .hf-remocn-blur-out-up {
      color: var(--hf-word-color, #18181b);
      font-family: Inter, system-ui, sans-serif;
      font-weight: 900;
      letter-spacing: -0.04em;
    }
    .hf-remocn-blur-out-up {
      display: inline-flex;
      gap: 12px;
      font-size: 56px;
      line-height: 1;
    }
    .hf-remocn-blur-out-up span {
      display: inline-block;
      transform: translate(
          calc(var(--hf-word-x, 0px) + var(--hf-word-y, 0px) * var(--hf-word-axis-x, 0)),
          calc(var(--hf-word-y, 0px) * var(--hf-word-axis-y, 1))
        )
        scale(var(--hf-word-scale, 1));
      filter: blur(calc(var(--hf-word-blur, 0px) * var(--hf-word-blur-scale, 1)));
      will-change: transform, filter, opacity;
    }
  </style>

  <script>
    (function () {
      "use strict";

      var vars =
        window.__hyperframes && window.__hyperframes.getVariables
          ? window.__hyperframes.getVariables()
          : {};

      // Unrecognised overrides return to their declared defaults.
      var axes = {
        up: { x: 0, y: 1 },
        down: { x: 0, y: -1 },
        left: { x: -1, y: 0 },
        right: { x: 1, y: 0 },
      };
      var reaches = { close: 0.5, standard: 1, far: 1.85 };
      var blurScales = { soft: 0.45, standard: 1, heavy: 2.2 };
      var tones = {
        ink: "#18181b",
        paper: "#fafafa",
        accent: "var(--brand, #34d399)",
      };

      function pick(table, value, fallback) {
        return Object.prototype.hasOwnProperty.call(table, value) ? value : fallback;
      }

      var axis = axes[pick(axes, vars.direction, "up")];
      var reach = reaches[pick(reaches, vars.distance, "standard")];
      var blurScale = blurScales[pick(blurScales, vars.blur, "standard")];
      var tone = tones[pick(tones, vars.tone, "ink")];

      var roots = document.querySelectorAll(".hf-remocn-blur-out-up");
      for (var i = 0; i < roots.length; i += 1) {
        roots[i].style.setProperty("--hf-word-axis-x", String(axis.x * reach));
        roots[i].style.setProperty("--hf-word-axis-y", String(axis.y * reach));
        roots[i].style.setProperty("--hf-word-blur-scale", String(blurScale));
        roots[i].style.setProperty("--hf-word-color", tone);
      }
    })();
  </script>

  <!--
    Timeline integration:
    tl.fromTo('.hf-remocn-blur-out-up span', { opacity: 0, '--hf-word-y': '22px', '--hf-word-scale': 0.92, '--hf-word-blur': '5px' }, { opacity: 1, '--hf-word-y': '0px', '--hf-word-scale': 1, '--hf-word-blur': '0px', duration: 0.3, stagger: 0.055, ease: 'power3.out' }, startTime);
  -->
  ```
</Accordion>

## Usage

Open `compositions/components/blur-out-up.html` and paste its contents into your composition. See the comment header in the file for detailed instructions.

Tagged `motion-primitive` `remocn-port` `typography`.

## Related topics

* [Browse the complete Catalog](/catalog)
* [Add assets and Catalog items in Studio](/studio/assets-and-blocks)
* [Build a richer composition](/go-further)


## Related topics

- [Soft Blur In](/catalog/components/soft-blur-in.md)
- [Blur In](/catalog/components/blur-in.md)
- [Motion Blur](/catalog/components/motion-blur.md)
