Batch Crop From Mask (BatchCropFromMask) - ComfyUI-KJNodes

D'un point de vue technique, le nœud Batch Crop From Mask prend une image originale de type IMAGE et un masque de type MASK en entrée.

Le nœud Batch Crop From Mask est un outil de traitement d'images par lots. Il peut identifier et recadrer automatiquement les régions cibles d'une image en fonction des masques fournis. La fonction principale de ce nœud est d'analyser les zones de pixels non nuls de chaque masque, de calculer les boîtes englobantes correspondantes, puis d'utiliser ces boîtes pour recadrer les sous-images correspondantes à partir des images originales.

Fonctionnalités du nœud

D'un point de vue technique, ce nœud prend une image originale de type IMAGE et un masque de type MASK en entrée. Il parcourt chaque paire image/masque et calcule le rectangle englobant minimum à partir des coordonnées des pixels non nuls du masque. Le nœud prend en charge le lissage de la taille de la boîte englobante. Le paramètre bbox_smooth_alpha ajuste le degré de mélange entre la taille de la boîte englobante de l'image courante et celle de l'image historique, ce qui permet d'obtenir des résultats de recadrage plus stables lors du traitement de séquences. La taille calculée de la boîte englobante est également mise à l'échelle en la multipliant par le coefficient crop_size_mult pour ajuster de manière flexible la taille finale de la zone recadrée.

Explication des paramètres du nœud - Batch Crop From Mask

Entrées (Inputs)

Nom du paramètre	Type de données	Requis	Valeur par défaut	Plage de valeurs/Options	Description
`original_images`	IMAGE	Oui	-	-	** : Séquence d'images originales en sortie, identique à l'entrée. Type : IMAGE.
`masks`	MASK	Oui	-	-	** : Séquence de masques en entrée, utilisée pour déterminer la zone cible à recadrer dans l'image originale. La région des pixels non nuls du masque sera calculée comme boîte englobante. Type : MASK.

Paramètres de contrôle (Parameters)

Nom du paramètre	Type de données	Requis	Valeur par défaut	Plage de valeurs/Options	Description
`crop_size_mult`	FLOAT	Oui	1.0	0.0 - 10.0 (pas : 0.001)	** : Multiplicateur de la taille de recadrage, utilisé pour mettre à l'échelle la taille de la boîte englobante calculée. Plage de valeurs de 0.0 à 10.0, pas de 0.001.
`bbox_smooth_alpha`	FLOAT	Oui	0.5	0.0 - 1.0 (pas : 0.01)	** : Coefficient de lissage de la boîte englobante, utilisé pour mélanger la taille de la boîte englobante de l'image courante avec celle de l'image précédente afin d'obtenir une transition fluide. Plage de valeurs de 0.0 à 1.0, pas de 0.01.

Sorties (Output)

Nom du paramètre	Type de données	Description
original_images	IMAGE	** : Séquence d'images originales en sortie, identique à l'entrée. Type : IMAGE.
cropped_images	IMAGE	** : Séquence d'images recadrées en sortie. Type : IMAGE.
bboxes	BBOX	** : Séquence des coordonnées des boîtes englobantes en sortie, au format (x1, y1, x2, y2). Type : BBOX.
width	INT	** : Largeur uniforme des images recadrées en sortie. Type : INT.
height	INT	** : Hauteur uniforme des images recadrées en sortie. Type : INT.

Cas d'utilisation

Dans un flux de travail réel, ce nœud est souvent utilisé dans des scénarios nécessitant de se concentrer sur une partie spécifique d'une image. Par exemple, lors de la création d'animations ou du traitement de séquences vidéo, vous pouvez d'abord utiliser un nœud générateur de masques (comme SAM ou GroundingDino) pour identifier l'objet principal dans chaque image. Ensuite, connectez la séquence de masques générée et la séquence d'images originales à ce nœud. Le nœud produira une séquence d'images recadrées ainsi que les coordonnées des boîtes englobantes correspondantes. Ces sorties peuvent ensuite être utilisées pour de la retouche locale (inpainting), de la super-résolution, ou comme entrée pour d'autres nœuds de traitement d'image.

Lien vers le code source du nœud Batch Crop From Mask

Le nœud Batch Crop From Mask provient du pack de nœuds ComfyUI-KJNodes.

Batch Crop From Mask(BatchCropFromMask)