Was macht HyperFrames Animation?
Sämtliches Bewegungswissen in einem Skill: Regeln (atomare Rezepte), Blaupausen (mehrphasige Szenenvorlagen), Übergänge (Szene-zu-Szene), Techniken (übergeordnete Motion-Design-Muster) und Adapter (pro Laufzeit-API).
Informationen zum Kompositionsvertrag (Datenattribute, Unterkompositionen, Determinismus) finden Sie in hyperframes-core.
Standard: Atomare Regeln zusammensetzen
Wählen Sie 2-4 Regeln aus rules-index.md aus, verketten Sie sie 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 einer vorhandenen vordefinierten mehrphasigen Vorlage entspricht (Marken-Enthüllung, sozialer Beweis usw.) und die Wiederverwendung ihrer Phasen-Pipeline echte Authoring-Zeit spart.
- Sie ausführbaren, referenzierbaren Code für eine komplexe Choreografie mit 4-5 Phasen benötigen.
Blaupausen befinden sich in blueprints-index.md. Jeder Eintrag verweist auf blueprints/<id>.md (Rezept). Lesen Sie diese nicht spekulativ; laden Sie sie erst, wenn Sie sich bereits für eine szenenübergreifende Orchestrierung entschieden haben.
Routing
| Gewünschte Aktion | Lesen |
|---|---|
| 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 übergeordnete Motion-Design-Technik nachschlagen | techniques.md |
| Die Animationskarte einer bestehenden Komposition analysieren | scripts/animation-map.mjs |
| GSAP-API – Timeline / Tweens / Positionsparameter | adapters/gsap.md |
| GSAP – fertige Effekt-Rezepte | rules/gsap-effects.md |
| GSAP – Transforms / 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-Postfx (Live-DOM via drawElementImage erfassen) | adapters/html-in-canvas-patterns.md |
Benannte Textanimationseffekte (24 IDs via externes animate-text-Skill) | adapters/animate-text.md |
Laufzeit auswählen
- GSAP ist der Standard für 95 % der Bewegungsarbeit – deckt Timeline-Orchestrierung, Transformationen, Easings und Stagger ab. Alle atomaren Regeln in diesem Skill basieren auf GSAP.
- Lottie wenn ein Asset eine eigene vorgefertigte Timeline besitzt (normalerweise After Effects-Exporte).
- Three.js für 3D-Szenen, Kamerabewegungen, shader-gesteuerte Visuals.
- Anime.js für leichtgewichtiges Tweening, wenn GSAP übertrieben ist.
- CSS für einfache wiederholte Motive, Dekoration, Schimmer – kein JavaScript-Animation-Overhead.
- WAAPI für native Browser-Keyframes ohne GSAP-Abhängigkeit.
- TypeGPU / WebGPU für GPU-gerenderte Canvaselemente (Partikel, Flüssigglas, benutzerdefinierte Shader).
Mehrere Laufzeiten können in einer Komposition koexistieren. Jede registriert ihre Instanzen auf dem laufzeitspezifischen Global-Objekt, sodass HyperFrames alle in einem Durchlauf suchen kann.
Kritische Einschränkungen
Voraussetzung: hyperframes-core → Nicht verhandelbare Regeln (Single Paused Timeline, data-duration bestimmt die Länge, kein Math.random / Date.now / performance.now, kein repeat: -1, kein gsap.set auf späteren Szenen-Clips, keine display-/visibility-Animation, keine Timeline-Konstruktion innerhalb von async / setTimeout / Promise). Diese werden hier nicht wiederholt.
Zusätzliche Animationsregeln, die über den Vertrag von Core hinausgehen:
- Vorberechnete Layout-Konstanten – leiten Sie Positionen niemals zur Tween-Zeit aus
getBoundingClientRect()ab. DOM-Messungen zur Tween-Zeit desynchronisieren, weil der Renderer parallel abtastet; berechnen Sie Koordinaten einmalig beim Einrichten der Komposition und verwenden Sie sie wieder. - Räumliche Bewegungen verwenden ausschließlich GSAP-Transform-Aliasnamen (
x,y,scale,rotation). Die Whitelist von Core erlaubt auchopacity/color/backgroundColor/borderRadiusfür nicht-räumliche Eigenschafts-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, tastet Bounding-Boxen ab, berechnet Flags und gibt animation-map.json aus. Verwenden Sie es, um die Choreografie nach dem Authoring zu prüfen (Totzonen, Stagger-Konsistenz, Lebenszyklus-Warnungen).
Siehe auch
hyperframes-core– Kompositionsstruktur, Datenattribute, Unterkompositionen, deterministischer Render-Vertraghyperframes-creative– Paletten, Typografie, Erzählung, Beat-Planung (nicht-animatorische kreative Richtung)hyperframes-cli–npx hyperframes lint / validate / inspect / preview / render