Spline Editor(SplineEditor)

⚠️ 進行中
まだワークフローの一部として期待しないでください。
多くのバグが含まれている可能性があり、安定性は
保証されません!!

さまざまなスケジュールやマスクバッチの値を生成するためのグラフィカルエディタ

技術的な実装の観点から、Spline Editorノードは複数のサンプリング方法（パス長や時間によるものなど）と補間アルゴリズム（Cardinal、Basisなど）をサポートし、制御点間の滑らかな遷移を計算します。

Spline Editorは、スプライン曲線を作成および編集するためのノードです。ユーザーは一連の制御点を定義することで、滑らかなパスや数値シーケンスを生成できます。このノードの中核機能は、これらの点を画像処理に使用可能なマスク（Mask）または一連の浮動小数点数の値に変換し、後続のアニメーションや重み制御のための基礎データを提供することです。

編集コントロール

• Shift + クリック で末尾に制御点を追加します。
• Ctrl + クリック で2点間に制御点を追加（分割）します。
• 点を右クリック で削除します（最初/最後の点は削除できません）。
• キャンバス上で右クリックするとコンテキストメニューが表示されます：
  • 新しいスプラインを追加 – 同じキャンバス上に新しいスプラインを作成します。これらのパスは現在、座標としてのみ出力されます。
  • 単一点を追加 – 現在位置の座標を返す単一の点を作成します。
  • スプラインを削除 – 現在選択されているスプラインを削除します（パスをクリックするか、「次のスプライン」オプションでスプラインを切り替えて選択します）。
• 純粋に視覚的なオプション（出力には影響しません）：
  • ハンドルの表示/非表示を切り替え
  • サンプル点を表示 – 返される点を表示します。

points_to_sample の値は、描かれたスプライン自体から返されるサンプル数を設定します。これは実際の制御点とは独立しているため、補間の種類が重要です。

sampling_method:

• time – 時間軸に沿ってサンプリング（スケジュール用）
• path – パス自体に沿ってサンプリング（座標に便利）
• controlpoints – 制御点のみをサンプリング
• speed – パスに沿った速度に基づいてサンプリング

出力タイプ:

• マスクバッチ – マスクを受け入れるノードと互換性あり
• 浮動小数点数のリスト – IPAdapterの重みなどと互換性あり
• pandasシリーズ – Fizzのノード Batch Value Schedule と互換性あり
• torchテンソル – 不明なノードと互換性あり

ノード機能

技術的な実装の観点から、このノードはさまざまなサンプリング方法（パス長や時間によるものなど）と補間アルゴリズム（Cardinal、Basisなど）をサポートし、制御点間の滑らかな遷移を計算します。文字列形式の座標点データを受け取り、ユーザー定義のキャンバスサイズ（mask_width および mask_height）上で対応するグレースケールマスク画像または数値リストを生成できます。また、出力結果を指定回数繰り返すこともサポートしています。

ノードパラメータ説明 - Spline Editor

接続入力 (Inputs)

コントロールパラメータ (Parameters)

出力

使用シーン

実際のアプリケーションでは、このノードは動的マスクや制御パラメータ曲線の構築によく使用されます。例えば、ビデオフレーム処理ワークフローでは、ユーザーが動きのパスを描画できます。Spline Editorはそのパスに沿ったマスクシーケンスを生成し、後続のノードで画像コンテンツ（粒子や光線など）の移動軌道を導くために使用され、複雑なアニメーション効果を作り出します。

注意事項

入力座標点の文字列形式は正確でなければならず、定義されたキャンバスサイズは最終的に使用する画像サイズと一致させる必要があります。一致しない場合、生成されるマスクがずれる可能性があります。また、曲線の滑らかさを確保するため、サンプリング点の数は低く設定しすぎないように注意してください。

Spline Editor ノードソースコードリンク

Spline Editor ノードは ComfyUI-KJNodes ノードパッケージに含まれています。