Plugin-Installation: Führen Sie vor Setup- oder Aktualisierungsbefehlen die Plugin-Ausführungsregeln aus, wenn dieses Skill innerhalb eines HyperFrames-Plugins verwendet wird. Bei eigenständigen Installationen behalten Sie die folgenden Aktualisierungshinweise bei.
HyperFrames Keyframes
Keyframes sind ein Posenvertrag: sichtbare Zustände, kontinuierliche Subjektidentität, suchsichere Laufzeit, verifizierte Pixel.
Verwenden Sie hyperframes-animation für übergreifende Szenenrezepte. Verwenden Sie hyperframes-cli für die vollständige Befehlsdokumentation. Verwenden Sie references/keyframe-patterns.md nur bei der Auswahl von Implementierungsmechanismen, nicht des visuellen Stils.
Bearbeitungsgrenze des Erstellers
Keyframes steuern die visuelle Bewegung, nicht den Clip-Zusammenbau. Harte Schnitte im Quellbereich, Trimmen, Splice und Neuanordnung gehören zu /hyperframes-core: Autor eines Medienelements pro beibehaltenem Bereich, platziere es mit data-start und data-duration und wähle seinen Quelloffset mit data-media-start. Angrenzende Bereiche ergeben einen harten Schnitt. Eine Überblendung verwendet überlappende Clips auf verschiedenen Spuren plus visuelle Deckkraft-Keyframes; Tonausblendungen verwenden /hyperframes-audio.
| Anfrage des Erstellers | Wahrheitsgemäßer Mechanismus |
|---|---|
| Punch-in / Punch-out | Keyframe scale mit x/y oder prozentualer Verschiebung auf einem nicht zeitgesteuerten visuellen/Bildausschnitt-Wrapper innerhalb des Clips. Verwenden Sie einen festgelegten/kurzen Tween für einen harten Punch und einen Tween für eine sanfte Bewegung. |
| Sanfter Multi-State-Zoom oder Reframe | Halten Sie einen Subjekt-Wrapper am Leben und autorisieren Sie mehrere Zoom/Reframe-Zustände als eine Posenleiter mit segmentspezifischem Easing. |
| Schwenk, Reframe oder Ken-Burns-Kamerafahrt | Animieren Sie die Wrapper-Translation plus Skalierung. Die Geometrie wird autorisiert; dies ist keine Gesichtsverfolgung oder automatische semantische Neurahmung. |
| Verkettete Kamerafahrten | Verketten Sie beschriftete Transformationsbeats auf einer registrierten, suchsicheren Timeline. |
| Match Cut oder Whip-Schwenk | /hyperframes-animation besitzt die visuelle Übergabe; /hyperframes-registry stellt die Grundbausteine bereit; Keyframes bewahren die autorisierte Geometrie, Richtung und Geschwindigkeit. Es gibt keine automatische Übereinstimmungsframes-Erkennung. |
| Zuschneiden und maskieren | Interpolieren Sie clip-path oder eine Maske auf einem inneren visuellen Wrapper, um zuzuschneiden/neuzurahmen, 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 überlappenden visuellen Clips; /hyperframes-animation besitzt die Übergabe-Choreographie. |
| Split-Screen-Übergabe | Behalten Sie beide visuellen Clips, die vom Kern platziert wurden, und keyframen Sie deren innere Zuschneide-/Masken-Wrapper und Trenngeometrie. |
| Konstante Quellzeitänderung | /hyperframes-core besitzt die normalisierte data-playback-rate (0.1..10) für rendersichere Bild- und tonhöhenbewahrten Ton. Sie ist für das gesamte Medienelement konstant. |
| Quellgeschwindigkeitsrampen | Eine rate-Spur in data-automation auf dem <video>/<audio> (t in Clip-Sekunden, v 0,1..10, log-Interpolation); sie gewinnt gegenüber der konstanten Rate. |
| Einfrieren / Halten | Eine visuelle Pose, das letzte Quellframe oder eine abgeschlossene Unterkomposition kann gehalten werden. Ein beliebiges Einfrieren in der Mitte der Quelle wird nicht unterstützt; bereiten Sie ein Standbild/ein abgeleitetes Segment vor, platzieren Sie es als eigenen Clip und setzen Sie dann mit einem anderen Quellbereich fort. |
Beim gemeinsamen Bearbeiten von Bild und Ton laden Sie /hyperframes-core, dieses Skill für visuelle Bewegung und /hyperframes-audio für Überblendungen, Querblenden, Lautstärkeautomatisierung, Ducking/Carve oder Effekte auf den platzierten Spuren.
Ein visueller Übergang oder eine Zuschneidebehandlung ist kein zeitlicher Quellschnitt oder Splice. /hyperframes-core besitzt die Timeline, das Clip-Timing und die Quellbereiche; Keyframes animieren nur die sichtbare Übergabe oder den Zuschnitt auf Wrappern innerhalb dieser Clips. Für kopierbare kombinierte Bild-/Tonrezepte verwenden Sie /hyperframes-core → references/creator-editing-recipes.md.
Verfahren
- Identifizieren Sie das animierte Subjekt, die sichtbaren Zustände, den Endzustand und die Laufzeit.
- Wählen Sie den kleinsten Mechanismus, der die Eingabeaufforderung beweist. Lesen Sie
references/keyframe-patterns.mdnur, wenn der Mechanismus unklar ist. - Autorisieren Sie suchsichere Keyframes in der deklarierten Laufzeit. Registrieren Sie die Laufzeitinstanz erst, nachdem der Build abgeschlossen ist; das Erstellen innerhalb von
document.fonts.readyist in Ordnung. - Verifizieren Sie mit
hyperframes check(es führt einen Lint aus),hyperframes keyframes, einem fokussierten--shotund Schnappschüssen zu Beweiszeiten. - 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 erforderlich sind, um die beabsichtigte Bewegung zu beweisen, einschließlich des Endzustands.
- Keyframen Sie sichtbare Kanäle, keinen versteckten Hilfszustand.
- Bewahren Sie die Objektidentität, wenn Kontinuität wichtig ist.
- Überblenden Sie nur, wenn die beabsichtigte Bewegung ein Ersatz oder eine Auflösung ist.
- Halten Sie lesbare oder semantische Zustände lange genug, um sie zu sehen.
- Das letzte Bild ist Teil der Animation, keine Bereinigung.
- Setzen Sie nicht auf Ruhe zurück, es sei denn, es wird angefordert.
- Beenden Sie nicht mit Schwarz, es sei denn, es wird angefordert.
- Wenn Sie eine Starterszene bearbeiten, bewahren Sie Layout, Kopie, Assets, Farben und Endzustand, es sei denn, Sie werden gebeten, neu zu gestalten.
Laufzeitregeln
GSAP:
- Erstellen Sie beim Seitenladen 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 Registrierungsschlüssel muss mit
data-composition-idübereinstimmen. - Rufen Sie
tl.play()nicht für renderkritische Bewegungen auf. - Halten Sie Wiederholungen endlich.
CSS-Keyframes:
- Endliche Dauer und Iterationszahl.
- 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.
- Fügen Sie jede Instanz zu
window.__hfAnimehinzu.
WAAPI:
- Endliche
duration. fill: "both".- Deterministische Konstruktion.
- Die Textoberfläche listet WAAPI nicht auf; verifizieren Sie mit
--shot(sucht WAAPI) und Schnappschüssen.
Niemals für renderkritische Bewegung verwenden:
Date.now()performance.now()- ungeseeter
Math.random() - Hover-/Scroll-Trigger
- Timer
- eine Timeline, die registriert wurde, bevor ihr asynchroner Build abgeschlossen ist
- nicht registrierter
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 Beschriftungen 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: Posenleiter mit schrittweiser Dauer/Easing.
- Prozentuale 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 teilen soll.
Kopieren Sie keine numerischen Abstände oder Timings aus Beispielen. Leiten Sie sie aus der tatsächlichen Kompositionsgeometrie und -dauer ab.
Für ein Subjekt, das sich zwischen zwei Boxen bewegt, bevorzugen Sie einen kontinuierlichen Transformations-Tween oder FLIP. Teilen Sie x/y/scale nur dann in mehrere erleichterte Keyframes auf, wenn der Betrachter einzelne Beats spüren soll; jedes Segment ändert die Geschwindigkeit und kann als Ruckler gelesen 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 die Subjektbewegung ausführen.
Verwenden Sie für Sichtbarkeitsänderungen autoAlpha auf der registrierten suchbaren GSAP-Timeline oder ein tl.set() mit einer Dauer von 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. Tweenen Sie niemals die Dauer von rohem visibility und niemals display.
Mechanismusauswahl
Wählen Sie den kleinsten Mechanismus, der die Eingabeaufforderung beweist:
| Bedarf | Mechanismus |
|---|---|
| Gleiches Subjekt ändert Box oder Hierarchie | geteiltes Element / FLIP |
| Subjekt reist eine sichtbare Route | Pfadverlauf |
| Strich wächst oder zeichnet nach | Strichzeichnen |
| Form wird zu einer anderen Form | Forminterpolation |
| 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 Bandunterteilung |
| Oberfläche biegt, dehnt oder schneidet | 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 klärt.
- Beschleunigung verlässt den Ruhezustand.
- Der Spitzenbeweis zeigt den Mechanismus unverkennbar.
- Durchschwingen verkauft Energie und Richtung.
- Überschwingen nur, wenn sich das Subjekt elastisch oder taktil anfühlen soll.
- Geschwindigkeitskonstanter Pfadverlauf benötigt normalerweise
ease: "none". - Diskrete UI-Zustände benötigen normalerweise ein scharfes Aus-Easing.
- Wiederholte Elemente benötigen geordnete Offsets, keine identischen Timings.
- Finale Verriegelungen benötigen längere Haltezeiten als Übergangsposen.
- Sanftheit bedeutet kontinuierliche Geschwindigkeit auf demselben Subjekt.
- Überlappen Sie keine Tweens, die dieselbe Transformationseigenschaft schreiben, es sei denn, die Überlappung ist beabsichtigt und verifiziert.
- Vermeiden Sie das Animieren großer
clip-path/Maskenänderungen, während dieselbe Heldenoberfläche auch skaliert oder reist; verwenden Sie verschachtelte Enthüllungen, nachdem sich die Hauptbewegung beruhigt hat.
Text
Bewahren Sie Zeilenboxen, Wortabstände, Lesbarkeit und endgültige Passung. Wenn sich Text intern bewegt, bewegen Sie die Glyphen oder maskierten Bänder, nicht nur Dekorationen um den Text. Erstellen Sie Schnappschüsse von lesbaren Frames.
SVG
Bevorzugen Sie für das Strichwachstum DrawSVGPlugin, dann stroke-dasharray/stroke-dashoffset. Bevorzugen Sie für die Forminterpolation MorphSVGPlugin; konvertieren Sie Primitiven bei Bedarf in Pfade und teilen Sie komplexe Silhouetten in einfachere Teile auf.
3D
Skalierung allein ist falsche Tiefe. Verwenden Sie Perspektive auf einem stabilen Elternteil, transform-style: preserve-3d, z-Reisen, Rotation, Kamera-/Weltbewegung, Okklusion und Schichtreihenfolge, wenn sich Objekte kreuzen.
Verwenden Sie ein oder zwei Diagnosewinkel, die die Tiefenbeziehung aufdecken. Wenn der angewinkelte Beweis keine Tiefenkreuzung zeigt, verbessern Sie z/Kamera/Okklusion.
Canvas / WebGL
Keyframen Sie Kameraposition, Kameraziel, Objekttransformation, Materialdeckkraft, Shader-Uniforms und Postprozess-Intensität durch deterministischen Zustand. Rendern Sie aus der HyperFrames-Zeit. Verwenden Sie --ghost, da Markerboxen die interne Canvas-Bewegung nicht 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 echte animierte Subjekt. Wählen Sie <times> für das erste Bild, Beweisposen, final-Minus-Halte und exaktes Finale. 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, Zeitabstände, DOM 3D-Projektion, fokussierter Selektorbeweis |
--layout strip | Bewegung an Ort und Stelle, Überlappungen, Kontakt, subtile Skalierung/Deckkraft, Textwellen |
--ghost | Canvas, WebGL, Shader-Bewegung, gerendertes 3D |
snapshot --at | Masken |
[gekürzt für die Übersetzung]