Easy Apply Inpaint : nœud d'inpainting pour ComfyUI-Easy-Use(applyInpaint)

Description

Le nœud Easy Apply Inpaint (applyInpaint) applique un inpainting basé sur un masque à une image tout en transportant un PIPE_LINE EasyUse à travers le graphe. Il appartient à la catégorie EasyUse/Inpaint et renvoie un PIPE_LINE mis à jour. Il est donc conçu pour être inséré dans un flux de pipeline EasyUse plutôt que d'être utilisé comme nœud de sortie autonome.

Le nœud prend en entrée l'image, un masque et un objet pipeline, puis effectue une passe d'inpainting à l'aide du backend et de la stratégie de conditionnement sélectionnés. Il expose des contrôles pour l'expansion du masque, la précision de calcul, la planification et la gestion facultative du masque de bruit.

Entrées

pipe

• Type : PIPE_LINE (requis)
• L'objet pipeline EasyUse transportant le modèle, le VAE, le conditionnement, le latent et d'autres états du flux de travail. L'opération d'inpainting est appliquée dans le contexte de ce pipeline, et le pipeline mis à jour est renvoyé en sortie.

image

• Type : IMAGE (requis)
• L'image à traiter par inpainting. Dans la plupart des flux de travail, il s'agit de l'image d'origine contenant l'objet ou la région à modifier.

mask

• Type : MASK (requis)
• Un masque à canal unique indiquant la région à traiter par inpainting. Les zones non nulles sont considérées comme la région à régénérer.

inpaint_mode

• Type : COMBO (requis)
• Options : normal, fooocus_inpaint, brushnet_random, brushnet_segmentation, powerpaint

Sélectionne le backend ou la stratégie d'inpainting :

• normal : comportement d'inpainting standard.
• fooocus_inpaint : inpainting de style Fooocus.
• brushnet_random : inpainting BrushNet avec un motif de génération aléatoire.
• brushnet_segmentation : inpainting BrushNet guidé par des informations de segmentation.
• powerpaint : inpainting basé sur PowerPaint, ce qui rend le sélecteur function utile pour différents types de tâches.

encode

• Type : COMBO (requis, défaut "none")
• Options : none, vae_encode_inpaint, inpaint_model_conditioning, different_diffusion

Contrôle la manière dont l'image d'entrée et le masque sont encodés ou conditionnés pour la passe d'inpainting :

• none : aucun encodage spécifique à l'inpainting n'est appliqué.
• vae_encode_inpaint : utilise un chemin d'encodage VAE spécialisé pour l'inpainting.
• inpaint_model_conditioning : utilise un conditionnement destiné aux modèles d'inpainting.
• different_diffusion : utilise une stratégie de conditionnement/inférence de style different-diffusion.

grow_mask_by

• Type : INT (requis, défaut 6, plage 0–64, pas 1)
• Nombre de pixels pour agrandir le masque avant l'inpainting. L'agrandissement du masque permet d'éviter les bords durs et laisse au modèle la marge nécessaire pour fondre le contenu généré dans la zone environnante.

dtype

• Type : COMBO (requis)
• Options : float16, bfloat16, float32, float64
• Précision utilisée pour le calcul de l'inpainting. float16 est généralement le plus rapide et utilise le moins de mémoire ; bfloat16 peut être préféré sur le matériel compatible ; float32 et float64 augmentent la précision numérique au détriment des performances.

fitting

• Type : FLOAT (requis, défaut 1, plage 0.3–1)
• Contrôle la force avec laquelle le contenu généré par inpainting est ajusté au comportement sélectionné. 1 est la valeur d'ajustement complète par défaut ; des valeurs plus faibles peuvent être utilisées pour réduire la force du conditionnement ou permettre un résultat plus souple.

function

• Type : COMBO (requis)
• Options : text guided, shape guided, object removal, context aware, image outpainting

Sélectionne le comportement sémantique de l'opération d'inpainting, en particulier pour les modes qui prennent en charge différents types de tâches :

• text guided : génération pilotée par un prompt textuel.
• shape guided : génération guidée par des informations de forme.
• object removal : suppression d'un objet et remplissage naturel de la région.
• context aware : remplissage contextuel de la zone masquée.
• image outpainting : extension de l'image au-delà de ses limites existantes.

scale

• Type : FLOAT (requis, défaut 1, plage 0–10)
• Multiplicateur d'échelle supplémentaire appliqué à l'opération d'inpainting. 1 est la valeur neutre par défaut ; des valeurs plus élevées amplifient l'échelle utilisée par le modèle d'inpainting.

start_at / end_at

• Type : INT (requis ; start_at défaut 0, end_at défaut 10000, plage 0–10000)
• Définissent le début et la fin de la plage d'échantillonnage/de débruitage affectée par l'opération d'inpainting. La plage par défaut 0–10000 couvre la totalité de la planification. Restreindre cette plage peut être utile pour une retouche légère plutôt qu'une régénération complète.

noise_mask

• Type : BOOLEAN (facultatif, défaut true)
• Lorsque cette option est activée, le nœud utilise un masque de bruit pendant l'échantillonnage afin que la région masquée à traiter soit diffusée à partir du bruit tandis que la zone non masquée est préservée. Désactivez cette option lorsque le chemin d'encodage/conditionnement sélectionné gère déjà le masque ou lorsque vous devez réduire l'utilisation de la mémoire.

Sorties

PIPE_LINE

• Le pipeline EasyUse mis à jour contenant le résultat de l'inpainting et l'état associé. Utilisez les nœuds en aval pour décoder, prévisualiser ou enregistrer le résultat.

Notes d'utilisation

• Toutes les entrées sauf noise_mask sont requises, le nœud peut donc effectuer directement une passe d'inpainting.
• Le nœud renvoie uniquement un PIPE_LINE ; il ne génère pas d'image ou de masque autonome.
• Pour la sélection de tâches de type PowerPaint, définissez inpaint_mode sur powerpaint et choisissez la function souhaitée.
• L'augmentation de grow_mask_by est un moyen pratique de réduire les coutures visibles lorsque le masque d'entrée est serré autour de l'objet.
• Lorsque vous utilisez des modes encode tels que inpaint_model_conditioning ou different_diffusion, testez noise_mask activé et désactivé, car l'interaction dépend du modèle d'inpainting et de l'échantillonneur.
• start_at et end_at utilisent une échelle de 0–10000. Une fenêtre étroite peut être utile pour des modifications subtiles : définissez start_at suffisamment haut pour passer les premières étapes de formation de la structure, ou définissez end_at plus bas pour éviter d'écraser complètement les détails fins.