Cut And Drag On Path (CutAndDragOnPath) - ComfyUI-KJNodes

Cut And Drag On Path ノードは、まず入力されたパス座標文字列を解析し、マスクで覆われた画像領域の境界を正確に識別して切り抜きます。

Cut And Drag On Path ノードは、画像処理ツールであり、画像内でマスクによって選択された領域を切り取り、ユーザーが定義したパスに沿って移動させることができます。このノードは主に動的効果の作成に使用され、例えばオブジェクトを特定の軌道に沿ってスライドさせたり浮遊させたりします。修復機能が有効な場合、切り取られた領域に残された空白部分をインテリジェントに埋めることもできます。

ノード機能

ノードはまず入力されたパス座標文字列を解析し、マスクで覆われた画像領域の境界を正確に識別して切り抜きます。切り抜かれた画像フラグメントは、座標シーケンスに基づいて指定サイズのキャンバス上で変位および合成されます。技術的な核心は、座標解析、領域の切り抜き、位置の再マッピングにあり、標準的な IMAGE および MASK テンソルフォーマットをサポートし、背景画像の使用や組み込みの修復アルゴリズムによる背景処理をオプションで利用できます。

ノードパラメータ説明 - Cut And Drag On Path

接続入力 (Inputs)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`image`	IMAGE	はい	-	-	マスク領域が切り取られ、パスに沿って移動される入力画像。
`mask`	MASK	はい	-	-	画像から切り取る領域を定義するマスク。ゼロ以外のピクセルのみが考慮されます。
`bg_image`	IMAGE	いいえ	-	-	オプションの背景画像。提供された場合、修復アルゴリズムの代わりにこの画像を使用して空白領域を埋めます。

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

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`coordinates`	STRING	はい	-	-	移動パスの座標シーケンスを定義する文字列。特定の形式のJSON配列である必要があります。
`frame_width`	INT	はい	512	16 - 4096 (ステップ: 1)	出力画像の幅を設定します。有効範囲は16～4096、ステップは1です。
`frame_height`	INT	はい	512	16 - 4096 (ステップ: 1)	出力画像の高さを設定します。有効範囲は16～4096、ステップは1です。
`inpaint`	BOOLEAN	はい	True	-	切り取り後に残った空白領域をインテリジェントに修復するかどうかを制御するブールスイッチ。有効で背景画像が提供されていない場合、cv2 TELEAアルゴリズムを使用して切り取られた領域が埋められます。

Output (出力)

パラメータ名	データ型	説明
image	IMAGE	処理後の出力画像シーケンス。
mask	MASK	同じパスに沿って変換されたマスクシーケンス。

使用シナリオ

シンプルなアニメーションや特殊効果を作成する際に、このノードを使用できます。例えば、ビデオフレーム処理ワークフローにおいて、まず SAM や手動描画でオブジェクトのマスクを取得し、その後他のノードを使用して運動パスの座標を生成し、最後にこのノードに接続することで、そのオブジェクトがパスに沿って移動する一連の画像シーケンスを出力し、後続のフレーム合成に使用できます。

注意事項

入力する座標文字列は特定の JSON フォーマット要件に準拠している必要があり、そうでない場合は正しく解析されない可能性があります。また、マスク領域が完全に黒い場合（つまり何も選択されていない場合）、ノードは何も処理せずに元の入力を直接返します。

Cut And Drag On Path ノードソースコードリンク

Cut And Drag On Path ノードは ComfyUI-KJNodes ノードパッケージに含まれています。

Cut And Drag On Path(CutAndDragOnPath)