HyperFrames Motion
Das gesamte Bewegungs- und Animationswissen in einem Skill: Regeln (atomare Rezepte), Baupläne (mehrphasige Szenenvorlagen), Übergänge (Szene-zu-Szene), Techniken (allgemeine Motion-Design-Muster) und Adapter (pro Laufzeit-APIs).
Informationen zum Kompositionsvertrag (Datenattribute, Unterkompositionen, Determinismus) finden Sie unter /hyperframes → core/.
Standard: Atomare Regeln kombinieren
Wählen Sie 2–4 Regeln aus rules-index.md aus, setzen Sie sie mit einer einzigen pausierten GSAP-Timeline zusammen – fertig. Dies ist schneller und erzeugt weniger Code als mit einem Bauplan zu beginnen.
Einen Bauplan laden, wenn
- Die Szene mit einer vorhandenen, vorgefertigten mehrphasigen Vorlage übereinstimmt (Marken-Enthüllung, Social Proof, Demo-Seiten-Scroll-Spotlight usw.) und die Wiederverwendung ihrer Phasen-Pipeline echte Bearbeitungszeit spart.
- Sie ausführbaren Ground-Truth-Code für eine komplexe 4–5-phasige Choreografie wünschen.
Baupläne 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, wenn Sie bereits entschieden haben, dass Sie eine Szenenorchestrierung benötigen.
Navigation
| Wenn Sie … | Lesen Sie |
|---|---|
| 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 Bauplans lesen | blueprints/<id>.md + examples/<id>.html |
| Einen Szenenübergang erstellen (CSS-gesteuert, zwischen zwei Clips) | transitions/overview.md, transitions/catalog.md |
| Ein allgemeines Motion-Design-Verfahren nachschlagen | techniques.md |
| Die Animationskarte einer vorhandenen Komposition analysieren | scripts/animation-map.mjs |
| GSAP-API – Timeline / Tweens / Position-Parameter | adapters/gsap.md |
| GSAP – Fertige Effektrezepte | rules/gsap-effects.md |
| GSAP – Transformationen / Leistung | 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 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 externes animate-text-Skill) | adapters/animate-text.md |
Laufzeit auswählen
- GSAP ist der Standard 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 eine eigene vorgefertigte Timeline hat (typischerweise After Effects-Exporte).
- Three.js für 3D-Szenen, Kamerabewegungen und shader-gesteuerte Grafiken.
- Anime.js für leichtgewichtiges Tweening, wenn GSAP zu viel Aufwand 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 Canvase (Partikel, Flüssigglas, benutzerdefinierte Shader).
Mehrere Laufzeiten können in einer Komposition nebeneinander existieren. Jede registriert ihre Instanzen im laufzeitspezifischen globalen Objekt, sodass HyperFrames alle in einem Durchlauf seeken kann.
Kritische Einschränkungen
Voraussetzung: /hyperframes/core → Unverhandelbare 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, keine Timeline-Erstellung innerhalb von async / setTimeout / Promise). Diese werden hier nicht wiederholt.
Zusätzliche Bewegungsrichtlinien zum Kernvertrag:
- Vorberechnete Layout-Konstanten – Positionen niemals zur Tween-Zeit aus
getBoundingClientRect()ableiten. DOM-Messungen zur Tween-Zeit desynchronisieren, da der Renderer parallel abtastet; Koordinaten einmal beim Kompositions-Setup berechnen und wiederverwenden. - Räumliche Bewegungen verwenden 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-motion/scripts/animation-map.mjs <composition-verzeichnis> \
--out <composition-verzeichnis>/.hyperframes/anim-map
Liest jede GSAP-Timeline, die unter window.__timelines registriert ist, zählt Tweens auf, tastet Bounding-Boxen ab, berechnet Flags und gibt animation-map.json aus. Verwenden Sie es, um die Choreografie zu prüfen (Totzonen, Stagger-Konsistenz, Lebenszyklus-Warnungen) nach dem Erstellen.
Siehe auch
/hyperframes→core/– Kompositionsstruktur, Datenattribute, Unterkompositionen, deterministischer Render-Vertrag/hyperframes-design– Paletten, Typografie, Beat-Planung (nicht-animative kreative Richtung)/hyperframes→cli/–npx hyperframes lint / validate / inspect / preview / render