Files
hyperframes/docs/primitives/halftone-dissolve.mdx
T
Miguel Angel Simon Sierra bb912587b9 feat(primitives): add 25 video primitives, live docs pages, and the catalog retrieval eval
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.
2026-07-31 12:27:41 +02:00

44 lines
1.4 KiB
Plaintext

---
title: "Halftone Dissolve"
description: "Accent dots appear on a fixed grid, open into windows onto scene B, and merge until scene B replaces scene A."
---
import { PrimitivePlayer } from "/snippets/PrimitivePlayer.jsx";
<span className="hf-primitive-eyebrow">Transitions</span>
<PrimitivePlayer name="halftone-dissolve" width={1920} height={1080} />
## Variables
| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `dot_size` | `enum` | `medium` | Grid pitch for the halftone field. |
| `direction` | `enum` | `ltr` | Threshold ordering: ltr sweeps left to right, center grows from the middle, noise scatters. |
| `dissolve_at` | `number` | `1.1` | Seconds from mount start when the dissolve begins. |
| `accent` | `enum` | `green` | Ink dot color: green rides --brand, blue rides --accent, violet rides --accent-2. |
| `exit` | `enum` | `none` | Optional departure. Default none: scene B holds until the frame cuts. |
## When to use it
Two slotted scenes need a textured transition whose reveal can sweep left to right, grow from center, or scatter from a seeded map.
## When to avoid it
Avoid cueing the dissolve so late that its 1.3-second transition and any exit cannot fit, because dissolve_at is clamped to keep both inside the clip.
## Pairs with
- [grade-split-reveal](/primitives/grade-split-reveal)
- [match-cut](/primitives/match-cut)
## Install
<CodeGroup>
```bash Terminal
npx hyperframes add halftone-dissolve
```
</CodeGroup>