Was macht HyperFrames Animation?
Das gesamte Bewegungswissen in einem Skill: Regeln (atomare Rezepte), Blueprints (mehrphasige Szenenvorlagen), Übergänge (Szene-zu-Szene), Techniken (allgemeine Motion-Design-Muster) und Adapter (pro Laufzeitumgebung APIs).
Für den Kompositionsvertrag (Datenattribute, Unterkompositionen, Deterministik) siehe hyperframes-core.
Standard: Atomare Regeln kombinieren
Wähle 2–4 Regeln aus rules-index.md, füge sie mit einer einzigen pausierten GSAP-Timeline zusammen – fertig. Das ist schneller und produziert weniger Code als mit einem Blueprint zu beginnen.
Blueprints laden, wenn
- Die Szene zu einer vorhandenen vordefinierten mehrphasigen Vorlage passt (Marken-Enthüllung, sozialer Beweis usw.) und die Wiederverwendung ihrer Phasen-Pipeline echte Zeit beim Erstellen spart.
- Du ausführbaren, referenzierbaren Code für eine komplexe 4–5-Phasen-Choreografie benötigst.
Blueprints befinden sich in blueprints-index.md. Jeder Eintrag verweist auf blueprints/<id>.md (Rezept). Lies sie nicht spekulativ; lade sie erst, wenn du dich bereits für eine szenenweite Orchestrierung entschieden hast.
Navigation
| Du möchtest… | Lies |
|---|---|
| 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 eines Blueprints 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 |
| Die Animationskarte einer bestehenden Komposition analysieren | scripts/animation-map.mjs |
| GSAP API – Timeline / Tweens / Positionsparameter | adapters/gsap.md |
| GSAP – Fertig-Effektrezepte | rules/gsap-effects.md |
| GSAP – Transformationen / Performance | adapters/gsap-transforms-and-perf.md |
| GSAP – Easing / 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-Posteffekte (Live-DOM via drawElementImage erfassen) | adapters/html-in-canvas-patterns.md |
Benannte Textanimationseffekte (24 IDs via externem animate-text Skill) | adapters/animate-text.md |
Laufzeitumgebung wählen
- GSAP ist der Standard für 95 % der Bewegungsarbeit – deckt Timeline-Orchestrierung, Transformationen, Easing, 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, shader-gesteuerte Visualisierungen.
- Anime.js für leichtgewichtiges Tweening, wenn GSAP zu viel ist.
- CSS für einfache, wiederholte Motive, Dekoration, Schimmer – ohne JavaScript-Animation Overhead.
- WAAPI für native Browser-Keyframes ohne GSAP-Abhängigkeit.
- TypeGPU / WebGPU für GPU-gerenderte Canvases (Partikel, Flüssigglas, benutzerdefinierte Shader).
Mehrere Laufzeitumgebungen können in einer Komposition koexistieren. Jede registriert ihre Instanzen in der laufzeitspezifischen globalen Variable, sodass HyperFrames alle in einem Durchgang 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 spätere Szenen-Clips, kein display oder rohes visibility Tweening, keine Timeline-Konstruktion innerhalb von async / setTimeout / Promise). GSAP autoAlpha und null-dauernde Sichtbarkeitssetzungen an expliziten Timeline-Grenzen bleiben durch den Kern erlaubt. Verwende diese Ausnahmen nur für Nicht-Clip-Elemente oder Wrapper innerhalb eines Clips; das Framework besitzt den .clip-Lebenszyklus. Wiederhole hier nicht den vollständigen Vertrag.
Zusätzliche Animationsregeln zum Kernvertrag:
- Vorberechnete Layout-Konstanten – leite Positionen niemals zur Tween-Zeit von
getBoundingClientRect()ab. DOM-Messungen zur Tween-Zeit desynchronisieren, weil der Renderer parallel abtastet; berechne Koordinaten einmal beim Kompositionsaufbau und verwende sie wieder. - Räumliche Bewegungen verwenden nur GSAP-Transformations-Aliase (
x,y,scale,rotation). Der Kern 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 <kompositionsverzeichnis> \
--out <kompositionsverzeichnis>/.hyperframes/anim-map
Liest jede auf window.__timelines registrierte GSAP-Timeline, zählt Tweens auf, beprobt Bounding-Boxen, berechnet Kennzahlen und gibt animation-map.json aus. Verwende es, um die Choreografie nach dem Erstellen zu überprüfen (tote Zonen, Staffelungskonsistenz, Lebenszykluswarnungen).
animation-map.mjs löst Helper-Pakete zuerst aus dem aktuellen Projekt auf, kann dann aber 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 du diese Bootstrap-Version explizit festlegen musst.
Siehe auch
hyperframes-core– Kompositionsstruktur, Datenattribute, Unterkompositionen, deterministischer Rendervertraghyperframes-creative– Paletten, Typografie, Erzählung, Beat-Planung (nicht-animatorische kreative Richtung)hyperframes-cli–npx hyperframes lint / check / snapshot / preview / render