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

Le nœud Cut And Drag On Path analyse d'abord la chaîne de coordonnées de chemin en entrée, puis identifie avec précision la limite de la zone d'image couverte par le masque et la découpe.

Le nœud Cut And Drag On Path est un outil de traitement d'image qui découpe la zone sélectionnée par un masque dans une image et la déplace le long d'un chemin défini par l'utilisateur. Ce nœud est principalement utilisé pour créer des effets dynamiques, comme faire glisser ou flotter un objet le long d'une trajectoire spécifique dans l'image. Si la fonction d'inpainting est activée, il peut également combler intelligemment les vides laissés par la zone découpée.

Fonctionnalités du nœud

Le nœud analyse d'abord la chaîne de coordonnées de chemin en entrée, puis identifie avec précision la limite de la zone d'image couverte par le masque et la découpe. Le fragment d'image découpé est ensuite déplacé et recomposé sur une toile aux dimensions spécifiées selon la séquence de coordonnées. Le cœur technique réside dans l'analyse des coordonnées, la découpe de zone et le remappage de position. Il prend en charge les formats de tenseurs IMAGE et MASK standard et utilise éventuellement une image d'arrière-plan ou un algorithme d'inpainting intégré pour gérer l'arrière-plan.

Description des paramètres du nœud - Cut And Drag On Path

Entrées (Inputs)

Nom du paramètre	Type de données	Requis	Valeur par défaut	Plage/Valeurs possibles	Description
`image`	IMAGE	Oui	-	-	L'image d'entrée à partir de laquelle la zone masquée sera découpée et déplacée le long du chemin.
`mask`	MASK	Oui	-	-	Le masque qui définit la région à découper de l'image. Seuls les pixels non nuls sont pris en compte.
`bg_image`	IMAGE	Non	-	-	Image d'arrière-plan optionnelle. Si fournie, cette image sera utilisée pour remplir les zones vides au lieu de l'algorithme d'inpainting.

Paramètres de contrôle (Parameters)

Nom du paramètre	Type de données	Requis	Valeur par défaut	Plage/Valeurs possibles	Description
`coordinates`	STRING	Oui	-	-	Chaîne définissant la séquence de coordonnées pour le chemin de déplacement. Doit être un tableau JSON dans un format spécifique.
`frame_width`	INT	Oui	512	16 - 4096 (pas: 1)	Définit la largeur de l'image de sortie. Plage valide de 16 à 4096, avec un pas de 1.
`frame_height`	INT	Oui	512	16 - 4096 (pas: 1)	Définit la hauteur de l'image de sortie. Plage valide de 16 à 4096, avec un pas de 1.
`inpaint`	BOOLEAN	Oui	True	-	Basculer booléen contrôlant s'il faut effectuer un inpainting intelligent pour remplir les zones vides laissées après la découpe. Lorsqu'il est activé et qu'aucune image d'arrière-plan n'est fournie, la zone découpée est remplie à l'aide de l'algorithme cv2 TELEA.

Sorties (Output)

Nom du paramètre	Type de données	Description
image	IMAGE	La séquence d'images de sortie après traitement.
mask	MASK	La séquence de masques transformée le long du même chemin.

Cas d'utilisation

Vous pouvez utiliser ce nœud lorsque vous créez des animations ou des effets spéciaux simples. Par exemple, dans un flux de travail de traitement de trames vidéo, vous pouvez d'abord obtenir un masque d'objet en utilisant SAM ou un dessin manuel, puis générer une séquence de coordonnées de chemin de mouvement via d'autres nœuds, et enfin la connecter à ce nœud. Cela produira une série de séquences d'images montrant l'objet se déplaçant le long du chemin, prêt pour une composition de trames ultérieure.

Points d'attention

Veuillez noter que la chaîne de coordonnées en entrée doit respecter un format JSON spécifique ; sinon, elle risque de ne pas être analysée correctement. De plus, si la zone du masque est entièrement noire (c'est-à-dire qu'aucune zone n'est sélectionnée), le nœud renverra directement l'entrée originale sans aucun traitement.

Lien vers le code source du nœud Cut And Drag On Path

Le nœud Cut And Drag On Path provient du pack de nœuds ComfyUI-KJNodes.

Cut And Drag On Path(CutAndDragOnPath)