HyperFrames Animation
Das gesamte Bewegungs-Wissen in einem Skill: Regeln (atomare Rezepte), Blueprints (mehrphasige Szenenvorlagen), Übergänge (Szene-zu-Szene), Techniken (breitere Motion-Design-Muster) und Adapter (pro Laufzeit-APIs).
Für den Kompositionsvertrag (Datenattribute, Unterkompositionen, Determinismus) siehe hyperframes-core.
Standard: Atomare Regeln kombinieren
Wählen Sie 2-4 Regeln aus rules-index.md, fügen Sie sie mit einer einzigen pausierten GSAP-Timeline zusammen – fertig. Das ist schneller und erzeugt weniger Code, als mit einem Blueprint zu beginnen.
Ein Blueprint laden, wenn
- Die Szene zu einer vorhandenen vordefinierten mehrphasigen Vorlage passt (z. B. Markenenthüllung, Social-Proof, Demo-Seiten-Scroll-Spotlight) und die Wiederverwendung ihrer Phasen-Pipeline echte Autorenzeit spart
- Sie ausführbaren, verlässlichen Code für eine komplexe 4-5-phasige Choreografie benötigen
Blueprints befinden sich in blueprints-index.md. Jeder Eintrag verweist auf blueprints/<id>.md (Rezept) und examples/<id>.html (ausführbares Beispiel). Lesen Sie es nicht spekulativ; laden Sie es erst, wenn Sie bereits entschieden haben, dass Sie eine Szenen-Orchestrierung benötigen.
Navigation
| Sie möchten... | 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 eines Blueprints lesen | blueprints/<id>.md + examples/<id>.html |
| Einen Szenenübergang (CSS-gesteuert, zwischen zwei Clips) erstellen | 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 Effektrezepte | rules/gsap-effects.md |
| GSAP — Transformationen / Performance | adapters/gsap-transforms-and-perf.md |
| GSAP — Easings / Staffelung | 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-Suche) | 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 über externen 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 Staffelung ab. Alle atomaren Regeln in diesem Skill basieren auf GSAP.
- Lottie wenn ein Asset seine eigene vorgefertigte Timeline hat (typischerweise 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 – keine JavaScript-Animationskosten.
- WAAPI für native Browser-Keyframes ohne GSAP-Abhängigkeit.
- TypeGPU / WebGPU für GPU-gerenderte Canvases (Partikel, flüssiges Glas, benutzerdefinierte Shader).
Mehrere Laufzeiten können in einer Komposition koexistieren. Jede registriert ihre Instanzen auf dem laufzeitspezifischen Global, sodass HyperFrames alle in einem Durchlauf suchen kann.
Kritische Einschränkungen
Voraussetzung: hyperframes-core → Unverhandelbare Regeln (einzelne pausierte Timeline, data-duration regelt die Länge, kein Math.random / Date.now / performance.now, kein repeat: -1, kein gsap.set auf Clips späterer Szenen, keine display/visibility-Animation, kein Timeline-Aufbau innerhalb von async / setTimeout / Promise). Hier nicht wiederholt.
Animationshandwerkliche Ergänzungen zum Kernvertrag:
- Vorberechnete Layout-Konstanten — Positionen niemals zur Tween-Zeit von
getBoundingClientRect()ableiten. Tween-Zeit-DOM-Messungen desynchronisieren, weil der Renderer parallel sampelt; Koordinaten einmal beim Kompositionsaufbau berechnen und wiederverwenden. - Räumliche Bewegungen nutzen ausschließlich GSAP-Transform-Aliase (
x,y,scale,rotation). Die Zulassungsliste des Kerns 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, sampelt Bounding-Boxen, berechnet Flags und gibt animation-map.json aus. Verwenden Sie es, um die Choreografie nach dem Erstellen zu prüfen (Totzonen, Staffelungskonsistenz, Lebenszyklus-Warnungen).
Siehe auch
hyperframes-core— Kompositionsstruktur, Datenattribute, Unterkompositionen, deterministischer Render-Vertraghyperframes-creative— Paletten, Typografie, Erzählung, Beat-Planung (nicht-animationsbezogene kreative Ausrichtung)hyperframes-cli—npx hyperframes lint / validate / inspect / preview / render