Was macht HyperFrames Animation?
Alles Bewegungs- und Animationswissen in einer Fähigkeit: Regeln (atomare Rezepte), Blaupausen (mehrphasige Szenenvorlagen), Übergänge (von Szene zu Szene), Techniken (allgemeine Motion-Design-Muster) und Adapter (runtime-spezifische APIs).
Informationen zum Kompositionsvertrag (Datenattribute, Unterkompositionen, Deterministrik) findest du unter hyperframes-core.
Standard: atomare Regeln zusammensetzen
Wähle 2-4 Regeln aus rules-index.md, verbinde sie mit einer einzigen pausierten GSAP-Timeline – fertig. Dies ist schneller und erzeugt weniger Code als der Start mit einer Blaupause.
Lade eine Blaupause, wenn
- Die Szene zu einer bestehenden, vordefinierten mehrphasigen Vorlage passt (Marken-Enthüllung, Social Proof usw.) und die Wiederverwendung ihrer Phasen-Pipeline echte Autorenzeit spart.
- Du ausführbaren Ground-Truth-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 nur, wenn du bereits entschieden hast, dass du eine szenenweite Orchestrierung benötigst.
Navigation
| Gewünschte Aktion… | Lies |
|---|---|
| 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 verfassen (CSS-gesteuert, zwischen zwei Clips) | transitions/overview.md, transitions/catalog.md |
| Eine allgemeine Motion-Design-Technik nachschlagen | techniques.md |
| Die Animationszuordnung einer bestehenden Komposition analysieren | scripts/animation-map.mjs |
| GSAP-API – Timeline / Tweens / Positionsparameter | adapters/gsap.md |
| GSAP – gebrauchsfertige Effekt-Rezepte | rules/gsap-effects.md |
| GSAP – Transformationen / Performance | adapters/gsap-transforms-and-perf.md |
| GSAP – Easings / 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) | adapters/html-in-canvas-patterns.md |
Benannte Text-Animationseffekte (24 IDs, via externe animate-text-Fähigkeit) | adapters/animate-text.md |
Auswahl einer Laufzeit
- GSAP ist der Standard für 95 % der Bewegungsarbeit – deckt Timeline-Orchestrierung, Transformationen, Easing und Stagger 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, Kamerabewegungen, shader-gesteuerte Bilder.
- Anime.js für leichtgewichtiges Tweening, wenn GSAP übertrieben wäre.
- 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 nebeneinander existieren. Jede registriert ihre Instanzen auf dem runtime-spezifischen 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 auf Clips späterer Szenen, keine Animation von display / visibility, kein Timeline-Aufbau innerhalb von async / setTimeout / Promise). Diese werden hier nicht wiederholt.
Zusätzliche Animations-Richtlinien über der Kernvereinbarung:
- Vorberechnete Layout-Konstanten – Positionen niemals zur Tween-Zeit aus
getBoundingClientRect()ableiten. Tween-Zeit-DOM-Messungen desynchronisieren, weil der Renderer parallel abtastet; Koordinaten einmal beim Kompositions-Setup berechnen und wiederverwenden. - Räumliche Bewegungen verwenden ausschließlich GSAP-Transform-Aliase (
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 <compositions-verzeichnis> \
--out <compositions-verzeichnis>/.hyperframes/anim-map
Liest jede auf window.__timelines registrierte GSAP-Timeline, zählt Tweens auf, sampelt Bounding-Boxen, berechnet Flags und gibt animation-map.json aus. Verwende es, um die Choreografie zu prüfen (tote Zonen, Stagger-Konsistenz, Lebenszyklus-Warnungen) nach dem Erstellen.
Siehe auch
hyperframes-core– Kompositionsstruktur, Datenattribute, Unterkompositionen, deterministischer Render-Vertraghyperframes-creative– Paletten, Typografie, Erzählung, Beat-Planung (nicht-Animation, kreative Richtung)hyperframes-cli–npx hyperframes lint / validate / inspect / preview / render