ImageAndMaskPreview

Le nœud ImageAndMaskPreview, qui hérite de la classe SaveImage, est principalement conçu pour générer des aperçus temporaires plutôt que pour un enregistrement permanent.

Le nœud ImageAndMaskPreview est un outil utilitaire pour prévisualiser des images et des masques. Sa fonction principale est de permettre aux utilisateurs de visualiser l'image ou le masque individuellement, ou de superposer le masque sur l'image avec une couleur et une transparence spécifiées, afin d'inspecter visuellement les zones masquées.

Fonctionnalité du nœud

Ce nœud hérite de la classe SaveImage mais est principalement destiné à générer des aperçus temporaires plutôt que des enregistrements permanents. Il prend en charge plusieurs formats de couleur pour définir la couleur du masque, notamment les tuples RGB, les tuples RGBA et les codes hexadécimaux. Lorsqu'une image et un masque sont fournis, le nœud compose le masque sur l'image avec l'opacité et la couleur définies ; si un seul des deux est fourni, il génère directement un aperçu de cet élément.

Description des paramètres du nœud - ImageAndMaskPreview

Entrées (Inputs)

Nom du paramètre	Type de données	Requis	Valeur par défaut	Plage/Valeurs possibles	Description
`image`	IMAGE	Non	-	-	Image d'entrée optionnelle à prévisualiser ou sur laquelle composer le masque.
`mask`	MASK	Non	-	-	Masque d'entrée optionnel à prévisualiser ou à composer sur l'image.

Paramètres de contrôle (Parameters)

Nom du paramètre	Type de données	Requis	Valeur par défaut	Plage/Valeurs possibles	Description
`mask_opacity`	FLOTTANT	Oui	1.0	0.0 - 1.0 (pas: 0.01)	Contrôle l'opacité globale du masque superposé sur l'image. La plage de valeurs va de 0.0 (complètement transparent) à 1.0 (complètement opaque), avec un pas d'ajustement de 0.01.
`mask_color`	CHAÎNE	Oui	255, 255, 255	-	Format RGBA (ex: "255,255,255,128") ou hexadécimal (ex: "#FF0000").
`pass_through`	Booléen	Oui	faux	-	Lorsqu'activé, le nœud désactive l'aperçu dans l'interface et transmet directement les données de l'image composite via le port de sortie.

Sortie (Output)

Nom du paramètre	Type de données	Description
composite	IMAGE	-

Cas d'utilisation

Ce nœud est très utile dans les flux de travail de traitement d'image. Par exemple, après avoir généré un masque, vous pouvez le connecter à ce nœud et régler mask_color sur un rouge vif pour vérifier rapidement si le masque couvre précisément la zone cible. Ou bien, avant une pipeline de composition vidéo, vous pouvez utiliser sa fonction pass_through pour transmettre directement le résultat composite aux nœuds d'animation suivants sans interrompre le flux pour consulter un aperçu.

Points d'attention

Il est important de noter que lorsque le mode pass_through est activé, le nœud n'affichera pas d'aperçu dans l'interface mais transmettra directement le résultat composite via le port de sortie. De plus, la couleur du masque prend en charge le format RGBA, ce qui signifie que vous pouvez spécifier une transparence indépendante pour la couleur elle-même, qui interagit avec le paramètre global mask_opacity.

Lien vers le code source du nœud ImageAndMaskPreview

Le nœud ImageAndMaskPreview provient du pack de nœuds ComfyUI-KJNodes.