HyperFrames Animation
Das gesamte Bewegungs-Wissen in einer Fähigkeit: Regeln (atomare Rezepte), Blaupausen (mehrphasige Szenenvorlagen), Übergänge (Szene-zu-Szene), Techniken (breitere Motion-Design-Muster) und Adapter (pro Laufzeit-APIs).
Informationen zum Kompositionsvertrag (Datenattribute, Unterkompositionen, Determinismus) finden Sie unter hyperframes-core.
Standard: Atomare Regeln kombinieren
Wählen Sie 2–4 Regeln aus rules-index.md, verknüpfen Sie diese mit einer einzigen, pausierten GSAP-Timeline – fertig. Dies ist schneller und erzeugt weniger Code als mit einer Blaupause zu beginnen.
Blaupause laden, wenn
- Die Szene zu einer vorhandenen, vordefinierten mehrphasigen Vorlage passt (Marken-Enthüllung, Social Proof usw.) und die Wiederverwendung ihrer Phasen-Pipeline erhebliche Authoring-Zeit spart.
- Sie ausführbaren, verbindlichen Code für eine komplexe 4- bis 5-phasige Choreografie wünschen.
Blaupausen befinden sich in blueprints-index.md. Jeder Eintrag verweist auf blueprints/<id>.md (Rezept). Lesen Sie sie nicht spekulativ; laden Sie sie erst, wenn Sie sich für eine szenenübergreifende Orchestrierung entschieden haben.
Routingtabelle
| Sie möchten… | Lesen Sie |
|---|---|
| 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 erstellen (CSS-gesteuert, zwischen zwei Clips) | transitions/overview.md, transitions/catalog.md |
| Eine breitere Motion-Design-Technik nachschlagen | techniques.md |
| Die Animationszuordnung einer vorhandenen Komposition analysieren | scripts/animation-map.mjs |
| GSAP-API — Timeline / Tween / Positionsparameter | adapters/gsap.md |
| GSAP — Fertige Effekt-Rezepte | rules/gsap-effects.md |
| GSAP — Transformationen / Performance | adapters/gsap-transforms-and-perf.md |
| GSAP — Easing / Staffelung (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 |
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 via externe animate-text-Fähigkeit) | adapters/animate-text.md |
Laufzeit auswählen
- GSAP ist die Standardlaufzeit für 95 % der Bewegungsarbeit – deckt Timeline-Orchestrierung, Transformationen, Easing und Staffelung ab. Alle atomaren Regeln in dieser Fähigkeit basieren auf GSAP.
- Lottie, wenn ein Asset eine eigene vorgefertigte Timeline besitzt (typischerweise After Effects-Exporte).
- Three.js für 3D-Szenen, Kamerabewegung, shader-basierte Visuals.
- Anime.js für leichtgewichtige Tweening, wenn GSAP übertrieben ist.
- CSS für einfache, wiederkehrende Motive, Dekoration, Schimmer – kein JavaScript-Animation-Overhead.
- 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 auf der laufzeitspezifischen Globalen, sodass HyperFrames alle in einem Durchlauf suchen kann.
Kritische Einschränkungen
Voraussetzung: hyperframes-core → Unverhandelbare Regeln (einzelne pausierte Timeline, data-duration steuert die Länge, kein Math.random / Date.now / performance.now, kein repeat: -1, kein gsap.set auf Clips späterer Szenen, keine Animation von display / visibility, keine Timeline-Konstruktion innerhalb von async / setTimeout / Promise). Diese werden hier nicht wiederholt.
Zusätzliche Animationsregeln (über den Kernvertrag hinaus):
- Vorberechnete Layout-Konstanten – leiten Sie Positionen niemals zur Laufzeit aus
getBoundingClientRect()ab. Laufzeit-DOM-Messungen führen zu Desynchronisation, da der Renderer parallel abtastet; berechnen Sie Koordinaten einmal bei der Kompositionseinrichtung und verwenden Sie sie wieder. - Räumliche Bewegung verwendet ausschließlich GSAP-Transformations-Aliasnamen (
x,y,scale,rotation). Die Zulassungsliste des Kerns erlaubt auchopacity/color/backgroundColor/borderRadiusfür nicht-räumliche Eigenschafts-Tweening – jedoch 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, tastet Bounding-Boxen ab, berechnet Flags und gibt animation-map.json aus. Verwenden Sie es, um die Choreografie nach dem Authoring zu überprüfen (tote Zonen, Staffelungskonsistenz, Lebenszyklus-Warnungen).
Siehe auch
hyperframes-core— Kompositionsstruktur, Datenattribute, Unterkompositionen, deterministischer Render-Vertraghyperframes-creative— Paletten, Typografie, Erzählung, Beat-Planung (nicht-animationsbezogene kreative Richtung)hyperframes-cli—npx hyperframes lint / validate / inspect / preview / render