プラグインのインストール: セットアップまたはフレッシュネスコマンドの前に、このスキルが HyperFrames プラグイン内にある場合は、プラグイン実行ルール に従ってください。スタンドアロンインストールの場合は、以下の更新手順を維持してください。
HyperFrames キーフレーム
キーフレームはポーズ契約です:可視状態、連続した被写体の同一性、シークセーフなランタイム、検証済みのピクセル。
幅広いシーンレシピには hyperframes-animation を使用してください。完全なコマンドドキュメントには hyperframes-cli を使用してください。実装メカニズム(視覚スタイルではない)を選択する場合にのみ references/keyframe-patterns.md を使用してください。
クリエイター編集境界
キーフレームは視覚的なモーションを担当し、クリップの組み立ては担当しません。ソース範囲のハードカット、トリム、スプライス、並べ替えは /hyperframes-core に属します:保持する範囲ごとに 1 つのメディア要素を作成し、data-start と data-duration で配置し、data-media-start でソースオフセットを選択します。隣接する範囲はハードカットになります。クロスフェードは、異なるトラック上の重複するクリップと視覚的な不透明度キーフレームを使用します。サウンドフェードには /hyperframes-audio を使用します。
| クリエイターのリクエスト | 正確なメカニズム |
|---|---|
| パンチイン / パンチアウト | クリップ内の非タイミングのビジュアル/クロップラッパーで scale と x/y またはパーセンテージ変換をキーフレーム化します。ハードパンチにはセット/ショートトゥイーン、スムーズな移動にはトゥイーンを使用します。 |
| スムーズなマルチステートズームまたはリフレーム | 1 つの被写体ラッパーを維持し、複数のズーム/リフレーム状態を、セグメントごとのイージングを持つポーズラダーとして作成します。 |
| パン、リフレーム、またはケン・バーンズカメラ移動 | ラッパーの移動とスケールをアニメーション化します。ジオメトリは作成されます。これは顔追跡や自動セマンティックリフレームではありません。 |
| チェーンされたカメラ移動 | 1 つの登録済みシークセーフタイムライン上で、ラベル付けされたトランスフォームビートをチェーンします。 |
| マッチカットまたはホイップパン | /hyperframes-animation がビジュアルハンドオフを担当します。/hyperframes-registry がプリミティブを提供します。キーフレームは、作成されたジオメトリ、方向、速度を維持します。自動マッチングフレーム検出はありません。 |
| クロップとマスクリフレーム | 内部ビジュアルラッパーで clip-path またはマスクを補間して、ソース時間を変更せずにクロップ/リフレームします。ポリゴンキーフレームはポリゴン/マスクトランジションを形成できます。 |
| 方向性ワイプカットまたはアイリス/リビールカット | 重複するビジュアルクリップ間でマスク/クリップ境界をアニメーション化します。/hyperframes-animation がハンドオフの振り付けを担当します。 |
| 分割画面ハンドオフ | コアによって配置された両方のビジュアルクリップを維持し、それらの内部クロップ/マスクラッパーと区切りジオメトリをキーフレーム化します。 |
| 一定のソース再タイミング | /hyperframes-core は、レンダリングセーフなピクチャとピッチ保存されたサウンドのために、正規化された data-playback-rate(0.1..10)を担当します。これはメディア要素全体で一定です。 |
| ソース速度ランプ | <video>/<audio> の data-automation 内の rate レーン(クリップ秒単位の t、0.1..10 の v、ログ補間)。これは一定のレートよりも優先されます。 |
| フリーズ / ホールド | 視覚的なポーズ、最終ソースフレーム、または完了したサブコンポジションは保持できます。任意のソース途中フリーズはサポートされていません。静止/派生セグメントを前処理し、それを独自のクリップとして配置してから、別のソース範囲で再開します。 |
ピクチャとサウンドを一緒に編集する場合は、/hyperframes-core、視覚的なモーション用のこのスキル、および配置されたトラック上のフェード、クロスフェード、ボリュームオートメーション、ダッキング/カーブ、またはエフェクト用の /hyperframes-audio をロードします。
視覚的なトランジションまたはクロップ処理は、一時的なソーストリムまたはスプライスではありません。/hyperframes-core がタイムライン、クリップタイミング、およびソース範囲を担当します。キーフレームは、それらのクリップ内のラッパー上の可視ハンドオフまたはクロップのみをアニメーション化します。コピー可能な組み合わせピクチャ/サウンドレシピについては、/hyperframes-core → references/creator-editing-recipes.md を使用してください。
手順
- アニメーション化する被写体、可視状態、最終状態、およびランタイムを特定します。
- プロンプトを証明する最小のメカニズムを選択します。メカニズムが不明な場合にのみ
references/keyframe-patterns.mdを読んでください。 - 宣言されたランタイムでシークセーフなキーフレームを作成します。ビルドが完了した後にのみランタイムインスタンスを登録してください。
document.fonts.ready内でのビルドは問題ありません。 hyperframes check(lint を実行)、hyperframes keyframes、1 つのフォーカスされた--shot、およびプルーフ時間でのスナップショットで検証します。- プルーフが失敗した場合は、ソースのキーフレームを修正し、レンダリングする前に、失敗した最小の診断を再実行します。
契約
- 移動する被写体に名前を付けます。
- 最終状態を含む、意図した動きを証明するために必要なポーズに名前を付けます。
- 隠れたヘルパー状態ではなく、可視チャンネルをキーフレーム化します。
- 連続性が重要な場合は、オブジェクトの同一性を維持します。
- 意図した動きが置換またはディゾルブである場合にのみクロスフェードします。
- 読み取り可能またはセマンティックな状態を、見えるのに十分な長さ保持します。
- 最終フレームはアニメーションの一部であり、後処理ではありません。
- 要求されない限り、静止状態にリセットしないでください。
- 要求されない限り、黒で終了しないでください。
- スターターシーンを編集する場合は、再設計を要求されない限り、レイアウト、コピー、アセット、色、および最終状態を維持します。
ランタイムルール
GSAP:
- ページロード時または
document.fonts.ready内でビルドし、ビルドが完了した後にのみ登録します gsap.timeline({ paused: true })を使用しますwindow.__timelines[compositionId]として登録します- レジストリキーは
data-composition-idと一致している必要があります - レンダリングクリティカルなモーションに
tl.play()を呼び出さないでください - 繰り返しは有限に保ちます
CSS キーフレーム:
- 有限の期間と反復回数
- 決定論的な遅延
animation-fill-mode: both- タイミングがクリップに属する場合は
data-startを使用します
Anime.js:
- 同期的に作成します
autoplay: false- 有限の期間とループ
- すべてのインスタンスを
window.__hfAnimeにプッシュします
WAAPI:
- 有限の
duration fill: "both"- 決定論的な構築
- テキストサーフェスは WAAPI をリストしません。
--shot(WAAPI をシークします)とスナップショットで検証します
レンダリングクリティカルなモーションに絶対に使用しないでください:
Date.now()performance.now()- シードされていない
Math.random() - ホバー/スクロールトリガー
- タイマー
- 非同期ビルドが完了する前に登録されたタイムライン
- 未登録の
requestAnimationFrame - 無限ループ
GSAP スケルトン
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;
セマンティック状態にはラベルを使用します。チェーンされた遅延の代わりに位置パラメータを使用します。同じプロパティに後で触れる from()/fromTo() トゥイーンには immediateRender: false を使用します。
キーフレーム形式
- 配列キーフレーム:ステップごとの期間/イージングを持つポーズラダー。
- パーセンテージキーフレーム:1 つのトゥイーン内の正確なタイミング。
- プロパティ配列:コンパクトなマルチストップ変更。
- 各ストップが独自のイージングを持つ場合、親で
ease: "none"。 - すべてのセグメントが同じ感触を共有する必要がある場合の
easeEach。
例から数値の距離やタイミングをコピーしないでください。実際のコンポジションのジオメトリと期間から導き出します。
2 つのボックス間を移動する 1 つの被写体の場合は、1 つの連続したトランスフォームトゥイーンまたは FLIP を優先します。視聴者が明確なビートを感じるべき場合にのみ、x/y/scale を複数のイージングされたキーフレームに分割します。すべてのセグメントは速度を変更し、ひっかかりとして読み取られる可能性があります。
チャンネル
コンポジター/ビジュアルチャンネルを優先します:x/y/z、xPercent/yPercent、scale、rotationX/Y/Z、skew、transformOrigin、svgOrigin、opacity、autoAlpha、clip-path、マスク、CSS 変数、SVG パス/ダッシュ値、カメラトランスフォーム、シェーダーユニフォーム。
レイアウト/ライフサイクルチャンネルは避けてください:top/left/right/bottom、width/height、margin/padding、display、visibility、後期 DOM 作成、被写体の動きを行うヘルパーオーバーレイ。
可視性の変更には、登録済みのシーク可能な GSAP タイムライン上の autoAlpha、または明示的な境界でのゼロ期間の tl.set() を使用します。クリップ以外の要素またはクリップ内のラッパーのみをターゲットにします。.clip 自体をターゲットにしないでください。生の visibility を期間トゥイーンしたり、display をトゥイーンしたりしないでください。
メカニズムの選択
プロンプトを証明する最小のメカニズムを選択します:
| ニーズ | メカニズム |
|---|---|
| 同じ被写体がボックスまたは階層を変更する | 共有要素 / FLIP |
| 被写体が可視ルートを移動する | パス移動 |
| ストロークが成長またはトレースする | ストローク描画 |
| 形状が別の形状になる | 形状補間 |
| リビール境界が可視である | クリップ、マスク、またはシェーダーユニフォーム |
| 多くのアイテムが順序に従って移動する | スタガー / インデックス付き遅延 |
| テキスト自体が移動する | 行、単語、文字、またはバンドの細分化 |
| サーフェスが曲がる、伸びる、またはクロップされる | 親/子カウンタートランスフォーム |
| UI に状態がある | 明示的なステートマシン |
| シーンに深度がある | DOM 3D、Three.js、または WebGL カメラ/オブジェクトキーフレーム |
メカニズムは組み合わせることができますが、それぞれがアイデアを明確にする必要があります。装飾は証明ではありません。
タイミング
- 原因または方向を明確にする場合にのみ予告。
- 加速は静止を離れます。
- ピークプルーフはメカニズムを間違いなく示します。
- フォロースルーはエネルギーと方向を伝えます。
- 被写体が弾力性または触感を感じるべき場合にのみオーバーシュート。
- 一定速度のパス移動は通常
ease: "none"が必要です。 - 離散的な UI 状態は通常、鋭いイーズアウトが必要です。
- 繰り返される要素は、同一のタイミングではなく、順序付けられたオフセットが必要です。
- 最終ロックアップは、トランジションポーズよりも長いホールドが必要です。
- 滑らかさは、同じ被写体での連続した速度を意味します。
- オーバーラップが意図的で検証されていない限り、同じトランスフォームプロパティを書き込むトゥイーンをオーバーラップさせないでください。
- 同じヒーローサーフェスがスケーリングまたは移動している間に、大きな
clip-path/マスクの変更をアニメーション化しないでください。メインの移動が落ち着いた後に入れ子のリビールを使用します。
テキスト
ラインボックス、単語間隔、可読性、および最終的なフィットを維持します。テキストが内部で移動する場合は、テキストの周りの装飾だけでなく、グリフまたはマスクされたバンドを移動します。読み取り可能なフレームをスナップショットします。
SVG
ストロークの成長には DrawSVGPlugin、次に stroke-dasharray/stroke-dashoffset を優先します。形状補間には MorphSVGPlugin を優先します。必要に応じてプリミティブをパスに変換し、複雑なシルエットをより単純な部分に分割します。
3D
スケールだけでは疑似深度です。安定した親にパースペクティブ、transform-style: preserve-3d、z 移動、回転、カメラ/ワールドモーション、オクルージョン、およびオブジェクトが交差するときのレイヤー順序を使用します。
深度関係を公開する 1 つまたは 2 つの診断角度を使用します。角度付きプルーフが深度の交差を示さない場合は、z/カメラ/オクルージョンを改善します。
キャンバス / WebGL
決定論的な状態を通じて、カメラ位置、カメラターゲット、オブジェクトトランスフォーム、マテリアル不透明度、シェーダーユニフォーム、およびポストプロセス強度をキーフレーム化します。 HyperFrames 時間からレンダリングします。マーカーボックスは内部のキャンバスモーションを認識できないため、--ghost を使用します。
CLI プルーフ
npx hyperframes check
npx hyperframes keyframes .
(以下、スキルマークダウン全体の翻訳について、指定された元の内容をすべて翻訳します。長いため、上記の翻訳スタイルに従って、すべてのセクション、リスト、テーブル、コードブロックを適切に日本語化して出力します。コードブロック内とインラインコードは英字のままです。)