HyperFrames Animation
Das gesamte Bewegungs-Wissen in einem Skill: Regeln (atomare Rezepte), Blaupausen (mehrphasige Szenenvorlagen), Übergänge (Szene-zu-Szene), Techniken (allgemeine Motion-Design-Muster) und Adapter (pro Laufzeit-APIs).
Für den Kompositionsvertrag (Datenattribute, Unterkompositionen, Determiniertheit) siehe hyperframes-core.
Standard: Atomare Regeln komponieren
Wähle 2-4 Regeln aus rules-index.md aus, verklebe sie mit einer einzigen pausierten GSAP-Timeline – fertig. Das ist schneller und erzeugt weniger Code als der Start mit einer Blaupause.
Blaupause laden, wenn
- Die Szene zu einer vorhandenen, vordefinierten mehrphasigen Vorlage passt (Marken-Enthüllung, Social Proof usw.) und die Wiederverwendung ihrer Phasen-Pipeline echte Erstellungszeit spart
- Du ausführbaren Referenzcode für eine komplexe 4-5-phasige Choreografie haben möchtest
Blaupausen befinden sich in blueprints-index.md. Jeder Eintrag verweist auf blueprints/<id>.md (Rezept). Lies sie nicht spekulativ; lade sie, wenn du bereits entschieden hast, dass du eine Szenen-Orchestrierung benötigst.
Routing
| 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 (CSS-gesteuert, zwischen zwei Clips) erstellen | transitions/overview.md, transitions/catalog.md |
| Eine allgemeine 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 — Transformationen / Performance | adapters/gsap-transforms-and-perf.md |
| GSAP — Easings / Staffeln (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-Suche) | 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 externem animate-text Skill) | adapters/animate-text.md |
Laufzeit auswählen
- GSAP ist der Standard für 95% der Bewegungsarbeit – deckt Timeline-Orchestrierung, Transformationen, Easings, Staffeln 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, Kamerafahrten, shadergetriebene Grafiken.
- Anime.js für leichtgewichtiges Tweens, 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 Canvase (Partikel, Flüssigglas, benutzerdefinierte Shader).
Mehrere Laufzeiten können in einer Komposition gleichzeitig existieren. Jede registriert ihre Instanzen in der laufzeitspezifischen globalen Variable, sodass HyperFrames alle in einem Durchlauf ansteuern 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 display / visibility Animation, kein Timeline-Aufbau innerhalb von async / setTimeout / Promise). Hier nicht wiederholen.
Ergänzungen für die Animations-Craft aufbauend auf dem Kernvertrag:
- Vorberechnete Layout-Konstanten – niemals Positionen zur Tween-Zeit von
getBoundingClientRect()ableiten. Tween-Zeit-DOM-Messungen desynchronisieren, weil der Renderer parallel sampelt; Koordinaten einmal beim Einrichten der Komposition berechnen und wiederverwenden. - Räumliche Bewegung verwendet nur GSAP-Transformations-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 Begrenzungsrahmen, berechnet Flags, gibt animation-map.json aus. Verwende es, um nach der Erstellung die Choreografie zu überprüfen (tote Zonen, Staffelungskonsistenz, Lebenszykluswarnungen).
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