HyperFrames Animation
Das gesamte Bewegungs-Know-how in einer Skill: Regeln (atomare Rezepte), Blaupausen (mehrphasige Szenenvorlagen), Übergänge (Szene-zu-Szene), Techniken (allgemeine Motion-Design-Muster) und Adapter (pro-Laufzeit-APIs).
Für den Kompositionsvertrag (Datenattribute, Subkompositionen, Determiniertheit) siehe hyperframes-core.
Standard: Atomare Regeln kombinieren
Wähle 2-4 Regeln aus rules-index.md, verknüpfe sie mit einer einzigen pausierten GSAP-Timeline – fertig. Das ist schneller und erzeugt weniger Code als der Einstieg über eine Blaupause.
Blaupause laden, wenn
- Die Szene zu einer vorhandenen, vorgefertigten mehrphasigen Vorlage passt (Marken-Enthüllung, Social-Proof usw.) und die Wiederverwendung ihrer Phasen-Pipeline echte Autorenzeit spart.
- Du ausführbaren Grundwahrheits-Code für eine komplexe 4-5-Phasen-Choreografie benötigst.
Blaupausen befinden sich in blueprints-index.md. Jeder Eintrag verweist auf blueprints/<id>.md (Rezept). Lies sie nicht spekulativ; lade sie erst, wenn du bereits entschieden hast, dass du eine szenenweite Orchestrierung benötigst.
Routenplanung
| Möchtest du… | Lese |
|---|---|
| Ein atomares Bewegungsmuster nach Auslöser/Tag auswählen | rules-index.md |
| Das vollständige HTML-/CSS-/GSAP-Rezept einer Regel lesen | rules/<name>.md |
| Eine mehrphasige Szenenvorlage auswählen | blueprints-index.md |
| Das vollständige Rezept einer Blaupause lesen | blueprints/<id>.md |
| Einen Szenenübergang schreiben (CSS-gesteuert, zwischen zwei Clips) | transitions/overview.md, transitions/catalog.md |
| Eine allgemeine Motion-Design-Technik nachschlagen | techniques.md |
| Bewegungsunschärfe – Verschlussschlieren auf einem Element (und wann nicht) | references/motion-blur.md |
| Die Animationskarte einer bestehenden Komposition analysieren | scripts/animation-map.mjs |
| GSAP-API – Timeline / Tweens / Positionsparameter | adapters/gsap.md |
| GSAP – einsatzbereite Effektrezepte | rules/gsap-effects.md |
| GSAP – Transformationen / Performance | adapters/gsap-transforms-and-perf.md |
| GSAP – Easing / Stagger | adapters/gsap-easing-and-stagger.md |
| GSAP – Timeline / Labels | adapters/gsap-timeline-and-labels.md |
Lottie / dotLottie (After Effects-Exporte, window.__hfLottie) | adapters/lottie.md |
| Character-Animation (Gehzyklus, Maskottchen, Gelenkpuppe, Gesten) | adapters/lottie.md → Charaktere |
Three.js / WebGL (3D-Szenen, AnimationMixer, hf-seek) | adapters/three.md |
Anime.js (window.__hfAnime) | adapters/animejs.md |
CSS-Keyframes (animation-delay / play-state / fill-mode) | adapters/css-animations.md |
Web Animations API (element.animate(), currentTime Seek) | adapters/waapi.md |
TypeGPU / WebGPU (navigator.gpu, WGSL, Compute-Pipelines) | adapters/typegpu.md |
HTML-als-Textur + WebGL/GLSL-Post-Effekte (Live-DOM via drawElementImage erfassen) | adapters/html-in-canvas-patterns.md |
Benannte Textanimationseffekte (24 IDs via externe animate-text-Skill) | adapters/animate-text.md |
Auswahl einer Laufzeit
- GSAP ist die Standardlaufzeit für 95 % der Bewegungsarbeit – deckt Timeline-Orchestrierung, Transformationen, Easing und Stagger ab. Alle atomaren Regeln in dieser Skill basieren auf GSAP.
- Lottie wenn ein Asset eine eigene vorgefertigte Timeline hat (typischerweise After Effects-Exporte), einschließlich Charakteren, die laufen, gestikulieren oder reagieren.
- Three.js für 3D-Szenen, Kamerabewegungen, shaderbasierte Visuals.
- Anime.js für leichtes Tweening, wenn GSAP überdimensioniert ist.
- CSS für einfache, wiederholte Motive, Dekoration, Schimmer – keine JavaScript-Animationskosten.
- WAAPI für native Browser-Keyframes ohne GSAP-Abhängigkeit.
- TypeGPU / WebGPU für GPU-gerenderte Canvase (Partikel, flüssiges Glas, benutzerdefinierte Shader).
Mehrere Laufzeiten können in einer Komposition koexistieren. Jede registriert ihre Instanzen im laufzeitspezifischen Global, sodass HyperFrames alle in einem Durchlauf suchen kann.
Kritische Einschränkungen
Voraussetzung: hyperframes-core → Nicht verhandelbare Regeln (einzelne pausierte Timeline, data-duration bestimmt die Länge, kein Math.random / Date.now / performance.now, kein repeat: -1, kein gsap.set beim Seitenladen auf Clips späterer Szenen, keine display- oder rohen visibility-Tweens und kein Timeline-Aufbau innerhalb von async / setTimeout / Promise). GSAP autoAlpha und null-dauernde Sichtbarkeitssetzungen an expliziten Timeline-Grenzen bleiben vom Kern erlaubt. Verwende diese Ausnahmen nur auf Nicht-Clip-Elementen oder Wrappern innerhalb eines Clips; das Framework besitzt den .clip-Lebenszyklus. Wiederhole hier nicht den vollständigen Vertrag.
Zusätzliche Regeln für die Animationsgestaltung, die über den Kernvertrag hinausgehen:
- Vorberechnete Layout-Konstanten – leite Positionen niemals zur Tween-Zeit aus
getBoundingClientRect()ab. DOM-Messungen zur Tween-Zeit desynchronisieren, weil der Renderer parallel abtastet; berechne Koordinaten einmal beim Kompositions-Setup und verwende sie wieder. - Räumliche Bewegung verwendet nur GSAP-Transformations-Aliasnamen (
x,y,scale,rotation). Die Zulassungsliste des Kerns erlaubt auchopacity/color/backgroundColor/borderRadiusfür nicht-räumliche Property-Tweens – aber niemalswidth/height/top/leftfür Layout-Änderungen.
Skripte
node skills/hyperframes-animation/scripts/animation-map.mjs <composition-dir> \
--out <composition-dir>/.hyperframes/anim-map
Liest jede auf window.__timelines registrierte GSAP-Timeline, zählt Tweens auf, mustert Bboxes, berechnet Flags und gibt animation-map.json aus. Verwende es zur Überprüfung der Choreografie (Dead Zones, Stagger-Konsistenz, Lebenszyklus-Warnungen) nach der Autorenarbeit.
animation-map.mjs sucht zuerst nach Hilfspaketen im aktuellen Projekt und kann dann die gebündelte HyperFrames-Paketversion starten. Setze HYPERFRAMES_SKILL_PKG_VERSION=<version> nur, wenn die Skill außerhalb der gebündelten CLI/Skill-Installation ausgeführt wird und du diese Bootstrap-Version explizit festlegen möchtest.
Siehe auch
hyperframes-core– Kompositionsstruktur, Datenattribute, Subkompositionen, deterministischer Rendering-Vertraghyperframes-creative– Paletten, Typografie, Storytelling, Beat-Planung (nicht-animatorische kreative Richtung)hyperframes-cli–npx hyperframes lint / check / snapshot / preview / render