Communitygithub.com

szeproka/hyperframes-registry

Blätter streichen durch das Bild und teilen sich, um die Überschrift zu enthüllen. HyperFrames-Block, 1920×1080, 12 s, 11 Variablen.

Was ist hyperframes-registry?

Diese HyperFrames-Komposition 'Canopy Part Title' erzeugt eine 12-sekündige, variable Animation, bei der ein dichtes Blätterdach mit geringer Schärfentiefe über den Bildschirm streicht und sich dann teilt, um zwei aufeinanderfolgende Überschriften zu enthüllen. Die Komposition ist ideal für Titelsequenzen, Übergänge oder heroische Bühnen, die einen natürlichen, sich bewegenden Vorhangeffekt erfordern. Sie unterstützt die Anpassung von Schriftart, Schriftstärke, Schriftgröße, Buchstabenabstand, Anzahl der blätternden Wellen, Geschwindigkeit des Streifens und verbleibenden Blättern, die eine sanfte Brise beibehalten. Entwickler können die Komposition über `npx hyperframes add canopy-part-title` in ihr Projekt einbinden und die Variablen per Kommandozeile oder HTML-Datenattribut setzen. Die Laufzeitumgebung nutzt three.js und GSAP, wobei jeder Einzelbild eine deterministische Funktion der Zeit ist, was robustes Suchen und Rendern ermöglicht. Die Komposition ist zwar mit HyperFrames/Studio kompatibel, jedoch wird davon abgeraten, `data-composition-variables` über das Design-Panel zu speichern.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/szeproka/hyperframes-registry/tree/HEAD/registry/blocks/canopy-part-title

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Canopy Part Title

Ein dichtes Blätterdach aus strukturierten Blättern streicht mit geringer Schärfentiefe über das Bild, teilt sich dann und gibt die erste Überschrift frei; eine zweite, in der Tiefe angehobene Gruppe trägt die zweite Überschrift an der Kamera vorbei. Einige Blätter bleiben auf dem Titel zurück und erzeugen eine leichte Brise. Schriftart, Schriftstärke, Schriftgröße, Buchstabenabstand, Blattanzahl, Streichgeschwindigkeit und der verbleibende Blätterwind sind variabel.

Kompositions-ID: canopy-part-title. Dauer 12 s bei 30 fps, 1920×1080.

Dateien

  • canopy-part-title.html (57 KB)
  • assets/leaf-surface-color.webp (64 KB)
  • assets/leaf-surface-normal.webp (136 KB)

Installation

Installieren mit npx hyperframes add canopy-part-title; standardmäßig landen die obigen Dateien unter compositions/canopy-part-title/. Anschließend den Block aus der Host-index.html einbinden:

<div
  data-composition-id="canopy-part-title"
  data-composition-src="compositions/canopy-part-title/canopy-part-title.html"
  data-start="0"
  data-duration="12"
  data-track-index="1"
  data-width="1920"
  data-height="1080"
></div>

Mit benutzerdefinierten Werten rendern, indem Sie direkt auf die Kompositionsdatei zielen:

npx --yes [email protected] render 'compositions/canopy-part-title/canopy-part-title.html' --variables '{"headline1":"Unterholz","headline2":"Langsam bewegen"}'

Variablen

Wird zur Laufzeit über window.__hyperframes.getVariables() ausgelesen; auf der Kompositionswurzel als data-composition-variables deklariert (Attribut in einfachen Anführungszeichen, reines JSON).

idtypstandardbezeichnung / bereich
headline1string"Unterholz"Überschrift 1
headline2string"Langsam bewegen"Überschrift 2
fontstring"Helvetica"Überschrift-Schriftart
fontWeightnumber900Schriftstärke 100–900 Schritt 100
fontSizenumber1Schriftgröße (1 = auto-fit) 0,3–2 Schritt 0,01
letterSpacingnumber0,01Buchstabenabstand (em) -0,2–1 Schritt 0,01
backgroundcolor"#020805"Hintergrund
leafCountnumber170Blätter pro Welle 40–320 Schritt 1
stayCountnumber5Zurückgelassene Blätter 0–20 Schritt 1
sweepSpeednumber1Streichgeschwindigkeit 0,3–3 Schritt 0,05
retainedBreezenumber1Verbleibender Blätterwind 0–2 Schritt 0,05

Laufzeitvertrag

  • Eine pausierte GSAP-Timeline registriert als window.__timelines["canopy-part-title"].
  • Resynchronisiert beim hf-seek CustomEvent; jedes Bild ist eine geschlossene Funktion der Zeit (nur gesäter PRNG, keine rAF-Schleifen, kein Date.now).
  • Renderer: three.js 0.170.0, GSAP 3.14.2, Canvas 2D, Post-Processing, gesäter PRNG, Schattenkarten. Budget etwa 350 MB pro Live-Instanz; jeweils nur eine ausführen.
  • Externe Laufzeitabhängigkeiten: https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js, https://cdn.jsdelivr.net/npm/[email protected]/build/three.module.js, https://cdn.jsdelivr.net/npm/[email protected]/examples/jsm/postprocessing/EffectComposer.js, https://cdn.jsdelivr.net/npm/[email protected]/examples/jsm/postprocessing/RenderPass.js, https://cdn.jsdelivr.net/npm/[email protected]/examples/jsm/postprocessing/BokehPass.js.
  • Webfonts von Google Fonts: Gelasio.

Bearbeitungsregeln (aus dem Quellprojekt)

  1. data-composition-variables als Attribut in einfachen Anführungszeichen mit einfachem JSON (") belassen. Niemals über das Design-Panel von Studio speichern.
  2. <canvas> nicht in statisches Markup setzen; zur Laufzeit erstellen.
  3. Jeden visuellen Zustand als Funktion von t beibehalten; Seek-Sicherheit macht den Block renderbar.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Verwandte Skills