ノード一覧に戻る

クリップループ補正

clip_loop_fit

AnimationClip の先頭状態を尺の位置(フレーム D)へ複製します。書き出しフレーム 0〜D-1 は「先頭に戻る直前」で止まり、ループしても一瞬止まりません

確認済み
解説あり

入力ポート

名前説明
クリップ
clip
AnimationClip
ループ補正する AnimationClip document です
進行度
progress
Float
正規化進行度(0.0〜1.0)のオプション入力です。未接続ならアニメーション時間に自動追従します

出力ポート

名前説明
クリップ
clip
AnimationClip
ループ補正済み AnimationClip document です
レイヤー
layer
RecordedLayer
補正済み clip を RecordedLayer として見た bridge 出力です
value
Map
指定時刻で評価した補正済み clip の現在値です
概要
summary
Text
短い概要文字列です

概要

クリップをループでつながる形に自動補正するノードです。先頭の状態を末尾に コピーして「最後のコマ→最初のコマ」の飛びをなくします。歩行や待機など、 繰り返し再生するモーションの仕上げに挟みます。

使い方のポイント

  • 置き場所は clip の直後: keyframe_clip → clip_loop_fit → clip_apply_*。 記録時にループを意識せず作っても、後からこのノードで閉じられる
  • 記録の最終ポーズが初期ポーズと大きく違う場合、末尾に「戻る動き」が 追加される形になる。戻りが急すぎるなら記録側で終わりを初期ポーズに寄せる

関連ノード

  • keyframe_clip — 補正対象のクリップ
  • clip_mixer — 合成してから補正も可
  • clip_apply_path / clip_apply_image — 補正後の適用先

技術詳細

内部では RecordedLayer 側の loop_fit を利用して、各 track の先頭状態を duration 末尾へ補います。
小ループを作りたい時に、clip 側の段階でつなぎやすくするための補助ノードです。

使用例

  • KeyframeClip の出力を ClipLoopFit に通してから ClipApplyPath / ClipApplyImage へ流します。

closureであり周期wrapではありません

Clip Loop Fit は先頭sampleをduration末尾へ追加して端点を一致させます。 duration外の評価時刻を周期的にwrapする再生機能ではありません。周期再生にはloopする 進行度を供給してください。progressは0〜1の正規化進行度で、progress × 尺(フレーム数)を評価します。 書き出し側(keyframe_clipのspritesheetやanimation_render)は尺Dフレームをt=0〜D-1で サンプルするため、補正後の最終フレームは「先頭に戻る直前」で止まります(ループ端点規則D7)。

ノード一覧に戻る
クリップループ補正 — PixPipeline ノード解説