Plugin-Installation: Führen Sie vor Setup- oder Aktualisierungsbefehlen die Plugin-Ausführungsregeln aus, wenn sich dieser Skill innerhalb eines HyperFrames-Plugins befindet. Bei eigenständigen Installationen gelten die untenstehenden Aktualisierungshinweise.
HyperFrames Keyframes
Keyframes sind ein Pose-Vertrag: sichtbare Zustände, kontinuierliche Subjektidentität, suchsichere Laufzeit, verifizierte Pixel.
Verwenden Sie hyperframes-animation für breite Szenenrezepte. Verwenden Sie hyperframes-cli für die vollständige Befehlsdokumentation. Verwenden Sie references/keyframe-patterns.md nur, wenn Sie Implementierungsmechanismen auswählen, nicht den visuellen Stil.
Bearbeitungsgrenze des Erstellers
Keyframes besitzen die visuelle Bewegung, nicht den Clip-Zusammenbau. Quellbereich-Schnitte, Trimmen, Splice und Neuanordnen gehören zu /hyperframes-core: Authorieren Sie ein Medienelement pro gehaltenem Bereich, platzieren Sie es mit data-start und data-duration und wählen Sie den Quell-Offset mit data-media-start. Angrenzende Bereiche ergeben einen harten Schnitt. Ein Überblendungseffekt verwendet überlappende Clips auf verschiedenen Spuren plus visuelle Deckkraft-Keyframes; Audioüberblendungen verwenden /hyperframes-audio.
| Erstellungsanfrage | Wahrheitsgetreuer Mechanismus |
|---|---|
| Punch-In / Punch-Out | Keyframe scale mit x/y oder prozentualer Verschiebung auf einem nicht zeitgebundenen visuellen/Crop-Wrapper innerhalb des Clips. Verwenden Sie einen festen/kurzen Tween für einen harten Punch und einen Tween für eine gleichmäßige Bewegung. |
| Gleichmäßiger Multi-State-Zoom oder Reframe | Halten Sie einen Subjekt-Wrapper aktiv und authorieren Sie mehrere Zoom/Reframe-Zustände als Pose-Leiter mit segmentweisem Easing. |
| Schwenk, Reframe oder Ken-Burns-Kamerabewegung | Animieren Sie Wrapper-Verschiebung plus Skalierung. Die Geometrie wird authoriert; dies ist keine Gesichtsverfolgung oder automatische semantische Neuausrichtung. |
| Verkettete Kamerabewegungen | Verketten Sie beschriftete Transformationsbeats auf einer registrierten suchsicheren Timeline. |
| Match Cut oder Whip Pan | /hyperframes-animation besitzt die visuelle Übergabe; /hyperframes-registry liefert Primitive; Keyframes bewahren authorierte Geometrie, Richtung und Geschwindigkeit. Es gibt keine automatische Erkennung übereinstimmender Frames. |
| Crop- und Masken-Reframe | Interpolieren Sie clip-path oder eine Maske auf einem inneren visuellen Wrapper, um zu croppen/reframen, ohne die Quellzeit zu ändern. Polygon-Keyframes können einen Polygon-/Maskenübergang bilden. |
| Gerichteter Wischschnitt oder Iris-/Enthüllungsschnitt | Animieren Sie eine Masken/Clip-Grenze über überlappende visuelle Clips; /hyperframes-animation besitzt die Übergabechoreographie. |
| Split-Screen-Übergabe | Halten Sie beide visuellen Clips durch den Core platziert, und keyframen Sie dann deren innere Crop/Mask-Wrapper und Teilergometrie. |
| Konstante Quellzeit-Neuskalierung | /hyperframes-core besitzt die normalisierte data-playback-rate (0.1..10) für rendersichere Bild- und tonhöhenbewahrte Tonausgabe. Sie ist für das gesamte Medienelement konstant. |
| Quellengeschwindigkeitsrampen | 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. |
| Freeze / Standbild | Eine visuelle Pose, ein letzter Quellframe oder eine fertiggestellte Unterkomposition kann gehalten werden. Ein willkürlicher Freeze innerhalb der Quelle wird nicht unterstützt; verarbeiten Sie ein Standbild/abgeleitetes Segment vor, platzieren Sie es als eigenen Clip, und fahren Sie dann mit einem anderen Quellbereich fort. |
Wenn Sie Bild und Ton gemeinsam bearbeiten, laden Sie /hyperframes-core, diesen Skill für visuelle Bewegung und /hyperframes-audio für Überblendungen, Crossfades, Lautstärkeautomatisierung, Ducking/Carve oder Effekte auf den platzierten Spuren.
Ein visueller Übergang oder eine Zuschneidebehandlung ist kein temporaler Quelltrim oder -splice. /hyperframes-core besitzt die Timeline, das Clip-Timing und die Quellbereiche; Keyframes animieren nur die sichtbare Übergabe oder den Crop auf Wrappern innerhalb dieser Clips. Für kopierbare kombinierte Bild/Ton-Rezepte verwenden Sie /hyperframes-core → references/creator-editing-recipes.md.
Vorgehen
- Identifizieren Sie das animierte Subjekt, die sichtbaren Zustände, den Endzustand und die Laufzeit.
- Wählen Sie den kleinsten Mechanismus, der die Aufforderung beweist. Lesen Sie
references/keyframe-patterns.mdnur, wenn der Mechanismus unklar ist. - Authorieren Sie suchsichere Keyframes in der deklarierten Laufzeit. Registrieren Sie die Laufzeitinstanz erst, nachdem der Build abgeschlossen ist; der Build innerhalb von
document.fonts.readyist in Ordnung. - Verifizieren Sie mit
hyperframes check(es führt Lint aus),hyperframes keyframes, einem fokussierten--shotund Schnappschüssen zu Beweiszeitpunkten. - Wenn der Beweis fehlschlägt, korrigieren Sie die Quell-Keyframes und führen Sie die kleinste fehlschlagende Diagnose erneut aus, bevor Sie rendern.
Vertrag
- Benennen Sie das sich bewegende Subjekt.
- Benennen Sie die Posen, die benötigt werden, um die beabsichtigte Bewegung zu beweisen, einschließlich des Endzustands.
- Keyframen Sie sichtbare Kanäle, keinen versteckten Helferzustand.
- Bewahren Sie die Objektidentität, wenn Kontinuität wichtig ist.
- Überblenden Sie nur, wenn die beabsichtigte Bewegung Ersatz oder Auflösung ist.
- Halten Sie lesbare oder semantische Zustände lange genug, um sie zu sehen.
- Der letzte Frame ist Teil der Animation, kein Aufräumen.
- Setzen Sie nicht auf Ruhezustand zurück, wenn nicht angefordert.
- Beenden Sie nicht auf Schwarz, wenn nicht angefordert.
- Wenn Sie eine Start-Szene bearbeiten, bewahren Sie Layout, Inhalt, Assets, Farben und den Endzustand, wenn nicht nach einem Redesign gefragt wird.
Laufzeitregeln
GSAP:
- Erstellen Sie beim Laden der Seite oder innerhalb von
document.fonts.readyund registrieren Sie erst, nachdem der Build abgeschlossen ist - Verwenden Sie
gsap.timeline({ paused: true }) - Registrieren Sie als
window.__timelines[compositionId] - Der Registry-Schlüssel muss mit
data-composition-idübereinstimmen - Rufen Sie
tl.play()nicht für render-kritische Bewegungen auf - Halten Sie Wiederholungen endlich
CSS-Keyframes:
- Endliche Dauer und Iterationsanzahl
- Deterministische Verzögerung
animation-fill-mode: both- Verwenden Sie
data-start, wenn das Timing zu einem Clip gehört
Anime.js:
- Synchron erstellen
autoplay: false- Endliche Dauer und Schleifen
- Jede Instanz zu
window.__hfAnimehinzufügen
WAAPI:
- Endliche
duration fill: "both"- Deterministische Konstruktion
- Die Textoberfläche listet WAAPI nicht auf; verifizieren Sie mit
--shot(es sucht WAAPI) und Schnappschüssen
Nie für render-kritische Bewegungen verwenden:
Date.now()performance.now()- Unseeded
Math.random() - Hover/Scroll-Trigger
- Timer
- Eine Timeline, die registriert wurde, bevor ihr asynchroner Build abgeschlossen ist
- Nicht registriertes
requestAnimationFrame - Endlosschleifen
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;
Verwenden Sie Labels für semantische Zustände. Verwenden Sie Positionsparameter anstelle von verketteten Verzögerungen. Verwenden Sie immediateRender: false für spätere from()/fromTo()-Tweens, die dieselbe Eigenschaft berühren.
Keyframe-Formen
- Array-Keyframes: Pose-Leiter mit Schritt-Dauer/Easing.
- Prozentuale Keyframes: exaktes Timing innerhalb eines Tweens.
- Eigenschafts-Arrays: kompakte Multi-Stop-Änderungen.
ease: "none"auf dem Elternteil, wenn jeder Stop sein eigenes Easing hat.easeEach, wenn jedes Segment das gleiche Gefühl haben soll.
Kopieren Sie keine numerischen Abstände oder Timings aus Beispielen. Leiten Sie sie aus der tatsächlichen Zusammensetzungsgeometrie und -dauer ab.
Bevorzugen Sie für ein Subjekt, das sich zwischen zwei Boxen bewegt, einen kontinuierlichen Transform-Tween oder FLIP. Teilen Sie x/y/scale nur dann in mehrere erweichte Keyframes auf, wenn der Betrachter deutliche Beats spüren soll; jedes Segment ändert die Geschwindigkeit und kann als Ruckeln wahrgenommen werden.
Kanäle
Bevorzugen Sie Composer/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, Kameratransformationen, Shader-Uniforms.
Vermeiden Sie Layout-/Lebenszyklus-Kanäle: top/left/right/bottom, width/height, margin/padding, display, visibility, späte DOM-Erstellung, Helfer-Overlays, die Subjektbewegungen ausführen.
Verwenden Sie für Sichtbarkeitsänderungen autoAlpha auf der registrierten suchsicheren GSAP-Timeline oder ein tl.set() mit Dauer Null an einer expliziten Grenze. Zielen Sie nur auf ein Nicht-Clip-Element oder einen Wrapper innerhalb des Clips; zielen Sie niemals auf .clip selbst. Verwenden Sie niemals Duration-Tweens für rohes visibility und tweenen Sie niemals display.
Mechanismusauswahl
Wählen Sie den kleinsten Mechanismus, der die Aufforderung beweist:
| Bedarf | Mechanismus |
|---|---|
| Gleiches Subjekt ändert Box oder Hierarchie | Shared Element / FLIP |
| Subjekt legt eine sichtbare Route zurück | Pfadreise |
| Strich wächst oder zeichnet nach | Strichzeichnung |
| Form wird zu einer anderen Form | Forminterpolation |
| Enthüllungsgrenze ist sichtbar | Clip, Maske oder Shader-Uniform |
| Viele Elemente bewegen sich mit Ordnung | Stagger / Indizierte Verzögerung |
| Text selbst bewegt sich | Zeilen-, Wort-, Zeichen- oder Bandunterteilung |
| Oberfläche biegt, dehnt oder croppt | Eltern/Kind-Gegentransformation |
| 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 verdeutlicht.
- Beschleunigung verlässt die Ruhe.
- Höhepunkt beweist den Mechanismus unmissverständlich.
- Nachlauf verkauft Energie und Richtung.
- Überschwingen nur, wenn sich das Subjekt elastisch oder taktil anfühlen soll.
- Gleichmäßige Pfadreise benötigt normalerweise
ease: "none". - Diskrete UI-Zustände benötigen normalerweise ein scharfes Ausblenden.
- Wiederholte Elemente benötigen geordnete Offsets, keine identische Zeitsteuerung.
- Endgültige Verriegelungen benötigen längere Haltezeiten als Übergangsposen.
- Glätte bedeutet kontinuierliche Geschwindigkeit auf demselben Subjekt.
- Überlappen Sie keine Tweens, die dieselbe Transform-Eigenschaft schreiben, es sei denn, die Überlappung ist beabsichtigt und verifiziert.
- Vermeiden Sie es, große
clip-path/Maskenänderungen zu animieren, während dieselbe Hauptoberfläche auch skaliert oder reist; verwenden Sie verschachtelte Enthüllungen, nachdem sich die Hauptbewegung beruhigt hat.
Text
Bewahren Sie Zeilenboxen, Wortabstand, Lesbarkeit und endgültige Passform. Wenn sich Text intern bewegt, bewegen Sie die Glyphen oder maskierten Bänder, nicht nur Dekorationen um den Text. Machen Sie Schnappschüsse von lesbaren Frames.
SVG
Bevorzugen Sie für Strichwachstum DrawSVGPlugin, dann stroke-dasharray/stroke-dashoffset. Bevorzugen Sie für Forminterpolation MorphSVGPlugin; konvertieren Sie Primitive bei Bedarf in Pfade und teilen Sie komplexe Silhouetten in einfachere Teile auf.
3D
Nur Skalierung ist keine echte Tiefe. Verwenden Sie Perspektive auf einem stabilen Elternteil, transform-style: preserve-3d, z-Reise, Rotation, Kamera-/Weltbewegung, Okklusion und Ebenenreihenfolge, wenn sich Objekte kreuzen.
Verwenden Sie ein oder zwei diagnostische Winkel, die die Tiefenbeziehung offenlegen. Wenn der angewinkelte Beweis keine Tiefenkreuzung zeigt, verbessern Sie z/Kamera/Okklusion.
Canvas / WebGL
Keyframen Sie Kameraposition, Kameraziel, Objekttransformation, Materialopazität, Shader-Uniforms und Nachbearbeitungsintensität durch deterministischen Zustand. Rendern Sie aus HyperFrames-Zeit. Verwenden Sie --ghost, da Markerboxen keine interne Canvas-Bewegung sehen können.
CLI-Beweis
npx hyperframes check
npx hyperframes keyframes .
npx hyperframes keyframes . --json
npx hyperframes keyframes . --runtime all
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --samples <n>
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --layout strip --from <t0> --to <t1>
npx hyperframes keyframes . --shot "<file>" --ghost --angle <angle>
npx hyperframes snapshot . --at <times>
Wählen Sie <selector> für das tatsächliche animierte Subjekt. Wählen Sie <times> für den ersten Frame, Beweispunkte, Finale-minus-Halte und exaktes Ende. Wählen Sie <angle> nur, wenn Tiefe bewiesen werden muss.
| Tool | Beweist |
|---|---|
keyframes | Ziele, explizite Stopps, Pfade, Spuren, zusammengesetzte Eltern/Kind-Bewegung, CSS-Stopps, Anime-Registrierung |
--shot | Geister, Routenform, Zeitabstand, DOM 3D-Projektion, fokussierter Selektorbeweis |
--layout strip | Bewegung an Ort und Stelle, Überlappungen, Kontakt, subtile Skalierung/Opazität, Textwellen |
--ghost | Canvas, WebGL, Shader-Bewegung, gerendertes 3D |
snapshot --at | Masken, sichtbare Grenzen, Endzustände, Schlüsselframes |