Plugin-Installation: Vor Einrichtungs- oder Aktualisierungsbefehlen befolgen Sie die Plugin-Ausführungsregeln, wenn dieser Skill innerhalb eines HyperFrames-Plugins verwendet wird. Bei eigenständigen Installationen gelten die unten stehenden Aktualisierungshinweise.
HyperFrames Animation
Alles Bewegungs-Wissen in einem Skill: Regeln (atomare Rezepte), Blaupausen (mehrphasige Szenenvorlagen), Übergänge (Szene-zu-Szene), Techniken (breitere Motion-Design-Patterns) 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, verknüpfen Sie diese mit einer einzigen pausierten GSAP-Timeline – fertig. Dies ist schneller und erzeugt weniger Code als der Einstieg über eine Blaupause.
Blaupause laden, wenn
- Die Szene einer vorhandenen vordefinierten mehrphasigen Vorlage entspricht (Marken-Enthüllung, Social-Proof usw.) und die Wiederverwendung ihrer Phasen-Pipeline echte Authoring-Zeit spart.
- Sie ausführbaren Ground-Truth-Code für eine komplexe 4-5-Phasen-Choreografie benötigen.
Blaupausen finden Sie in blueprints-index.md. Jeder Eintrag verweist auf blueprints/<id>.md (Rezept). Lesen Sie diese nicht spekulativ; laden Sie sie erst, wenn Sie sich bereits für eine szenenweite Orchestrierung entschieden haben.
Routing
| Sie möchten… | 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 Blaupause lesen | blueprints/<id>.md |
| Einen Szenenübergang (CSS-gesteuert, zwischen zwei Clips) authoring | 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 |
| Eine bestehende Komposition auf ihre Animationskarte hin 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 – Easing / Staffelung (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 → Characters |
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, 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), einschließlich Charakteren, die gehen, 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, Schimmer – keine JavaScript-Animationkosten.
- 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 koexistieren. Jede registriert ihre Instanzen in der laufzeitspezifischen globalen Variable, sodass HyperFrames alle in einem Durchlauf suchen kann.
Kritische Einschränkungen
Voraussetzung: hyperframes-core → Eine pausierte Timeline + Nicht verhandelbare Regeln (Einzelne pausierte Timeline, data-duration bestimmt die Länge, kein Math.random / Date.now / performance.now, kein repeat: -1 ohne eine endliche Wurzel-data-duration, kein gsap.set bei Seitenladevorgang auf Clips späterer Szenen, kein display oder rohes visibility-Tween, und die Timeline erst registrieren, nachdem sie vollständig aufgebaut ist, auch wenn der Aufbau innerhalb eines asynchronen Callbacks wie document.fonts.ready läuft). GSAP autoAlpha und Null-Dauer-Sichtbarkeitssets an expliziten Timeline-Grenzen bleiben vom Kern erlaubt. Verwenden Sie diese Ausnahmen nur auf Nicht-Clip-Elementen oder Wrappern innerhalb eines Clips; das Framework besitzt den .clip-Lebenszyklus. Wiederholen Sie hier nicht den vollständigen Vertrag.
Zusätzliche Animations-Erstellungsregeln zum Kernvertrag:
- Vorberechnete Layout-Konstanten – leiten Sie Positionen niemals zur Tween-Zeit aus
getBoundingClientRect()ab. Tween-Zeit-DOM-Messungen desynchronisieren, weil der Renderer parallel sampelt; berechnen Sie Koordinaten einmal beim Kompositions-Setup und verwenden Sie sie wieder. - Räumliche Bewegung verwendet nur GSAP-Transform-Aliase (
x,y,scale,rotation). Die Erlaubnisliste des Kerns erlaubt auchopacity/color/backgroundColor/borderRadiusfür nicht-räumliche Eigenschafts-Tweens – aber niemalswidth/height/top/leftfür Layoutänderungen.
Skripte
node <SKILL_DIR>/scripts/animation-map.mjs <compositions-verzeichnis> \
--out <compositions-verzeichnis>/.hyperframes/anim-map
Liest jede auf window.__timelines registrierte GSAP-Timeline, zählt Tweens auf, sampelt Begrenzungsrahmen, berechnet Flags und gibt animation-map.json aus. Verwenden Sie es, um die Choreografie nach dem Authoring zu prüfen (Totzonen, Staffelungskonsistenz, Lebenszykluswarnungen).
animation-map.mjs löst Hilfspakete zuerst aus dem aktuellen Projekt auf und kann dann die gebündelte HyperFrames-Paketversion bootstrappen. Setzen Sie HYPERFRAMES_SKILL_PKG_VERSION=<version> nur, wenn der Skill außerhalb der gebündelten CLI/Skill-Installation ausgeführt wird und Sie diese Bootstrap-Version explizit festlegen müssen.
Siehe auch
hyperframes-core– Kompositionsstruktur, Datenattribute, Unterkompositionen, deterministischer Render-Vertraghyperframes-creative– Paletten, Typografie, Erzählung, Beat-Planung (nicht-animationsbezogene kreative Richtung)hyperframes-cli–npx hyperframes lint / check / snapshot / preview / render