HyperFrames Animation
Sämtliches Bewegungs- und Animationswissen in einem Skill: Regelwerk (atomare Rezepte), Vorlagen (mehrphasige Szenenvorlagen), Übergänge (Szene-zu-Szene), Techniken (allgemeine Motion-Design-Muster) und Adapter (projektbezogene Laufzeit-APIs).
Den Kompositionsvertrag (Datenattribute, Sub-Kompositionen, Determinsmus) finden Sie in hyperframes-core.
Standard: Atomare Regeln zusammenstellen
Wählen Sie 2–4 Regeln aus rules-index.md, fügen Sie sie mit einer einzelnen pausierten GSAP-Timeline zusammen – fertig. Das ist schneller und erzeugt weniger Code, als mit einer Vorlage zu beginnen.
Eine Vorlage laden, wenn
- Die Szene mit einer vorhandenen, vorgefertigten mehrphasigen Vorlage übereinstimmt (Marken-Reveal, Social-Proof usw.) und die Wiederverwendung ihrer Phasen-Pipeline echte Authoring-Zeit spart.
- Sie ausführbaren, verlässlichen Code für eine komplexe 4–5-Phasen-Choreografie benötigen.
Die Vorlagen leben in blueprints-index.md. Jeder Eintrag verweist auf blueprints/<id>.md (Rezept). Lesen Sie sie nicht spekulativ; laden Sie sie erst, wenn Sie sich bereits für eine Szenen-Orchestrierung entschieden haben.
Navigation
| Was möchten Sie … | Lesen Sie |
|---|---|
| Ein atomares Bewegungsmuster nach Auslöser / Tag auswählen | rules-index.md |
| Ein vollständiges HTML/CSS/GSAP-Rezept einer Regel lesen | rules/<name>.md |
| Eine mehrphasige Szenenvorlage auswählen | blueprints-index.md |
| Das vollständige Rezept einer Vorlage lesen | blueprints/<id>.md |
| Einen Szenenübergang erstellen (CSS-gesteuert, zwischen zwei Clips) | transitions/overview.md, transitions/catalog.md |
| Eine allgemeine Motion-Design-Technik nachschlagen | techniques.md |
| Bewegungsunschärfe – Verschluss-Smear auf einem Element und wann man es nicht verwendet | references/motion-blur.md |
| Die Animations-Map einer vorhandenen Komposition analysieren | scripts/animation-map.mjs |
| GSAP API – Timeline/Tweens/Position-Parameter | adapters/gsap.md |
| GSAP – Fertige Effekt-Rezepte | rules/gsap-effects.md |
| GSAP – Transformationen / Performance | adapters/gsap-transforms-and-perf.md |
| GSAP – Easings / 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 |
| Charakter-Animation (Gehzyklus, Maskottchen, Gelenkpuppe, 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-Postfx (Live-DOM via drawElementImage erfassen) | adapters/html-in-canvas-patterns.md |
Benannte Texteffekte (24 IDs über externen animate-text-Skill) | adapters/animate-text.md |
Laufzeit auswählen
- GSAP ist der Standard für 95 % der Bewegungsarbeit – deckt Timeline-Orchestrierung, Transformationen, Easings, Stagger ab. Alle atomaren Regeln in diesem Skill basieren auf GSAP.
- Lottie, wenn ein Asset eine eigene vorgebackene Timeline hat (normalerweise After-Effects-Exporte), einschließlich Charakteren, die laufen, gestikulieren oder reagieren.
- Three.js für 3D-Szenen, Kamerabewegungen, shader-basierte Grafiken.
- Anime.js für leichtgewichtiges Tweening, wenn GSAP zu viel ist.
- CSS für einfache, wiederholte Motive, Dekoration, Glitzereffekte – kein JavaScript-Overhead.
- WAAPI für native Browser-Keyframes ohne GSAP-Abhängigkeit.
- TypeGPU / WebGPU für GPU-gerenderte Leinwände (Partikel, flüssiges Glas, benutzerdefinierte Shader).
Mehrere Laufzeiten können in einer Komposition gleichzeitig verwendet werden. Jede registriert ihre Instanzen auf dem laufzeitspezifischen Global, 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 beim Seitenladen für Clips späterer Szenen, keine display- oder rohen visibility-Tweens und keine Timeline-Konstruktion innerhalb von async / setTimeout / Promise). GSAP autoAlpha und Null-Dauer-Sichtbarkeitssetzungen an expliziten Timeline-Grenzen bleiben laut Core erlaubt. Verwenden Sie diese Ausnahmen nur für Nicht-Clip-Elemente oder Wrapper innerhalb eines Clips; das Framework besitzt den .clip-Lebenszyklus. Wiederholen Sie hier nicht den vollständigen Vertrag.
Zusätzliche Animationsregeln, die über den Core-Vertrag hinausgehen:
- Vorberechnete Layout-Konstanten – leiten Sie Positionen niemals zur Tween-Zeit mit
getBoundingClientRect()ab. DOM-Messungen zur Tween-Zeit desynchronisieren, weil der Renderer parallel abtastet. Berechnen Sie Koordinaten einmalig bei der Kompositionserstellung und verwenden Sie sie wieder. - Räumliche Bewegungen verwenden nur GSAP-Transformations-Aliase (
x,y,scale,rotation). Die Zulassungsliste von Core erlaubt auchopacity/color/backgroundColor/borderRadiusfür nicht-räumliche Property-Tweens – aber niemalswidth/height/top/leftfür Layout-Änderungen.
Skripte
node skills/hyperframes-animation/scripts/animation-map.mjs <compositions-verzeichnis> \
--out <compositions-verzeichnis>/.hyperframes/anim-map
Liest jede GSAP-Timeline, die auf window.__timelines registriert ist, zählt Tweens auf, nimmt Bounding-Box-Stichproben, berechnet Flags und gibt animation-map.json aus. Verwenden Sie dies zur Prüfung der Choreografie (tote Zonen, Stagger-Konsistenz, Lifecycle-Warnungen) nach dem Authoring.
animation-map.mjs löst zunächst Hilfspakete aus dem aktuellen Projekt auf und kann dann die gebündelte HyperFrames-Paketversion bootstrappen. Setzen Sie HYPERFRAMES_SKILL_PKG_VERSION=<version> nur, wenn Sie den Skill außerhalb der gebündelten CLI/Skill-Installation ausführen und diese Bootstrap-Version explizit festlegen müssen.
Siehe auch
hyperframes-core– Kompositionsstruktur, Datenattribute, Sub-Kompositionen, deterministischer Rendervertraghyperframes-creative– Paletten, Typografie, Narration, Beat-Planung (nicht-animationsbezogene kreative Richtung)hyperframes-cli–npx hyperframes lint / check / snapshot / preview / render