Was macht HyperFrames Keyframes?
Keyframes sind ein Pose-Vertrag: sichtbare Zustände, kontinuierliche Subjektidentität, seek-sichere Laufzeit, überprüfte Pixel.
Verwende hyperframes-animation für breite Szenen-Rezepte. Verwende hyperframes-cli für die vollständige Befehlsdokumentation. Verwende references/keyframe-patterns.md nur, wenn der Implementierungsmechanismus unklar ist, nicht für den visuellen Stil.
Grenze der Creator-Bearbeitung
Keyframes besitzen visuelle Bewegung, nicht Clip-Assemblierung. Harte Schnitte von Quellbereichen, Trimmen, Splice und Neuanordnung gehören zu /hyperframes-core: Autor ein Medienelement pro beibehaltenem Bereich, platziere es mit data-start und data-duration, und wähle seinen Quell-Offset mit data-media-start. Angrenzende Bereiche erzeugen einen harten Schnitt. Eine Überblendung verwendet überlappende Clips auf verschiedenen Spuren plus visuelle Opazitäts-Keyframes; Audioblenden verwenden /hyperframes-audio.
| Creator-Anfrage | Wahrheitsmechanismus |
|---|---|
| Punch-in / Punch-out | Keyframe scale mit x/y oder prozentualer Übersetzung auf einem nicht zeitgesteuerten visuellen/Crop-Wrapper innerhalb des Clips. Verwende einen set/kurzen Tween für einen harten Punch und einen Tween für eine sanfte Bewegung. |
| Sanfter Multi-State-Zoom oder Reframe | Halte einen Subjekt-Wrapper am Leben und autorisiere mehrere Zoom/Reframe-Zustände als eine Pose-Leiter mit abschnittsweisem Easing. |
| Schwenk, Reframe oder Ken-Burns-Kamera | Animiere Wrapper-Translation plus Skalierung. Geometrie ist autorisiert; dies ist keine Gesichtsverfolgung oder automatische semantische Neurahmung. |
| Verkettete Kamerabewegungen | Verkette beschriftete Transformationsbeats auf einer registrierten seek-sicheren Timeline. |
| Match Cut oder Whip-Schwenk | /hyperframes-animation besitzt den visuellen Handoff; /hyperframes-registry liefert Primitive; Keyframes bewahren autorisierte Geometrie, Richtung und Geschwindigkeit. Es gibt keine automatische Erkennung von Match-Frames. |
| Crop- und Mask-Reframe | Interpoliere clip-path oder eine Maske auf einem inneren visuellen Wrapper zum Zuschneiden/Neuausrichten, ohne die Quellzeit zu ändern. Polygon-Keyframes können einen Polygon/Mask-Übergang bilden. |
| Richtungs-Wipe-Cut oder Iris-/Reveal-Cut | Animiere eine Masken-/Clip-Grenze über überlappende visuelle Clips; /hyperframes-animation besitzt die Übergabe-Choreografie. |
| Split-Screen-Handoff | Halte beide visuellen Clips vom Core platziert, dann keyframe ihre inneren Crop/Mask-Wrapper und die Trenngeometrie. |
| Konstante Quell-Neuzeit | /hyperframes-core besitzt normalisierte data-playback-rate (0.1..10) für rendersichere Bild- und tonhöhenerhaltene Audiowiedergabe. Sie ist konstant für das gesamte Medienelement. |
| Quell-Geschwindigkeitsrampen | Eine rate-Spur in data-automation auf dem <video>/<audio> (t in Clip-Sekunden, v 0.1..10, log-Interpolation); sie überschreibt die konstante Rate. |
| Einfrieren / Halten | Eine visuelle Pose, ein letztes Quellbild oder eine fertige Unterkomposition kann gehalten werden. Beliebiges Einfrieren innerhalb der Quelle wird nicht unterstützt; verarbeite vorab ein Standbild/einen abgeleiteten Clip, platziere ihn als eigenen Clip und nimm dann mit einem anderen Quellbereich wieder auf. |
Wenn du Bild und Ton zusammen bearbeitest, lade /hyperframes-core, diese Fähigkeit für visuelle Bewegung und /hyperframes-audio für Blenden, Überblendungen, Lautstärkeautomatisierung, Ducking/Carve oder Effekte auf den platzierten Spuren.
Eine visuelle Übergangs- oder Zuschnittsbehandlung ist kein zeitlicher Quell-Trim oder Splice. /hyperframes-core besitzt die Timeline, das Clip-Timing und die Quellbereiche; Keyframes animieren nur den sichtbaren Handoff oder Zuschnitt auf Wrappern innerhalb dieser Clips. Für kopierbare kombinierte Bild/Ton-Rezepte verwende /hyperframes-core → references/creator-editing-recipes.md.
Vorgehen
- Identifiziere das animierte Subjekt, sichtbare Zustände, Endzustand und Laufzeit.
- Wähle den kleinsten Mechanismus, der die Eingabe beweist. Lies
references/keyframe-patterns.mdnur, wenn der Mechanismus unklar ist. - Erstelle seek-sichere Keyframes in der deklarierten Laufzeit. Baue synchron und registriere die Laufzeit-Instanz.
- Überprüfe mit
hyperframes lint,hyperframes check,hyperframes keyframes, einem fokussierten--shotund Schnappschüssen zu Beweiszeitpunkten. - Wenn der Beweis fehlschlägt, korrigiere die Quell-Keyframes und führe die kleinste fehlgeschlagene Diagnose erneut aus, bevor du renderst.
Vertrag
- Benenne das sich bewegende Subjekt.
- Benenne die Posen, die benötigt werden, um die beabsichtigte Bewegung zu beweisen, einschließlich des Endzustands.
- Keyframe sichtbare Kanäle, nicht versteckten Helferzustand.
- Bewahre die Objektidentität, wenn Kontinuität wichtig ist.
- Überblende nur, wenn die beabsichtigte Bewegung ein Austausch oder eine Auflösung ist.
- Halte lesbare oder semantische Zustände lange genug sichtbar.
- Der letzte Frame ist Teil der Animation, keine Aufräumarbeit.
- Setze nicht auf Ruhezustand zurück, es sei denn, es wird angefordert.
- Beende nicht auf Schwarz, es sei denn, es wird angefordert.
- Wenn du eine Start-Szene bearbeitest, bewahre Layout, Kopie, Assets, Farben und Endzustand, es sei denn, du wirst um ein Redesign gebeten.
Laufzeitregeln
GSAP:
- baue synchron beim Seitenladen
- verwende
gsap.timeline({ paused: true }) - registriere als
window.__timelines[compositionId] - Registry-Schlüssel muss mit
data-composition-idübereinstimmen - rufe
tl.play()nicht für rendertritische Bewegungen auf - halte Wiederholungen endlich
CSS-Keyframes:
- endliche Dauer und Iterationszahl
- deterministische Verzögerung
animation-fill-mode: both- verwende
data-start, wenn das Timing zu einem Clip gehört
Anime.js:
- erstelle synchron
autoplay: false- endliche Dauer und Schleifen
- füge jede Instanz zu
window.__hfAnimehinzu
WAAPI:
- endliche
duration fill: "both"- deterministische Konstruktion
- Die Textoberfläche listet WAAPI nicht auf; überprüfe mit
--shot(es sucht WAAPI) und Schnappschüssen
Verwende niemals für rendertritische Bewegungen:
Date.now()performance.now()- ungesäten
Math.random() - Hover/Scroll-Trigger
- Timer
- asynchron erstellte Timelines
- nicht registrierte
requestAnimationFrame - unendliche Schleifen
GSAP-Skelett
const root = document.querySelector("[data-composition-id]");
const compositionId = root.dataset.compositionId;
const tl = gsap.timeline({ paused: true });
tl.addLabel("state-a", 0);
tl.to(".subject", {
keyframes: [
{ x: 0, opacity: 1, duration: 0.2 },
{ x: 120, opacity: 1, duration: 0.4, ease: "power2.out" },
{ x: 100, opacity: 1, duration: 0.2, ease: "power2.inOut" },
],
ease: "none",
});
window.__timelines = window.__timelines || {};
window.__timelines[compositionId] = tl;
Verwende Labels für semantische Zustände. Verwende Positionsparameter anstelle von verketteten Verzögerungen. Verwende immediateRender: false für spätere from()/fromTo()-Tweens, die dieselbe Eigenschaft berühren.
Keyframe-Formen
- Array-Keyframes: Pose-Leiter mit Schritt-für-Schritt-Dauer/Easing.
- Prozent-Keyframes: exaktes Timing innerhalb eines Tweens.
- Eigenschafts-Arrays: kompakte Multi-Stopp-Änderungen.
ease: "none"auf dem Elternteil, wenn jeder Stopp sein eigenes Easing trägt.easeEach, wenn jedes Segment dasselbe Gefühl haben soll.
Kopiere keine numerischen Abstände oder Timings aus Beispielen. Leite sie aus der tatsächlichen Zusammensetzungsgeometrie und -dauer ab.
Für ein Subjekt, das sich zwischen zwei Boxen bewegt, bevorzuge einen kontinuierlichen Transform-Tween oder FLIP. Teile x/y/scale nur dann in mehrere erleichterte Keyframes auf, wenn der Betrachter unterschiedliche Beats spüren soll; jedes Segment ändert die Geschwindigkeit und kann als Ruckler wahrgenommen werden.
Kanäle
Bevorzuge Compositor/visuelle Kanäle: x/y/z, xPercent/yPercent, scale, rotationX/Y/Z, skew, transformOrigin, svgOrigin, opacity, autoAlpha, clip-path, Masken, CSS-Variablen, SVG-Pfad/Dash-Werte, Kamera-Transformationen, Shader-Uniforms.
Vermeide Layout/Lebenszyklus-Kanäle: top/left/right/bottom, width/height, margin/padding, display, visibility, späte DOM-Erstellung, Helfer-Overlays, die Subjektbewegungen ausführen.
Für Sichtbarkeitsänderungen verwende autoAlpha auf der registrierten suchbaren GSAP-Timeline oder ein tl.set() mit einer Dauer von null an einer expliziten Grenze. Ziele nur auf ein Nicht-Clip-Element oder einen Wrapper innerhalb des Clips; ziele niemals auf .clip selbst. Verwende niemals Dauer-Tween auf rohem visibility und niemals Tween auf display.
Mechanismuswahl
Wähle den kleinsten Mechanismus, der die Eingabe beweist:
| Bedarf | Mechanismus |
|---|---|
| Gleiches Subjekt ändert Box oder Hierarchie | geteiltes Element / FLIP |
| Subjekt reist eine sichtbare Route | Pfad-Reise |
| Strich wächst oder zeichnet nach | Strich-Zeichnung |
| Form wird zu einer anderen Form | Form-Interpolation |
| Enthüllungsgrenze ist sichtbar | Clip, Maske oder Shader-Uniform |
| Viele Elemente bewegen sich mit Reihenfolge | Stagger / indizierte Verzögerung |
| Text selbst bewegt sich | Zeilen-, Wort-, Zeichen- oder Band-Unterteilung |
| Oberfläche biegt, dehnt oder beschneidet | Eltern/Kind-Gegen-Transformation |
| UI hat Zustände | explizite Zustandsmaschine |
| Szene hat Tiefe | DOM 3D, Three.js oder WebGL-Kamera/Objekt-Keyframes |
Mechanismen können kombiniert werden, aber jeder muss die Idee klären. Dekoration ist kein Beweis.
Timing
- Antizipation nur, wenn sie Ursache oder Richtung klärt.
- Beschleunigung verlässt die Ruhe.
- Höhepunkt beweist den Mechanismus unmissverständlich.
- Durchzug verkauft Energie und Richtung.
- Überschwingen nur, wenn sich das Subjekt elastisch oder taktil anfühlen soll.
- Konstante Geschwindigkeit auf der Pfad-Reise benötigt normalerweise
ease: "none". - Diskrete UI-Zustände benötigen normalerweise einen scharfen Ausgang.
- Wiederholte Elemente benötigen geordnete Offsets, nicht identisches Timing.
- Endgültige Einrasten benötigen längere Haltezeiten als Übergangsposen.
- Glätte bedeutet kontinuierliche Geschwindigkeit auf demselben Subjekt.
- Überlappe keine Tweens, die dieselbe Transform-Eigenschaft schreiben, es sei denn, die Überlappung ist beabsichtigt und verifiziert.
- Vermeide die Animation großer
clip-path/Masken-Änderungen, während dieselbe Heldenoberfläche auch skaliert oder reist; verwende verschachtelte Enthüllungen, nachdem sich die Hauptbewegung beruhigt hat.
Text
Bewahre Zeilenboxen, Wortabstände, Lesbarkeit und endgültige Passform. Wenn sich Text intern bewegt, bewege die Glyphen oder maskierten Bänder, nicht nur Dekorationen um den Text herum. Mache Schnappschüsse von lesbaren Bildern.
SVG
Für Strichwachstum bevorzuge DrawSVGPlugin, dann stroke-dasharray/stroke-dashoffset. Für Forminterpolation bevorzuge MorphSVGPlugin; konvertiere Grundelemente bei Bedarf in Pfade und teile komplexe Silhouetten in einfachere Teile auf.
3D
Alleinige Skalierung ist falsche Tiefe. Verwende Perspektive auf einem stabilen Elternteil, transform-style: preserve-3d, Z-Reise, Rotation, Kamera-/Weltbewegung, Okklusion und Ebenenreihenfolge, wenn sich Objekte kreuzen.
Verwende ein oder zwei diagnostische Winkel, die die Tiefenbeziehung aufdecken. Wenn der angewinkelte Beweis keine Tiefenkreuzung zeigt, verbessere Z/Kamera/Okklusion.
Canvas / WebGL
Keyframe die Kameraposition, das Kameraziel, die Objekttransformation, die Materialopazität, die Shader-Uniforms und die Nachbearbeitungsintensität durch deterministischen Zustand. Rendere von der HyperFrames-Zeit aus. Verwende --ghost, weil Markerboxen die interne Canvas-Bewegung nicht sehen können.
CLI-Überprüfung
npx hyperframes lint
npx hyperframes check
npx hyperframes keyframes .
npx hyperframes keyframes . --json
npx hyperframes keyframes . --runtime all
npx hyperframes keyframes . --selector "<Selektor>" --shot "<Datei>" --samples <n>
npx hyperframes keyframes . --selector "<Selektor>" --shot "<Datei>" --layout strip --from <t0> --to <t1>
npx hyperframes keyframes . --shot "<Datei>" --ghost --angle <Winkel>
npx hyperframes snapshot . --at <Zeiten>
Wähle <Selektor> für das reale animierte Subjekt. Wähle <Zeiten> für den ersten Frame, Beweispunkte, final-minus-Halte und exakt final. Wähle <Winkel> nur, wenn Tiefe bewiesen werden muss.
| Werkzeug | Beweist |
|---|---|
keyframes | Ziele, explizite Stopps, Pfade, Spuren, zusammengesetzte Eltern/Kind-Bewegung, CSS-Stopps, Anime-Registrierung |
--shot | Geister, Routenform, Zeitabstand, DOM-3D-Projektion, fokussierter Selektor-Beweis |
--layout strip | Bewegung an Ort und Stelle, Überlappungen, Kontakt, subtile Skalierung/Opazität, Textwellen |
--ghost | Canvas, WebGL, Shader-Bewegung, gerendertes 3D |
snapshot --at | Masken, Textlesbarkeit, vollständiger Zustand, letzter Einrasten, Schwarz-/Reset-Enden |
Wenn der Selektor-Beweis falsch aussieht:
- führe
--jsonerneut aus - finde das tatsächliche animierte Ziel
- schieße auf dieses Ziel
- mache Schnappschüsse von vollständigen Frames
- vertraue gemalten Pixeln mehr als Logs
Diagnostische Lektüre
flat bedeutet keine expliziten Zwischenposen. keyframes bedeutet, dass explizite Stopps existieren.