沿路径剪切并拖动 (CutAndDragOnPath) - ComfyUI-KJNodes

沿路径剪切并拖动节点首先会解析输入的路径坐标字符串，然后精确识别遮罩覆盖的图像区域边界并将其裁剪出来。

沿路径剪切并拖动节点是一个图像处理工具，它能将图像中由遮罩选定的区域切割出来，并使其沿着用户定义的路径移动。该节点主要用于创建动态效果，例如让物体在画面中沿特定轨迹滑行或漂浮。如果启用了修复功能，它还能智能地填充被切割区域留下的空白。

节点功能

节点首先会解析输入的路径坐标字符串，然后精确识别遮罩覆盖的图像区域边界并将其裁剪出来。裁剪出的图像片段会根据坐标序列在指定尺寸的画布上进行位移和合成。技术核心在于坐标解析、区域裁剪与位置重映射，支持标准的 IMAGE 和 MASK 张量格式，并可选使用背景图或内置修复算法来处理背景。

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`image`	IMAGE	是	-	-	输入图像，遮罩区域将被剪切出来并沿路径移动。
`mask`	MASK	是	-	-	定义要从图像中裁剪的区域的遮罩。只考虑非零像素。
`bg_image`	IMAGE	否	-	-	可选的背景图像。若提供，将使用此图像填充空白区域，而非修复算法。

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`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 算法填充被切割区域。

参数名称	数据类型	说明
image	IMAGE	处理后的输出图像序列。
mask	MASK	经过相同路径变换的遮罩序列。

在制作简单的动画或特效时，你可以使用此节点。例如，在一个视频帧处理工作流中，先使用 SAM 或手动绘制得到一个物体的遮罩，然后通过其他节点生成一条运动路径坐标，最后连接至此节点，即可输出该物体沿路径移动的一系列图像序列，用于后续的帧合成。

请注意，输入的坐标字符串需符合特定的 JSON 格式要求，否则可能无法正确解析。此外，如果遮罩区域完全为黑色（即未选择任何区域），节点将直接返回原始输入，不会进行任何处理。