HyperFrames Animation
Das gesamte Bewegungs- und Animationswissen in einem Skill: Regeln (atomare Rezepte), Blueprints (mehrphasige Szenenvorlagen), Übergänge (Szene-zu-Szene), Techniken (breitere Motion-Design-Muster) und Adapter (pro Laufzeit-APIs).
Den Kompositionsvertrag (Datenattribute, Subkompositionen, Determinismus) findest du unter hyperframes-core.
Standard: Atomare Regeln komponieren
Wähle 2-4 Regeln aus rules-index.md, füge sie mit einer einzigen pausierten GSAP-Timeline zusammen – fertig. Das ist schneller und erzeugt weniger Code als ein Blueprint.
Blueprint laden, wenn
- Die Szene zu einer bestehenden, vordefinierten mehrphasigen Vorlage passt (Marken-Enthüllung, Social-Proof usw.) und die Wiederverwendung ihrer Phasen-Pipeline echte Authoring-Zeit spart.
- Du ausführbaren Code als Ground Truth für eine komplexe 4-5-phasige Choreografie benötigst.
Blueprints befinden sich in blueprints-index.md. Jeder Eintrag verweist auf blueprints/<id>.md (Rezept). Lies sie nicht spekulativ; lade sie, wenn du dich bereits für eine szenenübergreifende Orchestrierung entschieden hast.
Routing
| Du möchtest… | 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 eines Blueprints lesen | blueprints/<id>.md |
| Einen Szenenübergang erstellen (CSS-gesteuert, zwischen zwei Clips) | transitions/overview.md, transitions/catalog.md |
| Eine breitere Motion-Design-Technik nachschlagen | techniques.md |
| Bewegungsunschärfe – Shutter-Smear auf einem Element und wann man sie nicht verwenden sollte | references/motion-blur.md |
| Die Animationskarte einer bestehenden Komposition analysieren | scripts/animation-map.mjs |
| GSAP API – Timeline/Tweens/Positionsparameter | adapters/gsap.md |
| GSAP – vorgefertigte 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/Label | adapters/gsap-timeline-and-labels.md |
Lottie/dotLottie (After Effects Exporte, window.__hfLottie) | adapters/lottie.md |
| Charakter-Animation (Gehzyklus, Maskottchen, Gelenk-Puppe, Gesten) | adapters/lottie.md → Charaktere |
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 |
Laufzeit wählen
- GSAP ist der Standard für 95% der Bewegungsarbeit – deckt Timeline-Orchestrierung, Transforms, Easing, Stagger ab. Alle atomaren Regeln in diesem Skill basieren auf GSAP.
- Lottie wenn ein Asset eine eigene vorgefertigte Timeline hat (typischerweise After Effects Exporte), einschließlich Charakteren, die gehen, gestikulieren oder reagieren.
- Three.js für 3D-Szenen, Kamerabewegungen und shadergetriebene Visuals.
- Anime.js für leichtgewichtiges Tweening, wenn GSAP zu viel ist.
- CSS für einfache, wiederholte Motive, Dekoration, Schimmer – ohne JavaScript-Animation-Aufwand.
- 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 koexistieren. Jede registriert ihre Instanzen auf dem laufzeitspezifischen Global, sodass HyperFrames sie alle in einem Durchlauf seeken 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 beim Seitenladen auf späteren Szenen-Clips, keine display- oder rohen visibility-Tweens und keine Timeline-Konstruktion in async/setTimeout/Promise). GSAP autoAlpha und Zero-Duration-Sichtbarkeitssets an expliziten Timeline-Grenzen bleiben durch das Core erlaubt. Verwende diese Ausnahmen nur auf Nicht-Clip-Elementen oder Wrappern innerhalb eines Clips; das Framework besitzt den .clip-Lebenszyklus. Wiederhole hier nicht den vollständigen Vertrag.
Zusätzliche Animationsregeln auf dem Core-Vertrag:
- Vorberechnete Layout-Konstanten – leite niemals Positionen von
getBoundingClientRect()zur Tween-Zeit ab. Tween-Zeit DOM-Messungen desynchronisieren, weil der Renderer parallel abtastet; berechne Koordinaten einmal beim Kompositionsaufbau und verwende sie wieder. - Räumliche Bewegungen nur mit GSAP-Transform-Aliasen (
x,y,scale,rotation). Die Whitelist des 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-verzeichnis> \
--out <composition-verzeichnis>/.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. Verwende es, um die Choreografie nach dem Authoring zu prüfen (Totzonen, Stagger-Konsistenz, Lebenszyklus-Warnungen).
animation-map.mjs löst Hilfspakete zuerst aus dem aktuellen Projekt auf und kann dann die gebündelte HyperFrames-Paketversion bootstrappen. Setze HYPERFRAMES_SKILL_PKG_VERSION=<version> nur, wenn du den Skill außerhalb der gebündelten CLI/Skill-Installation ausführst und diese Bootstrap-Version explizit festlegen möchtest.
Siehe auch
hyperframes-core– Kompositionsstruktur, Datenattribute, Subkompositionen, deterministischer Render-Vertraghyperframes-creative– Paletten, Typografie, Erzählung, Beat-Planung (nicht-animationsbezogene kreative Richtung)hyperframes-cli–npx hyperframes lint / check / snapshot / preview / render