プラグインインストール: セットアップまたはフレッシュネスコマンドの前に、このスキルがHyperFramesプラグイン内にある場合は、プラグイン実行ルールに従ってください。スタンドアロンインストールの場合は、以下の更新手順を保持してください。
HyperFrames キーフレーム
キーフレームはポーズコントラクトです。可視状態、継続的な被写体の同一性、シークセーフなランタイム、検証済みピクセルを意味します。
広範なシーンレシピにはhyperframes-animationを使用してください。完全なコマンドドキュメントにはhyperframes-cliを使用してください。実装メカニズムを選択する場合(ビジュアルスタイルではなく)にのみreferences/keyframe-patterns.mdを参照してください。
クリエイター編集境界
キーフレームはビジュアルモーションを担当し、クリップのアセンブリは担当しません。ソース範囲のハードカット、トリム、スプライス、並べ替えは/hyperframes-coreに属します。保持する範囲ごとに1つのメディア要素を作成し、data-startとdata-durationで配置し、data-media-startでソースオフセットを選択します。隣接する範囲はハードカットになります。クロスフェードは、異なるトラック上で重なるクリップとビジュアル不透明度キーフレームを使用します。サウンドフェードは/hyperframes-audioを使用します。
| クリエイターリクエスト | 正確なメカニズム |
|---|---|
| パンチイン / パンチアウト | クリップ内の非タイミングビジュアル/クロップラッパー上で、x/yまたはパーセンテージ移動を伴うキーフレームscaleを使用します。ハードパンチにはセット/ショートトゥイーン、スムーズな動きにはトゥイーンを使用します。 |
| スムーズなマルチステートズームまたはリフレーム | 1つの被写体ラッパーを維持し、複数のズーム/リフレーム状態を、セグメントごとのイージングを持つポーズラダーとして作成します。 |
| パン、リフレーム、またはケンバーンズカメラ移動 | ラッパーの移動とスケールをアニメーション化します。ジオメトリは作成されます。これはフェイストラッキングや自動セマンティックリフレームではありません。 |
| チェーンカメラ移動 | ラベル付きトランスフォームビートを1つの登録済みシークセーフタイムラインにチェーンします。 |
| マッチカットまたはワイプパン | /hyperframes-animationがビジュアルハンドオフを担当し、/hyperframes-registryがプリミティブを提供します。キーフレームは作成されたジオメトリ、方向、速度を保持します。自動マッチングフレーム検出はありません。 |
| クロップとマスクリフレーム | 内部ビジュアルラッパーでclip-pathまたはマスクを補間し、ソース時間を変更せずにクロップ/リフレームします。ポリゴンキーフレームはポリゴン/マスクトランジションを形成できます。 |
| 方向性ワイプカットまたはアイリス/リビールカット | 重なるビジュアルクリップ間でマスク/クリップ境界をアニメーション化します。/hyperframes-animationがハンドオフの振り付けを担当します。 |
| スプリットスクリーンハンドオフ | コアで両方のビジュアルクリップを配置し、その内部のクロップ/マスクラッパーと仕切りジオメトリをキーフレームで制御します。 |
| 一定のソースリタイム | /hyperframes-coreが、レンダリングセーフなピクチャーとピッチ保存サウンドのために正規化されたdata-playback-rate(0.1..10)を担当します。メディア要素全体で一定です。 |
| ソース速度ランプ | data-automation内のrateレーンを<video>/<audio>に設定します(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 | マスク |