mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-15 13:58:20 +00:00
Miguel Angel Simon Sierra
bb912587b9
Adds the 25 video primitive compositions and their generated Mintlify pages. Each page embeds a live <hyperframes-player> preview with editable composition variables rather than a rendered MP4. Adds the catalog-browsing eval under evals/catalog-retrieval: a 424-entry shelf built from HEAD, nine retrieval conditions (no-catalog control, full read, lexical, semantic, and hybrid across several values of k), a brief generator that constructs each brief from a known target, a blind three-pass gold validation committee, and a mechanical scorer that keeps mountable and fit as two separate numbers. The eval vendors its own shelf, primitive sources, and preview list instead of reading them from an ignored working directory, so the shelf regenerates byte for byte from a clean checkout. Derived artifacts stay out: the embedding cache and the run checkpoints are regenerated rather than committed, so no run can score against a stale copy of either. Lint ignores now cover vendored minified player bundles by pattern instead of one path at a time.
44 lines
1.4 KiB
Plaintext
44 lines
1.4 KiB
Plaintext
---
|
|
title: "Echo Trail"
|
|
description: "A slotted subject travels along an authored path with lagged ghost copies that collapse into it and disappear at rest."
|
|
---
|
|
|
|
import { PrimitivePlayer } from "/snippets/PrimitivePlayer.jsx";
|
|
|
|
<span className="hf-primitive-eyebrow">Motion trails</span>
|
|
|
|
<PrimitivePlayer name="echo-trail" width={1920} height={1080} />
|
|
|
|
## Variables
|
|
|
|
| Name | Type | Default | Description |
|
|
| --- | --- | --- | --- |
|
|
| `echoes` | `number` | `4` | Ghost copy count, clamped 2 to 6. |
|
|
| `delta` | `number` | `0.09` | Lag between successive ghosts in seconds, clamped 0.03 to 0.3. |
|
|
| `path` | `enum` | `sweep` | Authored traversal preset. |
|
|
| `accent` | `enum` | `green` | Subject accent color: green rides --brand, blue rides --accent, violet rides --accent-2. |
|
|
| `exit` | `enum` | `none` | Optional departure. Default none: the settled element holds until the frame cuts. |
|
|
|
|
## When to use it
|
|
|
|
One moving subject needs an onion-skin trail that shows its recent positions before a clean landing.
|
|
|
|
## When to avoid it
|
|
|
|
Avoid it when more than six ghosts or a lag outside 0.03 to 0.3 seconds is required, because echoes are limited to 2 through 6 and delta is clamped to that range.
|
|
|
|
## Pairs with
|
|
|
|
- [particle-text-dissolve](/primitives/particle-text-dissolve)
|
|
- [orbit-ring-camera](/primitives/orbit-ring-camera)
|
|
|
|
## Install
|
|
|
|
<CodeGroup>
|
|
|
|
```bash Terminal
|
|
npx hyperframes add echo-trail
|
|
```
|
|
|
|
</CodeGroup>
|