クリップ適用画像

概要

keyframe_clip のクリップを画像に適用するノードです。選択範囲の移動・変形 として記録した動きを、指定時刻の状態で画像に再現します。パス版の clip_apply_path と対になる、クリップ→最終画像の橋渡し役です。

使い方のポイント

• 定番チェーン: keyframe_clip.clip + 元画像 → clip_apply_image → animation_render。記録した選択範囲の動きがスプライトシートにベイクされる
• Time Source は progress へつなぐとレンダーと同期します。Float Input を progress へつなぐと手動スクラブできます

関連ノード

• keyframe_clip — 適用するクリップの供給元
• clip_apply_path — パス版
• animation_render — 最終ベイク
• time_source — 時刻の供給

技術詳細

現在の実装では PixelCanvas の selection transform 記録を、最終画像に対して nearest-neighbor で適用します。

ここで重要なのは、現在の Clip Apply Image は

• PixelCanvasDocument 自体を編集するノードではない
• render-domain の Image に対して適用する

という点です。

そのため、P07 の基礎実装では次の用途を優先しています。

• 記録した selection move を、そのまま再生確認する
• downstream の合成・レンダーへ流す

逆に、layer 単位での非破壊再編集はこの段階ではまだ扱いません。

使用例

1. PixelCanvas
2. RecordTake
3. KeyframeClip
4. ClipApplyImage

接続:

• RecordTake.layer -> KeyframeClip.layer
• PixelCanvas.output -> ClipApplyImage.image
• KeyframeClip.clip -> ClipApplyImage.clip
• Float Input.output -> ClipApplyImage.time

これで Float Input を動かすと、selection transform の記録が画像へ再適用されます。

時刻と bounds 警告

• 時刻入力は progress(0〜1 の正規化進行度)一本です。Time Source は progress へ接続します。旧バージョンの絶対秒 time ピンは廃止され、 旧プロジェクトの接続は読込時に progress へ自動で繋ぎ替えられます。未接続時の評価時刻は 正規化進行度として扱われます。
• 記録時と現在の画像サイズが違う場合、selection bounds は実画像領域へ切り詰めて 安全に適用します。切り詰めは bounds_clipped、完全に画像外なら bounds_outside が warnings に出ます。