HyperFrames-Animation
Sämtliches Bewegungs-Wissen in einem Skill: Regeln (atomare Rezepte), Blaupausen (mehrphasige Szenenvorlagen), Übergänge (Szene-zu-Szene), Techniken (breitere Motion-Design-Muster) und Adapter (laufzeitspezifische APIs).
Den Kompositionsvertrag (Datenattribute, Unterkompositionen, Determiniertheit) finden Sie in hyperframes-core.
Standard: Atomare Regeln komponieren
Wählen Sie 2–4 Regeln aus rules-index.md, setzen Sie diese auf einer einzigen pausierten GSAP-Timeline zusammen – fertig. Dies ist schneller und erzeugt weniger Code als der Start mit einer Blaupause.
Eine Blaupause laden, wenn
- Die Szene einer vorhandenen vorgefertigten mehrphasigen Vorlage (Marken-Reveal, Social Proof usw.) entspricht und die Wiederverwendung der Phasen-Pipeline die Autorenzeit spürbar verkürzt.
- Sie ausführbaren Ground-Truth-Code für eine komplexe 4–5-phasige Choreografie benötigen.
Blaupausen leben in blueprints-index.md. Jeder Eintrag verweist auf blueprints/<id>.md (Rezept). Lesen Sie diese Datei nicht spekulativ; laden Sie sie erst, wenn Sie bereits entschieden haben, dass Sie eine Szenen-Orchestrierung benötigen.
Navigation
| Ziel | Lesen |
|---|---|
| Ein atomares Bewegungsmuster nach Trigger / 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 (CSS-gesteuert, zwischen zwei Clips) verfassen | transitions/overview.md, transitions/catalog.md |
| Eine breitere Motion-Design-Technik nachschlagen | techniques.md |
| Die Animationskarte einer vorhandenen Komposition analysieren | scripts/animation-map.mjs |
| GSAP-API – Timeline / Tweens / Positionsparameter | adapters/gsap.md |
| GSAP – Fertige Effekt-Rezepte | rules/gsap-effects.md |
| GSAP – Transformationen / Performance | adapters/gsap-transforms-and-perf.md |
| GSAP – Easing / Ruckeln | 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 |
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-FX (Live-DOM via drawElementImage erfassen) | adapters/html-in-canvas-patterns.md |
Benannte Textanimationseffekte (24 IDs über externes animate-text-Skill) | adapters/animate-text.md |
Laufzeit auswählen
- GSAP ist der Standard für 95 % der Bewegungsarbeit – deckt Timeline-Orchestrierung, Transformationen, Easing und Ruckeln ab. Alle atomaren Regeln in diesem Skill basieren auf GSAP.
- Lottie, wenn ein Asset eine eigene vorgefertigte Timeline (typischerweise After Effects-Exporte) besitzt.
- Three.js für 3D-Szenen, Kamerafahrten, shadergetriebene Visuals.
- Anime.js für leichtes Tweening, wenn GSAP übertrieben ist.
- CSS für einfache, sich wiederholende Motive, Dekoration, Schimmer – keine JavaScript-Animationskosten.
- WAAPI für native Browser-Keyframes ohne GSAP-Abhängigkeit.
- TypeGPU / WebGPU für GPU-gerenderte Canvases (Partikel, Flüssigglas, eigene Shader).
Mehrere Laufzeiten können in einer Komposition koexistieren. Jede registriert ihre Instanzen auf dem laufzeitspezifischen globalen Objekt, sodass HyperFrames alle in einem Durchlauf suchen kann.
Kritische Einschränkungen
Voraussetzung: hyperframes-core → Nicht verhandelbare Regeln (Einzige pausierte Timeline, data-duration bestimmt Länge, kein Math.random / Date.now / performance.now, kein repeat: -1, kein gsap.set auf späteren Szenen-Clips, keine display-/visibility-Animation, kein Timeline-Aufbau innerhalb von async / setTimeout / Promise). Diese werden hier nicht wiederholt.
Zusätzliche Animations-Anforderungen zum Kernvertrag:
- Vorberechnete Layout-Konstanten – Positionen niemals aus
getBoundingClientRect()zur Tween-Zeit ableiten. DOM-Messungen zur Tween-Zeit desynchronisieren, da der Renderer parallel abtastet; Koordinaten einmal beim Kompositions-Setup berechnen und wiederverwenden. - Räumliche Bewegungen verwenden ausschließlich GSAP-Transform-Alias (
x,y,scale,rotation). Die Zulassungsliste des Kerns erlaubt auchopacity/color/backgroundColor/borderRadiusfür nicht-räumliche Eigenschaft-Tweens – aber niemalswidth/height/top/leftfür Layout-Änderungen.
Skripte
node skills/hyperframes-animation/scripts/animation-map.mjs <composition-verzeichnis> \
--out <composition-verzeichnis>/.hyperframes/anim-map
Liest jede auf window.__timelines registrierte GSAP-Timeline, listet Tweens auf, tastet Bounding-Boxen ab, berechnet Flags und gibt animation-map.json aus. Verwenden Sie es, um die Choreografie zu überprüfen (tote Zonen, Ruckel-Konsistenz, Lebenszyklus-Warnungen) nach der Erstellung.
Siehe auch
hyperframes-core– Kompositionsstruktur, Datenattribute, Unterkompositionen, deterministischer Rendervertraghyperframes-creative– Paletten, Typografie, Erzählung, Beat-Planung (Nicht-Animations-Kreativdirektion)hyperframes-cli–npx hyperframes lint / validate / inspect / preview / render