HyperFrames Animation
Alles Bewegungs- und Animationswissen in einer Skill: Regeln (atomare Rezepte), Blueprints (mehrphasige Szenenvorlagen), Transitionen (Szene-zu-Szene), Techniken (allgemeine Motion-Design-Muster) und Adapter (Laufzeit-APIs).
Zum Kompositionsvertrag (Datenattribute, Unterkompositionen, Determinsmus) siehe hyperframes-core.
Standard: atomare Regeln kombinieren
Wähle 2–4 Regeln aus rules-index.md, verknüpfe sie mit einer einzigen pausierten GSAP-Timeline – erledigt. Dies ist schneller und erzeugt weniger Code als mit einer Vorlage zu starten.
Blueprint laden, wenn
- Die Szene zu einer existierenden, vorentworfenen mehrphasigen Vorlage passt (Marken-Reveal, Social-Proof, usw.) und die Wiederverwendung ihrer Phasen-Pipeline Zeit spart.
- Du ausführbaren Ground-Truth-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 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 Blueprints lesen | blueprints/<id>.md |
| Einen Szenenübergang (CSS-gesteuert, zwischen zwei Clips) erstellen | transitions/overview.md, transitions/catalog.md |
| Eine allgemeine Motion-Design-Technik nachschlagen | techniques.md |
| Eine bestehende Kompositions-Animation-Karte analysieren | scripts/animation-map.mjs |
| GSAP API – Timeline / Tweens / Positionsparameter | adapters/gsap.md |
| GSAP – einsatzfertige Effekt-Rezepte | rules/gsap-effects.md |
| GSAP – Transforms / Performance | adapters/gsap-transforms-and-perf.md |
| GSAP – Easing / 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 |
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 einfangen) | adapters/html-in-canvas-patterns.md |
Benannte Text-Animationseffekte (24 IDs via externe animate-text-Skill) | adapters/animate-text.md |
Laufzeit auswählen
- GSAP ist der Standard für 95% der Bewegungsarbeit – deckt Timeline-Orchestrierung, Transforms, Easing und Stagger ab. Alle atomaren Regeln in dieser Skill basieren auf GSAP.
- Lottie wenn ein Asset eine eigene vorgefertigte Timeline besitzt (typischerweise After Effects Exporte).
- Three.js für 3D-Szenen, Kamerabewegungen, Shader-gesteuerte Visuals.
- Anime.js für leichtes Tweensing, wenn GSAP zu schwer 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 Canvas (Partikel, flüssiges Glas, benutzerdefinierte Shader).
Mehrere Laufzeiten können in einer Komposition koexistieren. Jede registriert ihre Instanzen auf dem laufzeitspezifischen globalen Objekt, sodass HyperFrames sie alle in einem Durchlauf suchen 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 für Clips späterer Szenen, keine display / visibility Animation, kein Timeline-Aufbau innerhalb von async / setTimeout / Promise). Diese werden hier nicht wiederholt.
Animationstechnische Ergänzungen über den Kernvertrag hinaus:
- Vorberechnete Layout-Konstanten – Positionen niemals zur Tween-Zeit aus
getBoundingClientRect()ableiten. Tween-Zeit-DOM-Messungen desynchronisieren, weil der Renderer parallel sammelt; Koordinaten einmal beim Kompositionsaufbau berechnen und wiederverwenden. - Räumliche Bewegungen nutzen ausschließlich GSAP-Transform-Aliase (
x,y,scale,rotation). Die Zulassungsliste des Kerns erlaubt auchopacity/color/backgroundColor/borderRadiusfür nicht-räumliche Property-Tweens – jedoch 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. Nutze es, um nach dem Authoring die Choreografie zu prüfen (Totzonen, Stagger-Konsistenz, Lifecycle-Warnungen).
Siehe auch
hyperframes-core– Kompositionsstruktur, Datenattribute, Unterkompositionen, deterministischer Render-Vertraghyperframes-creative– Paletten, Typografie, Narration, Beat-Planung (nicht-animatorische kreative Leitung)hyperframes-cli–npx hyperframes lint / validate / inspect / preview / render