HyperFrames Animation
Das gesamte Bewegungs- und Animationswissen in einem Skill: Regeln (atomare Rezepte), Blaupausen (mehrphasige Szenenvorlagen), Übergänge (Szene-zu-Szene), Techniken (umfassendere Motion-Design-Muster) und Adapter (laufzeitspezifische APIs).
Für den Kompositionsvertrag (Datenattribute, Unterkompositionen, Determinismus) siehe hyperframes-core.
Standard: Atomare Regeln kombinieren
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 vorhandenen, vorgefertigten mehrphasigen Vorlage passt (Markenenthüllung, Social-Proof, Demo-Seiten-Scroll-Spotlight, usw.) und die Wiederverwendung ihrer Phasen-Pipeline echte Authoring-Zeit spart
- Du ausführbaren Ground-Truth-Code für eine komplexe 4-5-Phasen-Choreografie möchtest
Blaupausen befinden sich in blueprints-index.md. Jeder Eintrag verweist auf blueprints/<id>.md (Rezept) und examples/<id>.html (ausführbares Beispiel). Lies sie nicht spekulativ; lade sie erst, wenn du bereits entschieden hast, dass du eine Szenen-Orchestrierung benötigst.
Navigation
| Wenn du … | Dann lies |
|---|---|
| Ein atomares Bewegungsmuster nach Auslöser/Tag auswählen möchtest | rules-index.md |
| Das vollständige HTML/CSS/GSAP-Rezept einer Regel lesen möchtest | rules/<name>.md |
| Eine mehrphasige Szenenvorlage auswählen möchtest | blueprints-index.md |
| Das vollständige Rezept einer Blaupause lesen möchtest | blueprints/<id>.md + examples/<id>.html |
| Einen Szenenübergang erstellen möchtest (CSS-gesteuert, zwischen zwei Clips) | transitions/overview.md, transitions/catalog.md |
| Eine umfassendere Motion-Design-Technik nachschlagen möchtest | techniques.md |
| Die Animationszuordnung einer vorhandenen Komposition analysieren möchtest | scripts/animation-map.mjs |
| GSAP API – Timeline / Tweens / Positionsparameter | adapters/gsap.md |
| GSAP – integrierbare Effektrezepte | rules/gsap-effects.md |
| GSAP – Transformationen / Performance | adapters/gsap-transforms-and-perf.md |
| GSAP – Easing / 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 externem animate-text Skill) | 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 diesem Skill basieren auf GSAP.
- Lottie wenn ein Asset seine eigene vorgefertigte Timeline hat (normalerweise After Effects Exporte).
- Three.js für 3D-Szenen, Kamerabewegungen, Shader-gesteuerte Visuals.
- Anime.js für leichtgewichtige Tweens, wenn GSAP übertrieben ist.
- CSS für einfache, wiederholte Motive, Dekoration, Schimmer – kein JavaScript-Animationsaufwand.
- 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 koexistieren. Jede registriert ihre Instanzen im laufzeitspezifischen globalen Objekt, 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 display/visibility-Animation, kein Timeline-Aufbau innerhalb von async / setTimeout / Promise). Wiederhole diese hier nicht.
Zusätzliche Animationsanforderungen über den Kernvertrag hinaus:
- Vorberechnete Layout-Konstanten – leite Positionen niemals zur Tween-Zeit von
getBoundingClientRect()ab. DOM-Messungen während des Tweens desynchronisieren, da der Renderer parallel sampelt; berechne Koordinaten einmalig beim Kompositionsaufbau und verwende sie wieder. - Räumliche Bewegung verwendet nur GSAP-Transformationsaliase (
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. Verwende es, um die Choreografie nach dem Authoring zu prüfen (Totzonen, Stagger-Konsistenz, Lebenszyklus-Warnungen).
Siehe auch
hyperframes-core– Kompositionsstruktur, Datenattribute, Unterkompositionen, deterministischer Rendervertraghyperframes-creative– Paletten, Typografie, Erzählung, Taktplanung (Nicht-Animations-Kreativrichtung)hyperframes-cli–npx hyperframes lint / validate / inspect / preview / render