プラグインインストール: セットアップまたはフレッシュネスコマンドの前に、このスキルが 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、値 v 0.1..10、対数補間)。一定レートよりも優先されます。 |
| フリーズ / ホールド | ビジュアルポーズ、最終ソースフレーム、または完成したサブコンポジションをホールドできます。任意のソース内フリーズはサポートされていません。スチル/派生セグメントを前処理し、独自のクリップとして配置し、別のソース範囲で再開します。 |
ピクチャーとサウンドを一緒に編集する場合は、/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 .
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>
実際のアニメーション被写体には <selector> を選択します。最初のフレーム、証明ポーズ、最終マイナスホールド、正確な最終には <times> を選択します。深度を証明する必要がある場合のみ <angle> を選択します。
| ツール | 証明内容 |
|---|---|
keyframes | ターゲット、明示的な停止、パス、トレース、構成された親子モーション、CSS 停止、Anime 登録 |
--shot | ゴースト、ルート形状、時間間隔、DOM 3D 投影、フォーカスセレクタ証明 |
--layout strip | インプレースモーション、オーバーラップ、接触、微妙なスケール/不透明度、テキストウェーブ |
--ghost | キャンバス、WebGL、シェーダーモーション、レンダリング 3D |
snapshot --at | マスクの時間的接触とチャンネル分離の検証 |
--layout フラグ | 時間の経過に伴う被写体配置の証明(複数トラックの関係を含む) |